Skip to content
v2.273.0

Experimental

@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

H265SettingsProps Struct ​

Properties for H.265 codec settings.

Example ​

ts
// H.264
const h264 = medialive.EncodeConfiguration.video({
  name: 'h264_720p',
  codec: medialive.VideoCodecSettings.h264({
    rateControl: medialive.H264RateControl.cbr({ bitrate: Bitrate.mbps(3) }),
    framerate: medialive.Framerate.FPS_30,
    profile: medialive.H264Profile.HIGH,
  }),
  width: 1280,
  height: 720,
});

// H.265
const h265 = medialive.EncodeConfiguration.video({
  name: 'h265_1080p',
  codec: medialive.VideoCodecSettings.h265({
    rateControl: medialive.H265RateControl.qvbr({
      maxBitrate: Bitrate.mbps(5),
      qvbrQualityLevel: 7,
    }),
    framerate: medialive.Framerate.FPS_30,
    profile: medialive.H265Profile.MAIN,
    tier: medialive.H265Tier.HIGH,
  }),
  width: 1920,
  height: 1080,
});

Properties ​

adaptiveQuantizationH265AdaptiveQuantizationadaptive_quantizationH265AdaptiveQuantizationadaptiveQuantizationH265AdaptiveQuantizationAdaptiveQuantizationH265AdaptiveQuantizationAdaptiveQuantizationH265AdaptiveQuantization= H265AdaptiveQuantization.AUTO#
The adaptive quantization.

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

afdSignalingAfdSignalingafd_signalingAfdSignalingafdSignalingAfdSignalingAfdSignalingAfdSignalingAfdSignalingAfdSignaling= AfdSignaling.NONE#
AFD signaling mode.
alternativeTransferFunctionH265AlternativeTransferFunctionalternative_transfer_functionH265AlternativeTransferFunctionalternativeTransferFunctionH265AlternativeTransferFunctionAlternativeTransferFunctionH265AlternativeTransferFunctionAlternativeTransferFunctionH265AlternativeTransferFunction= service default#
Whether to insert an Alternative Transfer Function SEI message for backwards compatibility with non-HDR decoders.
bufSizenumberbuf_sizeint | floatbufSizeNumberBufSizedoubleBufSize*float64= service default#
Size of buffer (HRD buffer model) in bits.
colorMetadataColorMetadatacolor_metadataColorMetadatacolorMetadataColorMetadataColorMetadataColorMetadataColorMetadataColorMetadata= service default#
Whether to include color space metadata in the output.
colorSpaceSettingsH265ColorSpaceSettingscolor_space_settingsH265ColorSpaceSettingscolorSpaceSettingsH265ColorSpaceSettingsColorSpaceSettingsH265ColorSpaceSettingsColorSpaceSettingsH265ColorSpaceSettings= service default#
Color space settings for the video.
deblockingH265DeblockingdeblockingH265DeblockingdeblockingH265DeblockingDeblockingH265DeblockingDeblockingH265Deblocking= service default#
Deblocking filter control.
filterSettingsH265FilterSettingsfilter_settingsH265FilterSettingsfilterSettingsH265FilterSettingsFilterSettingsH265FilterSettingsFilterSettingsH265FilterSettings= service default#
Optional video filter settings.
fixedAfdstringfixed_afdstrfixedAfdStringFixedAfdstringFixedAfd*string= service default#
Four-bit AFD value to write on all frames. Only valid when afdSignaling is FIXED.

Valid values: FIXED_0000, FIXED_0010, FIXED_0011, FIXED_0100, FIXED_1000, FIXED_1001, FIXED_1010, FIXED_1011, FIXED_1100, FIXED_1101, FIXED_1110, FIXED_1111.

flickerAqFlickerAqflicker_aqFlickerAqflickerAqFlickerAqFlickerAqFlickerAqFlickerAqFlickerAq= service default#
If enabled, adjusts quantization within each frame to reduce flicker on I-frames.
framerateFramerateframerateFramerateframerateFramerateFramerateFramerateFramerateFrameraterequired#
The video frame rate.

Required for H.265.

gopBReferenceGopBReferencegop_b_referenceGopBReferencegopBReferenceGopBReferenceGopBReferenceGopBReferenceGopBReferenceGopBReference= service default#
If enabled, uses reference B frames for GOP structures that have B frames > 1.
gopClosedCadencenumbergop_closed_cadenceint | floatgopClosedCadenceNumberGopClosedCadencedoubleGopClosedCadence*float64= service default#
Frequency of closed GOPs.

Set to 1 for streaming so decoders joining mid-stream get an IDR frame quickly.

gopNumBFramesnumbergop_num_b_framesint | floatgopNumBFramesNumberGopNumBFramesdoubleGopNumBFrames*float64= service default#
Number of B-frames between reference frames.
gopSizeGopSizegop_sizeGopSizegopSizeGopSizeGopSizeGopSizeGopSizeGopSize= GopSize.seconds(1)#
The GOP size (keyframe interval).
levelH265LevellevelH265LevellevelH265LevelLevelH265LevelLevelH265Level= service default (auto)#
The H.265 level.

Valid values: H265_LEVEL_1, H265_LEVEL_2, H265_LEVEL_2_1, H265_LEVEL_3, H265_LEVEL_3_1, H265_LEVEL_4, H265_LEVEL_4_1, H265_LEVEL_5, H265_LEVEL_5_1, H265_LEVEL_5_2, H265_LEVEL_6, H265_LEVEL_6_1, H265_LEVEL_6_2, H265_LEVEL_AUTO.

lookAheadRateControlLookAheadRateControllook_ahead_rate_controlLookAheadRateControllookAheadRateControlLookAheadRateControlLookAheadRateControlLookAheadRateControlLookAheadRateControlLookAheadRateControl= service default#
Amount of lookahead.

Low decreases latency/memory; high can produce better quality.

minBitratenumbermin_bitrateint | floatminBitrateNumberMinBitratedoubleMinBitrate*float64= service default#
Minimum bitrate in bits/second.
minIIntervalnumbermin_i_intervalint | floatminIIntervalNumberMinIIntervaldoubleMinIInterval*float64= service default#
Only meaningful if sceneChangeDetect is enabled.

Enforces separation between repeated (cadence) I-frames and I-frames inserted by scene change detection.

minQpnumbermin_qpint | floatminQpNumberMinQpdoubleMinQp*float64= service default#
Minimum QP value.
mvOverPictureBoundariesH265MvOverPictureBoundariesmv_over_picture_boundariesH265MvOverPictureBoundariesmvOverPictureBoundariesH265MvOverPictureBoundariesMvOverPictureBoundariesH265MvOverPictureBoundariesMvOverPictureBoundariesH265MvOverPictureBoundaries= service default#
Whether motion vectors can cross picture boundaries.
mvTemporalPredictorH265MvTemporalPredictormv_temporal_predictorH265MvTemporalPredictormvTemporalPredictorH265MvTemporalPredictorMvTemporalPredictorH265MvTemporalPredictorMvTemporalPredictorH265MvTemporalPredictor= service default#
Whether to use temporal motion vector prediction.
pixelAspectRatioPixelAspectRatiopixel_aspect_ratioPixelAspectRatiopixelAspectRatioPixelAspectRatioPixelAspectRatioPixelAspectRatioPixelAspectRatioPixelAspectRatio= square pixels#
The pixel aspect ratio (PAR) of the video.
profileH265ProfileprofileH265ProfileprofileH265ProfileProfileH265ProfileProfileH265Profile= H265Profile.MAIN#
The H.265 profile.
rateControlH265RateControlrate_controlH265RateControlrateControlH265RateControlRateControlH265RateControlRateControlH265RateControl= CBR with no bitrate (service def…#
The rate control configuration.
default

Default: CBR with no bitrate (service default)

scanTypeScanTypescan_typeScanTypescanTypeScanTypeScanTypeScanTypeScanTypeScanType= ScanType.PROGRESSIVE#
Sets the scan type of the output.
sceneChangeDetectH265SceneChangeDetectscene_change_detectH265SceneChangeDetectsceneChangeDetectH265SceneChangeDetectSceneChangeDetectH265SceneChangeDetectSceneChangeDetectH265SceneChangeDetect= H265SceneChangeDetect.ENABLED#
Whether scene change detection inserts I-frames on scene changes.
slicesnumberslicesint | floatslicesNumberSlicesdoubleSlices*float64= encoder chooses based on resolut…#
Number of slices per picture.
default

Default: encoder chooses based on resolution

subgopLengthSubgopLengthsubgop_lengthSubgopLengthsubgopLengthSubgopLengthSubgopLengthSubgopLengthSubgopLengthSubgopLength= service default#
Sub-GOP length mode.
tierH265TiertierH265TiertierH265TierTierH265TierTierH265Tier= H265Tier.MAIN#
The H.265 tier.
tileHeightnumbertile_heightint | floattileHeightNumberTileHeightdoubleTileHeight*float64= service default#
Tile height in pixels.

Must be a multiple of the CTU size.

tilePaddingH265TilePaddingtile_paddingH265TilePaddingtilePaddingH265TilePaddingTilePaddingH265TilePaddingTilePaddingH265TilePadding= service default#
Tile padding mode.
tileWidthnumbertile_widthint | floattileWidthNumberTileWidthdoubleTileWidth*float64= service default#
Tile width in pixels.

Must be a multiple of the CTU size.

timecodeBurninTimecodeBurninSettingstimecode_burninTimecodeBurninSettingstimecodeBurninTimecodeBurninSettingsTimecodeBurninTimecodeBurninSettingsTimecodeBurninTimecodeBurninSettings= no timecode burn-in#
Timecode burn-in settings to overlay timecode on the video.
timecodeInsertionTimecodeInsertiontimecode_insertionTimecodeInsertiontimecodeInsertionTimecodeInsertionTimecodeInsertionTimecodeInsertionTimecodeInsertionTimecodeInsertion= service default#
Determines how timecodes are inserted into the video elementary stream.

This controls insertion into the output elementary stream. The channel's timecodeConfig controls the source of the timecode used for output.

treeblockSizeH265TreeblockSizetreeblock_sizeH265TreeblockSizetreeblockSizeH265TreeblockSizeTreeblockSizeH265TreeblockSizeTreeblockSizeH265TreeblockSize= service default#
Treeblock size for the encoder.