/AWS1/CL_MDCVIDEODESCRIPTION¶
Settings related to video encoding of your output. The specific video settings depend on the video codec that you choose.
CONSTRUCTOR
¶
IMPORTING¶
Optional arguments:¶
IV_AFDSIGNALING
TYPE /AWS1/MDCAFDSIGNALING
/AWS1/MDCAFDSIGNALING
¶
This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.
IV_ANTIALIAS
TYPE /AWS1/MDCANTIALIAS
/AWS1/MDCANTIALIAS
¶
The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.
IO_CODECSETTINGS
TYPE REF TO /AWS1/CL_MDCVIDEOCODECSETTINGS
/AWS1/CL_MDCVIDEOCODECSETTINGS
¶
Video codec settings contains the group of settings related to video encoding. The settings in this group vary depending on the value that you choose for Video codec. For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AV1, Av1Settings * AVC_INTRA, AvcIntraSettings * FRAME_CAPTURE, FrameCaptureSettings * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * UNCOMPRESSED, UncompressedSettings * VC3, Vc3Settings * VP8, Vp8Settings * VP9, Vp9Settings * XAVC, XavcSettings
IV_COLORMETADATA
TYPE /AWS1/MDCCOLORMETADATA
/AWS1/MDCCOLORMETADATA
¶
Choose Insert for this setting to include color metadata in this output. Choose Ignore to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.
IO_CROP
TYPE REF TO /AWS1/CL_MDCRECTANGLE
/AWS1/CL_MDCRECTANGLE
¶
Use Cropping selection to specify the video area that the service will include in the output video frame.
IV_DROPFRAMETIMECODE
TYPE /AWS1/MDCDROPFRAMETIMECODE
/AWS1/MDCDROPFRAMETIMECODE
¶
Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion is enabled.
IV_FIXEDAFD
TYPE /AWS1/MDC__INTEGERMIN0MAX15
/AWS1/MDC__INTEGERMIN0MAX15
¶
Applies only if you set AFD Signaling to Fixed. Use Fixed to specify a four-bit AFD value which the service will write on all frames of this video output.
IV_HEIGHT
TYPE /AWS1/MDC__INTEGERMIN32MAX8192
/AWS1/MDC__INTEGERMIN32MAX8192
¶
Use Height to define the video resolution height, in pixels, for this output. To use the same resolution as your input: Leave both Width and Height blank. To evenly scale from your input resolution: Leave Height blank and enter a value for Width. For example, if your input is 1920x1080 and you set Width to 1280, your output will be 1280x720.
IO_POSITION
TYPE REF TO /AWS1/CL_MDCRECTANGLE
/AWS1/CL_MDCRECTANGLE
¶
Use Selection placement to define the video area in your output frame. The area outside of the rectangle that you specify here is black.
IV_RESPONDTOAFD
TYPE /AWS1/MDCRESPONDTOAFD
/AWS1/MDCRESPONDTOAFD
¶
Use Respond to AFD to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to NONE. A preferred implementation of this workflow is to set RespondToAfd to and set AfdSignaling to AUTO. * Choose None to remove all input AFD values from this output.
IV_SCALINGBEHAVIOR
TYPE /AWS1/MDCSCALINGBEHAVIOR
/AWS1/MDCSCALINGBEHAVIOR
¶
Specify the video Scaling behavior when your output has a different resolution than your input. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/video-scaling.html
IV_SHARPNESS
TYPE /AWS1/MDC__INTEGERMIN0MAX100
/AWS1/MDC__INTEGERMIN0MAX100
¶
Use Sharpness setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.
IV_TIMECODEINSERTION
TYPE /AWS1/MDCVIDEOTIMECODEINSION
/AWS1/MDCVIDEOTIMECODEINSION
¶
Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration. In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration does.
IO_VIDEOPREPROCESSORS
TYPE REF TO /AWS1/CL_MDCVIDEOPREPROCESSOR
/AWS1/CL_MDCVIDEOPREPROCESSOR
¶
Find additional transcoding features under Preprocessors. Enable the features at each output individually. These features are disabled by default.
IV_WIDTH
TYPE /AWS1/MDC__INTEGERMIN32MAX8192
/AWS1/MDC__INTEGERMIN32MAX8192
¶
Use Width to define the video resolution width, in pixels, for this output. To use the same resolution as your input: Leave both Width and Height blank. To evenly scale from your input resolution: Leave Width blank and enter a value for Height. For example, if your input is 1920x1080 and you set Height to 720, your output will be 1280x720.
Queryable Attributes¶
AfdSignaling¶
This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.
Accessible with the following methods¶
Method | Description |
---|---|
GET_AFDSIGNALING() |
Getter for AFDSIGNALING, with configurable default |
ASK_AFDSIGNALING() |
Getter for AFDSIGNALING w/ exceptions if field has no value |
HAS_AFDSIGNALING() |
Determine if AFDSIGNALING has a value |
AntiAlias¶
The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.
Accessible with the following methods¶
Method | Description |
---|---|
GET_ANTIALIAS() |
Getter for ANTIALIAS, with configurable default |
ASK_ANTIALIAS() |
Getter for ANTIALIAS w/ exceptions if field has no value |
HAS_ANTIALIAS() |
Determine if ANTIALIAS has a value |
CodecSettings¶
Video codec settings contains the group of settings related to video encoding. The settings in this group vary depending on the value that you choose for Video codec. For each codec enum that you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AV1, Av1Settings * AVC_INTRA, AvcIntraSettings * FRAME_CAPTURE, FrameCaptureSettings * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * UNCOMPRESSED, UncompressedSettings * VC3, Vc3Settings * VP8, Vp8Settings * VP9, Vp9Settings * XAVC, XavcSettings
Accessible with the following methods¶
Method | Description |
---|---|
GET_CODECSETTINGS() |
Getter for CODECSETTINGS |
ColorMetadata¶
Choose Insert for this setting to include color metadata in this output. Choose Ignore to exclude color metadata from this output. If you don't specify a value, the service sets this to Insert by default.
Accessible with the following methods¶
Method | Description |
---|---|
GET_COLORMETADATA() |
Getter for COLORMETADATA, with configurable default |
ASK_COLORMETADATA() |
Getter for COLORMETADATA w/ exceptions if field has no value |
HAS_COLORMETADATA() |
Determine if COLORMETADATA has a value |
Crop¶
Use Cropping selection to specify the video area that the service will include in the output video frame.
Accessible with the following methods¶
Method | Description |
---|---|
GET_CROP() |
Getter for CROP |
DropFrameTimecode¶
Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion is enabled.
Accessible with the following methods¶
Method | Description |
---|---|
GET_DROPFRAMETIMECODE() |
Getter for DROPFRAMETIMECODE, with configurable default |
ASK_DROPFRAMETIMECODE() |
Getter for DROPFRAMETIMECODE w/ exceptions if field has no v |
HAS_DROPFRAMETIMECODE() |
Determine if DROPFRAMETIMECODE has a value |
FixedAfd¶
Applies only if you set AFD Signaling to Fixed. Use Fixed to specify a four-bit AFD value which the service will write on all frames of this video output.
Accessible with the following methods¶
Method | Description |
---|---|
GET_FIXEDAFD() |
Getter for FIXEDAFD, with configurable default |
ASK_FIXEDAFD() |
Getter for FIXEDAFD w/ exceptions if field has no value |
HAS_FIXEDAFD() |
Determine if FIXEDAFD has a value |
Height¶
Use Height to define the video resolution height, in pixels, for this output. To use the same resolution as your input: Leave both Width and Height blank. To evenly scale from your input resolution: Leave Height blank and enter a value for Width. For example, if your input is 1920x1080 and you set Width to 1280, your output will be 1280x720.
Accessible with the following methods¶
Method | Description |
---|---|
GET_HEIGHT() |
Getter for HEIGHT, with configurable default |
ASK_HEIGHT() |
Getter for HEIGHT w/ exceptions if field has no value |
HAS_HEIGHT() |
Determine if HEIGHT has a value |
Position¶
Use Selection placement to define the video area in your output frame. The area outside of the rectangle that you specify here is black.
Accessible with the following methods¶
Method | Description |
---|---|
GET_POSITION() |
Getter for POSITION |
RespondToAfd¶
Use Respond to AFD to specify how the service changes the video itself in response to AFD values in the input. * Choose Respond to clip the input video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to NONE. A preferred implementation of this workflow is to set RespondToAfd to and set AfdSignaling to AUTO. * Choose None to remove all input AFD values from this output.
Accessible with the following methods¶
Method | Description |
---|---|
GET_RESPONDTOAFD() |
Getter for RESPONDTOAFD, with configurable default |
ASK_RESPONDTOAFD() |
Getter for RESPONDTOAFD w/ exceptions if field has no value |
HAS_RESPONDTOAFD() |
Determine if RESPONDTOAFD has a value |
ScalingBehavior¶
Specify the video Scaling behavior when your output has a different resolution than your input. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/video-scaling.html
Accessible with the following methods¶
Method | Description |
---|---|
GET_SCALINGBEHAVIOR() |
Getter for SCALINGBEHAVIOR, with configurable default |
ASK_SCALINGBEHAVIOR() |
Getter for SCALINGBEHAVIOR w/ exceptions if field has no val |
HAS_SCALINGBEHAVIOR() |
Determine if SCALINGBEHAVIOR has a value |
Sharpness¶
Use Sharpness setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.
Accessible with the following methods¶
Method | Description |
---|---|
GET_SHARPNESS() |
Getter for SHARPNESS, with configurable default |
ASK_SHARPNESS() |
Getter for SHARPNESS w/ exceptions if field has no value |
HAS_SHARPNESS() |
Determine if SHARPNESS has a value |
TimecodeInsertion¶
Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To include timecodes in this output, set Timecode insertion to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration. In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration does.
Accessible with the following methods¶
Method | Description |
---|---|
GET_TIMECODEINSERTION() |
Getter for TIMECODEINSERTION, with configurable default |
ASK_TIMECODEINSERTION() |
Getter for TIMECODEINSERTION w/ exceptions if field has no v |
HAS_TIMECODEINSERTION() |
Determine if TIMECODEINSERTION has a value |
VideoPreprocessors¶
Find additional transcoding features under Preprocessors. Enable the features at each output individually. These features are disabled by default.
Accessible with the following methods¶
Method | Description |
---|---|
GET_VIDEOPREPROCESSORS() |
Getter for VIDEOPREPROCESSORS |
Width¶
Use Width to define the video resolution width, in pixels, for this output. To use the same resolution as your input: Leave both Width and Height blank. To evenly scale from your input resolution: Leave Width blank and enter a value for Height. For example, if your input is 1920x1080 and you set Height to 720, your output will be 1280x720.
Accessible with the following methods¶
Method | Description |
---|---|
GET_WIDTH() |
Getter for WIDTH, with configurable default |
ASK_WIDTH() |
Getter for WIDTH w/ exceptions if field has no value |
HAS_WIDTH() |
Determine if WIDTH has a value |