» AviSynth is a powerful video FrameServer for Win32.

AviSynth Links:
»Learn to script
»Discussion fora
»Project page
»External filters

» You can add pages to this website immediately. No login required.
Edit this document

» AboutAviSynth




( Diese Seite in flag-germany.gif Deutsch )

Histogram (clip clip [, string mode])

Adds a luminance histogram to the right side of the clip.

Starting from AviSynth 2.5 this filter will also show valid and invalid colors in YV12/YUY2 mode. Invalid values (below 16 and above 235) will be colored brown/yellow-ish.

Starting in 2.53:

An optional mode parameter has been added to show additional information of a clip. Mode can be "classic" (default old mode), "levels", "color" and from v 2.54: "luma", "stereo", "stereooverlay".

Classic mode


This will add a per-line luminance graph on the right side of the video. the left side of the graph represents luma = 0 and the right side represents luma = 255. The valid CCIR601 ranges are shown in a slightly different color in YV12/YUY2 mode, and a greenish line represents Y = 128.

Available in YUY2 and YV12 mode.

Levels mode


This mode will display three level-graphs on the left side of the video frame. This will show the distribution of the Y, U and V components in the current frame.

The topmost graph displays the luma (Y) distribution of the frame, where the left side represents Y = 0 and the right side represents Y = 255. The valid CCIR601 range has been indicated by a slightly different color and Y = 128 has been marked with a dotted line.

The middle graph displays the U (chroma) component, and the bottom graph displays the V component.

Only available in YV12 mode.

Color mode


This mode will display the U/V color placement in a 2 dimentional graph on the left side of the video frame.

The U component is displayed on the horizontal (X) axis, with the leftmost side being U = 0 and the rightmost side being U = 255.

The V component is displayed on the vertical (Y) axis , with the top representing V = 0 and the bottom representing V = 255.

Only available in YV12 mode.

Luma mode


This mode will amplify luminance, and display very small luminance variations. This is good for detecting blocking and noise, and can be helpful at adjusting filter parameters. In this mode a 1 pixel luminance difference will show as a 16 pixel luminance pixel, thus seriously enhancing small flaws.

Available in YUY2 and YV12 mode.

Stereo and StereoOverlay mode


This mode shows a clasic stereo graph, from the audio in the clip. Some may know these from recording studios. This can be used to see the left-right and phase distribution of the input signal. StereoOverlay will overlay the graph on top of the original. Each frame will contain only information from the current frame to the beginning of the next frame. The signal is linearly upsampled 8x, to provide clearer visuals.

This mode requires a stereo signal input and StereoOverlay input is YV12 only.


v2.53 Added different modes.
v2.55 Added dots to mode = "stereo" to show bias/offsets.
v2.56 Added invalid colors in YUY2 mode.

SourceForge Logo


Edit this document | View document history
Document last modified Thu, 24 Mar 2005 16:46:22