Get Current Clock Timestamp
QuartzSubsystem
0
Что это
Pure-функция, возвращающая текущую временную метку (timestamp) указанного звукового часового механизма (clock) в подсистеме Quartz. Используется для синхронизации аудиособытий с игровым временем.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (QuartzSubsystem Object Reference) — ссылка на подсистему Quartz
- Clock Name (Name) — имя часов, чью метку нужно получить
Выходы (данные):
- Return Value (QuartzTransportTimeStamp) — структура, содержащая текущую временную метку (количество семплов, тактов, долей и т.д.)
Когда используется
- Для получения текущей позиции в аудиопотоке, управляемом Quartz.
- Для синхронизации визуальных эффектов (анимаций, VFX) с конкретным моментом звуковой дорожки.
Типичные проблемы
- Неверное имя часов: если Clock Name не соответствует ни одним из созданных ранее часов, функция вернёт нулевую метку (все поля = 0). Всегда проверяйте, что часы созданы и запущены до вызова этой функции.
- Игнорирование структуры метки: разработчики часто используют только одно поле (например,
Bars), не учитывая, что метка содержит несколько уровней (семплы, доли, такты). Для точной синхронизации нужно сравнивать полную структуру или использовать специализированные функции Quartz для конвертации.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.