You are here: User Guide > Nuke > Working with Color > Histogram

Histogram

The Scope > Histogram provides three color channel and luma channel information that describes the distribution of red, green, blue, and luma pixels throughout the current frame.

The Histogram graphs the number of pixels at each brightness level, and from left to right, the areas of the Histogram represent shadow, mid tones, and highlights.

There are also Viewer and Channel selection controls on the Histogram tab:

Viewer selection - if you have multiple Viewers open, use the dropdown menu to associate Histogram output to the required Viewer.

The default value, Current Viewer, automatically displays details on the last Viewer you selected.

Channel selection - select the channels to output. The default setting displays RGB, but you can also view channels separately.

Mode selection - select the mode to output. The default setting displays ganged RGB, but you can also view the channels separately by checking Parade.

The scopes feature global customizable guides to help you view data. Navigate to Preferences > Scopes and enter values between 0 and 1 for Blackpoint and Whitepoint.

The guides at the edges of the Histogram turn red to warn you when the distribution is out of range:

Using the Histogram Node

The properties panel for the Histogram node includes a window that graphs the number of pixels at each brightness level. This is a useful gauge to see whether an image has a good distribution of shadows, midtones, and highlights.

The histogram maps the distribution

of shadows, midtones, and highlights.

To Define Tonal Range with the Histogram Node

1.   Click Color > Histogram to insert a Histogram node at the appropriate place in your script.
2.   Connect a Viewer to the output of the Histogram node so you can see the effect of your changes.
3.   Drag the leftmost input range slider till it roughly lines up with the initial boundary of the histogram.
4.   Drag the rightmost input range slider till it roughly lines up with the final boundary of the histogram.
5.   Drag the middle input range slider to define the midtone, or neutral, value.