Last updated 2026-06-29 15:18

vf/dar

1. Сводка

Задаёт флаг соотношения сторон при отображении (DAR) на видеопотоке без изменения размера пикселей. Кодер получает тот же растр, но плеерам сообщают отображать его в выбранном соотношении.

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

• Размечаете анаморфный SD-источник верным соотношением при отображении после того, как масштабатор дал квадратно-пиксельный растр.
• Принудительно ставите флаг 16:9 на потоке, чей исходный DAR был неверен или отсутствовал.
• Проносите нестандартное соотношение поставки (кинематографичное 21:9, квадратное 1:1 для соцсетей, 4:1 для бегущей строки) к кодеру.
• Наводите порядок после vf/crop, где окно обрезки изменило задуманное соотношение при отображении.

3. Входы

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

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

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

4. Выходы

• Video — filtergraph.VideoTransform. Те же пиксели, новый тег соотношения при отображении.

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

  • vf/crop — обрезает кадр до интересующей области.
  • vf/deinterlace — убирает артефакты чересстрочности.
  • vf/fieldorder — меняет или задаёт флаг порядка полей.
  • vf/format — преобразует пиксельный формат или цветовые свойства.
  • vf/fps — меняет частоту кадров на выходе.
  • 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. Параметры

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

• Aspect Ratio (enum, по умолчанию 16/9)

  Соотношение сторон при отображении, записываемое в сигнализацию битового потока.

  • Что задаёт. Флаг DAR, который плеер читает, чтобы выбрать способ отображения кадра. Пиксельные данные не меняются; переписываются только метаданные.
  • Когда менять. Выбирайте 16/9 для стандартной широкоэкранной доставки; 4/3 — для устаревшего SD-контента; 21/9 — для кинематографичного широкого экрана; 32/9 — для супер-ультрашироких дисплеев; 1/1 — для квадратных поставок соцсетей; 4/1 — для горизонтальной бегущей строки.
  • Допустимые значения. 4/3, 16/9, 21/9, 32/9, 1/1, 4/1.
  • Обязательно. да.

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

JSON-ключ	Название поля
aspect	Aspect Ratio

6. Пример

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

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

• H.264 HD — размечает изменённый по размеру кадр соотношением 16/9 при отображении перед кодером H.264.
• HEVC — задаёт соотношение при отображении на архивном кадре 1024x576 перед кодированием HEVC.
• Content-aware preview proxy ladder — задаёт соотношение при отображении для каждой SD- или HD-прокси-ветви перед масштабированием.
• MPEG-TS broadcast pre-encode — размечает вещательный кадр 1920x1080 соотношением 16/9 перед кодером H.264.
• XDCAM HD broadcast mezzanine — задаёт соотношение 16/9 при отображении на кадре XDCAM HD.
• Three-tier MP4 ladder (LQ / MQ / HQ) — размечает каждую ступень выбранным соотношением при отображении перед кодером H.264.

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

• Использование vf/dar для изменения размера картинки. Задание флага DAR не меняет пиксельный растр. Чтобы перейти от кадра 1920x1080 к 1280x720, используйте vf/scale; vf/dar только исправляет метаданные.

• Задание DAR, конфликтующего с растром. Разметка кадра 720x576 как 16/9 на плеере, уважающем DAR, растянет картинку с леттербоксом. Либо предварительно растяните узлом vf/scale, чтобы квадратно-пиксельное отображение совпало с тегом, либо пересмотрите DAR.

• Забытый vf/dar после анаморфного масштабирования. Когда vf/scale нормализует анаморфные пиксели, но флаг DAR в источнике всё ещё говорит 4:3, плеер игнорирует вашу работу. Ставьте vf/dar после масштабатора, чтобы поставить связный поток.