Package software.amazon.awssdk.services.mediaconvert.model

Class Mpeg2Settings

java.lang.Object
software.amazon.awssdk.services.mediaconvert.model.Mpeg2Settings
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<Mpeg2Settings.Builder,Mpeg2Settings>
@Generated("software.amazon.awssdk:codegen") public final class Mpeg2Settings extends Object implements SdkPojo, Serializable, ToCopyableBuilder<Mpeg2Settings.Builder,Mpeg2Settings>
Required when you set Codec to the value MPEG2.
See Also:

  • Method Details

    • adaptiveQuantization

      public final Mpeg2AdaptiveQuantization adaptiveQuantization()
      Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization, and Temporal adaptive quantization.

      If the service returns an enum value that is not available in the current SDK version, adaptiveQuantization will return Mpeg2AdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from adaptiveQuantizationAsString().

      Returns:
      Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization, and Temporal adaptive quantization.
      See Also:

    • adaptiveQuantizationAsString

      public final String adaptiveQuantizationAsString()
      Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization, and Temporal adaptive quantization.

      If the service returns an enum value that is not available in the current SDK version, adaptiveQuantization will return Mpeg2AdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from adaptiveQuantizationAsString().

      Returns:
      Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive quantization, and Temporal adaptive quantization.
      See Also:

    • bitrate

      public final Integer bitrate()
      Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.
      Returns:
      Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.

    • codecLevel

      public final Mpeg2CodecLevel codecLevel()
      Use Level to set the MPEG-2 level for the video output.

      If the service returns an enum value that is not available in the current SDK version, codecLevel will return Mpeg2CodecLevel.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from codecLevelAsString().

      Returns:
      Use Level to set the MPEG-2 level for the video output.
      See Also:

    • codecLevelAsString

      public final String codecLevelAsString()
      Use Level to set the MPEG-2 level for the video output.

      If the service returns an enum value that is not available in the current SDK version, codecLevel will return Mpeg2CodecLevel.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from codecLevelAsString().

      Returns:
      Use Level to set the MPEG-2 level for the video output.
      See Also:

    • codecProfile

      public final Mpeg2CodecProfile codecProfile()
      Use Profile to set the MPEG-2 profile for the video output.

      If the service returns an enum value that is not available in the current SDK version, codecProfile will return Mpeg2CodecProfile.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from codecProfileAsString().

      Returns:
      Use Profile to set the MPEG-2 profile for the video output.
      See Also:

    • codecProfileAsString

      public final String codecProfileAsString()
      Use Profile to set the MPEG-2 profile for the video output.

      If the service returns an enum value that is not available in the current SDK version, codecProfile will return Mpeg2CodecProfile.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from codecProfileAsString().

      Returns:
      Use Profile to set the MPEG-2 profile for the video output.
      See Also:

    • dynamicSubGop

      public final Mpeg2DynamicSubGop dynamicSubGop()
      Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames.

      If the service returns an enum value that is not available in the current SDK version, dynamicSubGop will return Mpeg2DynamicSubGop.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from dynamicSubGopAsString().

      Returns:
      Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames.
      See Also:

    • dynamicSubGopAsString

      public final String dynamicSubGopAsString()
      Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames.

      If the service returns an enum value that is not available in the current SDK version, dynamicSubGop will return Mpeg2DynamicSubGop.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from dynamicSubGopAsString().

      Returns:
      Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames.
      See Also:

    • framerateControl

      public final Mpeg2FramerateControl 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 the service returns an enum value that is not available in the current SDK version, framerateControl will return Mpeg2FramerateControl.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from framerateControlAsString().

      Returns:
      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.
      See Also:

    • framerateControlAsString

      public final String framerateControlAsString()
      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 the service returns an enum value that is not available in the current SDK version, framerateControl will return Mpeg2FramerateControl.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from framerateControlAsString().

      Returns:
      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.
      See Also:

    • framerateConversionAlgorithm

      public final Mpeg2FramerateConversionAlgorithm framerateConversionAlgorithm()
      Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.

      If the service returns an enum value that is not available in the current SDK version, framerateConversionAlgorithm will return Mpeg2FramerateConversionAlgorithm.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from framerateConversionAlgorithmAsString().

      Returns:
      Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
      See Also:

    • framerateConversionAlgorithmAsString

      public final String framerateConversionAlgorithmAsString()
      Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.

      If the service returns an enum value that is not available in the current SDK version, framerateConversionAlgorithm will return Mpeg2FramerateConversionAlgorithm.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from framerateConversionAlgorithmAsString().

      Returns:
      Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. 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: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
      See Also:

    • framerateDenominator

      public final Integer 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.
      Returns:
      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

      public final Integer 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.
      Returns:
      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.

    • gopClosedCadence

      public final Integer gopClosedCadence()
      Specify the relative frequency of open to closed GOPs in this output. For example, if you want to allow four open GOPs and then require a closed GOP, set this value to 5. When you create a streaming output, we recommend that you keep the default value, 1, so that players starting mid-stream receive an IDR frame as quickly as possible. Don't set this value to 0; that would break output segmenting.
      Returns:
      Specify the relative frequency of open to closed GOPs in this output. For example, if you want to allow four open GOPs and then require a closed GOP, set this value to 5. When you create a streaming output, we recommend that you keep the default value, 1, so that players starting mid-stream receive an IDR frame as quickly as possible. Don't set this value to 0; that would break output segmenting.

    • gopSize

      public final Double gopSize()
      Specify the interval between keyframes, in seconds or frames, for this output. Default: 12 Related settings: When you specify the GOP size in seconds, set GOP mode control to Specified, seconds. The default value for GOP mode control is Frames.
      Returns:
      Specify the interval between keyframes, in seconds or frames, for this output. Default: 12 Related settings: When you specify the GOP size in seconds, set GOP mode control to Specified, seconds. The default value for GOP mode control is Frames.

    • gopSizeUnits

      public final Mpeg2GopSizeUnits gopSizeUnits()
      Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.

      If the service returns an enum value that is not available in the current SDK version, gopSizeUnits will return Mpeg2GopSizeUnits.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from gopSizeUnitsAsString().

      Returns:
      Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.
      See Also:

    • gopSizeUnitsAsString

      public final String gopSizeUnitsAsString()
      Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.

      If the service returns an enum value that is not available in the current SDK version, gopSizeUnits will return Mpeg2GopSizeUnits.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from gopSizeUnitsAsString().

      Returns:
      Specify the units for GOP size. If you don't specify a value here, by default the encoder measures GOP size in frames.
      See Also:

    • hrdBufferFinalFillPercentage

      public final Integer hrdBufferFinalFillPercentage()
      If your downstream systems have strict buffer requirements: Specify the minimum percentage of the HRD buffer that's available at the end of each encoded video segment. For the best video quality: Set to 0 or leave blank to automatically determine the final buffer fill percentage.
      Returns:
      If your downstream systems have strict buffer requirements: Specify the minimum percentage of the HRD buffer that's available at the end of each encoded video segment. For the best video quality: Set to 0 or leave blank to automatically determine the final buffer fill percentage.

    • hrdBufferInitialFillPercentage

      public final Integer hrdBufferInitialFillPercentage()
      Percentage of the buffer that should initially be filled (HRD buffer model).
      Returns:
      Percentage of the buffer that should initially be filled (HRD buffer model).

    • hrdBufferSize

      public final Integer hrdBufferSize()
      Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.
      Returns:
      Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

    • interlaceMode

      public final Mpeg2InterlaceMode interlaceMode()
      Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.

      If the service returns an enum value that is not available in the current SDK version, interlaceMode will return Mpeg2InterlaceMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from interlaceModeAsString().

      Returns:
      Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.
      See Also:

    • interlaceModeAsString

      public final String interlaceModeAsString()
      Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.

      If the service returns an enum value that is not available in the current SDK version, interlaceMode will return Mpeg2InterlaceMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from interlaceModeAsString().

      Returns:
      Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.
      See Also:

    • intraDcPrecision

      public final Mpeg2IntraDcPrecision intraDcPrecision()
      Use Intra DC precision to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.

      If the service returns an enum value that is not available in the current SDK version, intraDcPrecision will return Mpeg2IntraDcPrecision.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from intraDcPrecisionAsString().

      Returns:
      Use Intra DC precision to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.
      See Also:

    • intraDcPrecisionAsString

      public final String intraDcPrecisionAsString()
      Use Intra DC precision to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.

      If the service returns an enum value that is not available in the current SDK version, intraDcPrecision will return Mpeg2IntraDcPrecision.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from intraDcPrecisionAsString().

      Returns:
      Use Intra DC precision to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio.
      See Also:

    • maxBitrate

      public final Integer maxBitrate()
      Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.
      Returns:
      Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.

    • minIInterval

      public final Integer minIInterval()
      Use this setting only when you also enable Scene change detection. This setting determines how the encoder manages the spacing between I-frames that it inserts as part of the I-frame cadence and the I-frames that it inserts for Scene change detection. When you specify a value for this setting, the encoder determines whether to skip a cadence-driven I-frame by the value you set. For example, if you set Min I interval to 5 and a cadence-driven I-frame would fall within 5 frames of a scene-change I-frame, then the encoder skips the cadence-driven I-frame. In this way, one GOP is shrunk slightly and one GOP is stretched slightly. When the cadence-driven I-frames are farther from the scene-change I-frame than the value you set, then the encoder leaves all I-frames in place and the GOPs surrounding the scene change are smaller than the usual cadence GOPs.
      Returns:
      Use this setting only when you also enable Scene change detection. This setting determines how the encoder manages the spacing between I-frames that it inserts as part of the I-frame cadence and the I-frames that it inserts for Scene change detection. When you specify a value for this setting, the encoder determines whether to skip a cadence-driven I-frame by the value you set. For example, if you set Min I interval to 5 and a cadence-driven I-frame would fall within 5 frames of a scene-change I-frame, then the encoder skips the cadence-driven I-frame. In this way, one GOP is shrunk slightly and one GOP is stretched slightly. When the cadence-driven I-frames are farther from the scene-change I-frame than the value you set, then the encoder leaves all I-frames in place and the GOPs surrounding the scene change are smaller than the usual cadence GOPs.

    • numberBFramesBetweenReferenceFrames

      public final Integer numberBFramesBetweenReferenceFrames()
      Specify the number of B-frames that MediaConvert puts between reference frames in this output. Valid values are whole numbers from 0 through 7. When you don't specify a value, MediaConvert defaults to 2.
      Returns:
      Specify the number of B-frames that MediaConvert puts between reference frames in this output. Valid values are whole numbers from 0 through 7. When you don't specify a value, MediaConvert defaults to 2.

    • parControl

      public final Mpeg2ParControl parControl()
      Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

      If the service returns an enum value that is not available in the current SDK version, parControl will return Mpeg2ParControl.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from parControlAsString().

      Returns:
      Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
      See Also:

    • parControlAsString

      public final String parControlAsString()
      Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

      If the service returns an enum value that is not available in the current SDK version, parControl will return Mpeg2ParControl.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from parControlAsString().

      Returns:
      Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow 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. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
      See Also:

    • parDenominator

      public final Integer parDenominator()
      Required when you set Pixel aspect ratio 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.
      Returns:
      Required when you set Pixel aspect ratio 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

      public final Integer parNumerator()
      Required when you set Pixel aspect ratio 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.
      Returns:
      Required when you set Pixel aspect ratio 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

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

      If the service returns an enum value that is not available in the current SDK version, qualityTuningLevel will return Mpeg2QualityTuningLevel.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from qualityTuningLevelAsString().

      Returns:
      Optional. Use Quality tuning level to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding.
      See Also:

    • qualityTuningLevelAsString

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

      If the service returns an enum value that is not available in the current SDK version, qualityTuningLevel will return Mpeg2QualityTuningLevel.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from qualityTuningLevelAsString().

      Returns:
      Optional. Use Quality tuning level to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding.
      See Also:

    • rateControlMode

      public final Mpeg2RateControlMode rateControlMode()
      Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).

      If the service returns an enum value that is not available in the current SDK version, rateControlMode will return Mpeg2RateControlMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from rateControlModeAsString().

      Returns:
      Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).
      See Also:

    • rateControlModeAsString

      public final String rateControlModeAsString()
      Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).

      If the service returns an enum value that is not available in the current SDK version, rateControlMode will return Mpeg2RateControlMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from rateControlModeAsString().

      Returns:
      Use Rate control mode to specify whether the bitrate is variable (vbr) or constant (cbr).
      See Also:

    • scanTypeConversionMode

      public final Mpeg2ScanTypeConversionMode scanTypeConversionMode()
      Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.

      If the service returns an enum value that is not available in the current SDK version, scanTypeConversionMode will return Mpeg2ScanTypeConversionMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from scanTypeConversionModeAsString().

      Returns:
      Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
      See Also:

    • scanTypeConversionModeAsString

      public final String scanTypeConversionModeAsString()
      Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.

      If the service returns an enum value that is not available in the current SDK version, scanTypeConversionMode will return Mpeg2ScanTypeConversionMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from scanTypeConversionModeAsString().

      Returns:
      Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
      See Also:

    • sceneChangeDetect

      public final Mpeg2SceneChangeDetect sceneChangeDetect()
      Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.

      If the service returns an enum value that is not available in the current SDK version, sceneChangeDetect will return Mpeg2SceneChangeDetect.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from sceneChangeDetectAsString().

      Returns:
      Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.
      See Also:

    • sceneChangeDetectAsString

      public final String sceneChangeDetectAsString()
      Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.

      If the service returns an enum value that is not available in the current SDK version, sceneChangeDetect will return Mpeg2SceneChangeDetect.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from sceneChangeDetectAsString().

      Returns:
      Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.
      See Also:

    • slowPal

      public final Mpeg2SlowPal slowPal()
      Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.

      If the service returns an enum value that is not available in the current SDK version, slowPal will return Mpeg2SlowPal.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from slowPalAsString().

      Returns:
      Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.
      See Also:

    • slowPalAsString

      public final String slowPalAsString()
      Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.

      If the service returns an enum value that is not available in the current SDK version, slowPal will return Mpeg2SlowPal.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from slowPalAsString().

      Returns:
      Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.
      See Also:

    • softness

      public final Integer softness()
      Ignore this setting unless you need to comply with a specification that requires a specific value. If you don't have a specification requirement, we recommend that you adjust the softness of your output by using a lower value for the setting Sharpness or by enabling a noise reducer filter. The Softness setting specifies the quantization matrices that the encoder uses. Keep the default value, 0, to use the AWS Elemental default matrices. Choose a value from 17 to 128 to use planar interpolation. Increasing values from 17 to 128 result in increasing reduction of high-frequency data. The value 128 results in the softest video.
      Returns:
      Ignore this setting unless you need to comply with a specification that requires a specific value. If you don't have a specification requirement, we recommend that you adjust the softness of your output by using a lower value for the setting Sharpness or by enabling a noise reducer filter. The Softness setting specifies the quantization matrices that the encoder uses. Keep the default value, 0, to use the AWS Elemental default matrices. Choose a value from 17 to 128 to use planar interpolation. Increasing values from 17 to 128 result in increasing reduction of high-frequency data. The value 128 results in the softest video.

    • spatialAdaptiveQuantization

      public final Mpeg2SpatialAdaptiveQuantization spatialAdaptiveQuantization()
      Keep the default value, Enabled, to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.

      If the service returns an enum value that is not available in the current SDK version, spatialAdaptiveQuantization will return Mpeg2SpatialAdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from spatialAdaptiveQuantizationAsString().

      Returns:
      Keep the default value, Enabled, to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.
      See Also:

    • spatialAdaptiveQuantizationAsString

      public final String spatialAdaptiveQuantizationAsString()
      Keep the default value, Enabled, to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.

      If the service returns an enum value that is not available in the current SDK version, spatialAdaptiveQuantization will return Mpeg2SpatialAdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from spatialAdaptiveQuantizationAsString().

      Returns:
      Keep the default value, Enabled, to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas that can sustain more distortion with no noticeable visual degradation and uses more bits on areas where any small distortion will be noticeable. For example, complex textured blocks are encoded with fewer bits and smooth textured blocks are encoded with more bits. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen with a lot of complex texture, you might choose to disable this feature. Related setting: When you enable spatial adaptive quantization, set the value for Adaptive quantization depending on your content. For homogeneous content, such as cartoons and video games, set it to Low. For content with a wider variety of textures, set it to High or Higher.
      See Also:

    • syntax

      public final Mpeg2Syntax syntax()
      Specify whether this output's video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 for your MXF profile, you must also set this value to D10.

      If the service returns an enum value that is not available in the current SDK version, syntax will return Mpeg2Syntax.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from syntaxAsString().

      Returns:
      Specify whether this output's video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 for your MXF profile, you must also set this value to D10.
      See Also:

    • syntaxAsString

      public final String syntaxAsString()
      Specify whether this output's video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 for your MXF profile, you must also set this value to D10.

      If the service returns an enum value that is not available in the current SDK version, syntax will return Mpeg2Syntax.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from syntaxAsString().

      Returns:
      Specify whether this output's video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 for your MXF profile, you must also set this value to D10.
      See Also:

    • telecine

      public final Mpeg2Telecine telecine()
      When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine produces a 29.97i output. Soft telecine produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.

      If the service returns an enum value that is not available in the current SDK version, telecine will return Mpeg2Telecine.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from telecineAsString().

      Returns:
      When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine produces a 29.97i output. Soft telecine produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
      See Also:

    • telecineAsString

      public final String telecineAsString()
      When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine produces a 29.97i output. Soft telecine produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.

      If the service returns an enum value that is not available in the current SDK version, telecine will return Mpeg2Telecine.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from telecineAsString().

      Returns:
      When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or soft telecine to create a smoother picture. Hard telecine produces a 29.97i output. Soft telecine produces an output with a 23.976 output that signals to the video player device to do the conversion during play back. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
      See Also:

    • temporalAdaptiveQuantization

      public final Mpeg2TemporalAdaptiveQuantization temporalAdaptiveQuantization()
      Keep the default value, Enabled, to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren't moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn't have moving objects with sharp edges, such as sports athletes' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization.

      If the service returns an enum value that is not available in the current SDK version, temporalAdaptiveQuantization will return Mpeg2TemporalAdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from temporalAdaptiveQuantizationAsString().

      Returns:
      Keep the default value, Enabled, to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren't moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn't have moving objects with sharp edges, such as sports athletes' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization.
      See Also:

    • temporalAdaptiveQuantizationAsString

      public final String temporalAdaptiveQuantizationAsString()
      Keep the default value, Enabled, to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren't moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn't have moving objects with sharp edges, such as sports athletes' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization.

      If the service returns an enum value that is not available in the current SDK version, temporalAdaptiveQuantization will return Mpeg2TemporalAdaptiveQuantization.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from temporalAdaptiveQuantizationAsString().

      Returns:
      Keep the default value, Enabled, to adjust quantization within each frame based on temporal variation of content complexity. When you enable this feature, the encoder uses fewer bits on areas of the frame that aren't moving and uses more bits on complex objects with sharp edges that move a lot. For example, this feature improves the readability of text tickers on newscasts and scoreboards on sports matches. Enabling this feature will almost always improve your video quality. Note, though, that this feature doesn't take into account where the viewer's attention is likely to be. If viewers are likely to be focusing their attention on a part of the screen that doesn't have moving objects with sharp edges, such as sports athletes' faces, you might choose to disable this feature. Related setting: When you enable temporal quantization, adjust the strength of the filter with the setting Adaptive quantization.
      See Also:

    • toBuilder

      public Mpeg2Settings.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<Mpeg2Settings.Builder,Mpeg2Settings>
      Returns:
      a builder for type T

    • builder

      public static Mpeg2Settings.Builder builder()

    • serializableBuilderClass

      public static Class<? extends Mpeg2Settings.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String toString()
      Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.