Histogram

The histogram displays the distribution of pixel values across the image, providing a quantitative view of exposure, contrast, and color balance. It is one of the most commonly used scopes in color grading and quality control.

Opening the Histogram

Toggle the histogram panel from the QC toolbar or by assigning a custom shortcut in the Shortcut Editor. The histogram appears as a floating overlay on the viewer. Press Escape to close it.

Note: The H key is assigned to fit-to-height by default. To use H for the histogram, set a custom binding in the Shortcut Editor.

Display Modes

The histogram supports several display modes:

RGB Mode

Displays overlapping red, green, and blue histograms on the same graph. This mode reveals the relative distribution of each color channel and makes color casts immediately visible. For example, if the red histogram is shifted to the right compared to green and blue, the image has a warm (red) cast.

Luminance Mode

Displays a single white histogram representing the perceived brightness of each pixel, calculated using Rec.709 luminance coefficients (0.2126R + 0.7152G + 0.0722B). This mode is useful for evaluating overall exposure without regard to color.

Separate Channels

Displays each channel (R, G, B) as its own histogram, making it easier to analyze channels that overlap heavily in RGB mode.

Log Scale

The histogram offers a logarithmic scale option. In linear scale, very common values (such as a large sky area at similar brightness) dominate the display, making less common values nearly invisible. Log scale compresses the vertical axis so that both common and uncommon values are visible.

Reading the Histogram

The horizontal axis represents pixel value (0 on the left, 255 or 1.0 on the right). The vertical axis represents how many pixels have each value.

Shape	Interpretation
Peak on the left	Many dark pixels; possible underexposure
Peak on the right	Many bright pixels; possible overexposure
Spikes at edges	Clipped shadows (left) or highlights (right)
Narrow spread	Low contrast
Wide spread	Full tonal range
Even distribution	Well-exposed, high-contrast image

Clipping Indicators

The histogram displays clipping percentages at the boundaries:

• Left edge: Percentage of pixels at absolute black (crushed shadows)
• Right edge: Percentage of pixels at absolute white (blown highlights)

These percentages help identify images with irrecoverable data loss in the shadows or highlights.

Clipping Overlay

The clipping overlay visualizes clipped pixels directly on the viewer:

• Red overlay: Blown-out highlights (pixel values at maximum)
• Blue overlay: Crushed shadows (pixel values at zero)

This overlay makes it immediately obvious which parts of the image have clipped data.

Channel Isolation Integration

When a channel is isolated (e.g., Shift+R for red only), the histogram updates to reflect the isolated channel data. The histogram always shows the distribution of what is currently visible in the viewer.

GPU Acceleration

Pixel analysis (bin calculation) runs on the CPU, which also provides the clipping statistics. When WebGL is available, the histogram bars are rendered on the GPU for efficient drawing; otherwise the component falls back to CPU-based canvas rendering. The display renders at native resolution on Hi-DPI screens.

VFX Use Case

Before final delivery, use the histogram to verify that no unintentional clipping exists. Many delivery specs (e.g., Netflix, Amazon) require that blacks and whites stay within legal range. Spikes at either edge of the histogram indicate data loss that may cause rejection in QC. Check both the RGB and luminance modes to catch per-channel clipping that may not be visible in luminance alone.

Pipeline Note

When reviewing CG renders, a histogram that is bunched entirely to the left with no highlight information often indicates that the renderer output is in linear space but the viewer is not applying a proper display transform. Ensure the correct OCIO config or tone mapping operator is active before evaluating exposure.

Practical Tips

• Check the histogram before and after color corrections to verify the intended effect
• A well-graded image typically uses the full tonal range without clipping at either end
• Use the clipping overlay during exposure adjustments to avoid losing detail
• Compare the RGB histogram shapes to identify and correct color casts

---

Related Pages

• Waveform Monitor -- spatial luminance distribution
• Vectorscope -- color vector analysis
• Pixel Probe -- exact pixel value readout
• False Color and Zebra -- exposure visualization overlays