MF_MT_PAN_SCAN_APERTURE attribute

Defines the pan/scan aperture, which is the 4×3 region of video that should be displayed in pan/scan mode.

Data type

Byte array

Remarks

The attribute value is an MFVideoArea structure.

This attribute is used to crop widescreen video to a 4:3 aspect ratio. The pan/scan aperture is used only in pan/scan mode, which is enabled by setting the MF_MT_PAN_SCAN_ENABLED attribute to TRUE.

If pan/scan mode is not enabled, use the display aperture, specified by the MF_MT_MINIMUM_DISPLAY_APERTURE attribute.

If this attribute is not set, the pan/scan aperture is assumed to be the entire video frame.

The GUID constant for this attribute is exported from mfuuid.lib.

Requirements

Minimum supported client
Windows Vista [desktop apps | UWP apps]
Minimum supported server
Windows Server 2008 [desktop apps | UWP apps]
Header
Mfapi.h

See also

Alphabetical List of Media Foundation Attributes

Media Type Attributes

Picture Aspect Ratio

Video Media Types

IMFAttributes::GetBlob

IMFAttributes::SetBlob

IMFMediaType

MF_MT_GEOMETRIC_APERTURE

MF_MT_MINIMUM_DISPLAY_APERTURE

MF_MT_PAN_SCAN_ENABLED