D3DTRANSFORMDATA

The D3DTRANSFORMDATA structure contains information about transformations for the IDirect3DViewport2::TransformVertices method.

typedef struct _D3DTRANSFORMDATA { 
    DWORD        dwSize; 
    LPVOID       lpIn; 
    DWORD        dwInSize; 
    LPVOID       lpOut; 
    DWORD        dwOutSize; 
    LPD3DHVERTEX lpHOut; 
    DWORD        dwClip; 
    DWORD        dwClipIntersection; 
    DWORD        dwClipUnion; 
    D3DRECT      drExtent; 
} D3DTRANSFORMDATA, *LPD3DTRANSFORMDATA; 
 

Members

dwSize

Size of the structure, in bytes. This member must be initialized before the structure is used.

lpIn

Address of the vertices to be transformed. This should be a D3DLVERTEX structure.

dwInSize

Stride of the vertices to be transformed.

lpOut

Address used to store the transformed vertices.

dwOutSize

Stride of output vertices.

lpHOut

Address of a value that contains homogeneous transformed vertices. This value is a D3DHVERTEX structure

dwClip

Flags specifying how the vertices are clipped. This member can be one or more of the following values:

D3DCLIP_BACK
	Clipped by the back plane of the viewing frustum.
D3DCLIP_BOTTOM
	Clipped by the bottom plane of the viewing frustum.
D3DCLIP_FRONT
	Clipped by the front plane of the viewing frustum.
D3DCLIP_GEN0 through D3DCLIP_GEN5
	Application-defined clipping planes.
D3DCLIP_LEFT
	Clipped by the left plane of the viewing frustum.
D3DCLIP_RIGHT
	Clipped by the right plane of the viewing frustum.
D3DCLIP_TOP
	Clipped by the top plane of the viewing frustum.

dwClipIntersection

Flags denoting the intersection of the clip flags. This member can be one or more of the following values:

D3DSTATUS_CLIPINTERSECTIONBACK
	Logical AND of the clip flags for the vertices compared to the back clipping plane of the viewing frustum.
D3DSTATUS_CLIPINTERSECTIONBOTTOM
	Logical AND of the clip flags for the vertices compared to the bottom of the viewing frustum.
D3DSTATUS_CLIPINTERSECTIONFRONT
	Logical AND of the clip flags for the vertices compared to the front clipping plane of the viewing frustum.
D3DSTATUS_CLIPINTERSECTIONGEN0 through D3DSTATUS_CLIPINTERSECTIONGEN5
	Logical AND of the clip flags for application-defined clipping planes.
D3DSTATUS_CLIPINTERSECTIONLEFT
	Logical AND of the clip flags for the vertices compared to the left side of the viewing frustum.
D3DSTATUS_CLIPINTERSECTIONRIGHT
	Logical AND of the clip flags for the vertices compared to the right side of the viewing frustum.
D3DSTATUS_CLIPINTERSECTIONTOP
	Logical AND of the clip flags for the vertices compared to the top of the viewing frustum.

dwClipUnion

Flags denoting the union of the clip flags. This member can be one or more of the following values:

D3DSTATUS_CLIPUNIONBACK
	Equal to D3DCLIP_BACK.
D3DSTATUS_CLIPUNIONBOTTOM
	Equal to D3DCLIP_BOTTOM.
D3DSTATUS_CLIPUNIONFRONT
	Equal to D3DCLIP_FRONT.
D3DSTATUS_CLIPUNIONGEN0 through D3DSTATUS_CLIPUNIONGEN5
	Equal to D3DCLIP_GEN0 through D3DCLIP_GEN5.
D3DSTATUS_CLIPUNIONLEFT
	Equal to D3DCLIP_LEFT.
D3DSTATUS_CLIPUNIONRIGHT
	Equal to D3DCLIP_RIGHT.
D3DSTATUS_CLIPUNIONTOP
	Equal to D3DCLIP_TOP.

drExtent

Value that defines the extent of the transformed vertices. This structure is filled by the transformation module with the screen extent of the transformed geometry. For geometries that are clipped, this extent will only include vertices that are inside the viewing volume. This value is a D3DRECT structure

Remarks

Each input vertex should be a three-vector vertex giving the [x y z] coordinates in model space for the geometry. The dwInSize member gives the amount to skip between vertices, allowing the application to store extra data inline with each vertex.

All values generated by the transformation module are stored as 16-bit precision values. The clip is treated as an integer bitfield that is set to the inclusive OR of the viewing volume planes that clip a given transformed vertex.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in d3dtypes.h.

See Also

IDirect3DViewport2::TransformVertices