Skip to content

Mpeg2Settings

Source code in docs_src/capo_medialive/types/mpeg2_settings.py
class Mpeg2Settings(TypedDict, closed=True):
    adaptive_quantization: NotRequired[
        "capo_medialive.types.mpeg2_adaptive_quantization.Mpeg2AdaptiveQuantization"
    ]
    """Choose Off to disable adaptive quantization. Or choose another value to enable the quantizer and set its strength. The strengths are: Auto, Off, Low, Medium, High. When you enable this field, MediaLive allows intra-frame quantizers to vary, which might improve visual quality."""
    afd_signaling: NotRequired["capo_medialive.types.afd_signaling.AfdSignaling"]
    """Indicates the AFD values that MediaLive will write into the video encode. If you do not know what AFD signaling is, or if your downstream system has not given you guidance, choose AUTO. AUTO: MediaLive will try to preserve the input AFD value (in cases where multiple AFD values are valid). FIXED: MediaLive will use the value you specify in fixedAFD."""
    color_metadata: NotRequired[
        "capo_medialive.types.mpeg2_color_metadata.Mpeg2ColorMetadata"
    ]
    """Specifies whether to include the color space metadata. The metadata describes the color space that applies to the video (the colorSpace field). We recommend that you insert the metadata."""
    color_space: NotRequired["capo_medialive.types.mpeg2_color_space.Mpeg2ColorSpace"]
    r"""Choose the type of color space conversion to apply to the output. For detailed information on setting up both the input and the output to obtain the desired color space in the output, see the section on \"MediaLive Features - Video - color space\" in the MediaLive User Guide. PASSTHROUGH: Keep the color space of the input content - do not convert it. AUTO:Convert all content that is SD to rec 601, and convert all content that is HD to rec 709."""
    display_aspect_ratio: NotRequired[
        "capo_medialive.types.mpeg2_display_ratio.Mpeg2DisplayRatio"
    ]
    """Sets the pixel aspect ratio for the encode."""
    filter_settings: NotRequired[
        "capo_medialive.types.mpeg2_filter_settings.Mpeg2FilterSettings"
    ]
    """Optionally specify a noise reduction filter, which can improve quality of compressed content. If you do not choose a filter, no filter will be applied. TEMPORAL: This filter is useful for both source content that is noisy (when it has excessive digital artifacts) and source content that is clean. When the content is noisy, the filter cleans up the source content before the encoding phase, with these two effects: First, it improves the output video quality because the content has been cleaned up. Secondly, it decreases the bandwidth because MediaLive does not waste bits on encoding noise. When the content is reasonably clean, the filter tends to decrease the bitrate."""
    fixed_afd: NotRequired["capo_medialive.types.fixed_afd.FixedAfd"]
    """Complete this field only when afdSignaling is set to FIXED. Enter the AFD value (4 bits) to write on all frames of the video encode."""
    framerate_denominator: NotRequired[
        "capo_medialive.types.__integer_min1.__integerMin1"
    ]
    """description": "The framerate denominator. For example, 1001. The framerate is the numerator divided by the denominator. For example, 24000 / 1001 = 23.976 FPS."""
    framerate_numerator: NotRequired[
        "capo_medialive.types.__integer_min1.__integerMin1"
    ]
    """The framerate numerator. For example, 24000. The framerate is the numerator divided by the denominator. For example, 24000 / 1001 = 23.976 FPS."""
    gop_closed_cadence: NotRequired["capo_medialive.types.__integer_min0.__integerMin0"]
    """MPEG2: default is open GOP."""
    gop_num_b_frames: NotRequired[
        "capo_medialive.types.__integer_min0_max7.__integerMin0Max7"
    ]
    """Relates to the GOP structure. The number of B-frames between reference frames. If you do not know what a B-frame is, use the default."""
    gop_size: NotRequired["capo_medialive.types.__double.__double"]
    """Relates to the GOP structure. The GOP size (keyframe interval) in the units specified in gopSizeUnits. If you do not know what GOP is, use the default. If gopSizeUnits is frames, then the gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, the gopSize must be greater than 0, but does not need to be an integer."""
    gop_size_units: NotRequired[
        "capo_medialive.types.mpeg2_gop_size_units.Mpeg2GopSizeUnits"
    ]
    """Relates to the GOP structure. Specifies whether the gopSize is specified in frames or seconds. If you do not plan to change the default gopSize, leave the default. If you specify SECONDS, MediaLive will internally convert the gop size to a frame count."""
    scan_type: NotRequired["capo_medialive.types.mpeg2_scan_type.Mpeg2ScanType"]
    """Set the scan type of the output to PROGRESSIVE or INTERLACED (top field first)."""
    subgop_length: NotRequired[
        "capo_medialive.types.mpeg2_sub_gop_length.Mpeg2SubGopLength"
    ]
    """Relates to the GOP structure. If you do not know what GOP is, use the default. FIXED: Set the number of B-frames in each sub-GOP to the value in gopNumBFrames. DYNAMIC: Let MediaLive optimize the number of B-frames in each sub-GOP, to improve visual quality."""
    timecode_insertion: NotRequired[
        "capo_medialive.types.mpeg2_timecode_insertion_behavior.Mpeg2TimecodeInsertionBehavior"
    ]
    r"""Determines how MediaLive inserts timecodes in the output video. For detailed information about setting up the input and the output for a timecode, see the section on \"MediaLive Features - Timecode configuration\" in the MediaLive User Guide. DISABLED: do not include timecodes. GOP_TIMECODE: Include timecode metadata in the GOP header."""
    timecode_burnin_settings: NotRequired[
        "capo_medialive.types.timecode_burnin_settings.TimecodeBurninSettings"
    ]
    """Timecode burn-in settings"""

adaptive_quantization instance-attribute

adaptive_quantization: NotRequired[Mpeg2AdaptiveQuantization]

Choose Off to disable adaptive quantization. Or choose another value to enable the quantizer and set its strength. The strengths are: Auto, Off, Low, Medium, High. When you enable this field, MediaLive allows intra-frame quantizers to vary, which might improve visual quality.

afd_signaling instance-attribute

afd_signaling: NotRequired[AfdSignaling]

Indicates the AFD values that MediaLive will write into the video encode. If you do not know what AFD signaling is, or if your downstream system has not given you guidance, choose AUTO. AUTO: MediaLive will try to preserve the input AFD value (in cases where multiple AFD values are valid). FIXED: MediaLive will use the value you specify in fixedAFD.

color_metadata instance-attribute

color_metadata: NotRequired[Mpeg2ColorMetadata]

Specifies whether to include the color space metadata. The metadata describes the color space that applies to the video (the colorSpace field). We recommend that you insert the metadata.

color_space instance-attribute

color_space: NotRequired[Mpeg2ColorSpace]

Choose the type of color space conversion to apply to the output. For detailed information on setting up both the input and the output to obtain the desired color space in the output, see the section on \"MediaLive Features - Video - color space\" in the MediaLive User Guide. PASSTHROUGH: Keep the color space of the input content - do not convert it. AUTO:Convert all content that is SD to rec 601, and convert all content that is HD to rec 709.

display_aspect_ratio instance-attribute

display_aspect_ratio: NotRequired[Mpeg2DisplayRatio]

Sets the pixel aspect ratio for the encode.

filter_settings instance-attribute

filter_settings: NotRequired[Mpeg2FilterSettings]

Optionally specify a noise reduction filter, which can improve quality of compressed content. If you do not choose a filter, no filter will be applied. TEMPORAL: This filter is useful for both source content that is noisy (when it has excessive digital artifacts) and source content that is clean. When the content is noisy, the filter cleans up the source content before the encoding phase, with these two effects: First, it improves the output video quality because the content has been cleaned up. Secondly, it decreases the bandwidth because MediaLive does not waste bits on encoding noise. When the content is reasonably clean, the filter tends to decrease the bitrate.

fixed_afd instance-attribute

fixed_afd: NotRequired[FixedAfd]

Complete this field only when afdSignaling is set to FIXED. Enter the AFD value (4 bits) to write on all frames of the video encode.

framerate_denominator instance-attribute

framerate_denominator: NotRequired[__integerMin1]

description": "The framerate denominator. For example, 1001. The framerate is the numerator divided by the denominator. For example, 24000 / 1001 = 23.976 FPS.

framerate_numerator instance-attribute

framerate_numerator: NotRequired[__integerMin1]

The framerate numerator. For example, 24000. The framerate is the numerator divided by the denominator. For example, 24000 / 1001 = 23.976 FPS.

gop_closed_cadence instance-attribute

gop_closed_cadence: NotRequired[__integerMin0]

MPEG2: default is open GOP.

gop_num_b_frames instance-attribute

gop_num_b_frames: NotRequired[__integerMin0Max7]

Relates to the GOP structure. The number of B-frames between reference frames. If you do not know what a B-frame is, use the default.

gop_size instance-attribute

gop_size: NotRequired[__double]

Relates to the GOP structure. The GOP size (keyframe interval) in the units specified in gopSizeUnits. If you do not know what GOP is, use the default. If gopSizeUnits is frames, then the gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, the gopSize must be greater than 0, but does not need to be an integer.

gop_size_units instance-attribute

gop_size_units: NotRequired[Mpeg2GopSizeUnits]

Relates to the GOP structure. Specifies whether the gopSize is specified in frames or seconds. If you do not plan to change the default gopSize, leave the default. If you specify SECONDS, MediaLive will internally convert the gop size to a frame count.

scan_type instance-attribute

scan_type: NotRequired[Mpeg2ScanType]

Set the scan type of the output to PROGRESSIVE or INTERLACED (top field first).

subgop_length instance-attribute

subgop_length: NotRequired[Mpeg2SubGopLength]

Relates to the GOP structure. If you do not know what GOP is, use the default. FIXED: Set the number of B-frames in each sub-GOP to the value in gopNumBFrames. DYNAMIC: Let MediaLive optimize the number of B-frames in each sub-GOP, to improve visual quality.

timecode_burnin_settings instance-attribute

timecode_burnin_settings: NotRequired[TimecodeBurninSettings]

Timecode burn-in settings

timecode_insertion instance-attribute

timecode_insertion: NotRequired[Mpeg2TimecodeInsertionBehavior]

Determines how MediaLive inserts timecodes in the output video. For detailed information about setting up the input and the output for a timecode, see the section on \"MediaLive Features - Timecode configuration\" in the MediaLive User Guide. DISABLED: do not include timecodes. GOP_TIMECODE: Include timecode metadata in the GOP header.