Get Current Frame Metrics
UserDefinedCaptureProtocolЧто это
Pure-функция, возвращающая метрики текущего захватываемого кадра для пользовательского протокола захвата (UserDefinedCaptureProtocol). Позволяет получить номер кадра, временные метки и другие параметры, определённые структурой FFrameMetrics. Не требует exec-пинов, так как не имеет побочных эффектов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (UserDefinedCaptureProtocol Object Reference) — экземпляр протокола захвата, для которого запрашиваются метрики.
Выходы (данные):
- Return Value (FFrameMetrics) — структура с метриками текущего кадра: номер кадра, длительность, время с начала захвата и т.д.
Когда используется
- В переопределённых методах
UserDefinedCaptureProtocol(например, вOnNewFrame), чтобы получить точные тайминги и номер кадра. - Для синхронизации внешних систем (субтитры, анимации) с захватываемыми кадрами.
Типичные проблемы
- Вызов вне активного захвата: если протокол не запущен (нет вызова
StartCapture), функция возвращает пустую структуру или нулевые значения. Всегда проверяйте статус захвата перед вызовом. - Путаница с кадровым номером: номер кадра начинается с 0 и увеличивается на каждом новом кадре — не путать с индексом в массивах, если они ведут счёт с 1.