CreatorДокументация 0.3.2 beta
Разделы документацииВ этой статье
CREATOR / РУКОВОДСТВО

C++ и Creator SDK

Добавляй собственные алгоритмы и вызываемые функции с переносимым SDK 1 для C++23.

Первая функция

Добавь C++ Function. Укажи Entry function = process, вставь код и нажми «Обновить ноду». Анализ исходника создаст реальные порты. Подключи Audio и результат, затем Compile.

#include <vlt/creator.hpp>

vlt::AudioFrame process(vlt::AudioFrame audio, float gain = 0.5f) {
    return {audio.left * gain, audio.right * gain};
}

Сигнатура и порты

float становится Number, bool — Gate, vlt::AudioFrame — Audio. Возвращаемая структура может создавать несколько выходов. VLT_PORT задаёт стабильный ID; значения по умолчанию задают ручные значения числовых входов.

vlt::Function<Signature> создаёт вызываемый вход. Подключи Function-выход другой C++-ноды с той же сигнатурой. Это вызов с аргументами из кода, а не готовый аудиопоток. Каждый binding хранит собственное состояние.

Состояние и realtime

Состояние хранится в State. Подготавливай vlt::Buffer в prepare, очищай историю в reset. Во время process не выделяй память, не работай с файлами, сетью или ОС. Локальные helpers помещай в тот же исходник либо в другую Function-ноду.

Контекст передаёт частоту дискретизации, время, темп и seed. Корректно объявляй latency и tail для выравнивания параллельных ветвей и завершения экспорта.

Проверка и сборка

После любой правки, даже тела функции без изменения сигнатуры, нажми «Обновить ноду». Это анализ исходника, а не публикация нового DSP. Compile проверяет графы, собирает переносимый код и устанавливает .vltmini.

Проверь mono/stereo, крайние параметры, разные частоты дискретизации, reset, автоматизацию и хвост эффекта. Успешная компиляция сама по себе не оценивает звук.

Скачать полный справочник SDK на русском: API, жизненный цикл и исходники примеров

ДалееAI-помощник Creator →