Get Loop Regions
SoundWave
0
Что это
Pure-функция ассета SoundWave. Возвращает массив структур, описывающих зоны зацикливания (loop regions), заданные в редакторе звуковой волны. Позволяет получить информацию о точках входа и длительности луп-сегментов для последующей обработки или воспроизведения.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (SoundWave) — звуковой ассет, для которого запрашиваются регионы.
Выходы (данные):
- Loop Regions (Array of SoundWave Loop Region) — массив всех определённых зон зацикливания. Каждый элемент содержит смещение (Offset) и длительность (Duration) в секундах.
Когда используется
- Для динамического воспроизведения отдельных сегментов звука, например, для создания ритмических циклов или подгрузки разных частей трека.
- В инструментах анализа аудио, где нужно выяснить, содержит ли файл встроенные точки зацикливания (часто встречается в музыкальных ассетах).
Типичные проблемы
- Не проверен массив на пустоту — если в звуковом ассете не заданы loop regions, функция вернёт пустой массив. Попытка обратиться к элементу без проверки длины приведёт к ошибке выполнения.
- Путаница с временными единицами — значения Offset и Duration в структуре SoundWave Loop Region задаются в секундах, но новички иногда думают, что это проценты или сэмплы.
- Забыли, что функция pure — разработчики могут случайно пытаться подключить её exec-пинами, что не требуется; ноду достаточно просто поставить в граф данных.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.