Export (0) Print
Expand All
Expand Minimize

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

Evr.h

See also

IMFVideoDisplayControl::GetAspectRatioMode
IMFVideoDisplayControl::SetAspectRatioMode
Media Foundation Enumerations
Enhanced Video Renderer

 

 

Community Additions

ADD
Show:
© 2014 Microsoft