aws-cdk-lib.aws_medialive.CfnChannel.H265SettingsProperty

H265SettingsProperty Struct

H265 Settings.

The parent of this entity is VideoCodecSettings.

Source

Generated code

Type last changed

v2.220.0 · 14 Oct 2025

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_medialive as medialive } from 'aws-cdk-lib';

declare const hlg2020Settings: any;
const h265SettingsProperty: medialive.CfnChannel.H265SettingsProperty = {
  adaptiveQuantization: 'adaptiveQuantization',
  afdSignaling: 'afdSignaling',
  alternativeTransferFunction: 'alternativeTransferFunction',
  bitrate: 123,
  bufSize: 123,
  colorMetadata: 'colorMetadata',
  colorSpaceSettings: {
    colorSpacePassthroughSettings: { },
    dolbyVision81Settings: { },
    hdr10Settings: {
      maxCll: 123,
      maxFall: 123,
    },
    hlg2020Settings: hlg2020Settings,
    rec601Settings: { },
    rec709Settings: { },
  },
  deblocking: 'deblocking',
  filterSettings: {
    bandwidthReductionFilterSettings: {
      postFilterSharpening: 'postFilterSharpening',
      strength: 'strength',
    },
    temporalFilterSettings: {
      postFilterSharpening: 'postFilterSharpening',
      strength: 'strength',
    },
  },
  fixedAfd: 'fixedAfd',
  flickerAq: 'flickerAq',
  framerateDenominator: 123,
  framerateNumerator: 123,
  gopBReference: 'gopBReference',
  gopClosedCadence: 123,
  gopNumBFrames: 123,
  gopSize: 123,
  gopSizeUnits: 'gopSizeUnits',
  level: 'level',
  lookAheadRateControl: 'lookAheadRateControl',
  maxBitrate: 123,
  minBitrate: 123,
  minIInterval: 123,
  minQp: 123,
  mvOverPictureBoundaries: 'mvOverPictureBoundaries',
  mvTemporalPredictor: 'mvTemporalPredictor',
  parDenominator: 123,
  parNumerator: 123,
  profile: 'profile',
  qvbrQualityLevel: 123,
  rateControlMode: 'rateControlMode',
  scanType: 'scanType',
  sceneChangeDetect: 'sceneChangeDetect',
  slices: 123,
  subgopLength: 'subgopLength',
  tier: 'tier',
  tileHeight: 123,
  tilePadding: 'tilePadding',
  tileWidth: 123,
  timecodeBurninSettings: {
    fontSize: 'fontSize',
    position: 'position',
    prefix: 'prefix',
  },
  timecodeInsertion: 'timecodeInsertion',
  treeblockSize: 'treeblockSize',
};

Properties

adaptiveQuantization?optionalstringadaptive_quantization?optionalstradaptiveQuantization?optionalStringAdaptiveQuantization?optionalstringAdaptiveQuantization?optional*string#

Adaptive quantization.

Allows intra-frame quantizers to vary to improve visual quality.

afdSignaling?optionalstringafd_signaling?optionalstrafdSignaling?optionalStringAfdSignaling?optionalstringAfdSignaling?optional*string#

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.

alternativeTransferFunction?optionalstringalternative_transfer_function?optionalstralternativeTransferFunction?optionalStringAlternativeTransferFunction?optionalstringAlternativeTransferFunction?optional*string#

Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.

bitrate?optionalnumberbitrate?optionalint | floatbitrate?optionalNumberBitrate?optionaldoubleBitrate?optional*float64#

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.

bufSize?optionalnumberbuf_size?optionalint | floatbufSize?optionalNumberBufSize?optionaldoubleBufSize?optional*float64#

Size of buffer (HRD buffer model) in bits.

colorMetadata?optionalstringcolor_metadata?optionalstrcolorMetadata?optionalStringColorMetadata?optionalstringColorMetadata?optional*string#

Includes colorspace metadata in the output.

colorSpaceSettings?optionalIResolvable | CfnChannel.H265ColorSpaceSettingsPropertycolor_space_settings?optionaltyping.Union[IResolvable, H265ColorSpaceSettingsProperty]colorSpaceSettings?optionalIResolvableColorSpaceSettings?optionalIResolvableColorSpaceSettings?optionalinterface{}#

Color Space settings.

deblocking?optionalstringdeblocking?optionalstrdeblocking?optionalStringDeblocking?optionalstringDeblocking?optional*string#

filterSettings?optionalIResolvable | CfnChannel.H265FilterSettingsPropertyfilter_settings?optionaltyping.Union[IResolvable, H265FilterSettingsProperty]filterSettings?optionalIResolvableFilterSettings?optionalIResolvableFilterSettings?optionalinterface{}#

Optional filters that you can apply to an encode.

fixedAfd?optionalstringfixed_afd?optionalstrfixedAfd?optionalStringFixedAfd?optionalstringFixedAfd?optional*string#

Four bit AFD value to write on all frames of video in the output stream.

Only valid when afdSignaling is set to 'Fixed'.

flickerAq?optionalstringflicker_aq?optionalstrflickerAq?optionalStringFlickerAq?optionalstringFlickerAq?optional*string#

If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.

framerateDenominator?optionalnumberframerate_denominator?optionalint | floatframerateDenominator?optionalNumberFramerateDenominator?optionaldoubleFramerateDenominator?optional*float64#

Framerate denominator.

framerateNumerator?optionalnumberframerate_numerator?optionalint | floatframerateNumerator?optionalNumberFramerateNumerator?optionaldoubleFramerateNumerator?optional*float64#

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

gopBReference?optionalstringgop_b_reference?optionalstrgopBReference?optionalStringGopBReference?optionalstringGopBReference?optional*string#

gopClosedCadence?optionalnumbergop_closed_cadence?optionalint | floatgopClosedCadence?optionalNumberGopClosedCadence?optionaldoubleGopClosedCadence?optional*float64#

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.

gopNumBFrames?optionalnumbergop_num_b_frames?optionalint | floatgopNumBFrames?optionalNumberGopNumBFrames?optionaldoubleGopNumBFrames?optional*float64#

gopSize?optionalnumbergop_size?optionalint | floatgopSize?optionalNumberGopSize?optionaldoubleGopSize?optional*float64#

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.

gopSizeUnits?optionalstringgop_size_units?optionalstrgopSizeUnits?optionalStringGopSizeUnits?optionalstringGopSizeUnits?optional*string#

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.

level?optionalstringlevel?optionalstrlevel?optionalStringLevel?optionalstringLevel?optional*string#

H.265 Level.

lookAheadRateControl?optionalstringlook_ahead_rate_control?optionalstrlookAheadRateControl?optionalStringLookAheadRateControl?optionalstringLookAheadRateControl?optional*string#

Amount of lookahead.

A value of low can decrease latency and memory usage, while high can produce better quality for certain content.

maxBitrate?optionalnumbermax_bitrate?optionalint | floatmaxBitrate?optionalNumberMaxBitrate?optionaldoubleMaxBitrate?optional*float64#

For QVBR: See the tooltip for Quality level.

minBitrate?optionalnumbermin_bitrate?optionalint | floatminBitrate?optionalNumberMinBitrate?optionaldoubleMinBitrate?optional*float64#

minIInterval?optionalnumbermin_i_interval?optionalint | floatminIInterval?optionalNumberMinIInterval?optionaldoubleMinIInterval?optional*float64#

Only meaningful if sceneChangeDetect is set to enabled.

notes

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

minQp?optionalnumbermin_qp?optionalint | floatminQp?optionalNumberMinQp?optionaldoubleMinQp?optional*float64#

mvOverPictureBoundaries?optionalstringmv_over_picture_boundaries?optionalstrmvOverPictureBoundaries?optionalStringMvOverPictureBoundaries?optionalstringMvOverPictureBoundaries?optional*string#

mvTemporalPredictor?optionalstringmv_temporal_predictor?optionalstrmvTemporalPredictor?optionalStringMvTemporalPredictor?optionalstringMvTemporalPredictor?optional*string#

parDenominator?optionalnumberpar_denominator?optionalint | floatparDenominator?optionalNumberParDenominator?optionaldoubleParDenominator?optional*float64#

Pixel Aspect Ratio denominator.

parNumerator?optionalnumberpar_numerator?optionalint | floatparNumerator?optionalNumberParNumerator?optionaldoubleParNumerator?optional*float64#

Pixel Aspect Ratio numerator.

profile?optionalstringprofile?optionalstrprofile?optionalStringProfile?optionalstringProfile?optional*string#

H.265 Profile.

qvbrQualityLevel?optionalnumberqvbr_quality_level?optionalint | floatqvbrQualityLevel?optionalNumberQvbrQualityLevel?optionaldoubleQvbrQualityLevel?optional*float64#

Controls the target quality for the video encode.

notes

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

rateControlMode?optionalstringrate_control_mode?optionalstrrateControlMode?optionalStringRateControlMode?optionalstringRateControlMode?optional*string#

Rate control mode.

notes

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.

scanType?optionalstringscan_type?optionalstrscanType?optionalStringScanType?optionalstringScanType?optional*string#

Sets the scan type of the output to progressive or top-field-first interlaced.

sceneChangeDetect?optionalstringscene_change_detect?optionalstrsceneChangeDetect?optionalStringSceneChangeDetect?optionalstringSceneChangeDetect?optional*string#

Scene change detection.

slices?optionalnumberslices?optionalint | floatslices?optionalNumberSlices?optionaldoubleSlices?optional*float64#

Number of slices per picture.

notes

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.

subgopLength?optionalstringsubgop_length?optionalstrsubgopLength?optionalStringSubgopLength?optionalstringSubgopLength?optional*string#

tier?optionalstringtier?optionalstrtier?optionalStringTier?optionalstringTier?optional*string#

H.265 Tier.

tileHeight?optionalnumbertile_height?optionalint | floattileHeight?optionalNumberTileHeight?optionaldoubleTileHeight?optional*float64#

tilePadding?optionalstringtile_padding?optionalstrtilePadding?optionalStringTilePadding?optionalstringTilePadding?optional*string#

tileWidth?optionalnumbertile_width?optionalint | floattileWidth?optionalNumberTileWidth?optionaldoubleTileWidth?optional*float64#

timecodeBurninSettings?optionalIResolvable | CfnChannel.TimecodeBurninSettingsPropertytimecode_burnin_settings?optionaltyping.Union[IResolvable, TimecodeBurninSettingsProperty]timecodeBurninSettings?optionalIResolvableTimecodeBurninSettings?optionalIResolvableTimecodeBurninSettings?optionalinterface{}#

timecodeInsertion?optionalstringtimecode_insertion?optionalstrtimecodeInsertion?optionalStringTimecodeInsertion?optionalstringTimecodeInsertion?optional*string#

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

treeblockSize?optionalstringtreeblock_size?optionalstrtreeblockSize?optionalStringTreeblockSize?optionalstringTreeblockSize?optional*string#