Skip to content

Color Management

When displaying VapourSynth clips, VSView must convert the output to packed RGB for rendering on the screen.

Currently, this conversion explicitly targets BT.709 primaries and transfer characteristics.

HDR and Out-of-Range Content

VSView does not perform tone mapping.

Because display conversion is currently fixed to BT.709 targets, HDR content and out-of-range values will be clipped during preview.

This behavior affects preview only. It does not change the source clip in your script.

Required Properties

VSView relies on VapourSynth frame properties _Matrix, _Primaries and _Transfer to properly interpret a clip's color space during conversion.

If these are missing, the conversion may fail or colors may appear incorrect.

Explicit Handling

VSView does not infer or "guess" missing properties.

You must ensure your clip has the correct properties set, or configure a fallback policy.

Frame Property Policy

You can control how VSView reacts to missing properties via the Settings Dialog.

YUV Conversion

If the clip's color family is YUV and _Matrix is unknown or unspecified, VSView will always fail to convert the output to RGB.

  • Error (Default)

    If _Transfer, or _Primaries are missing, VSView stops rendering and displays a failure image because VapourSynth does not have enough information to convert between color spaces.

  • Warn

    If _Transfer or _Primaries are missing, no transfer or primaries conversion is performed and a warning is logged instead.

  • Ignore

    Follows the same steps as Warn, but no warnings are emitted to the log.