КОМПЛЕКТ KBDUKE TOUCH — grandMA2 — ВЕРСИЯ 1.4
Рабочий плагин 1.0.0. Проверено на grandMA2 onPC 3.9.60.37.
Это комплект для MA2. Отдельный комплект для MA3 имеет версию 1.8.

УСТАНОВКА С ФЛЕШКИ
1. Распакуйте ZIP, скопируйте папку gma2 в корень флешки.
2. В Plugins Pool нажмите Edit, затем свободную ячейку. В редакторе откройте
   Import, выберите флешку и Touch_Install_grandMA2_v1_4.xml.
   Одноимённый Lua должен лежать рядом с XML.
3. Закройте редактор и Patch. Один раз нажмите Touch - Install MA2.
   Дождитесь Installed: там будут номера рабочего плагина и типа прибора.
4. В Patch добавьте KBDuke / Touch 35ch RGBW 2inst BG / 35ch, задайте FID и адрес.
   Подтвердите изменения патча. Для старого Touch 35ch см. раздел НОВЫЙ ПРИБОР.
5. Выберите Touch, проверьте Dimmer → Background → Transition, сохраните шоу.

WINDOWS onPC
Можно использовать ту же флешку. Другой вариант: скопируйте содержимое gma2
в папку данных своей версии MA2 (обычно ProgramData/MA Lighting Technologies/
grandma/gma2_V_3.9.60), затем импортируйте установщик из внутреннего диска.
Рабочая установка всё равно выполняется запуском Touch - Install MA2 в MA2.

УПРАВЛЕНИЕ И ОБНОВЛЕНИЕ
Установщик уже запускает Touch Auto Encoder MA2. После загрузки шоу запустите
его один раз ЛКМ. Повторное нажатие проверяет работу; для остановки нажмите Off,
затем рабочий плагин. Ограничения в две минуты нет. Автозапуск не настроен.
После смены User Profile запускайте плагин в нужном профиле.

При обновлении с комплекта 1.2 или 1.3 импортируйте установщик 1.4 и запустите его.
Он использует прежний рабочий плагин, добавляет Background в прежний служебный
World и при необходимости ставит TOUCH_BACKGROUND перед TOUCH_TRANSITION.
Порядок обычных атрибутов Dimmer сохраняется. Изменённые пользователем
служебные объекты установщик сохраняет и сообщает о несовпадении.

КАК РАБОТАЕТ MA2
Используется служебный World с атрибутами Touch и служебная группа чтения
выбора. Эти объекты не нужно выбирать вручную. Проверка идёт раз в 0,35 секунды.
Возврат по умолчанию — World 1 (Full). Профиль с жёстко назначенным World
не подходит. Служебную группу TOUCH - Selection Service MA2 не редактируйте.
World ограничивает доступные для программирования атрибуты.

НОВЫЙ ПРИБОР
Touch 35ch RGBW 2inst BG / 35ch. Теперь всего 35 DMX-адресов.
35-й — единственный резервный канал. 36-го канала в приборе нет.
По сравнению с комплектами MA2 1.3 / MA3 1.7 удалён только резервный DMX 36.
Каналы 1–35 сохранены: Background — DMX 3, Transition — DMX 4, Shutter — DMX 34.
Полный порядок — DMX_MAP.txt.

BG в названии отличает этот прибор с Background от прежнего Touch 35ch без него.
При обновлении существующего 36ch-патча выберите для нужных Touch новый тип
Touch 35ch RGBW 2inst BG / 35ch. Стартовые адреса можно сохранить; размер станет 35.
Один запуск установщика не меняет тип уже запатченных приборов автоматически.
Старый 35ch без Background имеет другую раскладку: для него сверяйтесь с DMX_MAP.txt.

ДВА ИНСТАНСА
FID.1 — Main: общие параметры и первый RGBW. FID.2 — только второй RGBW.
FID.3 нет. Первый RGB по умолчанию 100%, W — 0%; второй RGBW — весь 0%.
Move X/Y по умолчанию 50% (после округления DMX 128), Scale X/Y — 0%.
Background и Transition по умолчанию 0%. Dimmer, RGBW и Speed — 16 бит.
Шкала Speed — 0–255. Сначала очистите programmer, когда проверяете defaults.

РАСКЛАДКА TOUCH
Dimmer: Dimmer → Background → Transition.
Position: Move X, Move Y, Scale X, Scale Y.
Gobo A: Clip, Speed, Period, Width.
Gobo B: Pixelate, Speed Bounce, Mirror, Feedback.
Color: RGBW выбранного инстанса. Beam: Shutter.
Чистый выбор Touch, включая второй инстанс, включает раскладку Touch.
Обычный, смешанный и пустой выбор возвращают обычную раскладку.
Стандартный Dimmer сохранён для эффектов. Макрос выбора группы не нужен.

ФАЙЛЫ ПРОВЕРКИ
Verification.json/txt описывают проведённые тесты и ограничения.
SHA256SUMS.txt содержит контрольные суммы. Для установки эти файлы импортировать
не нужно. Отдельный XML прибора находится в комплекте рядом с установщиком.
MCP, интернет и компьютер автора для работы плагина не требуются.
