H265SettingsProps

class aws_cdk.aws_medialive_alpha.H265SettingsProps(*, framerate, adaptive_quantization=None, afd_signaling=None, alternative_transfer_function=None, buf_size=None, color_metadata=None, color_space_settings=None, deblocking=None, filter_settings=None, fixed_afd=None, flicker_aq=None, gop_b_reference=None, gop_closed_cadence=None, gop_num_b_frames=None, gop_size=None, level=None, look_ahead_rate_control=None, min_bitrate=None, min_i_interval=None, min_qp=None, mv_over_picture_boundaries=None, mv_temporal_predictor=None, pixel_aspect_ratio=None, profile=None, rate_control=None, scan_type=None, scene_change_detect=None, slices=None, subgop_length=None, tier=None, tile_height=None, tile_padding=None, tile_width=None, timecode_burnin=None, timecode_insertion=None, treeblock_size=None)

Bases: object

(experimental) Properties for H.265 codec settings.

Parameters:

framerate (Framerate) – (experimental) The video frame rate. Required for H.265.
adaptive_quantization (Optional[H265AdaptiveQuantization]) – (experimental) The adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Default: H265AdaptiveQuantization.AUTO
afd_signaling (Optional[AfdSignaling]) – (experimental) AFD signaling mode. Default: AfdSignaling.NONE
alternative_transfer_function (Optional[H265AlternativeTransferFunction]) – (experimental) Whether to insert an Alternative Transfer Function SEI message for backwards compatibility with non-HDR decoders. Default: - service default
buf_size (Union[int, float, None]) – (experimental) Size of buffer (HRD buffer model) in bits. Default: - service default
color_metadata (Optional[ColorMetadata]) – (experimental) Whether to include color space metadata in the output. Default: - service default
color_space_settings (Optional[H265ColorSpaceSettings]) – (experimental) Color space settings for the video. Default: - service default
deblocking (Optional[H265Deblocking]) – (experimental) Deblocking filter control. Default: - service default
filter_settings (Optional[H265FilterSettings]) – (experimental) Optional video filter settings. Default: - service default
fixed_afd (Optional[str]) – (experimental) 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. Default: - service default
flicker_aq (Optional[FlickerAq]) – (experimental) If enabled, adjusts quantization within each frame to reduce flicker on I-frames. Default: - service default
gop_b_reference (Optional[GopBReference]) – (experimental) If enabled, uses reference B frames for GOP structures that have B frames > 1. Default: - service default
gop_closed_cadence (Union[int, float, None]) – (experimental) Frequency of closed GOPs. Set to 1 for streaming so decoders joining mid-stream get an IDR frame quickly. Default: - service default
gop_num_b_frames (Union[int, float, None]) – (experimental) Number of B-frames between reference frames. Default: - service default
gop_size (Optional[GopSize]) – (experimental) The GOP size (keyframe interval). Default: GopSize.seconds(1)
level (Optional[H265Level]) – (experimental) 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. Default: - service default (auto)
look_ahead_rate_control (Optional[LookAheadRateControl]) – (experimental) Amount of lookahead. Low decreases latency/memory; high can produce better quality. Default: - service default
min_bitrate (Union[int, float, None]) – (experimental) Minimum bitrate in bits/second. Default: - service default
min_i_interval (Union[int, float, None]) – (experimental) Only meaningful if sceneChangeDetect is enabled. Enforces separation between repeated (cadence) I-frames and I-frames inserted by scene change detection. Default: - service default
min_qp (Union[int, float, None]) – (experimental) Minimum QP value. Default: - service default
mv_over_picture_boundaries (Optional[H265MvOverPictureBoundaries]) – (experimental) Whether motion vectors can cross picture boundaries. Default: - service default
mv_temporal_predictor (Optional[H265MvTemporalPredictor]) – (experimental) Whether to use temporal motion vector prediction. Default: - service default
pixel_aspect_ratio (Optional[PixelAspectRatio]) – (experimental) The pixel aspect ratio (PAR) of the video. Default: - square pixels
profile (Optional[H265Profile]) – (experimental) The H.265 profile. Default: H265Profile.MAIN
rate_control (Optional[H265RateControl]) – (experimental) The rate control configuration. Default: - CBR with no bitrate (service default)
scan_type (Optional[ScanType]) – (experimental) Sets the scan type of the output. Default: ScanType.PROGRESSIVE
scene_change_detect (Optional[H265SceneChangeDetect]) – (experimental) Whether scene change detection inserts I-frames on scene changes. Default: H265SceneChangeDetect.ENABLED
slices (Union[int, float, None]) – (experimental) Number of slices per picture. Default: - encoder chooses based on resolution
subgop_length (Optional[SubgopLength]) – (experimental) Sub-GOP length mode. Default: - service default
tier (Optional[H265Tier]) – (experimental) The H.265 tier. Default: H265Tier.MAIN
tile_height (Union[int, float, None]) – (experimental) Tile height in pixels. Must be a multiple of the CTU size. Default: - service default
tile_padding (Optional[H265TilePadding]) – (experimental) Tile padding mode. Default: - service default
tile_width (Union[int, float, None]) – (experimental) Tile width in pixels. Must be a multiple of the CTU size. Default: - service default
timecode_burnin (Union[TimecodeBurninSettings, Dict[str, Any], None]) – (experimental) Timecode burn-in settings to overlay timecode on the video. Default: - no timecode burn-in
timecode_insertion (Optional[TimecodeInsertion]) – (experimental) 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. Default: - service default
treeblock_size (Optional[H265TreeblockSize]) – (experimental) Treeblock size for the encoder. Default: - service default

Stability:

experimental

ExampleMetadata:

infused

Example:

# H.264
h264 = medialive.EncodeConfiguration.video(
    name="h264_720p",
    codec=medialive.VideoCodecSettings.h264(
        rate_control=medialive.H264RateControl.cbr(bitrate=Bitrate.mbps(3)),
        framerate=medialive.Framerate.FPS_30,
        profile=medialive.H264Profile.HIGH
    ),
    width=1280,
    height=720
)

# H.265
h265 = medialive.EncodeConfiguration.video(
    name="h265_1080p",
    codec=medialive.VideoCodecSettings.h265(
        rate_control=medialive.H265RateControl.qvbr(
            max_bitrate=Bitrate.mbps(5),
            qvbr_quality_level=7
        ),
        framerate=medialive.Framerate.FPS_30,
        profile=medialive.H265Profile.MAIN,
        tier=medialive.H265Tier.HIGH
    ),
    width=1920,
    height=1080
)

Attributes

adaptive_quantization

(experimental) The adaptive quantization.

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

Default:: H265AdaptiveQuantization.AUTO
Stability:: experimental

afd_signaling

(experimental) AFD signaling mode.

Default:: AfdSignaling.NONE
Stability:: experimental

alternative_transfer_function

(experimental) Whether to insert an Alternative Transfer Function SEI message for backwards compatibility with non-HDR decoders.

Default:

service default

Stability:

experimental

buf_size

(experimental) Size of buffer (HRD buffer model) in bits.

Default:

service default

Stability:

experimental

color_metadata

(experimental) Whether to include color space metadata in the output.

Default:

service default

Stability:

experimental

color_space_settings

(experimental) Color space settings for the video.

Default:

service default

Stability:

experimental

deblocking

(experimental) Deblocking filter control.

Default:

service default

Stability:

experimental

filter_settings

(experimental) Optional video filter settings.

Default:

service default

Stability:

experimental

fixed_afd

(experimental) 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.

Default:

service default

Stability:

experimental

flicker_aq

(experimental) If enabled, adjusts quantization within each frame to reduce flicker on I-frames.

Default:

service default

Stability:

experimental

framerate

(experimental) The video frame rate.

Required for H.265.

Stability:: experimental

gop_b_reference

(experimental) If enabled, uses reference B frames for GOP structures that have B frames > 1.

Default:

service default

Stability:

experimental

gop_closed_cadence

(experimental) Frequency of closed GOPs.

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

Default:

service default

Stability:

experimental

gop_num_b_frames

(experimental) Number of B-frames between reference frames.

Default:

service default

Stability:

experimental

gop_size

(experimental) The GOP size (keyframe interval).

Default:: GopSize.seconds(1)
Stability:: experimental

level

(experimental) 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.

Default:

service default (auto)

Stability:

experimental

look_ahead_rate_control

(experimental) Amount of lookahead.

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

Default:

service default

Stability:

experimental

min_bitrate

(experimental) Minimum bitrate in bits/second.

Default:

service default

Stability:

experimental

min_i_interval

(experimental) Only meaningful if sceneChangeDetect is enabled.

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

Default:

service default

Stability:

experimental

min_qp

(experimental) Minimum QP value.

Default:

service default

Stability:

experimental

mv_over_picture_boundaries

(experimental) Whether motion vectors can cross picture boundaries.

Default:

service default

Stability:

experimental

mv_temporal_predictor

(experimental) Whether to use temporal motion vector prediction.

Default:

service default

Stability:

experimental

pixel_aspect_ratio

(experimental) The pixel aspect ratio (PAR) of the video.

Default:

square pixels

Stability:

experimental

profile

(experimental) The H.265 profile.

Default:: H265Profile.MAIN
Stability:: experimental

rate_control

(experimental) The rate control configuration.

Default:

CBR with no bitrate (service default)

Stability:

experimental

scan_type

(experimental) Sets the scan type of the output.

Default:: ScanType.PROGRESSIVE
Stability:: experimental

scene_change_detect

(experimental) Whether scene change detection inserts I-frames on scene changes.

Default:: H265SceneChangeDetect.ENABLED
Stability:: experimental

slices

(experimental) Number of slices per picture.

Default:

encoder chooses based on resolution

Stability:

experimental

subgop_length

(experimental) Sub-GOP length mode.

Default:

service default

Stability:

experimental

tier

(experimental) The H.265 tier.

Default:: H265Tier.MAIN
Stability:: experimental

tile_height

(experimental) Tile height in pixels.

Must be a multiple of the CTU size.

Default:

service default

Stability:

experimental

tile_padding

(experimental) Tile padding mode.

Default:

service default

Stability:

experimental

tile_width

(experimental) Tile width in pixels.

Must be a multiple of the CTU size.

Default:

service default

Stability:

experimental

timecode_burnin

(experimental) Timecode burn-in settings to overlay timecode on the video.

Default:

no timecode burn-in

Stability:

experimental

timecode_insertion

(experimental) 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.

Default:

service default

Stability:

experimental

treeblock_size

(experimental) Treeblock size for the encoder.

Default:

service default

Stability:

experimental