Enum VLDVDPlayer.TVLDVDPreferredDisplayMode

From Mitov Wiki Doc
Jump to: navigation, search

This is a Beta Read Only version of this page. Please review and send recommendations to mitov@mitov.com. We will enable the editing as soon as we are happy with the overall Wiki site.

Package: VideoLabPkg

Unit: VLDVDPlayer

Contents

Syntax

Delphi:

type TVLDVDPreferredDisplayMode = (pdmDefault, pdm16x9, pdm4x3Panscan, pdm4x3Letterbox);

C++ Builder:

enum TVLDVDPreferredDisplayMode {pdmDefault, pdm16x9, pdm4x3Panscan, pdm4x3Letterbox};

Visual C++ (MFC):

enum CTVLDVDPreferredDisplayMode {pdmDefault, pdm16x9, pdm4x3Panscan, pdm4x3Letterbox};

Summary

Indicates the user's preferred window aspect ratio and conversion method.

Description

Defines enumeration that indicates the user's preferred window aspect ratio and conversion method. Remarks Indicates the user's preferred window aspect ratio and preferred method of conversion of 16 x 9 content to a 4 x 3 window aspect ratio. Pan-scan and letterboxing are the two conversion methods. Displaying a video at the largest possible size inside the display window without any cropping or stretching is called displaying in letterbox format. Pan-scan is specifically cropping a 16 x 9 video for display in a 4 x 3 window using parameters defined by the video author.


This enumerated type indicates a preference of conversion mechanisms because some content can only be displayed using one of these methods. Content that is 4 x 3 is always converted to a 16 x 9 window by using sideboxing, where black bars are added to the right and left sides of the display instead of the top and bottom of the display as in the 16 x 9 to 4 x 3 conversion using letterboxing.


The following table shows the conversion method used between the actual content type listed in the first column, and the user display preference setting, indicated by one of the other columns.

Actual content type 16 x 9 4 x 3 4 x 3
pan-scan letterbox
---------------------- ----------- ---------- -----------
4 x 3 Sideboxing None None
16 x 9 letterbox only None Letterbox Letterbox
16 x 9 pan-scan only None Pan-scan Pan-scan
16 x 9 pan-scan or None Pan-scan Letterbox
letterbox

The native window size used is always the user's preferred size.

Values

pdmDefault Use the default window size and content type.
pdm16x9 Use a 16 x 9 window.
pdm4x3Panscan Use a 4 x 3 window and convert to pan-scan, if possible.
pdm4x3Letterbox Use a 4 x 3 window and convert to letterbox, if possible.
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox