Package software.amazon.awssdk.services.medialive.model

Interface H265Settings.Builder

All Superinterfaces:
Buildable, CopyableBuilder<H265Settings.Builder,H265Settings>, SdkBuilder<H265Settings.Builder,H265Settings>, SdkPojo
Enclosing class:
H265Settings
public static interface H265Settings.Builder extends SdkPojo, CopyableBuilder<H265Settings.Builder,H265Settings>

  • Method Details

    • adaptiveQuantization

      H265Settings.Builder adaptiveQuantization(String adaptiveQuantization)
      Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.
      Parameters:
      adaptiveQuantization - Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • adaptiveQuantization

      H265Settings.Builder adaptiveQuantization(H265AdaptiveQuantization adaptiveQuantization)
      Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.
      Parameters:
      adaptiveQuantization - Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • afdSignaling

      H265Settings.Builder afdSignaling(String afdSignaling)
      Indicates that AFD values will be written into the output stream. If afdSignaling is "auto", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to "fixed", the AFD value will be the value configured in the fixedAfd parameter.
      Parameters:
      afdSignaling - Indicates that AFD values will be written into the output stream. If afdSignaling is "auto", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to "fixed", the AFD value will be the value configured in the fixedAfd parameter.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • afdSignaling

      H265Settings.Builder afdSignaling(AfdSignaling afdSignaling)
      Indicates that AFD values will be written into the output stream. If afdSignaling is "auto", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to "fixed", the AFD value will be the value configured in the fixedAfd parameter.
      Parameters:
      afdSignaling - Indicates that AFD values will be written into the output stream. If afdSignaling is "auto", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to "fixed", the AFD value will be the value configured in the fixedAfd parameter.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • alternativeTransferFunction

      H265Settings.Builder alternativeTransferFunction(String alternativeTransferFunction)
      Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.
      Parameters:
      alternativeTransferFunction - Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • alternativeTransferFunction

      H265Settings.Builder alternativeTransferFunction(H265AlternativeTransferFunction alternativeTransferFunction)
      Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.
      Parameters:
      alternativeTransferFunction - Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • bitrate

      H265Settings.Builder bitrate(Integer bitrate)
      Average bitrate in bits/second. Required when the rate control mode is VBR or CBR. Not used for QVBR. In an MS Smooth output group, each output must have a unique value when its bitrate is rounded down to the nearest multiple of 1000.
      Parameters:
      bitrate - Average bitrate in bits/second. Required when the rate control mode is VBR or CBR. Not used for QVBR. In an MS Smooth output group, each output must have a unique value when its bitrate is rounded down to the nearest multiple of 1000.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • bufSize

      H265Settings.Builder bufSize(Integer bufSize)
      Size of buffer (HRD buffer model) in bits.
      Parameters:
      bufSize - Size of buffer (HRD buffer model) in bits.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • colorMetadata

      H265Settings.Builder colorMetadata(String colorMetadata)
      Includes colorspace metadata in the output.
      Parameters:
      colorMetadata - Includes colorspace metadata in the output.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • colorMetadata

      H265Settings.Builder colorMetadata(H265ColorMetadata colorMetadata)
      Includes colorspace metadata in the output.
      Parameters:
      colorMetadata - Includes colorspace metadata in the output.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • colorSpaceSettings

      H265Settings.Builder colorSpaceSettings(H265ColorSpaceSettings colorSpaceSettings)
      Color Space settings
      Parameters:
      colorSpaceSettings - Color Space settings
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • colorSpaceSettings

      default H265Settings.Builder colorSpaceSettings(Consumer<H265ColorSpaceSettings.Builder> colorSpaceSettings)
      Color Space settings This is a convenience method that creates an instance of the H265ColorSpaceSettings.Builder avoiding the need to create one manually via H265ColorSpaceSettings.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to colorSpaceSettings(H265ColorSpaceSettings).

      Parameters:
      colorSpaceSettings - a consumer that will call methods on H265ColorSpaceSettings.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • filterSettings

      H265Settings.Builder filterSettings(H265FilterSettings filterSettings)
      Optional filters that you can apply to an encode.
      Parameters:
      filterSettings - Optional filters that you can apply to an encode.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • filterSettings

      default H265Settings.Builder filterSettings(Consumer<H265FilterSettings.Builder> filterSettings)
      Optional filters that you can apply to an encode. This is a convenience method that creates an instance of the H265FilterSettings.Builder avoiding the need to create one manually via H265FilterSettings.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to filterSettings(H265FilterSettings).

      Parameters:
      filterSettings - a consumer that will call methods on H265FilterSettings.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • fixedAfd

      H265Settings.Builder fixedAfd(String fixedAfd)
      Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'.
      Parameters:
      fixedAfd - Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • fixedAfd

      H265Settings.Builder fixedAfd(FixedAfd fixedAfd)
      Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'.
      Parameters:
      fixedAfd - Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • flickerAq

      H265Settings.Builder flickerAq(String flickerAq)
      If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.
      Parameters:
      flickerAq - If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • flickerAq

      H265Settings.Builder flickerAq(H265FlickerAq flickerAq)
      If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.
      Parameters:
      flickerAq - If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • framerateDenominator

      H265Settings.Builder framerateDenominator(Integer framerateDenominator)
      Framerate denominator.
      Parameters:
      framerateDenominator - Framerate denominator.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • framerateNumerator

      H265Settings.Builder framerateNumerator(Integer framerateNumerator)
      Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.
      Parameters:
      framerateNumerator - Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • gopClosedCadence

      H265Settings.Builder gopClosedCadence(Integer gopClosedCadence)
      Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.
      Parameters:
      gopClosedCadence - Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • gopSize

      H265Settings.Builder gopSize(Double gopSize)
      GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits. If gopSizeUnits is frames, gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, gopSize must be greater than 0, but need not be an integer.
      Parameters:
      gopSize - GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits. If gopSizeUnits is frames, gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, gopSize must be greater than 0, but need not be an integer.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • gopSizeUnits

      H265Settings.Builder gopSizeUnits(String gopSizeUnits)
      Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.
      Parameters:
      gopSizeUnits - Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • gopSizeUnits

      H265Settings.Builder gopSizeUnits(H265GopSizeUnits gopSizeUnits)
      Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.
      Parameters:
      gopSizeUnits - Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • level

      H265Settings.Builder level(String level)
      H.265 Level.
      Parameters:
      level - H.265 Level.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • level

      H265Settings.Builder level(H265Level level)
      H.265 Level.
      Parameters:
      level - H.265 Level.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • lookAheadRateControl

      H265Settings.Builder lookAheadRateControl(String lookAheadRateControl)
      Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.
      Parameters:
      lookAheadRateControl - Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • lookAheadRateControl

      H265Settings.Builder lookAheadRateControl(H265LookAheadRateControl lookAheadRateControl)
      Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.
      Parameters:
      lookAheadRateControl - Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • maxBitrate

      H265Settings.Builder maxBitrate(Integer maxBitrate)
      For QVBR: See the tooltip for Quality level
      Parameters:
      maxBitrate - For QVBR: See the tooltip for Quality level
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • minIInterval

      H265Settings.Builder minIInterval(Integer minIInterval)
      Only meaningful if sceneChangeDetect is set to enabled. Defaults to 5 if multiplex rate control is used. Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1
      Parameters:
      minIInterval - Only meaningful if sceneChangeDetect is set to enabled. Defaults to 5 if multiplex rate control is used. Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • parDenominator

      H265Settings.Builder parDenominator(Integer parDenominator)
      Pixel Aspect Ratio denominator.
      Parameters:
      parDenominator - Pixel Aspect Ratio denominator.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • parNumerator

      H265Settings.Builder parNumerator(Integer parNumerator)
      Pixel Aspect Ratio numerator.
      Parameters:
      parNumerator - Pixel Aspect Ratio numerator.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • profile

      H265Settings.Builder profile(String profile)
      H.265 Profile.
      Parameters:
      profile - H.265 Profile.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • profile

      H265Settings.Builder profile(H265Profile profile)
      H.265 Profile.
      Parameters:
      profile - H.265 Profile.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • qvbrQualityLevel

      H265Settings.Builder qvbrQualityLevel(Integer qvbrQualityLevel)
      Controls the target quality for the video encode. Applies only when the rate control mode is QVBR. Set values for the QVBR quality level field and Max bitrate field that suit your most important viewing devices. Recommended values are: - Primary screen: Quality level: 8 to 10. Max bitrate: 4M - PC or tablet: Quality level: 7. Max bitrate: 1.5M to 3M - Smartphone: Quality level: 6. Max bitrate: 1M to 1.5M
      Parameters:
      qvbrQualityLevel - Controls the target quality for the video encode. Applies only when the rate control mode is QVBR. Set values for the QVBR quality level field and Max bitrate field that suit your most important viewing devices. Recommended values are: - Primary screen: Quality level: 8 to 10. Max bitrate: 4M - PC or tablet: Quality level: 7. Max bitrate: 1.5M to 3M - Smartphone: Quality level: 6. Max bitrate: 1M to 1.5M
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • rateControlMode

      H265Settings.Builder rateControlMode(String rateControlMode)
      Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.
      Parameters:
      rateControlMode - Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • rateControlMode

      H265Settings.Builder rateControlMode(H265RateControlMode rateControlMode)
      Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.
      Parameters:
      rateControlMode - Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • scanType

      H265Settings.Builder scanType(String scanType)
      Sets the scan type of the output to progressive or top-field-first interlaced.
      Parameters:
      scanType - Sets the scan type of the output to progressive or top-field-first interlaced.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • scanType

      H265Settings.Builder scanType(H265ScanType scanType)
      Sets the scan type of the output to progressive or top-field-first interlaced.
      Parameters:
      scanType - Sets the scan type of the output to progressive or top-field-first interlaced.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • sceneChangeDetect

      H265Settings.Builder sceneChangeDetect(String sceneChangeDetect)
      Scene change detection.
      Parameters:
      sceneChangeDetect - Scene change detection.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • sceneChangeDetect

      H265Settings.Builder sceneChangeDetect(H265SceneChangeDetect sceneChangeDetect)
      Scene change detection.
      Parameters:
      sceneChangeDetect - Scene change detection.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • slices

      H265Settings.Builder slices(Integer slices)
      Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures. This field is optional; when no value is specified the encoder will choose the number of slices based on encode resolution.
      Parameters:
      slices - Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures. This field is optional; when no value is specified the encoder will choose the number of slices based on encode resolution.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • tier

      H265Settings.Builder tier(String tier)
      H.265 Tier.
      Parameters:
      tier - H.265 Tier.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • tier

      H265Settings.Builder tier(H265Tier tier)
      H.265 Tier.
      Parameters:
      tier - H.265 Tier.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • timecodeInsertion

      H265Settings.Builder timecodeInsertion(String timecodeInsertion)
      Determines how timecodes should be inserted into the video elementary stream. - 'disabled': Do not include timecodes - 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config
      Parameters:
      timecodeInsertion - Determines how timecodes should be inserted into the video elementary stream. - 'disabled': Do not include timecodes - 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • timecodeInsertion

      H265Settings.Builder timecodeInsertion(H265TimecodeInsertionBehavior timecodeInsertion)
      Determines how timecodes should be inserted into the video elementary stream. - 'disabled': Do not include timecodes - 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config
      Parameters:
      timecodeInsertion - Determines how timecodes should be inserted into the video elementary stream. - 'disabled': Do not include timecodes - 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • timecodeBurninSettings

      H265Settings.Builder timecodeBurninSettings(TimecodeBurninSettings timecodeBurninSettings)
      Timecode burn-in settings
      Parameters:
      timecodeBurninSettings - Timecode burn-in settings
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • timecodeBurninSettings

      default H265Settings.Builder timecodeBurninSettings(Consumer<TimecodeBurninSettings.Builder> timecodeBurninSettings)
      Timecode burn-in settings This is a convenience method that creates an instance of the TimecodeBurninSettings.Builder avoiding the need to create one manually via TimecodeBurninSettings.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to timecodeBurninSettings(TimecodeBurninSettings).

      Parameters:
      timecodeBurninSettings - a consumer that will call methods on TimecodeBurninSettings.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also: