Contents

Evaluating an app’s video color

Check color reproduction for a video in your app by using test patterns, video test equipment, and light-measurement instruments.

Overview

AVFoundation automatically applies color management to video during playback. ColorSync creates a color transform that provides a color match between the video’s color space (as specified by the color tag in the media) and the specific chromaticity and gamma characteristics of your display.

ColorSync uses the display’s ICC profile to obtain its chromaticity and gamma characteristics. It then performs the color match using perceptual rendering intent to scale the video colors so they fit into the destination gamut specified by the display. AVFoundation applies this color transformation to each pixel of each frame in real time during video playback, ensuring the color fidelity of the original video.

Manage color reproduction

During playback, the color-management process changes the pixel values encoded in the video file to make them appear true to the original on the display. As a result of this color management, the Digital Color Meter app reports values from the display buffer that are different from the actual pixels encoded in the video file. Further, the Digital Color Meter app may report unequal pixel values between seemingly identical displays if their display profiles differ.

You can use a variety of techniques to verify that the system properly manages color in your video:

  • Use test pattern files to evaluate the color characteristics of your app or workflow.

  • Output the test pattern files to a vectorscope or waveform analyzer to review video signals.

  • Use the test pattern files with a spectroradiometer or colorimeter to measure front-of-screen (FoS) luminance.

Appropriate color management of your video during playback requires tagging your content, using frameworks that offer implicit color management of video, and evaluating your results.

For more information about color tags, see Tagging media with video color information.

Evaluate video using test pattern files

Use test pattern files to evaluate the color characteristics of your AVFoundation-based app or workflow. These files produce expected results when displayed on Apple devices and operating systems. Open these files in the QuickTime Player App or with other apps or workflows that properly support the QuickTime File Format Specification. Read the display buffer pixel values using the Digital Color Meter app. See Evaluating video using QuickTime test pattern files.

Evaluate video using a vectorscope or waveform analyzer

Output test patterns to a vectorscope or waveform analyzer to analyze the video signals. View the test pattern on a vectorscope and verify the correct colorspace conversion matrices. Verify the gamma, quantization errors, and range expansion and compression on a waveform monitor. See Evaluating an app’s video color using video test equipment.

Evaluate video using a spectroradiometer or colorimeter

Output the test pattern files to a spectroradiometer or colorimeter to measure front-of-screen (FoS) luminance. Measure and compare your results against the expected FoS values. See Evaluating an app’s video color using light-measurement Instruments.

Ensure accurate color application of your app’s video

To ensure application of the appropriate color management to your video during playback:

  • Use high-level frameworks integrated with ColorSync, such as AVFoundation, for implicit color management.

  • Tag all video content with color information to avoid inconsistent color across different devices. In most cases, the system treats untagged media as if the author created it in the SD color space. See Tagging media with video color information.

  • Evaluate all results using the techniques described here.

Topics

Video evaluation

See Also

Media writing