Nle Handoff

---
name: nle-handoff
description: Передача монтажа из DaVinci Resolve в Premiere Pro и Avid Media Composer - сборка проекта Premiere (.prproj) из открытого проекта Resolve, сборка бина Avid (.avb) с мастерами, sync- и group-клипами и отдельного файла настроек проекта (.avp), проверка AAF и XML с вписыванием имён тейпов. Запускай на задачи экспорта для монтажёра, бин для Авида, проект для Премьера, AAF не открывается, проверить XML.
---

# Передача монтажа: Premiere, Avid, AAF/XML

Ни один из выходных файлов не открывался в целевой программе при написании: проверялись структура, ссылки и сверка с исходником. Скажи об этом получателю.

## Проект Premiere

```bash
PRPROJ_OUT=out.prproj PRPROJ_TEMPLATE=свой_проект.prproj [PRPROJ_TIMELINES="Монтаж A|Монтаж B"] \
  python -m core.adapters.resolve_run exec core/adapters/resolve_prproj_job.py
```

- Resolve читается только на чтение. Шаблон - любой реальный `.prproj`, сохранённый самым СТАРЫМ Premiere, в котором результат должен открыться (новый проект старый Premiere не откроет, старый новый откроет). Из шаблона берутся настройки проекта; содержимое отбрасывается.
- Переносится: корзины по папкам медиапула, медиа (видео, звук, видео+звук, моно/стерео, стоп-кадры), секвенции с дорожками, клипы (позиция, in/out, скорость), Motion (позиция, масштаб, поворот), связь видео и звука, скрытые видеодорожки и заглушённые звуковые, громкость клипа (читается из XML Resolve, пишется как Volume Level `10^((дБ-15)/20)`, выше +15 дБ обрезается).
- НЕ переносится и попадает в отчёт: грейд и эффекты Resolve (клип получает цветовую метку), ключи громкости, затухания, кроссфейды, переходы, маркеры, прозрачность, отражение, кроп, режимы наложения, составные клипы, титры без файла, одиночные выключенные клипы. Цвет метки клипа из Resolve не переносится.
- Статус дорожек (скрыта/заглушена) Resolve отдаёт только для открытого таймлайна. Для остальных все дорожки остаются включёнными, в отчёте предупреждение.
- Описание формата: `docs/prproj-format.md`.

## Бин Avid и настройки проекта

```bash
python -m core.avb_build takes.json day.avb --hdr headers.json \
  --project "Имя проекта" --avp-template их_проект.avp --settings-template их_проект_Settings.xml --preset hd-1080p24
```

- Нужно: `pip install pyavb`, PyAV, `takes.json` из `dailies-prep`, диск с MXF (заголовки читаются с него и кэшируются в `--hdr`). Дубли, чьих заголовков нет, пропускаются и перечислены в отчёте.
- В бине: звуковой мастер на дубль с колонками из заголовка MXF (Scene, Take, TapeID, TRKn...), камерные мастера, `...a.sync.01` (картинка камеры и все дорожки звука со сдвигом; если камера началась раньше звука, лишняя голова картинки обрезается), `...Grp.01` (селекторы по камерам и скрытая композиция).
- Бин - сам проект, `.avp` - его настройки, они отдельные файлы. `.avp` пишется правками на месте без смещения байтов: новый GUID, штамп времени и целочисленные параметры формата. Список бинов внутри `.avp` остаётся как в шаблоне (Avid покажет их как отсутствующие). Известен один пресет формата, `hd-1080p24`; другие частоты и размеры требуют образца такого проекта.
- Не сделано: вид бина (колонки, сортировка, шрифты), `_ORG_BIN`.
- Файл `.avp` для проверки разбирается `core.avp_build.read_attrs`.

## Проверка AAF и XML

```bash
python -m core.handoff_check aaf файл.aaf
python -m core.handoff_check name-tapes файл.aaf исправленный.aaf --hdr headers.json
python -m core.handoff_check xml файл.xml
```

- AAF: счёт объектов, частоты, дескрипторы, тейпы без имени, висячие ссылки, медиа на диске. Resolve пишет все тейпы с пустым именем; `name-tapes` вписывает имя ролика из заголовка MXF (или имя файла). Что именно пустые имена тейпов не пускают AAF в конкретный Avid, НЕ подтверждено: это проверка и лучшее исправление, а не гарантия. Если не открывается и после, нужен текст ошибки Avid и частота проекта Avid (AAF здесь целиком в 24 кадрах).
- XML: клипы, выключенные клипы (Resolve при импорте их пропускает), клипы с позицией `-1` у переходов, пути к файлам, повторные id.