Skip to content

/AWS1/CL_MDLVIDEODESCRIPTION

Video settings for this stream.

CONSTRUCTOR

IMPORTING

Required arguments:

IV_NAME TYPE /AWS1/MDL__STRING /AWS1/MDL__STRING

The name of this VideoDescription. Outputs will use this name to uniquely identify this Description. Description names should be unique within this Live Event.

Optional arguments:

IO_CODECSETTINGS TYPE REF TO /AWS1/CL_MDLVIDEOCODECSETTINGS /AWS1/CL_MDLVIDEOCODECSETTINGS

Video codec settings.

IV_HEIGHT TYPE /AWS1/MDL__INTEGER /AWS1/MDL__INTEGER

Output video height, in pixels. Must be an even number. For most codecs, you can leave this field and width blank in order to use the height and width (resolution) from the source. Note, however, that leaving blank is not recommended. For the Frame Capture codec, height and width are required.

IV_RESPONDTOAFD TYPE /AWS1/MDLVIDEODESCRESPONDTOAFD /AWS1/MDLVIDEODESCRESPONDTOAFD

Indicates how MediaLive will respond to the AFD values that might be in the input video. If you do not know what AFD signaling is, or if your downstream system has not given you guidance, choose PASSTHROUGH. RESPOND: MediaLive clips the input video using a formula that uses the AFD values (configured in afdSignaling ), the input display aspect ratio, and the output display aspect ratio. MediaLive also includes the AFD values in the output, unless the codec for this encode is FRAME_CAPTURE. PASSTHROUGH: MediaLive ignores the AFD values and does not clip the video. But MediaLive does include the values in the output. NONE: MediaLive does not clip the input video and does not include the AFD values in the output

IV_SCALINGBEHAVIOR TYPE /AWS1/MDLVIDEODESCSCALINGBEHAV /AWS1/MDLVIDEODESCSCALINGBEHAV

STRETCH_TO_OUTPUT configures the output position to stretch the video to the specified output resolution (height and width). This option will override any position value. DEFAULT may insert black boxes (pillar boxes or letter boxes) around the video to provide the specified output resolution.

IV_SHARPNESS TYPE /AWS1/MDL__INTEGERMIN0MAX100 /AWS1/MDL__INTEGERMIN0MAX100

Changes the strength of the anti-alias filter used for scaling. 0 is the softest setting, 100 is the sharpest. A setting of 50 is recommended for most content.

IV_WIDTH TYPE /AWS1/MDL__INTEGER /AWS1/MDL__INTEGER

Output video width, in pixels. Must be an even number. For most codecs, you can leave this field and height blank in order to use the height and width (resolution) from the source. Note, however, that leaving blank is not recommended. For the Frame Capture codec, height and width are required.


Queryable Attributes

CodecSettings

Video codec settings.

Accessible with the following methods

Method Description
GET_CODECSETTINGS() Getter for CODECSETTINGS

Height

Output video height, in pixels. Must be an even number. For most codecs, you can leave this field and width blank in order to use the height and width (resolution) from the source. Note, however, that leaving blank is not recommended. For the Frame Capture codec, height and width are required.

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

Name

The name of this VideoDescription. Outputs will use this name to uniquely identify this Description. Description names should be unique within this Live Event.

Accessible with the following methods

Method Description
GET_NAME() Getter for NAME, with configurable default
ASK_NAME() Getter for NAME w/ exceptions if field has no value
HAS_NAME() Determine if NAME has a value

RespondToAfd

Indicates how MediaLive will respond to the AFD values that might be in the input video. If you do not know what AFD signaling is, or if your downstream system has not given you guidance, choose PASSTHROUGH. RESPOND: MediaLive clips the input video using a formula that uses the AFD values (configured in afdSignaling ), the input display aspect ratio, and the output display aspect ratio. MediaLive also includes the AFD values in the output, unless the codec for this encode is FRAME_CAPTURE. PASSTHROUGH: MediaLive ignores the AFD values and does not clip the video. But MediaLive does include the values in the output. NONE: MediaLive does not clip the input video and does not include the AFD values in the 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

STRETCH_TO_OUTPUT configures the output position to stretch the video to the specified output resolution (height and width). This option will override any position value. DEFAULT may insert black boxes (pillar boxes or letter boxes) around the video to provide the specified output resolution.

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

Changes the strength of the anti-alias filter used for scaling. 0 is the softest setting, 100 is the sharpest. A setting of 50 is 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

Width

Output video width, in pixels. Must be an even number. For most codecs, you can leave this field and height blank in order to use the height and width (resolution) from the source. Note, however, that leaving blank is not recommended. For the Frame Capture codec, height and width are required.

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

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT___LISTOFVIDEODESCRIPTION

TYPES TT___LISTOFVIDEODESCRIPTION TYPE STANDARD TABLE OF REF TO /AWS1/CL_MDLVIDEODESCRIPTION WITH DEFAULT KEY
.