Compositor Transform

Creates a combination of two input DXSurfaces. The samples of the surfaces are combined one by one to form the output, using the color and alpha values of each sample to determine the final color of the output sample. The way in which these colors and alpha values are combined depends on your setting for the Function property.

For example, if you select DXCOMPFUNC_A_OVER_B as your compositor function, the first DXSurface will be rendered over the second DXSurface. The second surface will show through any regions of the first surface that are translucent.

For more information about the different compositor functions, see the DXCOMPFUNC enumeration.

Note To use this transform, you need to have Microsoft® DirectX® Media 6, Microsoft Internet Explorer 5, Microsoft Windows® 98 Second Edition, or Windows 2000 installed.

Transform Specifications

The following table contains the information you need in order to use this transform in C++ and script.

Class identifier (CLSID)	CLSID_DXTComposite
Globally unique identifier (GUID)	9A43A844-0831-11D1-817F-0000F87557DB
Programmatic identifier (ProgId)	DXImageTransform.Microsoft.Compositor
Category identifier (CATID)	CATID_DXImageTransform
Custom interfaces	IDXTComposite
Supported interfaces	IDXSurfacePick
Inputs	Two required of type IDXSurface.
Output	IDXSurface

Custom Properties

The following table lists the custom properties that control the transform output.

Property	Type	Default	Description
Function	DXCOMPFUNC	DXCOMPFUNC_A_OVER_B	The kind of compositing operation to perform. Supported operations include: DXCOMPFUNC_CLEAR, DXCOMPFUNC_MIN, DXCOMPFUNC_MAX, DXCOMPFUNC_A, DXCOMPFUNC_A_OVER_B, DXCOMPFUNC_A_IN_B, DXCOMPFUNC_A_OUT_B, DXCOMPFUNC_A_ATOP_B, DXCOMPFUNC_A_SUBTRACT_B, DXCOMPFUNC_A_ADD_B, DXCOMPFUNC_A_XOR_B, DXCOMPFUNC_B, DXCOMPFUNC_B_OVER_A, DXCOMPFUNC_B_IN_A, DXCOMPFUNC_B_OUT_A, DXCOMPFUNC_B_ATOP_A, DXCOMPFUNC_B_SUBTRACT_A, DXCOMPFUNC_B_ADD_A

These options are described in more detail in the DXCOMPFUNC enumeration reference.