ColorCurves

The color grading curves provide additional color adjustmnent that is applied after any color grading transform (3D LUT). They allow basic adjustment of saturation and small exposure adjustments, along with color filter tinting to provide white balance adjustment or more stylistic effects. These are similar to controls found in many professional imaging or colorist software. The global controls are applied to the entire image. For advanced tuning, extra controls are provided to adjust the shadow, midtone and highlight areas of the image; corresponding to low luminance, medium luminance, and high luminance areas respectively.

Hierarchy

  • ColorCurves

Index

Properties

globalDensity

globalDensity: number

Sets the global Density value. The density value is in range [-100,+100] where 0 means the color filter has no effect and +100 means the color filter has maximum effect. Values less than zero provide a filter of opposite hue.

globalExposure

globalExposure: number

Sets the global Exposure value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase exposure and negative values decrease exposure.

globalHue

globalHue: number

Sets the global Hue value. The hue value is a standard HSB hue in the range [0,360] where 0=red, 120=green and 240=blue. The default value is 30 degrees (orange).

globalSaturation

globalSaturation: number

Sets the global Saturation value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase saturation and negative values decrease saturation.

highlightsDensity

highlightsDensity: number

Sets the highlights Density value. The density value is in range [-100,+100] where 0 means the color filter has no effect and +100 means the color filter has maximum effect. Values less than zero provide a filter of opposite hue.

highlightsExposure

highlightsExposure: number

Sets the highlights Exposure value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase exposure and negative values decrease exposure.

highlightsHue

highlightsHue: number

Sets the highlights Hue value. The hue value is a standard HSB hue in the range [0,360] where 0=red, 120=green and 240=blue. The default value is 30 degrees (orange).

highlightsSaturation

highlightsSaturation: number

Sets the highlights Saturation value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase saturation and negative values decrease saturation.

midtonesDensity

midtonesDensity: number

Sets the midtones Density value. The density value is in range [-100,+100] where 0 means the color filter has no effect and +100 means the color filter has maximum effect. Values less than zero provide a filter of opposite hue.

midtonesExposure

midtonesExposure: number

Sets the midtones Exposure value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase exposure and negative values decrease exposure.

midtonesHue

midtonesHue: number

Sets the midtones Hue value. The hue value is a standard HSB hue in the range [0,360] where 0=red, 120=green and 240=blue. The default value is 30 degrees (orange).

midtonesSaturation

midtonesSaturation: number

Sets the midtones Saturation value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase saturation and negative values decrease saturation.

shadowsDensity

shadowsDensity: number

Sets the shadows Density value. The density value is in range [-100,+100] where 0 means the color filter has no effect and +100 means the color filter has maximum effect. Values less than zero provide a filter of opposite hue.

shadowsExposure

shadowsExposure: number

Sets the shadows Exposure value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase exposure and negative values decrease exposure.

shadowsHue

shadowsHue: number

Sets the shadows Hue value. The hue value is a standard HSB hue in the range [0,360] where 0=red, 120=green and 240=blue. The default value is 30 degrees (orange).

shadowsSaturation

shadowsSaturation: number

Sets the shadows Saturation value. This is an adjustment value in the range [-100,+100], where the default value of 0.0 makes no adjustment, positive values increase saturation and negative values decrease saturation.

Methods

clone

  • Clones the current color curve instance.

    Returns ColorCurves

    The cloned curves

getClassName

  • getClassName(): string
  • Returns string

serialize

  • serialize(): any
  • Serializes the current color curve instance to a json representation.

    Returns any

    a JSON representation

Static Bind

  • Bind(colorCurves: ColorCurves, effect: Effect, positiveUniform?: string, neutralUniform?: string, negativeUniform?: string): void
  • Binds the color curves to the shader.

    Parameters

    • colorCurves: ColorCurves

      The color curve to bind

    • effect: Effect

      The effect to bind to

    • Optional positiveUniform: string
    • Optional neutralUniform: string
    • Optional negativeUniform: string

    Returns void

Static Parse

  • Parses the color curve from a json representation.

    Parameters

    • source: any

      the JSON source to parse

    Returns ColorCurves

    The parsed curves

Static PrepareUniforms

  • PrepareUniforms(uniformsList: string[]): void
  • Prepare the list of uniforms associated with the ColorCurves effects.

    Parameters

    • uniformsList: string[]

      The list of uniforms used in the effect

    Returns void

Generated using TypeDoc