## Limiter

`Limiter` (clip, int "min_luma", int "max_luma", int "min_chroma", int "max_chroma", string "show")

Этот фильтр появился в версии v2.5. Стандарт, который называется CCIR-601, определяет диапазон значений пикселов, допустимый для отображения на телеэкране. Этот диапазон составляет 16-235 для яркостной компоненты и 16-240 для цветности.

Значения вне данного диапазона могут неправильно отображаться на некоторых телевизорах, и неплохо было бы исключить их перед кодированием, конечно если планируется просматривать видео именно на телевизоре. По умолчанию этот фильтр обрезает (выравнивает) значения пикселов, меньшие 16 до значения 16, а большие 235 (или 240 для цвета) до 235 (соотв. 240).

До версии v2.53 значение по умолчанию было неправильным и составляло 236 (а не 235). В этих версиях необходимо использовать Limiter(16, 235, 16, 240) для получения сигнала, соответствующего стандарту CCIR-601.

В версии 2.56, добавлен необязательный параметр show. Если он задан, то пикселы со значениями вне указанного диапазона [min_luma,max_luma] или [min_chroma,max_chroma] будут выделены цветом.

Параметр show может иметь значения "luma" (показывает пикселы с яркостью вне диапазона как красные/зеленые), "luma_grey" (показывает пикселы с яркостью вне диапазона и делает все остальные пикселы серыми), "chroma" (окрашивает все пикселы с цветностью вне диапазона в желтый), "chroma_grey" (показывает все пикселы с цветностью вне диапазона и делает все остальные пикселы серыми). Окраска пикселов происходит следующим образом:

YUY2 (цветность считается общей для двух горизонтально расположенных пикселей p1 и p2: Y1UY2V):

YV12 (цветность считается общей для квадрата 2x2 Y11uY12v;/Y21uY22v)
Цвета пикселов определяются следующей таблицей:

j,k=1,2 или j,k=11,12,21,22 | luma | luma_grey
--- | --- | ---
Yj < min_luma | pj - красный | pj - красный
Yj > max_luma | pj - зеленый | pj - зеленый
Yj < min_luma and Yk > max_luma | все p - желтый | pj - хаки, pk - оливковый
| chroma | chroma_grey
U < min_chroma | желтый | желтый
U > max_chroma | желтый | синий
V < min_chroma | желтый | голубой
V > max_chroma | желтый | красный
U < min_chroma and V < min_chroma | желтый | зеленый
U > max_chroma and V < min_chroma | желтый | цвет морской волны
U < min_chroma and V > max_chroma | желтый | оранжевый
U > max_chroma and V > max_chroma | желтый | вишневый

Changelog:

v2.56 | добавлен параметр show чтобы можно было просмотреть пикселы, для которых яркость/цветность лежат вне установленных пределов

`$English Date: 2005/01/26 22:08:35 $
Русский перевод 25.05.2005 Alexander Nickolsky (anickol@yahoo.com)`