Vixen
02b45cc4
csharp
public readonly record struct ColorGradingRange

One tonal range's five grading operations.

Read the guide page for this →

Remarks

The American Society of Cinematographers' colour decision list, which every grading suite reads and writes. Saturation and contrast, then the slope-offset-power triple that the standard calls gain, offset and gamma — ⚠ applied in that order, because two tools applying the same numbers in different orders produce different pictures, which is the one thing an interchange format exists to prevent.

⚠ Scene-referred. These run before the tonemap on unbounded light, so Gamma is a power on radiance and 1 means "leave it alone" rather than "display gamma", and Contrast pivots around 0.18 in log space rather than around 0.5. A range copied from a display-referred tool will be roughly right and not exactly right, which is the honest trade for grading where both SDR and HDR output agree.

Fields and properties (6)

  • public float Saturation

    How much colour survives. 0 is greyscale, 1 leaves it alone.

  • public float Contrast

    Contrast about middle grey. 1 leaves it alone.

  • public Vector3 Gamma

    The power, per channel. The standard's power.

  • public Vector3 Gain

    The multiplier, per channel. The standard's slope.

  • public Vector3 Offset

    What is added, per channel. The standard's offset.

  • public static ColorGradingRange Neutral

    The range that changes nothing.

Used by (6)

  • ColorGradingVixen.Rendering.PostFx
  • PostEffectTestsVixen.Rendering.PostFx.Tests
  • TonemapRendererVixen.Rendering.PostFx
  • TypeRegistrationVixen.Rendering.PostFx
  • Vixen_Rendering_PostFx_ColorGradingRangeSerializerVixen.Rendering.PostFx
  • Vixen_Rendering_PostFx_ColorGradingSerializerVixen.Rendering.PostFx