Last updated 2026-06-29 15:18

prores

1. Сводка

Пишет мезонин-файл Apple ProRes. Даёт монтажный интра-only-мастер в один шаг — кодек и контейнер объединены, — покрывая семейство ProRes 422 и 4444, применяемое как де-факто промежуточный формат в постпродакшене, финишинге и вещательной контрибуции.

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

• Готовите монтажный интермедиат для финишинга в Final Cut, DaVinci Resolve, Avid Media Composer или другом NLE, считающем ProRes полноценным кодеком.
• Генерируете контрибуционный мастер вещания в ProRes 422 HQ или ProRes 4444, где спецификация поставки указывает семейство ProRes.
• Перекодируете long-GOP-камерный мастер в интра-only рабочую копию, у которой каждый кадр ключевой — что делает операции только подрезки и только приведения покадрово точными без GOP-декодирования.
• Архивируете высококачественную мастер-копию программы, которую ниже по потоку перекодируют многократно; ProRes переносит потери поколений гораздо лучше любого интер-кадрового кодека.

3. Входы

• Audio — []filtergraph.AudioTransform. Один или несколько аудиопотоков или цепочек фильтров.

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

  • af/aformat — приводит аудио к заданному формату сэмплов, раскладке каналов и частоте.
  • af/aresample — пересэмплирует аудио к частоте 48 кГц, которую ожидает семейство ProRes.
  • af/join — объединяет несколько моноаудиопотоков в один многоканальный.
  • af/stereo — фиксирует стереораскладку каналов.
  • map/audio — выбирает, какие аудиопотоки источника идут на кодер.

• Video — filtergraph.VideoTransform. Видеопоток или граф фильтров для кодирования.

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

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

• Timecode — *core.Timecode. Необязательный исходный таймкод для переноса в файл ProRes.

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

  • map/timecode — сохраняет или задаёт стартовый таймкод программы.

4. Выходы

• Package — core.Package. Упакованный файл ProRes (по соглашению QuickTime MOV), готовый к шагу загрузки.

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

  • analyze — инспектирует файл и извлекает метаданные медиа.
  • concat — склеивает несколько клипов в один выход.
  • upload — записывает пакет на целевой URL.

5. Параметры

Форма «Настройки» — один столбец с двумя полями. Профиль ProRes, субдискретизация цветности, поддержка альфа-канала и контейнер определяются платформой; формируйте поставку выше по потоку через vf/scale, vf/format, vf/fps и vf/fieldorder.

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

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

  • Что задаёт. Подпись над плиткой; на выход не влияет.
  • Когда менять. Задавайте, когда в одном графе несколько узлов prores — например, отдельные мастеры ProRes 1080p и 720p для одной программы, — чтобы каждый выход был узнаваем.

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

  Имя файла для пакета ProRes.

  • Что задаёт. Имя итогового объекта. Значение составляется с URL назначения загрузки в финальный путь объекта.
  • Когда менять. Задавайте фиксированное имя, когда назначение ожидает детерминированный ключ объекта (master.mov, programme_finish.mov), или ссылайтесь на переменную процесса, когда несколько узлов ProRes делят один процесс.

6. Пример

Полный разбор — переменные, настройка каждого узла и ожидаемый результат — смотрите в Adaptive streaming with HLS, DASH and captions.

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

• Adaptive streaming with HLS, DASH and captions — готовит промежуточный мастер ProRes параллельно с ветвями стриминга H.264 / HLS / DASH, давая высококачественную архивную копию той же программы.

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

• Целевой ProRes для стриминга или веб-доставки. ProRes — промежуточный кодек; его файлы на порядок крупнее эквивалентного потока H.264 или H.265. Для OTT, веба или прогрессивной загрузки кодируйте x264, x265, ni264 или qsv264.
• Перекодирование существующего мастера ProRes. Когда источник уже ProRes нужного тира, перекодирование через этот узел жжёт ЦПУ и рискует сдвинуть теги цветовой сигнализации. Используйте copy, когда менять нужно только контейнер или метаданные.
• Пропуск приведения порядка полей / пиксельного формата выше по потоку. Узел prores соблюдает порядок полей и пиксельный формат из цепочки фильтров выше по потоку; несовпадения дают файлы, которые воспроизводятся, но спотыкаются о контроль качества на принимающем объекте. Применяйте vf/fieldorder, vf/format и vf/scale выше по потоку, когда источник ещё не совпадает со спецификацией поставки.
• Пропуск приведения частоты дискретизации аудио. Поставки ProRes почти повсеместно ожидают аудио 48 кГц. Пронесите источник 44,1 кГц как есть — и принимающий NLE отметит несовпадение частоты дискретизации. Пересэмплируйте узлом af/aresample выше по потоку.

9. Заметки

Форма этого узла намеренно узка — тир кодека, субдискретизация цветности, поддержка альфа-канала, размер кадра и контейнер целиком определяются реализацией ProRes в среде выполнения. Формируйте видеохарактеристики поставки (разрешение, частота кадров, порядок полей, соотношение сторон пикселя, пиксельный формат) семейством фильтров vf/* выше по потоку; аудиохарактеристики (частота дискретизации, раскладка каналов, разрядность) — семейством af/*. Выход по соглашению — QuickTime MOV; NLE ниже по потоку определяют эссенцию ProRes и считают файл интермедиатом.