Get Current Timestamp
QuartzClockHandleЧто это
Pure-функция, возвращающая текущую временну́ю метку (timestamp) Quartz-часов (QuartzClockHandle). Метка содержит информацию о музыкальном времени: количество тактов, долей, позицию в семплах и BPM. Не требует выполнения по exec-линии – вызывается как источник данных.
Пины
Exec-входы:
Нет (pure)
Exec-выходы:
Нет (pure)
Входы (данные):
- Target (QuartzClockHandle) – ссылка на часы, чью метку нужно получить.
Выходы (данные):
- ReturnValue (QuartzTransportTimeStamp) – структура с полями: MusicTimeOffset, BeatFraction, BPM, SamplesPerSecond, SecondsPerSample и др.
Когда используется
- Синхронизация анимаций, аудио или VFX с музыкальным временем в проектах с процедурной музыкой.
- Получение текущей доли такта для динамического изменения параметров (например, цвета, скорости).
Типичные проблемы
- Забывают, что функция pure – и подключают к ней exec-линию (что излишне, но не сломает граф).
- Путают с GetCurrentTime (другая функция, возвращающая абсолютное время в секундах). GetCurrentTimestamp даёт музыкальный контекст, а не секунды.