## Histogram

`Histogram` (clip, string ''mode'')

Přidává histogram jasu na pravou stranu klipu.

Od AviSynthu v2.50 tento filtr také zobrazí platné a neplatné barvy v YUV režimech. Neplatné hodnoty (pod 16 a nad 235) budou vybarveny do hněda/žluta.

Od v2.53:Byl přidán volitelný parametr mode pro zobrazení doplňujících informací o klipu. mode může být "Classic" (výchozí, klasický starý režim), "Levels" - úrovně, "Color" - barva, "Luma" - jas (v2.54), "Stereo"(v2.54), "Stereooverlay"(v2.54), "Color2" (v2.58) a "Audiolevels" (v2.58).

### Klasický režim "Classic"

Po řádcích přidává graf jasu (nazývaný Waveform Monitor) na pravou stranu videa. Levá strana grafu reprezentuje jas-luma = 0 a pravá strana reprezentuje jas-luma = 255. Neplatné rozsahy podle CCIR-601 jsou jsou zabarveny do hněda/žluta, a zelenkavá čára reprezentuje Y = 128.
Dostupné v YUV režimech.

### Režim úrovně "Levels"

Tento režim zobrazí tři grafy úrovní na pravé straně video snímku (které jsou nazývány Histogramy). Zobrazí rozdělení komponent Y, U a V komponent v aktuálním snímku.

Horní graf zobrazuje rozdělení jasu (Y) ve snímku, kde levá strana reprezentuje Y = 0 a pravá strana reprezentuje Y = 255. Platný rozsah CCIR601 bude zobrazen mírně odlišnou barvou a Y = 128 bude označen čárkovanou čárou. Svislé osy zobrazují počet pixelů pro danou hodnotu jasu (Y) . Střední graf zobrazí komponentu U, a spodní graf zobrazí komponentu V.

Dostupný v YV12 režimu.

### Režim barva "Color"

Tento režim zobrazí hodnoty barevnosti (U/V rozmístění barev) ve dvourozměrném grafu (který se nazývá Vectorscope) na pravé straně video snímku. Může být použit ke čtení odstínu a sytosti klipu. Současně je to histogram. Čím bělejší je pixel ve vectorescopu, tím více pixelů vstupního klipu odpovídá takovému pixelu (to je, že více pixelů má tuto barevnou hodnotu).

Komponenta U je zobrazena na vodorovné ose (osa X), na levém kraji je U = 0 a na pravém kraji je U = 255. Komponenta V je zobrazena na svislé ose (osa Y), nahoře je V = 0 a dole je V = 255.

Pozice bílého pixelu v grafu odpovídá barevné hodnotě pixelu vstupního klipu. Tento graf může být tedy použit pro čtení odstínu (nádechu barvy) a sytosti (převaha odstínu v barvě). Jak se mění odstín barvy, pohybuje se kolem čtverce. Ve středu čtverce, je sytost nula, což znamená, že odpovídající pixel nemá žádnou barvu. Pokud zvětšujete množství dané barvy, zatímco jiné barvy necháte nezměněné, sytost se zvětší, a posouvá se směrem ke kraji čtverce.

Dostupný v YV12 režimu.

### Režim barva2 "Color2"

Tento režim zobrazí pixely ve dvourozměrném grafu (který se nazývá vectorscope) na pravé straně videosnímku. Může být použit ke čtení odstínu a sytosti klipu.

Komponenta U je zobrazena na horizontální ose (X) , na levé straně je U = 0 a na pravé straně je U = 255. Komponenta V je zobrazena na vertikální (Y) ose, nahoře je V = 0 a dole je V = 255. Šedý čtverec ukazuje na platný rozsah CCIR601.

Pozice pixelu v grafu odpovídá hodnotě barevnosti pixelu vstupního klipu. Tento graf může být tedy použit pro čtení odstínu (nádechu barvy) a sytosti (převaha odstínu v barvě). Jak se mění odstín barvy, pohybuje se kolem kruhu. Ve středu kruhu je sytost nula, což znamená, že odpovídající pixel nemá žádnou barvu. Pokud zvětšujete množství dané barvy, zatímco jiné barvy necháte nezměněné, sytost se zvětší, a posouvá se směrem ke kraji kruhu. Je zde zanesena barevná kružnice rozdělená na šest odstínů (červená, žlutá, zelená, tyrkysová, modrá a purpurová) aby vám pomohli číst hodnoty odstínů. Také jsou na ni vyneseny bílé body po 15 stupních.

Při U=255, V= 128 je odstín nulový (což odpovídá modré) a sytost je maximální, to je, sqrt( (U-128)^2 + (V-128)^2 ) = 127. Při otočení bílých hodin (clock-wise), řekněme o 90 stupňů, je barevnost dána U=128, V= 255 (což odpovídá červené). Při udržování konstantního odstínu a snižování sytosti, se rozumí, že se pohybujeme z kruhu do středu vectorscopu. Proto se nádech barvy nemění (a sice červená), pouze se pomalu mění do černobílé. atd ...

Dostupný v YV12 režimu.

### Režim jas "Luma"

Tento režim zesílí jasovou složku, a zobrazí velmi malé rozdíly jasu. To je dobré pro detekci bloků a šumu, a může pomoci k nastavení parametrů filtru. V tomto režimu bude hodnota rozdílu jasu 1 daného pixelu zobrazena jako 16, a tak výrazně zvětší malé defekty.

Dostupný v YV12 režimu.

### Režimy Stereo a StereoOverlay

Tento režim zobrazí klasický stereo graf audio klipu. Někteří ho mohou znát z nahrávacích studií. Může být užitečný pro prohlédnutí rozdělení na levé-pravé a rozdělení fáze vstupního signálu. StereoOverlay bude překrývat graf navrchu originálu. Každý snímek bude obsahovat pouze informaci z aktuálního snímku do začátku dalšího snímku. Signál je lineárně převzorkován (zvýšení počtu vzorků) 8x, aby byla čistší vizualizace.

Tento režim vyžaduje vstupní stereo signál a StereoOverlay vyžaduje YV12 video.

### Režim AudioLevels

Tento režim zobrazuje hlasitosti audia pro každý kanál v decibelech (je podporováno více kanálů). Přesněji je zde určeno:

- kořenová střední kvadratická hodnota vzorků příslušející každému snímku a převádí tuto hodnotu na decibely použitím následujícího vztahu:
  RMS = 20 * log_10( sqrt( sum_j( sample(j)^2 ) / j ) / 32768 ) # pro každý kanál
- maximální hlasitost vzorků příslušejících každému snímku a převádí ji na hodnotu v decibelech použitím následujícího vztahu:
  max = 20 * log_10( max_j( sample(j) ) / 32768 ) # pro každý kanál
  Sloupce odpovídající kořenové střední kvadratické hodnotě jsou zelené, a pro maxima jsou modré. Filtr je dostupný v planárním režimu a audio je převedeno na 16 bit. Všimněte si, že pro 16 bit audio, by mohla být maximální hlasitost
  20 * log_10(32768/32768) = 0 dB (protože 2^16/2 = 32768)
  a minimální hlasitost
  20 * log_10(1/32768) = - 90.31 dB

Změny:

v2.53 | Přidány různé režimy.
v2.55 | Přidány body k režimu = "stereo" pro zobrazení sklonu/posunu.
v2.56 | Přidány neplatné barvy v režimu YUY2.
v2.58 | Přidány režimy Color2 a AudioLevels.
v2.60 | Přidána planární podpora.

`$English Date: 2007/09/12 07:54:58 $`

`Český překlad:12.2.2009`