LUA CREATOR · SCRIPT SDK 1

Твои инструменты.
Твои правила.

Преврати повторяющиеся действия в одну команду. Собери MIDI-генератор, анализатор аудио или целое окно для своей задачи — прямо внутри VLTone.

Бесплатно. Lua уже входит в VLTone.

Lua Creator: редактор, команды и проверка скрипта
Редактор, проверка, запуск и установка — в одном окне.
01

Creator: ноды, C++ и Lua

Выберите подходящий способ расширения VLTone: обработку звука в графе или инструмент работы с проектом.

  1. Для обработки аудиосигнала откройте Creator с нодами. Соедините вход, обработку и выход; настройте интерфейс мини-модуля.
  2. Если нужного алгоритма нет среди нод, добавьте C++ Function и используйте Creator SDK.
  3. Для команд, генерации MIDI, анализа файлов и собственных окон откройте Lua Creator через раздел скриптов.
  4. Сохраните исходный проект. Компиляция DSP-модуля и установка Lua-пакета — разные способы добавить результат в программу.

Выбран редактор, соответствующий задаче. Подробный справочник доступен на странице Creator.

Перейти к нодам и C++
02

Lua Creator: первый скрипт

Lua 5.5 входит в VLTone. Скрипты запускаются в отдельных процессах; управляет изменениями проекта сама DAW.

  1. Откройте Lua Creator из раздела скриптов. Создайте пакет через New или откройте пример SDK через Open.
  2. Проверьте manifest: ID, имя, версию, список команд, их entry-файлы, contexts и permissions.
  3. Выберите команду, отредактируйте её Lua-файл и нажмите Check. Исправьте ошибки из журнала.
  4. Сохраните пакет и нажмите Preview copy. Проверьте результат на копии проекта.
  5. Когда результат подходит, используйте Run in real project для настоящего проекта. Stop прекращает активный запуск.
  6. Нажмите Install, чтобы добавить команды в библиотеку; Export сохраняет пакет .vltscript для передачи.

Проверенный скрипт установлен и доступен в меню скриптов.

Check проверяет исходник, но не заменяет проверку поведения на копии проекта.

main.luaЧтение выделения
local context = vlt.context.get()
local tracks = context.selection.tracks or {}

return {
  message = "Selected tracks: " .. #tracks
}

Минимальная команда читает контекст и возвращает сообщение. Для практики с изменениями открой midi-transpose из SDK.

03

Lua: дорожки, клипы, MIDI и Undo

Скрипт получает контекст выделения и выполняет поддерживаемые операции через Script SDK.

  1. Прочитайте выделение через vlt.context.get(), а состояние — через vlt.project.get().
  2. Проверьте наличие дорожки или MIDI-клипа и подготовьте операции. Используйте ID из актуального ответа.
  3. Передайте актуальную revision, понятный label и operations в vlt.project.apply().
  4. Проверьте результат в программе и отмените через Undo. Если проект изменился во время расчёта, перечитайте его и повторите подготовку.

Пакет правок применён согласованно и доступен в истории.

Начните с примера midi-transpose: он учитывает выделение, диапазон MIDI и актуальность состояния.

04

Lua: свои окна и фоновые задачи

Script SDK позволяет создавать инструменты с интерфейсом внутри VLTone.

  1. Откройте пример interactive-workbench или styled-workbench и изучите описание окна и обработчики.
  2. Используйте штатные кнопки, поля, таблицы и вкладки; для собственной графики добавьте canvas.
  3. Разбивайте долгую работу на части, показывайте прогресс и предоставляйте остановку.
  4. Проверьте клавиатуру, закрытие окна и Stop. Завершённые правки проверяйте отдельно от оставшейся фоновой работы.

Инструмент имеет свой интерфейс и управляемый жизненный цикл.

05

Lua: анализ и генерация аудио

Скрипты могут работать с PCM, готовить файлы и измерять результат. Обработка выполняется как задача инструмента, а не как DSP-нода аудиопотока.

  1. Откройте pcm-analysis, transient-slicer или Arrangement Lab из SDK.
  2. Выберите исходный файл или параметры генерации. Проверьте необходимые разрешения.
  3. Чтение и синтез выполняйте ограниченными блоками; для долгих задач предусмотрите отмену.
  4. Прослушайте результат, проверьте уровень и только после этого добавьте готовое аудио в проект.

Получен измеренный или сгенерированный аудиоматериал для аранжировки.

06

Lua: установка, разрешения и обмен

Установленные пакеты управляются через менеджер скриптов. Разрешения задают доступные им действия.

  1. Откройте пакет в Lua Creator и проверьте исходники, ресурсы и заявленные permissions.
  2. Выполните Check и Preview copy, затем Install.
  3. В менеджере скриптов выберите команду, назначьте горячую клавишу или добавьте её в панель. Контекстные команды показываются в подходящем месте.
  4. Для обмена используйте Export → .vltscript. Сохраните редактируемые исходники отдельно.
  5. Если скрипт не запускается, проверьте выбранную команду, контекст проекта, разрешения и журнал.

Команды доступны там, где нужны, а пакет можно передать другому пользователю.

07 · SCRIPT SDK

Начни с работающего примера.

Открой папку примера в Lua Creator, изучи manifest.json и код примера, затем проверь запуск на копии проекта. В архиве — SDK и готовые примеры.

midi-transpose

Транспонирование MIDI

Выделение, ноты, актуальное состояние и один шаг Undo.

arrangement-lab

Arrangement Lab

Композиция, ритм, шесть аудиопартий, микшер и измерения.

styled-workbench

Свой интерфейс

Окна, вкладки, таблицы, оформление и события.

transient-slicer

Нарезка по транзиентам

Анализ аудио и подготовка слайсов для проекта.

pcm-analysis

Анализ PCM

Чтение аудиобуферов и измерение сигнала.

background-events

Фоновые события

Реакция на события и управление временем жизни задачи.

SDK reference в редакторе показывает справочник установленной версии. Для внешнего редактора: vlt_script_worker --sdk выводит каталог API, --check file.lua проверяет файл без выполнения.

Расширяй VLTone под себя.

Creator и Lua доступны бесплатно, без регистрации.

Скачать VLTone