Skip to content

/AWS1/CL_MDCCOLORCORRECTOR

Settings for color correction.

CONSTRUCTOR

IMPORTING

Optional arguments:

IV_BRIGHTNESS TYPE /AWS1/MDC__INTEGERMIN1MAX100 /AWS1/MDC__INTEGERMIN1MAX100

Brightness level.

IO_CLIPLIMITS TYPE REF TO /AWS1/CL_MDCCLIPLIMITS /AWS1/CL_MDCCLIPLIMITS

Specify YUV limits and RGB tolerances when you set Sample range conversion to Limited range clip.

IV_COLORSPACECONVERSION TYPE /AWS1/MDCCOLORSPACECONVERSION /AWS1/MDCCOLORSPACECONVERSION

Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SDR. SDR to HDR conversion doesn't upgrade the dynamic range. The converted video has an HDR format, but visually appears the same as an unconverted output. HDR to SDR conversion uses tone mapping to approximate the outcome of manually regrading from HDR to SDR. When you specify an output color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

IV_CONTRAST TYPE /AWS1/MDC__INTEGERMIN1MAX100 /AWS1/MDC__INTEGERMIN1MAX100

Contrast level.

IO_HDR10METADATA TYPE REF TO /AWS1/CL_MDCHDR10METADATA /AWS1/CL_MDCHDR10METADATA

Use these settings when you convert to the HDR 10 color space. Specify the SMPTE ST 2086 Mastering Display Color Volume static metadata that you want signaled in the output. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator. When you set Color space conversion to HDR 10, these settings are required. You must set values for Max frame average light level and Max content light level; these settings don't have a default value. The default values for the other HDR 10 metadata settings are defined by the P3D65 color space. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

IV_HDRTOSDRTONEMAPPER TYPE /AWS1/MDCHDRTOSDRTONEMAPPER /AWS1/MDCHDRTOSDRTONEMAPPER

Specify how MediaConvert maps brightness and colors from your HDR input to your SDR output. The mode that you select represents a creative choice, with different tradeoffs in the details and tones of your output. To maintain details in bright or saturated areas of your output: Choose Preserve details. For some sources, your SDR output may look less bright and less saturated when compared to your HDR source. MediaConvert automatically applies this mode for HLG sources, regardless of your choice. For a bright and saturated output: Choose Vibrant. We recommend that you choose this mode when any of your source content is HDR10, and for the best results when it is mastered for 1000 nits. You may notice loss of details in bright or saturated areas of your output. HDR to SDR tone mapping has no effect when your input is SDR.

IV_HUE TYPE /AWS1/MDC__INTEGERMINNEG180M00 /AWS1/MDC__INTEGERMINNEG180M00

Hue in degrees.

IV_MAXLUMINANCE TYPE /AWS1/MDC__INTEGERMIN0MAX21400 /AWS1/MDC__INTEGERMIN0MAX21400

Specify the maximum mastering display luminance. Enter an integer from 0 to 2147483647, in units of 0.0001 nits. For example, enter 10000000 for 1000 nits.

IV_SAMPLERANGECONVERSION TYPE /AWS1/MDCSAMPLERANGECONVERSION /AWS1/MDCSAMPLERANGECONVERSION

Specify how MediaConvert limits the color sample range for this output. To create a limited range output from a full range input: Choose Limited range squeeze. For full range inputs, MediaConvert performs a linear offset to color samples equally across all pixels and frames. Color samples in 10-bit outputs are limited to 64 through 940, and 8-bit outputs are limited to 16 through 235. Note: For limited range inputs, values for color samples are passed through to your output unchanged. MediaConvert does not limit the sample range. To correct pixels in your input that are out of range or out of gamut: Choose Limited range clip. Use for broadcast applications. MediaConvert conforms any pixels outside of the values that you specify under Minimum YUV and Maximum YUV to limited range bounds. MediaConvert also corrects any YUV values that, when converted to RGB, would be outside the bounds you specify under Minimum RGB tolerance and Maximum RGB tolerance. With either limited range conversion, MediaConvert writes the sample range metadata in the output.

IV_SATURATION TYPE /AWS1/MDC__INTEGERMIN1MAX100 /AWS1/MDC__INTEGERMIN1MAX100

Saturation level.

IV_SDRREFERENCEWHITELEVEL TYPE /AWS1/MDC__INTEGERMIN100MAX100 /AWS1/MDC__INTEGERMIN100MAX100

Specify the reference white level, in nits, for all of your SDR inputs. Use to correct brightness levels within HDR10 outputs. The following color metadata must be present in your SDR input: color primaries, transfer characteristics, and matrix coefficients. If your SDR input has missing color metadata, or if you want to correct input color metadata, manually specify a color space in the input video selector. For 1,000 nit peak brightness displays, we recommend that you set SDR reference white level to 203 (according to ITU-R BT.2408). Leave blank to use the default value of 100, or specify an integer from 100 to 1000.

Queryable Attributes

Brightness

Brightness level.

Accessible with the following methods

Method Description
GET_BRIGHTNESS() Getter for BRIGHTNESS, with configurable default
ASK_BRIGHTNESS() Getter for BRIGHTNESS w/ exceptions if field has no value
HAS_BRIGHTNESS() Determine if BRIGHTNESS has a value

ClipLimits

Specify YUV limits and RGB tolerances when you set Sample range conversion to Limited range clip.

Accessible with the following methods

Method Description
GET_CLIPLIMITS() Getter for CLIPLIMITS

ColorSpaceConversion

Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SDR. SDR to HDR conversion doesn't upgrade the dynamic range. The converted video has an HDR format, but visually appears the same as an unconverted output. HDR to SDR conversion uses tone mapping to approximate the outcome of manually regrading from HDR to SDR. When you specify an output color space, MediaConvert uses the following color space metadata, which includes color primaries, transfer characteristics, and matrix coefficients: * HDR 10: BT.2020, PQ, BT.2020 non-constant * HLG 2020: BT.2020, HLG, BT.2020 non-constant * P3DCI (Theater): DCIP3, SMPTE 428M, BT.709 * P3D65 (SDR): Display P3, sRGB, BT.709 * P3D65 (HDR): Display P3, PQ, BT.709

Accessible with the following methods

Method Description
GET_COLORSPACECONVERSION() Getter for COLORSPACECONVERSION, with configurable default
ASK_COLORSPACECONVERSION() Getter for COLORSPACECONVERSION w/ exceptions if field has n
HAS_COLORSPACECONVERSION() Determine if COLORSPACECONVERSION has a value

Contrast

Contrast level.

Accessible with the following methods

Method Description
GET_CONTRAST() Getter for CONTRAST, with configurable default
ASK_CONTRAST() Getter for CONTRAST w/ exceptions if field has no value
HAS_CONTRAST() Determine if CONTRAST has a value

Hdr10Metadata

Use these settings when you convert to the HDR 10 color space. Specify the SMPTE ST 2086 Mastering Display Color Volume static metadata that you want signaled in the output. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator. When you set Color space conversion to HDR 10, these settings are required. You must set values for Max frame average light level and Max content light level; these settings don't have a default value. The default values for the other HDR 10 metadata settings are defined by the P3D65 color space. For more information about MediaConvert HDR jobs, see https://docs.aws.amazon.com/console/mediaconvert/hdr.

Accessible with the following methods

Method Description
GET_HDR10METADATA() Getter for HDR10METADATA

HdrToSdrToneMapper

Specify how MediaConvert maps brightness and colors from your HDR input to your SDR output. The mode that you select represents a creative choice, with different tradeoffs in the details and tones of your output. To maintain details in bright or saturated areas of your output: Choose Preserve details. For some sources, your SDR output may look less bright and less saturated when compared to your HDR source. MediaConvert automatically applies this mode for HLG sources, regardless of your choice. For a bright and saturated output: Choose Vibrant. We recommend that you choose this mode when any of your source content is HDR10, and for the best results when it is mastered for 1000 nits. You may notice loss of details in bright or saturated areas of your output. HDR to SDR tone mapping has no effect when your input is SDR.

Accessible with the following methods

Method Description
GET_HDRTOSDRTONEMAPPER() Getter for HDRTOSDRTONEMAPPER, with configurable default
ASK_HDRTOSDRTONEMAPPER() Getter for HDRTOSDRTONEMAPPER w/ exceptions if field has no
HAS_HDRTOSDRTONEMAPPER() Determine if HDRTOSDRTONEMAPPER has a value

Hue

Hue in degrees.

Accessible with the following methods

Method Description
GET_HUE() Getter for HUE, with configurable default
ASK_HUE() Getter for HUE w/ exceptions if field has no value
HAS_HUE() Determine if HUE has a value

MaxLuminance

Specify the maximum mastering display luminance. Enter an integer from 0 to 2147483647, in units of 0.0001 nits. For example, enter 10000000 for 1000 nits.

Accessible with the following methods

Method Description
GET_MAXLUMINANCE() Getter for MAXLUMINANCE, with configurable default
ASK_MAXLUMINANCE() Getter for MAXLUMINANCE w/ exceptions if field has no value
HAS_MAXLUMINANCE() Determine if MAXLUMINANCE has a value

SampleRangeConversion

Specify how MediaConvert limits the color sample range for this output. To create a limited range output from a full range input: Choose Limited range squeeze. For full range inputs, MediaConvert performs a linear offset to color samples equally across all pixels and frames. Color samples in 10-bit outputs are limited to 64 through 940, and 8-bit outputs are limited to 16 through 235. Note: For limited range inputs, values for color samples are passed through to your output unchanged. MediaConvert does not limit the sample range. To correct pixels in your input that are out of range or out of gamut: Choose Limited range clip. Use for broadcast applications. MediaConvert conforms any pixels outside of the values that you specify under Minimum YUV and Maximum YUV to limited range bounds. MediaConvert also corrects any YUV values that, when converted to RGB, would be outside the bounds you specify under Minimum RGB tolerance and Maximum RGB tolerance. With either limited range conversion, MediaConvert writes the sample range metadata in the output.

Accessible with the following methods

Method Description
GET_SAMPLERANGECONVERSION() Getter for SAMPLERANGECONVERSION, with configurable default
ASK_SAMPLERANGECONVERSION() Getter for SAMPLERANGECONVERSION w/ exceptions if field has
HAS_SAMPLERANGECONVERSION() Determine if SAMPLERANGECONVERSION has a value

Saturation

Saturation level.

Accessible with the following methods

Method Description
GET_SATURATION() Getter for SATURATION, with configurable default
ASK_SATURATION() Getter for SATURATION w/ exceptions if field has no value
HAS_SATURATION() Determine if SATURATION has a value

SdrReferenceWhiteLevel

Specify the reference white level, in nits, for all of your SDR inputs. Use to correct brightness levels within HDR10 outputs. The following color metadata must be present in your SDR input: color primaries, transfer characteristics, and matrix coefficients. If your SDR input has missing color metadata, or if you want to correct input color metadata, manually specify a color space in the input video selector. For 1,000 nit peak brightness displays, we recommend that you set SDR reference white level to 203 (according to ITU-R BT.2408). Leave blank to use the default value of 100, or specify an integer from 100 to 1000.

Accessible with the following methods

Method Description
GET_SDRREFERENCEWHITELEVEL() Getter for SDRREFERENCEWHITELEVEL, with configurable default
ASK_SDRREFERENCEWHITELEVEL() Getter for SDRREFERENCEWHITELEVEL w/ exceptions if field has
HAS_SDRREFERENCEWHITELEVEL() Determine if SDRREFERENCEWHITELEVEL has a value