Microsoft DirectX 8.0 |
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