amazonka-mediaconvert-2.0: Amazon Elemental MediaConvert SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.MediaConvert.Types.Vp8Settings

Description

 
Synopsis

Documentation

data Vp8Settings Source #

Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value VP8.

See: newVp8Settings smart constructor.

Constructors

Vp8Settings' 

Fields

  • bitrate :: Maybe Natural

    Target bitrate in bits/second. For example, enter five megabits per second as 5000000.

  • framerateControl :: Maybe Vp8FramerateControl

    If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

  • framerateConversionAlgorithm :: Maybe Vp8FramerateConversionAlgorithm

    Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost.

  • framerateDenominator :: Maybe Natural

    When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

  • framerateNumerator :: Maybe Natural

    When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

  • gopSize :: Maybe Double

    GOP Length (keyframe interval) in frames. Must be greater than zero.

  • hrdBufferSize :: Maybe Natural

    Optional. Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

  • maxBitrate :: Maybe Natural

    Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate.

  • parControl :: Maybe Vp8ParControl

    Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

  • parDenominator :: Maybe Natural

    Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.

  • parNumerator :: Maybe Natural

    Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.

  • qualityTuningLevel :: Maybe Vp8QualityTuningLevel

    Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding.

  • rateControlMode :: Maybe Vp8RateControlMode

    With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.

Instances

Instances details
FromJSON Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

ToJSON Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

Generic Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

Associated Types

type Rep Vp8Settings :: Type -> Type #

Read Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

Show Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

NFData Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

Methods

rnf :: Vp8Settings -> () #

Eq Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

Hashable Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

type Rep Vp8Settings Source # 
Instance details

Defined in Amazonka.MediaConvert.Types.Vp8Settings

type Rep Vp8Settings = D1 ('MetaData "Vp8Settings" "Amazonka.MediaConvert.Types.Vp8Settings" "amazonka-mediaconvert-2.0-ClG8xHhlx4y6bdaCrZchqH" 'False) (C1 ('MetaCons "Vp8Settings'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "bitrate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "framerateControl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Vp8FramerateControl)) :*: S1 ('MetaSel ('Just "framerateConversionAlgorithm") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Vp8FramerateConversionAlgorithm)))) :*: (S1 ('MetaSel ('Just "framerateDenominator") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "framerateNumerator") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "gopSize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Double))))) :*: ((S1 ('MetaSel ('Just "hrdBufferSize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "maxBitrate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "parControl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Vp8ParControl)))) :*: ((S1 ('MetaSel ('Just "parDenominator") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "parNumerator") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))) :*: (S1 ('MetaSel ('Just "qualityTuningLevel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Vp8QualityTuningLevel)) :*: S1 ('MetaSel ('Just "rateControlMode") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Vp8RateControlMode)))))))

newVp8Settings :: Vp8Settings Source #

Create a value of Vp8Settings 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:bitrate:Vp8Settings', vp8Settings_bitrate - Target bitrate in bits/second. For example, enter five megabits per second as 5000000.

$sel:framerateControl:Vp8Settings', vp8Settings_framerateControl - If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

$sel:framerateConversionAlgorithm:Vp8Settings', vp8Settings_framerateConversionAlgorithm - Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost.

$sel:framerateDenominator:Vp8Settings', vp8Settings_framerateDenominator - When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

$sel:framerateNumerator:Vp8Settings', vp8Settings_framerateNumerator - When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

$sel:gopSize:Vp8Settings', vp8Settings_gopSize - GOP Length (keyframe interval) in frames. Must be greater than zero.

$sel:hrdBufferSize:Vp8Settings', vp8Settings_hrdBufferSize - Optional. Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

$sel:maxBitrate:Vp8Settings', vp8Settings_maxBitrate - Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate.

$sel:parControl:Vp8Settings', vp8Settings_parControl - Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

$sel:parDenominator:Vp8Settings', vp8Settings_parDenominator - Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.

$sel:parNumerator:Vp8Settings', vp8Settings_parNumerator - Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.

$sel:qualityTuningLevel:Vp8Settings', vp8Settings_qualityTuningLevel - Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding.

$sel:rateControlMode:Vp8Settings', vp8Settings_rateControlMode - With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.

vp8Settings_bitrate :: Lens' Vp8Settings (Maybe Natural) Source #

Target bitrate in bits/second. For example, enter five megabits per second as 5000000.

vp8Settings_framerateControl :: Lens' Vp8Settings (Maybe Vp8FramerateControl) Source #

If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

vp8Settings_framerateConversionAlgorithm :: Lens' Vp8Settings (Maybe Vp8FramerateConversionAlgorithm) Source #

Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATE_DROP) for numerically simple conversions, such as 60 fps to 30 fps. For numerically complex conversions, you can use interpolate (INTERPOLATE) to avoid stutter. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence, use FrameFormer (FRAMEFORMER) to do motion-compensated interpolation. FrameFormer chooses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost.

vp8Settings_framerateDenominator :: Lens' Vp8Settings (Maybe Natural) Source #

When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

vp8Settings_framerateNumerator :: Lens' Vp8Settings (Maybe Natural) Source #

When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

vp8Settings_gopSize :: Lens' Vp8Settings (Maybe Double) Source #

GOP Length (keyframe interval) in frames. Must be greater than zero.

vp8Settings_hrdBufferSize :: Lens' Vp8Settings (Maybe Natural) Source #

Optional. Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

vp8Settings_maxBitrate :: Lens' Vp8Settings (Maybe Natural) Source #

Ignore this setting unless you set qualityTuningLevel to MULTI_PASS. Optional. Specify the maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. The default behavior uses twice the target bitrate as the maximum bitrate.

vp8Settings_parControl :: Lens' Vp8Settings (Maybe Vp8ParControl) Source #

Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

vp8Settings_parDenominator :: Lens' Vp8Settings (Maybe Natural) Source #

Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.

vp8Settings_parNumerator :: Lens' Vp8Settings (Maybe Natural) Source #

Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.

vp8Settings_qualityTuningLevel :: Lens' Vp8Settings (Maybe Vp8QualityTuningLevel) Source #

Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, multi-pass encoding.

vp8Settings_rateControlMode :: Lens' Vp8Settings (Maybe Vp8RateControlMode) Source #

With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.