Last updated 2026-06-29 15:18

vf/fps

1. Сводка

Приводит частоту кадров на выходе. Дублирует или отбрасывает кадры, чтобы поток покидал фильтр на постоянном целевом ритме, совпадающем с профилем кодера или спецификацией поставки.

2. Когда использовать

• Фиксируете источник с переменной частотой кадров на постоянной частоте перед кодированием для HLS, DASH или вещательного мультиплекса.
• Готовите поставки 25/1 PAL или 30000/1001 NTSC из мастера 24p, 50p или 60p.
• Выравниваете ветвь графики или наложения с ритмом основного видео перед композитом.
• Предварительно приводите к профилю, требующему фиксированную частоту (AVC-Intra 100 = 25/30000/1001, XDCAM HD = 25 или 30000/1001, DV PAL = 25).

3. Входы

• Video — filtergraph.VideoTransform. Видеопоток, чью частоту кадров вы хотите задать. Обязателен.

  Совместимые узлы выше по потоку:

  • vf/crop — обрезает кадр до интересующей области.
  • vf/dar — задаёт метаданные соотношения сторон при отображении.
  • vf/deinterlace — убирает артефакты чересстрочности.
  • vf/fieldorder — меняет или задаёт флаг порядка полей.
  • vf/format — преобразует пиксельный формат или цветовые свойства.
  • vf/hwupload — загружает кадры в GPU для аппаратной обработки.
  • vf/letterbox — дополняет кадр до целевого растра.
  • vf/overlay — накладывает графику на видео.
  • vf/scale — масштабирует видео до заданных размеров.
  • map/video — выбирает видеопоток для выхода.

4. Выходы

• Video — filtergraph.VideoTransform. Видео на выбранной постоянной частоте кадров.

  Совместимые узлы ниже по потоку:

  • vf/crop — обрезает кадр до интересующей области.
  • vf/dar — задаёт метаданные соотношения сторон при отображении.
  • vf/deinterlace — убирает артефакты чересстрочности.
  • vf/fieldorder — меняет или задаёт флаг порядка полей.
  • vf/format — преобразует пиксельный формат или цветовые свойства.
  • vf/hwupload — загружает кадры в GPU для аппаратной обработки.
  • vf/letterbox — дополняет кадр до целевого растра.
  • vf/overlay — накладывает графику на видео.
  • vf/scale — масштабирует видео до заданных размеров.
  • avcintra — кодирует видео профилями AVC-Intra.
  • dv — пишет выход как файл/контейнер DV.
  • ni264 — использует аппаратно-ускоренное кодирование H.264.
  • prores — кодирует видео в профили Apple ProRes.
  • qsv264 — кодирует H.264 через Intel Quick Sync Video.
  • x264 — программно кодирует видео H.264/AVC.
  • x265 — программно кодирует видео H.265/HEVC.
  • xdcam — кодирует XDCAM HD MXF для вещательной доставки.

5. Параметры

Форма «Настройки» — один столбец с одним полем.

• Frame Rate (string отношение num/den, без значения по умолчанию)

  Целевая частота кадров, выраженная целочисленным отношением.

  • Что задаёт. Частоту кадров на выходе, которую принудительно ставит фильтр. Кадры дублируются при повышении частоты и отбрасываются при понижении; фильтр не интерполирует. Используйте отношения (не десятичные дроби), чтобы сохранить вещательную точность: 30000/1001 для NTSC 29,97, 24000/1001 для киноритма 23,976.
  • Когда менять. Задавайте для каждой поставки, которой нужна постоянная частота кадров: 25/1 — для PAL, 30000/1001 — для NTSC, 24/1 — для кино, 50/1 или 60000/1001 — для прогрессива высокой частоты. Сопоставляйте значение с профилем кодера ниже по потоку.
  • Обязательно. да.

Соответствие JSON-ключей и названий полей

JSON-ключ	Название поля
fps	Frame Rate

6. Пример

Полный разбор — переменные, настройка каждого узла и ожидаемый результат — смотрите в H.264 HD.

7. Где используется

• H.264 HD — приводит частоту кадров к 25/1 перед кодером H.264.
• HEVC — задаёт частоту кадров перед кодированием HEVC.
• AVC-Intra MXF broadcast mezzanine — принудительно ставит постоянную частоту кадров на каждой ветви AVC-Intra для вещательной совместимости.
• MP4 with branded logo overlay — приводит частоту кадров источника перед композитом наложения.
• Content-aware preview proxy ladder — задаёт частоту кадров прокси на каждой ветви лестницы.
• MPEG-TS broadcast pre-encode — фиксирует частоту кадров на 25/1 перед кодированием H.264 в транспортный поток.
• Cropped H.264 MP4 from interlaced source — задаёт прогрессивную частоту кадров на деинтерлейснутой ветви.
• XDCAM HD broadcast mezzanine — согласует ритм XDCAM HD перед кодером.
• Three-tier MP4 ladder (LQ / MQ / HQ) — фиксирует частоту кадров на каждой ступени лестницы LQ/MQ/HQ.

8. Антипаттерны

• Задание частоты кадров, удваивающей или уполовинивающей источник. Переход с 50p на 25p отбрасывает каждый второй кадр и теряет плавность движения; переход с 24p на 60p вставляет дубликаты, проявляющиеся как дёрганье. Выбирайте цель, чей исходный ритм — небольшое целое кратное, или ждите артефактов движения.

• Использование vf/fps для деинтерлейсинга. Уполовинивание 50i до 25p через vf/fps всё равно оставляет поток помеченным как чересстрочный. Берите vf/deinterlace, когда цель — прогрессивный выход.

• Задание десятичной частоты. Значения вроде 23.976 теряют точность и могут дрейфовать на длинных кодированиях. Всегда используйте целочисленные отношения, такие как 24000/1001.