## ColorYUV

`ColorYUV` (clip, float "gain_y", float "off_y", float "gamma_y", float "cont_y", float "gain_u", float "off_u", float "gamma_u", float "cont_u",
float "gain_v", float "off_v", float "gamma_v", float "cont_v", string "levels", string "opt",
boolean "showyuv", boolean "analyze", boolean "autowhite", boolean "autogain")

`ColorYUV` umožňuje řadu různých metod pro změnu barev a jasu Vašeho obrazu. `ColorYUV` je přítomen v AviSynth v2.5. Všechna nastavení tohoto filtru jsou volitelná. Všechny hodnoty jsou ve výchozím nastavení "0".

gain, off, gamma a cont mohou být nastaveny nezávisle na každém kanálu.

gain je násobič hodnoty, a rozšiřuje signál zdola nahoru (v poměru ke spodní hranici). Aby jsme vás trochu zmátli,nazýváme ve filtru Tweak toto nastavení jako contrast. To znamená, že je-li gain nastaven na 0, zachovávají se hodnoty takové jaké jsou. Když je gain 256 všechny hodnoty jsou násobeny 2 (dvakrát jasnější). Je-li gain 512 všechny hodnoty jsou násobeny 3. Tedy pokud je gain = k*256 pro nějaké celé číslo k pak jas Y dostane (k+1)*Y (analogicky pro barvy). I když je to možné, nemá smysl použít toto nastavení pro barevnost signálu.

off (offset, posun) přidá hodnotu jasovým (luma) nebo barevným (chroma) hodnotám. Offset nastavený na 16 přidá 16 k hodnotám pixelu. Offset rovný -32 odečte 32 z hodnot všech pixelů.

gamma přizpůsobí gamma daného kanálu. Hodnota gamma rovná 0 je odpovídá korekci gamma 1.0. Je-li gamma nastaveno na 256 odpovídá to korekci gamma 2.0. Hodnoty gamma mohou být do -256, kdy je korekce gamma 0.0.

cont (kontrast) je také násobič hodnoty, a rozšiřuje signál ven od středu. To znamená, že je-li nastaven kontrast na 0, zachovávají se hodnoty takové jaké jsou. je-li kontrast 256 všechny hodnoty jsou násobeny 2 (dvakrát jasnější). Je-li kontrast 512 všechny hodnoty jsou násobeny 3. Tedy pokud je cont = k*256 pro nějaké celé číslo k (a nulový gain) pak jas Y dostane Y + k*(Y-128) (analogicky pro barvy). I když je to možmé, nemá smysl použít toto nastavení pro jas signálu.

levels mohou být nastaveny buď "TV->PC" nebo "PC->TV". To provádí převod rozsahu. Normálně YUV hodnoty nejsou v rozsahu 0 až 255 (PC rozsah), ale v omezeném rozsahu (TV rozsah). Toto provede převod mezi těmito formáty. Pokud není zadán žádný parametr, žádný převod se neprovede (výchozí nastavení).

opt může být buď "coring" nebo "" (nic, výchozí nastavení). Zadání "coring" ohraničí YUV hodnoty do povoleného TV-rozsahu. Jinak budou "nepřípustné výsledky" akceptovány.

showYUV může být true nebo false. Přepíše výchozí zobrazení zobrazením, ukazujícím všechny barevné hodnoty ve dvou osách. To může být užitečné pokud potřebujete přizpůsobit barvy Vašeho obrazu, ale potřebujete vědět jak jsou barvy rozloženy. V levém horním rohu obrazu jsou hodnoty barevnosti U, V rovny '16'. Na pravé straně obrazu je U na svém maximu. Ve spodu obrazu je V na svém maximu. Uprostřed obou barevných kanálů je hodnota 128 (nebo šedé pole). Jas ve snímku 0 je roven 16, jas ve snímku 1 je roven 17 atd.

analyze může být true nebo false. Toto zobrazí na obrazovce statistiku barev. Jsou zde maximální hodnoty a minimální hodnoty všech kanálů. Jsou zde střední hodnoty všech kanálů. Je zde "loose maximum" a "loose minimum". "Loose" hodnoty extrémů filtrují (neberou v potaz) velmi jasné nebo velmi temné šumové pixely, které vytváří umělá nízká nebo vysoká minima/maxima.

autowhite (autorovnováha bílé) může být true nebo false. Toto nastavení použije informaci z analyzéru, a pokusí se vystředit barevné posuny. Pokud máte nahraný nějaký materiál, kde jsou barvy posunuty na stranu jedné barvy, tento filtr může pomoci. Ale buďte opatrní - není příliš inteligentní - pokud je váš materiál čistá modrá obloha, autowhite ji úplně předělá na šedou! Pokud přidáte "off_u" nebo "off_v" parametry současně s autowhite, nebudou použity!

autogain může být true nebo false. Toto nastavení použje informaci z analyzéru, a pokusí se vytvořit tak dobrý kontrast jak je jen možné. To znamená, mění jasové (y) hodnoty k dosažení minimálních a maximálních hodnot. Bude to pracovat jako režim "autozesílení" (autogain) na kamerách, který velmi zesiluje tmavé scény, zatímco nechává scény s dobrým kontrastem bez povšimnutí. V některých místech je toto zpracování také nazýváno "autoúrovně" (autolevels).

Hodnoty sytosti (sat), kontrastu (cont) a světlosti (bright) (jako například ve `Tweak` ) jsou spojeny s hodnotami v tomto filtru následujícími vztahy:

cont_u = cont_v = (sat-1) * 256
gain_y = (cont-1) * 256
off_y = bright

Sytost 0.8 dá například: cont_u = cont_v = - 0.2 * 256 = -51.2. Všimněte si, že ve Tweak jsou YUV hodnoty vždy ohraničeny do přípustného TV-rozsahu, ale zde pro to musíte zadat opt="coring".

    #  Toto upraví gamma pro všechny kanály (i když v menší míře než y), a zmenší 'y' .
    ColorYUV(gamma_y=128, gamma_u=256, gamma_v=256, off_y=-16)

    #  Ukáže všechny barvy. snímek 0 jas je 16, snímek 1 jas je 17 atd.
    ColorYUV(showyuv=true)

    #  Obnoví viditelnost velmi špatných nahrávek.
    ColorYUV(autogain=true, autowhite=true)

`$English Date: 2008/12/11 19:53:34 $`

`Český překlad: 12.2.2009`