IDXTransform interface

The IDXTransform interface is used to set up a transform and cause it to produce its graphics output. This interface is exposed on all Microsoft DirectX Transform objects created with the IDXTransformFactory::CreateTransform method.

Members

The IDXTransform interface inherits from IDXBaseObject. IDXTransform also has these types of members:

• Methods

Methods

The IDXTransform interface has these methods.

Method	Description
Execute	Executes the transform operation given the specified portion bounds and places the result in the destination data object.
GetInOutInfo	Retrieves input or output information about the specified data object, and an optional pointer to it.
GetMiscFlags	Retrieves flags that describe the behavior of the transform.
GetQuality	Retrieves the quality level used to render the transform result.
MapBoundsIn2Out	Maps the input coordinate space to the output coordinate space.
MapBoundsOut2In	Maps the output coordinate space to the input coordinate space.
SetMiscFlags	Sets transform flags that specify how to generate the output.
SetQuality	Sets the quality level used to render the transform result.
Setup	Defines the input and output data objects used in the transform.

 

Remarks

Input and output data objects are specified for transform objects in the IDXTransform::Setup method. This method accepts pointers to the data object's IUnknown interface, which enables transforms to support any number and type of data objects. If you provide only an output data object, then reading, modifying, and writing all occur on that object. The transform input and output data objects are typically DXSurface objects, though this depends on the individual transform.

All transforms on DXSurfaces support data access through either the IDXARGBReadPtr or IDXARGBReadWritePtr pointer modifier interfaces, or both. These interfaces provide simplified access to samples of the DXSurface in either of the following two pixel formats: ARGB32, or alpha premultipliedPMARGB32. These formats are defined for optimal alpha blending performance and to maintain precision for intermediate results. In addition, transforms also must support Component Object Model (COM) aggregation so that additional interface pointers can be passed to the client.

The IDXTransform interface inherits from the IDXBaseObject interface. You can use the methods in the IDXBaseObject interface to manage the generation ID.

Transforms can use discrete DXBNDS structures to describe DXSurfaces. The CDXBnds template helper class can take bounds of any type and convert them where necessary. Transforms should always work using bounds in their native coordinate type.

For information about creating a transform object and retrieving the IDXTransform interface, see the IDXTransformFactory interface.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header	Dxtrans.h
IDL	Dxtrans.idl
DLL	Dxtrans.dll