Last updated 2026-06-29 15:18

vf/scale

1. Сводка

Меняет размеры видео до целевых. Масштабирует кадры вверх или вниз до выбранной ширины и высоты перед тем, как они дойдут до кодера, и при необходимости нормализует соотношение сторон пикселя, чтобы отображаемые пиксели были квадратными.

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

• Готовите копию 1080p, 720p или SD из мастера более высокого разрешения.
• Собираете лестницу ABR, где каждая ступень — другое масштабированное разрешение, идущее в один кодер.
• Понижаете разрешение UHD-источника, чтобы питать HD-кодер, не принимающий исходное разрешение.
• Подгоняете под спецификацию доставки, требующую фиксированный размер кадра независимо от источника.

3. Входы

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

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

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

4. Выходы

• Video — filtergraph.VideoTransform. Видео с изменённым размером, пригодное для дальнейшей фильтрации или для видеокодера.

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

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

Форма «Настройки» — один столбец с двумя полями. Описаны в порядке следования в форме.

• Node Label (string, по умолчанию пусто)

  Произвольное имя, отображаемое на плитке узла на холсте.

  • Что задаёт. Подпись над плиткой; на масштабирование не влияет.
  • Когда менять. Задавайте, когда в одном графе несколько узлов scale — например, ступени лестницы ABR, где каждая копия — другое разрешение, — чтобы каждый был узнаваем с одного взгляда.

• Resolution (string WIDTHxHEIGHT, без значения по умолчанию)

  Целевой размер кадра.

  • Что задаёт. Ширину и высоту масштабированного кадра в пикселях. Соотношение сторон, подразумеваемое этими значениями, перекрывает входящее соотношение, поэтому кадр растягивается или сжимается под размер, если геометрия выше по потоку уже не совпадает.
  • Когда менять. Выбирайте разрешение, которого требует поставка: 1920x1080 — для HD, 1280x720 — для 720p, 640x360 — для небольшого веб-прокси, 3840x2160 — для UHD. Для лестниц ABR используйте по одному узлу scale на ступень.
  • Обязательно. да.

• Sample Aspect Ratio (SAR) (boolean, по умолчанию выкл.)

  Нормализовать соотношение сторон пикселя к 1:1.

  • Что задаёт. Переписывает ли масштабатор метаданные SAR так, чтобы один исходный пиксель равнялся одному пикселю отображения. С выключенным переключателем SAR из входа сохраняется.
  • Когда менять. Включайте, когда у источника анаморфные пиксели (типично для старых вещательных форматов SD), а поставка должна отображаться квадратными пикселями — без этого плеер растянет кадр по исходному SAR, даже если вы уже отмасштабировали до целевого размера растра.

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

JSON-ключ	Название поля
resolution	Resolution
sarnorm	Sample Aspect Ratio (SAR)

6. Пример

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

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

• Three-tier MP4 ladder (LQ / MQ / HQ) — три экземпляра Scale на 448×252, 640×360 и 1920×1080 дают растры LQ / MQ / HQ лестницы распространения.
• XDCAM HD broadcast mezzanine — масштабирует мастер до 1920x1080 перед кодером XDCAM HD 4:2:2 для вещательно-совместимого мезонина MXF.
• MPEG-TS broadcast pre-encode — масштабирует мастер до 1920x1080 перед x264 для вещательного транспортного потока 1080p25.
• Content-aware preview proxy ladder — меняет размер каждой ветви до прокси-растра её корзины (640x480, 640x360 или 1280x720) перед кодированием H.264.
• MP4 with branded logo overlay — масштабирует леттербоксный мастер до 1920x1080 перед наложением логотипа и кодером x264.
• AVC-Intra MXF broadcast mezzanine — масштабирует леттербоксный мастер до 1920x1080 перед кодером AVC-Intra 100 на каждой ветви MXF.
• HEVC archive — масштабирует мастер до 1024x576 перед кодером HEVC.
• H.264 HD — масштабирует мастер до 1280x720 перед кодером H.264.

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

• Масштабирование без согласования соотношения сторон. Выбор целевого разрешения, чьё соотношение сторон отличается от источника — например 1280x720 из 4:3-источника, — растягивает картинку. Добавьте vf/letterbox или vf/crop перед этим узлом, чтобы дойти до целевого растра чисто.
• Повышающее масштабирование сверх разрешения источника. Масштабирование меньшего мастера до большего растра не добавляет деталей; оно раздувает размер файла и обнажает артефакты сжатия источника.
• Забытый SAR на анаморфных источниках. Масштабирование анаморфного источника до квадратного растра без включения Sample Aspect Ratio (SAR) оставляет плееру применять исходный неквадратный SAR к новому кадру — что даёт растянутое изображение.