> For the complete documentation index, see [llms.txt](https://docs.timeinpixels.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timeinpixels.com/nobe-omniscope/qc/hdr-limit.md).

# HDR Limit

Flag frames whose measured MaxCLL or MaxFALL exceeds a configured nit limit.

HDR Limit compares each frame's HDR Statistics values with the nit limits you specify. Use it to locate peak-level or frame-average excursions in OmniScope Pro.

For the complete setup and review workflow, see [HDR level checks](https://docs.timeinpixels.com/nobe-omniscope/qc/hdr-level-checks.md).

## Enable HDR Limit

1. Open **QC → QC Tools Panel (All Inputs)** and select the relevant input.
2. Enable **HDR Statistics** using its section power button or toggle. HDR Limit remains disabled until HDR Statistics is enabled.
3. Enable and expand **HDR Limit**.
4. Enable **Check MaxCLL**, **Check MaxFALL**, or both, and enter the limits from your delivery specification.

## Settings

| Control                         | Purpose                                                           |
| ------------------------------- | ----------------------------------------------------------------- |
| **Check MaxCLL**                | Flag a frame when its measured peak exceeds the MaxCLL limit.     |
| **MaxCLL Limit (nits)**         | Peak threshold, adjustable from 1 to 10,000 nits.                 |
| **Check MaxFALL**               | Flag a frame when its measured average exceeds the MaxFALL limit. |
| **MaxFALL Limit (nits)**        | Frame-average threshold, adjustable from 1 to 10,000 nits.        |
| **Show thresholds in timeline** | Display the enabled limits on the HDR track.                      |

Set **MaxCLL Limit (nits)** to the peak ceiling in your delivery specification, such as 600, 1000, 2000, or 4000 nits. These are example limits, not format presets. Only enable a MaxFALL limit when the delivery specification provides one. A mastering-display peak does not by itself define the permitted frame average.

## Measurement settings matter

HDR Limit uses the values calculated by [HDR Statistics](https://docs.timeinpixels.com/nobe-omniscope/qc/hdr-statistics-maxfall-and-maxcll.md):

* **Max RGB (legacy)** measures the brightest decoded RGB channel per pixel.
* **Real luminance (CIE Y)** measures luminance using the input color space.
* **Ignore brightest pixels** excludes a configurable bright tail from MaxCLL. Leave it off when checking for literal peak excursions unless the specification requires rejection. MaxFALL remains the frame average.

Match these settings when comparing with another QC tool. Confirm the input's transfer function, color space, and range first. Changing the limit does not alter the input signal or repair its metadata.

## Read and record results

1. Inspect **Current MaxFALL** and **Current MaxCLL** in the HDR Limit section. Enabled checks show their threshold and whether the current frame is within it.
2. Open the [QC Timeline](https://docs.timeinpixels.com/nobe-omniscope/qc/qc-timeline.md) and show the **HDR** track to review measurements over time.
3. To collect a timestamped event list, add the [Error Logger](https://docs.timeinpixels.com/nobe-omniscope/scopes/error-logger.md) and choose **Start Recording Errors** before playing the content. Excursions are recorded as **HDR MaxCLL Limit** or **HDR MaxFALL Limit** events, including measured and threshold values.
4. Complete a fresh full playback or file scan before reporting whole-content maxima. Reset accumulated statistics before a new comparison run.

The **Current** readings describe one frame. The **Global** readings in HDR Statistics hold the highest peak and highest frame average encountered since reset.

## Scope of the check

HDR Limit checks measured picture levels. It does not validate all HDR10, HDR10+, Dolby Vision, or platform delivery requirements, and it does not verify that embedded or sidecar metadata agrees with the picture. Use the external report's exact check name and settings to determine whether its failure is comparable.

## Related tools

* [HDR Statistics](https://docs.timeinpixels.com/nobe-omniscope/qc/hdr-statistics-maxfall-and-maxcll.md)
* [Video File and Free Run](https://docs.timeinpixels.com/nobe-omniscope/sources/video-file.md)
* [QC Timeline](https://docs.timeinpixels.com/nobe-omniscope/qc/qc-timeline.md)
* [QC EDL Export](https://docs.timeinpixels.com/nobe-omniscope/qc/qc-edl-export.md)
