Index Topic Contents | |||
Previous Topic: Property Sets Next Topic: DVD Copy Protection Property Set |
DVD Subpicture Property Set
DVD Subpicture properties control the color, contrast, and output of the subpicture display.
The following information presents the necessary constants and data types to use for this property set in calls to IKsPropertySet methods. It provides values for the GUID (guidPropSet), property ID (dwPropID), and property data type (pPropData) parameters.
Property Set GUID: AM_KSPROPSETID_DvdSubPic
Property ID Data type used by the specified property AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON AM_PROPERTY_COMPOSIT_ON AM_PROPERTY_DVDSUBPIC_HLI AM_PROPERTY_SPHLI AM_PROPERTY_DVDSUBPIC_PALETTE AM_PROPERTY_SPPAL The following list provides the Subpicture property IDs and descriptions.
- AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON
- Set-only property that enables or disables subpicture display. DirectShow defines the AM_PROPERTY_COMPOSIT_ON Boolean data type for this property, as well as PAM_PROPERTY_COMPOSIT_ON as a pointer to this data type. TRUE indicates display the subpicture, FALSE indicates disable it. See the WDM portion of the Windows 98 DDK for more information.
- AM_PROPERTY_DVDSUBPIC_HLI
- Set-only property that specifies a rectangle of subpicture or screen whose color or contrast will be changed. Data type is AM_PROPERTY_SPHLI.
The AM_PROPERTY_DVDSUBPIC_HLI property is set-only. It specifies a rectangle of subpicture or screen whose color or contrast will be changed. This differs from the DVD-Video specification, in that the Microsoft DVD navigator parses all button and keyboard information and passes only one highlight rectangle to the subpicture decoder at any given time. As a result, highlight information is sent to the decoder more often than it is present in the DVD stream.
The highlight information arrives asynchronously to the data stream. The decoder uses the highlight Start and End time stamps to correlate the highlight information to the relevant subpicture information, if any. If the decoder has not received any subpicture stream information for the requested time stamps, the decoder assumes that the highlight information is stand-alone and does not apply to a subpicture. In this case, the decoder assumes the color and contrast information is all the same color.
The data is not entirely in DVD disc format. Microsoft provides an additional structure of type AM_PROPERTY_SPHLI that is passed as the parameter to this property. This structure describes the currently selected button from the DVD highlight information.
The DVD navigator processes all keystroke information and sends new highlight information each time a button state changes. The information describes only one mode of one button at a time. It includes a display rectangle in pixel coordinates of the screen, or a display of the subpicture, if present. The structure also contains color and contrast information, but only for the present state of the currently selected button. The format is defined in the DVD specification.
Highlight information contains Start and End time stamps. These are in the same units as other time stamps, with two exceptions: A Start time stamp of 0xFFFFFFFF means the highlight property is effective upon receipt, and an End time stamp of 0xFFFFFFFF means the highlight property is valid until next highlight received.
The HLISS field is as defined in the DVD specification. A value of zero indicates that all highlights are invalid and the decoder should disable all highlights.
- AM_PROPERTY_DVDSUBPIC_PALETTE
- Sets the palette for a subpicture. Data type is AM_PROPERTY_SPPAL.
Use the IKsPropertySet interface to set, retrieve, and query for support of these properties.
This property set uses the following data types.
Data type Description AM_COLCON Specifies the color contrast. Substructure of the AM_PROPERTY_SPHLI structure. AM_DVD_YUV Specifies DVD YUV subpicture data. Substructure of the AM_PROPERTY_SPPAL structure. AM_PROPERTY_COMPOSIT_ON Boolean data used by the AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON property. AM_PROPERTY_SPHLI Describes the currently selected button from the DVD highlight information. AM_PROPERTY_SPPAL Specifies the DVD subpicture palette. DVD Subpicture Property Set
AM_COLCONIndicates the color contrast description from the DVD highlight (HLI) structure.
typedef struct _AM_COLCON { UCHAR emph1col:4; UCHAR emph2col:4; UCHAR backcol:4; UCHAR patcol:4; UCHAR emph1con:4; UCHAR emph2con:4; UCHAR backcon:4; UCHAR patcon:4; } AM_COLCON, *PAM_COLCON;Members
- emph1col
- Emphasis color 1.
- emph2col
- Emphasis color 2.
- backcol
- Background color.
- patcol
- Pattern color.
- emph1con
- Emphasis contrast 1.
- emph2con
- Emphasis contrast 2.
- backcon
- Background contrast.
- patcon
- Pattern contrast.
Remarks
This structure is contained within the AM_PROPERTY_SPHLI structure.
DVD Subpicture Property Set
AM_DVD_YUVDVD YUV subpicture data.
typedef struct _AM_DVD_YUV { UCHAR Reserved; UCHAR Y; UCHAR U; UCHAR V; } AM_DVD_YUV, *PAM_DVD_YUV;Members
- Reserved
- Reserved.
- Y
- Y color data.
- U
- U color data.
- V
- V color data.
Remarks
This structure is contained within the AM_PROPERTY_SPPAL structure.
DVD Subpicture Property Set
AM_PROPERTY_SPHLIDescribes the currently selected button from the DVD highlight information.
typedef struct _AM_PROPERTY_SPHLI { USHORT HLISS; USHORT Reserved; ULONG StartPTM; ULONG EndPTM; USHORT StartX; USHORT StartY; USHORT StopX; USHORT StopY; AM_COLCON ColCon; } AM_PROPERTY_SPHLI, *PAM_PROPERTY_SPHLI;Members
- HLISS
- Highlight status of current selection.
- Reserved
- Reserved for internal use. Do not use or set.
- StartPTM
- Start presentation time divided by 90,000.
- EndPTM
- End presentation time divided by 90,000.
- StartX
- Start x-coordinate pixel of the current highlight button.
- StartY
- Start y-coordinate pixel of the current highlight button.
- StopX
- Ending x-coordinate pixel of the current highlight button.
- StopY
- Ending y-coordinate pixel of the current highlight button.
- ColCon
- Color contrast description of type AM_COLCON.
Remarks
The AM_PROPERTY_DVDSUBPIC_HLI property uses this structure.
DVD Subpicture Property Set
AM_PROPERTY_SPPALSpecifies the DVD subpicture palette.
typedef struct _AM_PROPERTY_SPPAL { AM_DVD_YUV sppal[16]; } AM_PROPERTY_SPPAL, *PAM_PROPERTY_SPPAL;Members
- sppal
- Array of 16 YUV elements that correspond to the 4-bit color numbers requested within the subpicture command stream. The YUV elements are of type AM_DVD_YUV.
Remarks
The AM_PROPERTY_DVDSUBPIC_PALETTE property uses this structure.
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.