Get Duration Of Quantization Type In Seconds
QuartzSubsystemЧто это
Pure-функция подсистемы Quartz. Возвращает длительность в секундах для заданного типа квантования (например, четверть, восьмая) на основе текущего темпа (BPM) указанных часов. Полезна для расчёта временных интервалов в ритмической музыке, анимации или игровых событиях, синхронизированных с метрономом.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (QuartzSubsystem Object Reference) — ссылка на подсистему Quartz
- Quantization Type (EQuartzQuantizationType) — тип квантования (1/1, 1/2, 1/4, 1/8, 1/16, 1/32 и т.д.)
- Clock (QuartzClockHandle Object Reference) — ссылка на часы, которые задают текущий темп (BPM)
Выходы (данные):
- Return Value (Float) — длительность в секундах
Когда используется
- Синхронизация игровых событий с ритмом: запуск таймеров, анимаций, звуковых эффектов через заданное количество нот.
- Расчёт времени для кастомных метрономов или секвенсоров.
- Привязка визуальных эффектов (вспышки, движения) к музыкальному такту.
Типичные проблемы
- Отсутствие или некорректный ClockHandle — без валидной ссылки на работающие часы функция возвращает 0. Убедитесь, что часы созданы и запущены (через
CreateNewClockилиGetClock). - Несовместимый тип квантования — если часы не поддерживают высокое разрешение (high-resolution), слишком мелкие типы (1/32, 1/64) могут дать 0 или неточное значение.
- Нулевой BPM — если темп часов не установлен или равен 0, длительность будет 0. Всегда задавайте BPM через
SetBPMилиSetMillisecondsPerTick.