AM_ASPECT_RATIO_MODE Enumeration

Specifies the aspect ratio of a video image in a display window.

Syntax

typedef enum _AM_ASPECT_RATIO_MODE
{
    AM_ARMODE_STRETCHED,
    AM_ARMODE_LETTER_BOX,
    AM_ARMODE_CROP,
    AM_ARMODE_STRETCHED_AS_PRIMARY  
} AM_ASPECT_RATIO_MODE;

Elements

AM_ARMODE_STRETCHED

No aspect ratio correction.

AM_ARMODE_LETTER_BOX

Put the video in letterbox format. Paint background color in the excess region so the video is not distorted.

AM_ARMODE_CROP

Crop the video to the correct aspect ratio.

AM_ARMODE_STRETCHED_AS_PRIMARY

Use whatever mode is currently set for the primary stream. This value is valid only for secondary streams.

Remarks

The AM_ARMODE_STRETCHED member causes a video stream to occupy the entire region of the display window when the window is resized, possibly stretching the video. The AM_ARMODE_LETTER_BOX member eliminates video stretching and distortions by keeping the aspect ratio consistent and painting the excess areas of the window a background color. The AM_ARMODE_CROP member also prevents stretching, by cropping the image if necessary.

See Also

• IMixerPinConfig::GetAspectRatioMode
• IMixerPinConfig::SetAspectRatioMode
• DirectShow Enumerated Types