104 lines
4.2 KiB
Markdown
104 lines
4.2 KiB
Markdown
# FilmScanStabilizer
|
||
|
||
Этот скрипт выполняет стабилизацию оцифрованной кинопленки. Выравнивание выполняется на основе расчета смещения перфорации в каждом кадре.
|
||
|
||
```
|
||
СИНТАКСИС
|
||
|
||
filmstab [опции] файл
|
||
|
||
ОПИСАНИЕ
|
||
|
||
Запускает обработку подготовленной севенции. В результате обработки создает файл .jsx который при импортировании
|
||
в Adobe AfterEffects создает ключи сдвигающие кадый кадр секвенции для ее выравнивания.
|
||
При обработке скриптом, за эталон позиционирования берется самый первый кадр секвенции.
|
||
Скрипту указывается шаблон имени файлов секвенции.
|
||
Шаблон имени файлов секвенции указывается в формате синтаксиса printf (img_%05d.jpg, aa_%06d.exr)
|
||
|
||
|
||
-c файл
|
||
JSON файл конфигурации.
|
||
|
||
-k номер_начального_кадра
|
||
Порядковый номер кадра, с которого начнется обработка.
|
||
|
||
-r значение
|
||
Частота кадров секвенции. Значение по умолчанию: 24.
|
||
|
||
-l значение
|
||
Значение сдивга маркера слева, в px. Значение по умолчанию: 0.
|
||
|
||
-t значение
|
||
Значение сдивга маркера сверху, в px. Значение по умолчанию: 0.
|
||
|
||
-f
|
||
Принудительная перезапись существующего файла
|
||
|
||
ПРИМЕРЫ
|
||
|
||
filmstab -c conf/config_16mm_1p_1.json -k 151 -f tmp/sequence_%05d.jpg
|
||
|
||
```
|
||
|
||
## Описание файла конфигурации
|
||
|
||
###### пример файла конфигурации:
|
||
```
|
||
{
|
||
"export_filename": "ae_stabilize.jsx",
|
||
"factor": 1,
|
||
"render_scale": 0.2,
|
||
"line_size": 160,
|
||
"pixel_bri_gain": 128,
|
||
"markers": {
|
||
"vm": {
|
||
"size": 290,
|
||
"count": 4,
|
||
"offset": 50,
|
||
"lines": [
|
||
{
|
||
"top": 610,
|
||
"invert": true,
|
||
"grp_offset": [5, 4175]
|
||
},
|
||
{
|
||
"top": 2905,
|
||
"grp_offset": [30, 4175]
|
||
}
|
||
]
|
||
},
|
||
"hm": {
|
||
"size": 290,
|
||
"count": 4,
|
||
"offset": 50,
|
||
"lines": [
|
||
{
|
||
"left": 370,
|
||
"invert": true,
|
||
"grp_offset": [315, 3085]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
###### описание параметров:
|
||
|
||
* **export_filename:** имя файла. в который будут записаны ключи позиционирования секвенции
|
||
* **factor:** *(уточнить)*
|
||
* **render_scale:** значение масштабирования превью, относительно размера исходного кадра.
|
||
* **line_size:** длина линии маркера, в px
|
||
* **pixel_bri_gain:** значение яркости пикселя (0...255) по которому выполняется расчет изменения состояния
|
||
* **markers:** список настроек маркеров
|
||
* **vm:** настройки для групп вертикальных маркеров
|
||
* **hm:** настройки для групп горизонтальных мсаркеров
|
||
* **size:** длина линиий *(уточнить, как связано с line_size)*, в px
|
||
* **count:** количество линии в каждой группе
|
||
* **offset:** растояние между линиями в группе, в px
|
||
* **lines:** описание групп маркеров
|
||
* **top:** отступ сверху, в px
|
||
* **left:** отступ слева, а px
|
||
* **invert:** инвертирование значения состояния, используется для настройки противоположных маркеров
|
||
* **grp_offset:** сдвиг группы [?, ?], в px
|