Get Beat Progress Percent
QuartzClockHandle
0
Что это
Pure-функция класса QuartzClockHandle. Возвращает прогресс текущего бита в пределах от 0.0 (начало бита) до 1.0 (конец бита). Используется для синхронизации анимаций, VFX или звуковых событий с музыкальным временем.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (QuartzClockHandle) — ссылка на работающий кварцевый таймер.
Выходы (данные):
- ReturnValue (float) — прогресс текущего бита (0.0 … 1.0).
Когда используется
- Анимация сцены под бит (например, покачивание объектов).
- Синхронизация спавна врагов/частиц с долей бита.
- Реализация ритмических геймплейных механик (например, ритм-игры).
Типичные проблемы
- Неправильное понимание значения – функция возвращает прогресс текущего бита от его начала, а не оставшееся время до конца такта или следуещего бита.
- Невалидный ClockHandle – если таймер не активен или удалён, возвращается 0.0 без превдупреждения.
- Путаница с «Get Beat Fraction» – в Quartz есть две похожие функции: текущая показывает долю бита, а BeatFraction — долю такта. Уделите внимание названию.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.