nlve/IMPLEMENTATION_PLAN.md
chaiman c19e517979 Этап 2: кадрирование на клипе с перетаскиваемой рамкой
Настройка кадрирования переехала с файла на клип: два куска одного файла
бывает нужно кадрировать по-разному. У файла осталась такая же, но лишь
как заготовка — её берёт новый клип при добавлении. Проекты, записанные
раньше, читаются: клип без своей настройки берёт её у файла.

Открывается кнопкой в правом нижнем видимом углу клипа. Именно видимом:
у клипа длиной в час настоящий угол почти всегда за краем экрана — та же
задача, что уже решена для ручки громкости.

В окне слева появился кадр источника с рамкой, которую тянут мышью за
середину и за правый нижний угол. Рамка держит пропорции кадра проекта и
пересчитывается в увеличение и смещение; ползунки и рамка следуют друг за
другом.

Кусок пересобирается теперь не только когда файл не совпадает с проектом,
но и когда у клипа своё кадрирование.

Проверено сборкой: первый кусок без кадрирования скопирован, второй с
увеличением вдвое пересобран через scale=1280:720,crop=640:360:384:180.
154 пакета вошло, 154 вышло, декодирование без ошибок.

Заодно: правый щелчок по списку файлов теперь выделяет файл под курсором.
Без этого меню без выделения отключалось целиком и выглядело так, будто
его нет. Цвет формы звука сменён на пастельно-жёлтый.
2026-08-19 23:10:08 +03:00

11 KiB
Raw Blame History

План: аудиодорожки, связки, наложение

Решения, принятые до начала работ

Четыре развилки, от которых зависит всё остальное.

Звук при раздельном аудио — всегда перекодируется. Как только звук можно двигать отдельно от видео, точки реза перестают совпадать, а резать звук копированием получается только по границам звуковых кадров — шаг около 21 мс. На стыках это слышно щелчками и уводит синхронность. Час звука кодируется секунды, а видео при этом по-прежнему копируется, то есть тяжёлая часть не страдает.

Кроссфейд возникает сам только в пределах одной дорожки. Перекрытие клипов на разных дорожках — это не кроссфейд, а наложение. Если считать кроссфейдом любое перекрытие, нынешние проекты, где клипы на V1, V2 и V4 перекрываются постоянно, разом станут перекодируемыми.

При перекрытии разных дорожек верхний клип побеждает целиком. Это несущее решение всего редактора: именно оно позволяет собирать ролик копированием. Прозрачность становится осознанным исключением на отдельном клипе, и программа предупреждает, сколько секунд придётся пересобрать.

Кадрирование переезжает на клип, у файла остаётся заготовка. Новый клип берёт настройку файла при добавлении и дальше правится сам по себе. Два куска одного файла можно кадрировать по-разному.

Что здесь несущее

Сборка ролика — это копирование. Всё, что смешивает пиксели или звук, копированием не собирается.

Механизм «пересобрать только этот кусок, остальное скопировать» уже написан — для чужих файлов и точных резов. У куска монтажа есть признак «нельзя скопировать» и готовая цепочка фильтров. Прозрачность и кроссфейды ложатся в него как ещё один повод, а не как новая архитектура.

Настоящая новая работа — в другом месте: раздельное аудио меняет не сборку, а нарезку. Видео и звук перестают резаться в одних точках, и сборка начинает делать два потока с последующим сшиванием.

Этап 1. Осциллограмма звука

Цель. На клипе видна форма звука.

Критерий готовности. Пики считаются один раз на файл и запоминаются в кэше проекта рядом с индексом опорных кадров. Отрисовка не замедляет перетаскивание клипов.

Отдельно — визуальное усиление по Shift+вверх и Shift+вниз. Звук бывает тихим, и угадывать за пользователя, во сколько раз растянуть картинку, неправильно: в Вегасе это отдано ему двумя сочетаниями клавиш. Усиление меняет только рисунок, самого звука не касается, и запоминается между запусками.

Проверка. Осциллограмма совпадает с тишиной и громкими местами в файле. На тихой записи усиление по Shift+вверх делает видимой границу между тишиной и звуком.

Про скорость первоначальный критерий был занижен: я написал «меньше двух секунд», не подумав, откуда берутся данные. Чтобы разобрать звук, ffmpeg читает файл целиком, а это 6.3 ГБ. Замер: 12.7 с, то есть около 500 МБ/с — скорость чтения с диска, быстрее не выйдет. Работа идёт в фоне и окно не держит, а повторное открытие берёт готовые пики из кэша.

Состояние. Готов.

Проверено: файл «4 с тона, 4 с тишины, 4 с тона» даёт форму в первой и последней трети и пустоту посередине. Пики для файла на 892 с — 89 208 значений, 89 КБ на диске. Полная амплитуда даёт 254 из 255, тишина ноль. Shift вверх и вниз меняют высоту, значение сохраняется между запусками.

Этап 2. Кадрирование на клипе

Цель. У каждого клипа своё кадрирование, редактор открывается кнопкой с самого клипа.

Критерий готовности. Настройка хранится у клипа; при добавлении берётся у файла. Кнопка в правом нижнем видимом углу клипа — как ручка громкости, она держится видимой части, а не середины. В окне редактора рамку можно тянуть мышью, а не только задавать числами.

Проверка. Два куска одного файла с разным кадрированием собираются в один ролик, каждый со своим. Кнопка доступна на клипе длиной в час, прокрученном до середины.

Состояние. Готов.

Проверено сборкой: первый кусок без кадрирования скопирован, второй с увеличением вдвое пересобран через scale=1280:720,crop=640:360:384:180. 154 пакета вошло, 154 вышло, полное декодирование без ошибок.

Рамка проверена мышью: потянул угол — увеличение стало 162%, смещение −31%, и результат справа показал ровно обрезанную часть.

Этап 3. Виды дорожек и связки

Цель. Звук живёт на своих дорожках и по умолчанию связан с видео.

Критерий готовности. У дорожки есть вид, у клипа — принадлежность к связке. Добавление файла заводит пару «видео плюс звук». Перемещение, рез, удаление и схлопывание работают со связкой целиком, в том числе когда в ней два видео одно над другим. Ctrl+G связывает и развязывает.

Проверка. Рез по курсору режет всю связку в одной точке. Удаление клипа удаляет связку. Развязанный клип двигается один.

Состояние. Не начат.

Этап 4. Раздельное аудио

Цель. Звук можно двигать и слушать отдельно от своего видео.

Критерий готовности. Уплощение делается дважды — отдельно для картинки и для звука. Сборка делает поток видео копированием и поток звука перекодированием, затем сшивает их. Предпросмотр показывает картинку и звук из разных мест монтажа.

Проверка. Звук из дыры воспроизводится под чужой картинкой. Собранный ролик: число кадров видео совпадает с ожидаемым, звук не разъезжается с картинкой на всей длине.

Риск снят замером. mpv принимает edl:// как внешнюю звуковую дорожку и берёт звук именно из неё. Проверено так: картинке дали список «тишина, потом тон», звуку — обратный «тон, потом тишина». На выходе первые пять секунд дали -21 dB, вторые -91 dB, то есть звук пришёл из своего списка, а не из картинки.

Состояние. Не начат.

Этап 5. Прозрачность и кроссфейды

Цель. Клип может быть полупрозрачным, а перекрытие на одной дорожке — переходом.

Критерий готовности. Ползунок на видеоклипе задаёт прозрачность, на звуковом — громкость. Уплощение выдаёт для перекрытий стопку клипов, а не одного победителя. Перед сборкой программа сообщает, сколько секунд придётся пересобрать. Ручной переход можно задать и там, где ничего не перекрывается.

Проверка. Ролик с одним полупрозрачным клипом: пересобран только этот участок, остальное скопировано без потерь. Кроссфейд на одной дорожке даёт плавный переход, число кадров сходится.

Состояние. Не начат.

Порядок нельзя менять

Этапы 3 и 4 связаны жёстко: связки без раздельных дорожек бессмысленны, а раздельное аудио без связок неуправляемо. Этап 5 опирается на оба: до него у клипа нет разделения на «громкость» и «прозрачность».

Этапы 1 и 2 ни от чего не зависят и делаются в любой момент.