Get Beats Per Minute
QuartzClockHandle
0
Что это
Pure-функция, возвращающая текущее значение BPM (ударов в минуту) для указанного QuartzClockHandle. Используется для синхронизации игровых событий с темпом музыкального трека или метронома.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (QuartzClockHandle) — ссылка на часы Quartz, для которых запрашивается BPM.
Выходы (данные):
- ReturnValue (Float) — текущее значение BPM (может быть дробным).
Когда используется
- Привязка анимаций, VFX или геймплея к музыкальному темпу.
- Расчёт длительности тактов/долей вручную (например, для создания собственных таймеров, синхронизированных с музыкой).
- Отладка и визуализация темпа в редакторе.
Типичные проблемы
- Если часы Quartz не были запущены или не существуют, возвращается 0.0 — это не ошибка, а штатное поведение, но его нужно учитывать в логике (например, проверять
IsValidна Target). - BPM может быть нецелым (например, 120.5), поэтому при сравнениях с целыми числами используйте допуск (толеранс) или округление.
- Функция возвращает значение на момент вызова; если BPM динамически меняется (через
SetBeatsPerMinute), необходимо вызывать её заново для получения актуального значения.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.