Get Thirty Second Notes Per Minute
QuartzClockHandle
0
Что это
Pure-функция, возвращающая текущий темп в ударах тридцатьвторой ноты в минуту для заданного QuartzClockHandle. Позволяет получить значение BPM, масштабированное до длительности тридцатьвторой ноты (1/32). Полезна при работе с музыкальными таймингами и метрономом в Quartz.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (QuartzClockHandle) — ссылка на активный кварцевый таймер, для которого запрашивается темп.
Выходы (данные):
- ReturnValue (float) — количество тридцатьвторых нот в минуту (например, при 120 BPM = 960).
Когда используется
- Для синхронизации анимаций, визуальных эффектов или звуковых событий с музыкальным ритмом, где требуется точность до 1/32 доли.
- При расчёте длительности одного тика (1/32) для таймеров или задержек в ритмических системах.
Типичные проблемы
- Путаница с BPM: Функция возвращает не стандартные удары в минуту (quarter notes), а количество тридцатьвторых нот. Например, при 120 BPM результат будет 960 (120 × 8), а не 120. Новички часто ожидают BPM напрямую.
- Неактивный таймер: Если
QuartzClockHandleне запущен или был остановлен, возвращаемое значение может быть нулевым или неопределённым. Всегда проверяйте состояние таймера перед вызовом.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.