MFVideoAspectRatioMode enumeration
Specifies the aspect-ratio mode.
Syntax
typedef enum MFVideoAspectRatioMode { MFVideoARMode_None = 0x00000000, MFVideoARMode_PreservePicture = 0x00000001, MFVideoARMode_PreservePixel = 0x00000002, MFVideoARMode_NonLinearStretch = 0x00000004, MFVideoARMode_Mask = 0x00000007 } MFVideoAspectRatioMode;
Constants
- MFVideoARMode_None
-
Do not maintain the aspect ratio of the video. Stretch the video to fit the output rectangle.
- MFVideoARMode_PreservePicture
-
Preserve the aspect ratio of the video by letterboxing or within the output rectangle.
- MFVideoARMode_PreservePixel
-
Note Currently the EVR ignores this flag.
Correct the aspect ratio if the physical size of the display device does not match the display resolution. For example, if the native resolution of the monitor is 1600 by 1200 (4:3) but the display resolution is 1280 by 1024 (5:4), the monitor will display non-square pixels.
If this flag is set, you must also set the MFVideoARMode_PreservePicture flag.
- MFVideoARMode_NonLinearStretch
-
Apply a non-linear horizontal stretch if the aspect ratio of the destination rectangle does not match the aspect ratio of the source rectangle.
The non-linear stretch algorithm preserves the aspect ratio in the middle of the picture and stretches (or shrinks) the image progressively more toward the left and right. This mode is useful when viewing 4:3 content full-screen on a 16:9 display, instead of pillar-boxing. Non-linear vertical stretch is not supported, because the visual results are generally poor.
This mode may cause performance degradation.
If this flag is set, you must also set the MFVideoARMode_PreservePixel and MFVideoARMode_PreservePicture flags.
- MFVideoARMode_Mask
-
Bitmask to validate flag values. This value is not a valid flag.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
See also
- IMFVideoDisplayControl::GetAspectRatioMode
- IMFVideoDisplayControl::SetAspectRatioMode
- Media Foundation Enumerations
- Enhanced Video Renderer