Snap Frame Time
TimeManagementBlueprintLibraryЧто это
Pure-функция из библиотеки TimeManagementBlueprintLibrary. Принимает исходное время кадра (FFrameTime) и две частоты кадров (FFrameRate) — исходную и целевую (для «привязки»). Возвращает ближайшее время кадра (FFFrameTime), кратное целевой частоте. Полезна для синхронизации анимации, захвата видео или точного тайминга в проектах со смешанными фреймрейтами.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- SourceFrameTime (FFrameTime) — исходное значение времени в кадрах и суб-кадрах
- SourceRate (FFrameRate) — частота кадров, в которой задан SourceFrameTime
- SnapRate (FFrameRate) — целевая частота кадров, к которой нужно привязать время
Выходы (данные):
- ReturnValue (FFrameTime) — привязанное время кадра, кратное SnapRate
Когда используется
- Приведение временных меток с одной частоты кадров к другой (например, с 30 FPS к 24 FPS).
- Выравнивание таймингов в системе суб-кадров для устранения дрожания (judder) при воспроизведении.
- Подготовка данных для захвата или экспорта с фиксированным фреймрейтом.
Типичные проблемы
- Перепутаны SourceRate и SnapRate — если поменять местами, результат будет неверным, так как функция рассчитывает ближайшее кратное относительно SnapRate.
- Игнорирование суб-кадров — SourceFrameTime может содержать дробную часть (суб-кадр); SnapFrameTimeToRate корректно округляет до ближайшего кадра SnapRate, но если ожидается только целая часть — нужно дополнительно вызывать
GetFrameилиRoundToFrame. - Несоответствие допустимых значений — обе частоты должны быть ненулевыми и физически осмысленными; передача нулевого знаменателя вызовет краш или ошибку asserts.