Пошаговая инструкция экспорта эффектов, созданных в программе «Jinx!»

Шаг 1

Перейдите на сайт разработчиков «Jinx!» и скачайте приложение. Распакуйте архив с программой в отдельную папку. Запустите приложение

Шаг 2

Программа «Jinx!» поставляется с демо-скриптом, содержащем большое количество настроенных сцен, эффектов и переходов.
Для подключения скрипта примера в меню "File" выберите пункт "Import"

В окне выбора файла выберите "demo.jnx" и нажмите кнопку "Открыть"

После того, как скрипт подключен к программе, выбор пункта меню "View Scenelist" (или нажатие кнопки F2)

откроет окно выбора доступных сцен.

Каждая сцена содержит комбинацию эффектов, результат отображается в реальном режиме времени в панелях предпросмотра в верхней части главного окна Jinx.
Изучите как работают и комбинируются эффекты. Изменяйте настройки каналов и смотрите как они влияют на результат.

В интернете вы можете найти большое количество инструкций по созданию эффектов с помощью Jinx,
доступны видеоуроки в Youtube.

Шаг 3

Откройте окно настроек матрицы

и задайте размер рабочего поля в пикселях

Размер должен соответствовать вашей матрице, которую вы используете в своем проекте

Шаг 4

Настройте выходное устройство, в формате которого будут сохраняться созданные вами эффекты.
В нашем случае программа должна создавать файлы для отображения в приложении управления матрицей Glediator

Откройте окно настроек выходных устройств

Нажмите кнопку Add ("Добавить") для добавления нового устройства

• В комбо-боксе "Device Type" выберите значение "Glediator"
• Отметьте чекбокс "Redirect Output to File"
• Нажмите кнопку "Select"

Выберите файл в который по умолчанию будет сохраняться анимация эффекта.
Если файла еще не существует - введите название в строке "Имя файла" - файл будет создан при сохранении данных.
Нажмите кнопку "Сохранить".
Закройте окно создания устройства. Устройство создано и готово к работе.

Шаг 5

Далее требуется указать конфигурацию вашей матрицы - тип (зигзаг или по строкам / по колонкам), угол подключения, где находится первый светодиод и направление из этого угла.

Внимание!!!

Если у вас поменялся размер матрицы или угол ее подключения - настройку следует проводить "с чистого листа".
То есть - в меню "File" выбрать пункт "Open", открыть файл "demo.jnx" или сохраненный вами файл настроек.
Задать размеры матрицы, создать выходное устройство и тип подключения матрицы.
Если этого не сделать - выходной файл может иметь неверный формат и вы долго будете выяснять что не так.

Выберите в меню пункт настройки варианта подключения матрицы

В открывшемся окне представлена схема матрицы, на которую должны выводиться эффекты.
Красными представлены пиксели для которых еще не назначено соответствие светодиодам матрицы

В комбобоксе "Patch Device" выберите созданное на предыдущем шаге устройство

Выберите левую верхнюю ячейку виртуальной матрицы
Нажмите кнопку "Fast Patch"

1. Укажите размеры матрицы
2. Выберите устройство
3. Выберите порядок следования цветов в вашей ленте. Возможно с этим параметром придется поэкспериментировать, если в результате экспорта эффект отображается не теми цветами.
4. Выберите направление светодиодов из угла подключения матрицы В комбобоксе "Patch Mode"

Доступны следующие варианты:

• Linewise starting Top-Left - Левый верхний угол, параллельно по строкам слева направо
• Linewise starting Top-Right - Правый верхний угол, параллельно по строкам справа налево
• Linewise starting Bottom-Left - Левый нижний угол, параллельно по строкам слева направо
• Linewise starting Bottom-Right - Правый верхний угол, параллельно по строкам справа налево
• Snakelines starting Top-Left - Левый верхний угол, зигзаг направление вправо
• Snakelines starting Top-Right - Правый верхний угол, зигзаг направление влево
• Snakelines starting Bottom-Left - Левый нижний угол, зигзаг направление вправо
• Snakelines starting Bottom-Right - Правый нижний угол, зигзаг направление влево
• Columnwise starting Top-Left - Левый верхний угол, параллельно по колонкам сверху вниз
• Columnwise starting Top-Right - Правый верхний угол, параллельно по колонкам сверху вниз
• Columnwise starting Bottom-Left - Левый нижний угол, параллельно по колонкам снизу вверх
• Columnwise starting Bottom-Right - Правый нижний угол, параллельно по колонкам снизу вверх
• Snakecolumns starting Top-Left - Левый верхний угол, зигзаг, направление вниз
• Snakecolumns starting Top-Right - Правый верхний угол, зигзаг, направление вниз
• Snakecolumns starting Bottom-Left - Левый нижний угол, зигзаг, направление вверх
• Snakecolumns starting Bottom-Right - Правый нижний угол, зигзаг, направление вверх

Если направление и угол подключения матрицы выбраны неверно - эффект может отображаться зеркально, перевернутым или вообще без внятного рисунка, если перепутан угол подключения и ширина матрицы не равна ее высоте или перепутаны параллельный тип матрицы и зигзаг, строки и колонки.

Завершите конфигурирование параметров матрицы, нажав на кнопку "OK"

Теперь клетки матрицы имеют зеленый цвет, что означает, что каждой ячейке виртуальной / программной матрицы назначен светодиод физической матрицы

Нажмите кнопку "ОК" для завершения настройки.

Шаг 6

Итак, эффект создан или выбран один из готовых примеров. Он отображается в реальном режиме времени в центральной панели, являющейся результатом смешивания эффектов из правой и левой панелей предварительного просмотра. Можно сохранить эффект в файл, который позже будет воспроизведен на вашей матрице.

Для начала экспорта в меню "Setup" выберите пункт "Start Output". Нажмите на него в подходящий момент, наблюдая за отображением в панели предпросмотра.
Дождитесь завершения воспроизведения эффекта и повторно нажмите на пункт "Start Output". Запись анимации будет остановлена.
Сохраняйте достаточно длинные фрагменты - от этого зависит продолжительность воспроизведения эффекта на вашей матрице.

Найдите cохраненный файл в папке, которую вы настроиле на Шаге 3

Откройте в Проводнике вашу SD-карту
Создайте в корне SD арточки папку, соответствующую размерам вашей матрицы.
В примере это папка "48x16".

Скопируйте файл из папки Jinx в папку на SD карточке. Файл может иметь любое имя, но расширение файла должно обязательно быть ".out"
Имена файлов можете задать просто по порядку "001.out", "002.out", "003.out" и так далее
или дать эффектам осмысленные названия, например "Hellfire.out", "Rain drops.out", "New Year.out" и т.п

Внимание!!!

Имена файлов эффектов НЕ ДОЛЖНЫ содержать кириллицу! Допускаются только буквы латинского алфавита, цифры и некоторые символы.

Экспортируйте другие эффекты, повторяя описанные в Шаге 6 действия.
Текущая версия микропрограммы поддерживает до 128 различных эффектов.

Шаг 7

Вставьте SD-карту в ваш контроллер, перезагрузите его, нажав на кнопку сброса.
Если у вас включен монитор порта, вы увидите сообщение о том, что карта обнаружена и на ней найдены файлы с вашими эффектами

Подключите телефон к матрице, перейдите в раздел эффектов, в комбобоксе выбора эффекта выберите "SD-карта"
Эффект должен начать воспроизводиться на вашей Матрице.
Если цвета эффекта не совпадают с теми, что отображаются в Jinx или изображение перевернуто или не читается вовсе,
вернитесь к настройкам матрицы в Jinx, проверьте корректность указанных размеров, порядка цветов RGB/GRB/...,
настройки точки подключения матрицы.