# 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