Руководство LumaMap

Быстрый старт за пять минут

1. Начните с шаблона или пустой сцены. При запуске открывается стартовый экран: шаблоны «Здание или фасад», «Сцена, клуб, концерт», «Объект необычной формы», «Светодиодные ленты» или пустой проект (⌘N).
2. Обведите объект. Поверхность → Quad (⌘1) и перетащите четыре угла на края стены, экрана или декорации. Неровная поверхность — Превратить в сетку (⌘2), круглая — Эллипс (⌘3), произвольная — Bezier (⌘4).
3. Дайте ей картинку. Перетащите видео или изображение из Finder в Медиа пул, а оттуда — на поверхность. Нет своего контента — + → Библиотека заготовок: огонь, вода, неон, космос — около пятидесяти анимаций.
4. Выведите на проектор. Вывод → Показать все выводы (⌘↩). Какой экран у какого проектора — в панели Выводы (⌘⇧O).
5. Проверьте и заблокируйте. Вывод → Проверить готовность (⌘⇧T) за секунду проверит проекторы, файлы, сеть и лицензию. Затем F5 — область «Шоу»: правка заблокирована, случайно сдвинуть угол уже нельзя.

Интерфейс

• Канва — в центре: сцена целиком, поверхности и их ручки. Колесо или два пальца на трекпаде — масштаб и сдвиг, ⌘0 или F — сбросить вид, ⌘⇧0 — вписать сцену. Через несколько секунд без движения ручки прячутся, чтобы было видно чистую картинку; пока мышь над слоями и медиапулом — не прячутся.
• Слои и Медиа пул — слева: порядок поверхностей и все источники проекта. Миниатюры видео и камер живые.
• Инспектор — справа: свойства выбранной поверхности (источник, геометрия, цвет, эффекты, маска, переход, плейлист).
• Транспорт — внизу канвы: воспроизведение таймлайна, шаг по кадрам, темп.
• Монитор вывода — маленькое окно в углу канвы, пока открыт вывод: то, что реально видит проектор. Шапкой его можно свернуть.
• Рабочие области F1–F5: Маппинг, Медиа, Управление, Калибровка, Шоу — набор панелей под текущее занятие.
• Настройки — ⌘,: язык, автосохранение, тема, размер текста по панелям, стиль рамки канвы, таймлайн, порт OSC, темп.

Поверхности

Поверхность — форма, на которую ложится картинка. Координаты сцены не зависят от разрешения: проект, собранный на ноутбуке, так же ляжет на проектор 4K.

Точная подгонка

• Углы прилипают к соседним углам и краям вывода (примагничивание). Временно отключить — держать ⇧; совсем — в Настройках.
• Точные значения — в числовых полях инспектора (позиция в пикселях вывода). При 3D-калибровке стрелки двигают отмеченную точку на пиксель, с ⇧ — на десять.
• Маска: обрезать картинку по контуру, с мягким краем (растушёвкой) и инверсией.
• Слой свёлся в точку и не ловится мышью — Вернуть форму и место (⌘9).
• ⌘D — копия поверхности со всеми настройками. Удаление отменяется ⌘Z.

Источники

Всё, что можно показать, живёт в Медиа пуле (кнопка + или перетаскивание файлов). Один источник может идти на несколько поверхностей.

• Видео — H.264, HEVC, ProRes на аппаратном декодере, со звуком. У ролика — скорость, обрезка начала и конца, повтор. Куда идёт звук — Настройки → Проект и вывод → Звуковой выход (звуковая карта, HDMI проектора, пульт); у отдельного ролика — свой выход в инспекторе, строка «Звук в».
• HAP — формат для нескольких 4K-роликов одновременно: кадры уходят в видеокарту сжатыми. Любое видео перекодируется прямо в программе: правый клик в медиапуле → Сделать копию в HAP. У HAP нет звука.
• Изображения — PNG, JPG, TIFF и другие.
• Камера, захват экрана, телефон — живое видео: веб-камера, экран или окно другой программы, камера телефона через браузер.
• Syphon, Spout, NDI — картинка из Resolume, TouchDesigner, OBS или с другого компьютера по сети.
• Шейдеры — генераторы, бесконечные и в любом разрешении. Библиотека заготовок (+ → Библиотека заготовок) и свои: формат ISF (.fs) — тысячи бесплатных генераторов из сети. Параметры шейдера становятся ползунками в инспекторе.
• FFGL-генераторы — плагины Resolume и MadMapper (+ → Генератор FFGL…, файлы .bundle на macOS и .dll на Windows). Плагины ищутся в папках Resolume «Extra Effects», FreeFrame и ~/Documents/LumaMap/FFGL.
• Веб-страница — сайт, свой файл .html или шаблон (часы, обратный отсчёт, «Под музыку»): + → Веб-страница…. Страница живая — анимации, видео, обновления идут в эфир. В инспекторе: размер, частота кадров, прозрачный фон, звук страницы, автообновление, свой CSS и JavaScript. Открыть страницу показывает её в окне, чтобы войти в аккаунт или нажать play, — это та же страница, что в эфире. Свой .html после сохранения в редакторе обновляется сам.
• Заливка цветом — однотонный источник, удобен для проверки и подсветки.

Своя страница, которая слушает шоу

На каждой странице есть объект luma: темп (bpm, beat — вспышка 1→0 на каждую долю, beatPhase, beats — номер доли), звук 0…1 (bass, mid, treble, level) и значения своих ползунков в luma.p. Ползунки страница объявляет сама — они появляются в инспекторе в карточке «Параметры страницы», их можно анимировать и вести с пульта, как у шейдеров:

luma.declare({
  speed: {label: "Скорость", min: 0, max: 4, value: 1},
  tint:  {label: "Цвет", value: "#ff8800"},
  flip:  {label: "Отразить", value: false},
  mode:  {label: "Режим", options: ["Волны", "Точки"]}
});
luma.on(l => { /* l.beat, l.bass, l.p.speed … */ });

Эффекты, цвет, переходы

• Цвет: яркость, контраст, насыщенность, оттенок, прозрачность.
• Встроенные эффекты: блюр, пикселизация, хроматическая аберрация, виньетка, шум, постеризация, инверсия, хромакей.
• Режимы наложения — как слои ложатся друг на друга (обычный, сложение, умножение, экран).
• Цепочка эффектов слоя (инспектор → Эффекты → + Добавить эффект…): больше 150 встроенных эффектов в девяти группах — цвет, размытие и свет, искажение, геометрия, стилизация (комикс, LED-экран, кинескоп, VHS, старое кино, витраж, масляная живопись…), глитч, память кадра (шлейф, эхо, обратная связь, светящийся след движения, стоп-кадр в такт), ритм и звук (удар зумом, строб и вспышка в такт, сайдчейн, тряска от баса) и маски с ключами (хромакей, лумакей, диафрагма, шторка). Эффекты ставятся цепочкой: у каждого выключатель, порядок и смесь — сколько эффекта поверх исходной картинки.
• Примерка: в окне эффектов достаточно навести курсор на эффект — он сразу виден на слое, ещё до добавления. Поиск понимает названия и описания: «шлейф», «бас», «неон».
• Свои эффекты — файл ISF (.fs), в том числе многопроходные с памятью кадра (PASSES, PERSISTENT), и плагины FFGL из Resolume/MadMapper. Плагины FFGL получают темп шоу; встроенные эффекты и ISF слышат темп и звук (u_beat, u_bass…), а без темпа идут сами на 120 BPM.
• Та же цепочка есть у всей сцены: вкладка Сцена → «Эффект».
• Узлы (+ → Узлы (граф эффектов) или «Узловой эффект» в окне эффектов): собирайте свои эффекты и генераторы из блоков — источники пула, генераторы, все 150+ эффектов, смешивание, маска, трансформ и числовые узлы (доля, бас, LFO, случайное на долю, математика). Любой числовой ползунок эффекта — это ещё и вход: подключите «Бас» к «Силе» — эффект дышит от музыки. В каждом узле живое превью; провод тянется от выхода к входу, Delete удаляет, F показывает весь граф.
• Переход при смене источника: растворение, шторка, через чёрный и длительность — в инспекторе в строке «Переход». Работает при любой смене: руками, кью, плейлистом.

Проекторы и калибровка

Несколько выводов

В панели Выводы (⌘⇧O) — список проекторов: экран, полноэкранный или оконный режим. ⌘↩ открывает все. Окно вывода закрывается клавишей Esc или табличкой «✕» в правом верхнем углу (она появляется при движении мыши над выводом). Все выводы рисуются в один момент — кадры на соседних проекторах не расходятся.

Сшивка двух проекторов

Сшить два проектора (⌘⇧B): ширина зоны перекрытия по каждому краю и гамма по каналам — шов становится невидимым. Подогнать цвет и яркость (⌘⇧L) выравнивает проекторы, которые светят по-разному.

Калибровка без рулетки

• Настроить по фото с камеры (⌘⇧K) — автокалибровка по меткам ArUco.
• Снять сцену телефоном — проектор показывает коды, телефон снимает; затем Обвести объект по снимку (⌘⇧E) — обводка по фотографии сразу становится поверхностью.
• 3D-калибровка проектора по точкам — для 3D-модели: отметьте 6 и больше точек модели и наведите на них перекрестие на настоящем объекте — программа вычислит положение и объектив проектора.
• Тестовые паттерны (⌘⇧N — следующий): сетка, шкала, мишень, полосы — на всех выводах вместо сцены.

Проекторы по сети (PJLink)

В панели Выводы у каждого вывода — «Проектор по сети»: IP-адрес и пароль PJLink (если задан в проекторе). Кнопки «Включить», «Выключить», «Шторка (AV mute)», «Проверить» — состояние, часы лампы и ошибки. Все сразу — Вывод → Включить / Выключить все проекторы. PJLink понимают проекторы почти всех марок.

Несколько компьютеров на одно шоу

Когда проекторов больше, чем выходов у одного компьютера: на всех компьютерах — копия одного проекта со своими выводами. В Настройки → Управление → Синхронизация компьютеров один ставится «Ведущим», остальные — «Ведомыми», с одинаковым именем группы — оно же пароль: чужие компьютеры в сети не смогут управлять шоу. Таймлайн, кью, затемнение и ролики идут вместе по локальной сети, расхождение роликов — единицы миллисекунд. В строке состояния ведущего видно, сколько компьютеров следуют и с какой точностью.

Шоу: сцены, таймлайн, темп

• Сценарий показа (кью-лист, ⌘⇧Q) — сцены по порядку. Кью может переключать источники и пресеты, запускать свет и действия. Следующая — кнопкой GO, клавишей или с пульта.
• Пресеты (⌘⇧P) — сохранённые состояния сцены.
• Таймлайн (⌘T) — ключевые кадры любых параметров. Вид (ключи, компактный, кривые, клипы, аудио-волна) выбирается в Настройках.
• LFO (⌘L) — автоколебания параметров без ключей: синус, меандр, пила, треугольник, случайно — в герцах или в такт.
• Клипы (⌘⇧U) — сетка живого запуска медиа по слоям и колонкам, в том числе с MIDI-пульта.
• Темп: кнопка Tap на транспорте, или ведомый темп по MIDI Clock / Ableton Link (Настройки → Управление → «Темп шоу»).

Управление с пультов

• MIDI (⌘M) — режим обучения: пошевелите регулятор на контроллере, и он привяжется к параметру.
• OSC — включается галочкой «OSC» в строке меню; порт — в Настройках → Управление.
• DMX / Art-Net со светового пульта (⌘⇧D) — LumaMap как медиасервер под пультом света.
• Таймкод LTC / MTC (⌘⇧G) — таймлайн идёт по пульту или DAW.
• Пульт в браузере телефона (⌘⇧W) — веб-пульт по локальной сети, без установки приложений.
• Реакция на звук (⌘⇧A) — параметры отзываются на музыку с микрофона или звуковой карты.
• Скрипт (⌘⇧C) — Python-консоль сцены для нестандартных задач.

Свет и светодиоды

• Световые приборы (Управление → Световые приборы (DMX)): пары, головы, прожекторы по Art-Net или sACN. Режим «цвет с экрана» — прибор светит цветом выбранного участка картинки. Блэкаут гасит и свет.
• Светодиодные ленты и матрицы (⌘⇧X) — та же картинка уходит в пиксели по сети, без второй программы.
• Куб SP107E — адресная лента по Bluetooth, управляется из кью.

Отдача, запись, трансляция

• Syphon (macOS), Spout (Windows), NDI — Управление → Отдача в другие программы: картинка вывода уходит источником в Resolume, MadMapper, OBS, vMix, TouchDesigner или по сети на другой компьютер.
• Виртуальная камера (⌘⇧V) — показ в Zoom, OBS, Meet как обычная камера.
• Запись видео (⌘⇧R) — пишет то, что видит проектор, в файл MP4.

Инсталляции без оператора

Компьютер-плеер

Любой компьютер с LumaMap становится плеером, как MiniMad или BrightSign: Настройки → Этот компьютер — плеер. После входа в систему программа открывается без редактора, выводы — во весь экран; пока шоу нет, на экране видны имя плеера, адрес и PIN. Шоу отправляется из редактора: Вывод → Отправить на плеер… — плеер находится в сети сам, проект со всеми файлами уходит одним архивом, и показ начинается сразу. В том же окне — миниатюра экрана плеера и кнопки «Пуск», «Стоп», «Блэкаут». Последнее шоу плеер открывает сам после перезапуска, а сторож показа поднимает его после сбоя.

• Плейлист на слое (инспектор → Плейлист): слой сам перебирает видео, картинки и шейдеры — по кругу, случайно или один раз, с переходом слоя.
• Расписание показа (Вывод → Расписание показа): дни недели и часы, когда вывод горит. Вне расписания — чёрный экран, к началу всё включается само. Правило может переходить через полночь. Галочка «Включать и выключать сами проекторы» — проекторы с адресом PJLink включаются к началу и выключаются после: лампа не горит всю ночь.
• Запуск сразу в показ: ключ --show открывает выводы и режим показа при старте. Поставьте программу в автозагрузку с этим ключом и проектом — компьютер включился, шоу идёт.
  macOS: open -a LumaMap --args "/путь/проект.luma" --show
  Windows: ярлык "C:\Program Files\LumaMap\LumaMap.exe" "C:\путь\проект.luma" --show в папке автозагрузки.
• Сторож показа — см. следующий раздел: если программа упадёт, она поднимется сама.

Надёжность и плавность

Если что-то пошло не так

• Сторож показа. Если программа упадёт или зависнет, пока открыты выводы, она перезапустится сама за несколько секунд и вернёт проект, выводы, режим показа, позицию таймлайна и активную кью. Не больше трёх раз за 10 минут. Отключается в Настройки → Общие.
• Автосохранение — копия проекта пишется регулярно (интервал — в Настройках). После сбоя при следующем запуске программа предложит восстановить работу.
• Блэкаут ⌘B — мгновенно погасить выводы, не останавливая сцену; возврат тем же сочетанием.
• Лог — Справка → Показать лог; пришлите его в поддержку вместе с описанием.

Без ступенек на градиентах

Настройки → Глубокий цвет (16 бит) и дизеринг (включено по умолчанию): кадр собирается в 16 битах на канал — слои, эффекты, мягкая сшивка проекторов и цветокалибровка, — а в 8 бит проектора переводится один раз, с неприметным шумом. Плавные градиенты, затемнения и зоны сшивки идут без полос. Нужна любая видеокарта последних лет; 10-битный кабель и проектор не обязательны.

Чтобы картинка шла ровно

• Несколько видео 4K одновременно — перекодируйте в HAP (правый клик в медиапуле).
• Подключайте проектор проводом (HDMI, DisplayPort). Беспроводной AirPlay не рассчитан на живую графику и может подтормаживать.
• Монитор вывода можно свернуть за шапку — это освобождает несколько кадров в секунду на слабых машинах.
• Рамка канвы: Настройки → Интерфейс → «Рамка канвы» → «Без анимации» снимает ещё немного нагрузки. В режиме показа рамка замирает сама.
• Режим показа (F5) не только блокирует правку, но и убирает всё лишнее с экрана оператора.

Горячие клавиши

Частые вопросы

Проектор показывает чёрный экран

Откройте Вывод → Почему нет картинки: программа пройдёт по цепочке и скажет, где обрыв — нет источника, файл не найден, поверхность за краем вывода, вывод погашен блэкаутом или расписанием.

Как перенести проект на компьютер площадки

Файл → Собрать проект в папку: проект и все его ролики, картинки и звук копируются в одну папку (медиа — в подпапку media). Перенесите папку целиком и откройте проект оттуда. Плагины FFGL не копируются — поставьте их на компьютере площадки.

Файлы проекта не находятся на другом компьютере

Пропавший файл программа сама ищет рядом с проектом и в папке media. Не нашла — в строке состояния будет «Не найдено файлов», а Файл → Найти пропавшие файлы поищет их по имени в указанной папке со всеми подпапками.

Мои плагины FFGL не видны

Положите .bundle (macOS) или .dll (Windows) в ~/Documents/LumaMap/FFGL или в папку Resolume «Extra Effects». Нужен FFGL 2 (плагины для Resolume 7 и новее). На Mac с Apple Silicon плагин должен быть собран под arm64 или универсальным.

Картинка подтормаживает

См. «Чтобы картинка шла ровно» выше. Если не помогло — пришлите лог (Справка → Показать лог) в поддержку.

Как связаться с поддержкой

Справка → Написать в поддержку, или канал новостей t.me/LumaMapp. Идеи — Справка → Предложить идею.