Amazonka.MediaConvert.Types.ColorCorrector

Documentation

data ColorCorrector

Settings for color correction.

See: newColorCorrector smart constructor.

Constructors

ColorCorrector'

Fields

• brightness :: Maybe Natural

  Brightness level.

• colorSpaceConversion :: Maybe 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 Elemental tone mapping technology to approximate the outcome of manually regrading from HDR to SDR. Select Force P3D65 (SDR) to set the output color space metadata to the following: * Color primaries: Display P3 * Transfer characteristics: SMPTE 428M * Matrix coefficients: BT.709

• contrast :: Maybe Natural

  Contrast level.

• hdr10Metadata :: Maybe 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 (ColorSpaceConversion) to HDR 10 (FORCE_HDR10), these settings are required. You must set values for Max frame average light level (maxFrameAverageLightLevel) and Max content light level (maxContentLightLevel); 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.

• hue :: Maybe Int

  Hue in degrees.

• sampleRangeConversion :: Maybe SampleRangeConversion

  Specify the video color sample range for this output. To create a full range output, you must start with a full range YUV input and keep the default value, None (NONE). To create a limited range output from a full range input, choose Limited range (LIMITED_RANGE_SQUEEZE). With RGB inputs, your output is always limited range, regardless of your choice here. When you create a limited range output from a full range input, MediaConvert limits the active pixel values in a way that depends on the output's bit depth: 8-bit outputs contain only values from 16 through 235 and 10-bit outputs contain only values from 64 through 940. With this conversion, MediaConvert also changes the output metadata to note the limited range.

• saturation :: Maybe Natural

  Saturation level.

• sdrReferenceWhiteLevel :: Maybe Natural

  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.

Instances

FromJSON ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

parseJSON :: Value -> Parser ColorCorrector

parseJSONList :: Value -> Parser [ColorCorrector]

ToJSON ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

toJSON :: ColorCorrector -> Value

toEncoding :: ColorCorrector -> Encoding

toJSONList :: [ColorCorrector] -> Value

toEncodingList :: [ColorCorrector] -> Encoding

Generic ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Associated Types

type Rep ColorCorrector :: Type -> Type

Methods

from :: ColorCorrector -> Rep ColorCorrector x

to :: Rep ColorCorrector x -> ColorCorrector

Read ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

readsPrec :: Int -> ReadS ColorCorrector

readList :: ReadS [ColorCorrector]

readPrec :: ReadPrec ColorCorrector

readListPrec :: ReadPrec [ColorCorrector]

Show ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

showsPrec :: Int -> ColorCorrector -> ShowS

show :: ColorCorrector -> String

showList :: [ColorCorrector] -> ShowS

NFData ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

rnf :: ColorCorrector -> ()

Eq ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

(==) :: ColorCorrector -> ColorCorrector -> Bool

(/=) :: ColorCorrector -> ColorCorrector -> Bool

Hashable ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

Methods

hashWithSalt :: Int -> ColorCorrector -> Int

hash :: ColorCorrector -> Int

type Rep ColorCorrector

Defined in Amazonka.MediaConvert.Types.ColorCorrector

type Rep ColorCorrector = D1 ('MetaData "ColorCorrector" "Amazonka.MediaConvert.Types.ColorCorrector" "amazonka-mediaconvert-2.0-ClG8xHhlx4y6bdaCrZchqH" 'False) (C1 ('MetaCons "ColorCorrector'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "brightness") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "colorSpaceConversion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ColorSpaceConversion))) :*: (S1 ('MetaSel ('Just "contrast") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "hdr10Metadata") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Hdr10Metadata)))) :*: ((S1 ('MetaSel ('Just "hue") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "sampleRangeConversion") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SampleRangeConversion))) :*: (S1 ('MetaSel ('Just "saturation") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "sdrReferenceWhiteLevel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))))))

newColorCorrector :: ColorCorrector

Create a value of ColorCorrector with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:brightness:ColorCorrector', colorCorrector_brightness - Brightness level.

$sel:colorSpaceConversion:ColorCorrector', colorCorrector_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 Elemental tone mapping technology to approximate the outcome of manually regrading from HDR to SDR. Select Force P3D65 (SDR) to set the output color space metadata to the following: * Color primaries: Display P3 * Transfer characteristics: SMPTE 428M * Matrix coefficients: BT.709

$sel:contrast:ColorCorrector', colorCorrector_contrast - Contrast level.

$sel:hdr10Metadata:ColorCorrector', colorCorrector_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 (ColorSpaceConversion) to HDR 10 (FORCE_HDR10), these settings are required. You must set values for Max frame average light level (maxFrameAverageLightLevel) and Max content light level (maxContentLightLevel); 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.

$sel:hue:ColorCorrector', colorCorrector_hue - Hue in degrees.

$sel:sampleRangeConversion:ColorCorrector', colorCorrector_sampleRangeConversion - Specify the video color sample range for this output. To create a full range output, you must start with a full range YUV input and keep the default value, None (NONE). To create a limited range output from a full range input, choose Limited range (LIMITED_RANGE_SQUEEZE). With RGB inputs, your output is always limited range, regardless of your choice here. When you create a limited range output from a full range input, MediaConvert limits the active pixel values in a way that depends on the output's bit depth: 8-bit outputs contain only values from 16 through 235 and 10-bit outputs contain only values from 64 through 940. With this conversion, MediaConvert also changes the output metadata to note the limited range.

$sel:saturation:ColorCorrector', colorCorrector_saturation - Saturation level.

$sel:sdrReferenceWhiteLevel:ColorCorrector', colorCorrector_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.

colorCorrector_brightness :: Lens' ColorCorrector (Maybe Natural)

Brightness level.

colorCorrector_colorSpaceConversion :: Lens' ColorCorrector (Maybe 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 Elemental tone mapping technology to approximate the outcome of manually regrading from HDR to SDR. Select Force P3D65 (SDR) to set the output color space metadata to the following: * Color primaries: Display P3 * Transfer characteristics: SMPTE 428M * Matrix coefficients: BT.709

colorCorrector_contrast :: Lens' ColorCorrector (Maybe Natural)

Contrast level.

colorCorrector_hdr10Metadata :: Lens' ColorCorrector (Maybe 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 (ColorSpaceConversion) to HDR 10 (FORCE_HDR10), these settings are required. You must set values for Max frame average light level (maxFrameAverageLightLevel) and Max content light level (maxContentLightLevel); 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.

colorCorrector_hue :: Lens' ColorCorrector (Maybe Int)

Hue in degrees.

colorCorrector_sampleRangeConversion :: Lens' ColorCorrector (Maybe SampleRangeConversion)

Specify the video color sample range for this output. To create a full range output, you must start with a full range YUV input and keep the default value, None (NONE). To create a limited range output from a full range input, choose Limited range (LIMITED_RANGE_SQUEEZE). With RGB inputs, your output is always limited range, regardless of your choice here. When you create a limited range output from a full range input, MediaConvert limits the active pixel values in a way that depends on the output's bit depth: 8-bit outputs contain only values from 16 through 235 and 10-bit outputs contain only values from 64 through 940. With this conversion, MediaConvert also changes the output metadata to note the limited range.

colorCorrector_saturation :: Lens' ColorCorrector (Maybe Natural)

Saturation level.

colorCorrector_sdrReferenceWhiteLevel :: Lens' ColorCorrector (Maybe Natural)

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.