# Audion VS Engine Lite

[English](README_EN.md) · [Руководство](USER_GUIDE_RU.md)

**Содержание**

- [Зачем это сделано](#зачем-это-сделано)
- [Четыре палитры](#четыре-палитры)
- [Принцип](#принцип)
- [Издания](#издания)
- [Дальше](#дальше)
- [Техническая часть](#техническая-часть)
  - [Перед первым запуском](#перед-первым-запуском)
  - [FFmpeg и драйвер NVIDIA](#ffmpeg-и-драйвер-nvidia)
  - [Профили](#профили)

Техническая подготовка и стилизация видео на VapourSynth и FFmpeg. Двадцать два
пресета в четырёх независимых палитрах, без нейросетевого слоя.

## Зачем это сделано

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

Программа превращает это в набор готовых пресетов. Скрипт остаётся под капотом:
движок собирает цепочку `vspipe | ffmpeg` и запускает её.

## Четыре палитры

Они независимы: можно взять только техническую обработку и не трогать
стилизацию, и наоборот.

| палитра | пресетов | что делает |
|---|---|---|
| **Точность** | 8 | шумодав, включая прицельный по теням, устранение полос, контролируемый возврат микрозерна. Технический слой **до** колориста |
| **Плёнка** | 5 | эмуляции киноплёнки: 35 мм Kodak, 16 мм, Super 8, отбеливание, универсальный кинематографический |
| **Ретро** | 2 | аналоговый характер: VHS и ЭЛТ, любительская камера девяностых |
| **Восстановление** | 7 | то, чего нет в монтажных пакетах: устранение чересстрочности, обратная телекинопроекция, шумодав с компенсацией движения, устранение радуги и блочности, снятие дымки, плюс увеличение разрешения без нейросетей |

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

## Принцип

Движок — оркестратор на Python поверх `vspipe | ffmpeg`. Он не переписывает
VapourSynth и не прячет его: собранную команду видно, её можно взять и запустить
руками.

Запускающие файлы — обычные пакетные, с быстрым выбором и запасным меню, в
русской и английской версиях.

## Издания

| издание | пресетов | чем отличается |
|---|---|---|
| полное | 28 | со слоем нейросетей: увеличение разрешения, удвоение частоты кадров, нейросетевой шумодав |
| **Lite** | 22 | классические плагины VapourSynth, без нейросетей |

Это издание легче и не требует видеокарты: всё считается классическими
плагинами.

## Дальше

* [Руководство](USER_GUIDE_RU.md) — установка движка, первый запуск, палитры,
  профили, командная строка.

---

## Техническая часть

### Перед первым запуском

Движок VapourSynth и плагины ставятся отдельно — это делается один раз. Пока
этого нет, пресеты не запустятся.

### FFmpeg и драйвер NVIDIA

Каждая сборка FFmpeg собрана под конкретную версию заголовков аппаратного
кодирования и требует своего минимума драйвера. Самая свежая сборка на старом
драйвере не ускоряет, а ломает аппаратный путь: сборка подбирается по драйверу.

### Профили

Сохранённые сочетания пресетов и параметров — чтобы не собирать одну и ту же
цепочку заново.