D3DMCLIPSTATUS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure is used to describe how primitives are affected by the clipping planes.

Syntax

typedef struct _D3DMCLIPSTATUS {
  ULONG ClipUnion;
  ULONG ClipIntersection;
} D3DMCLIPSTATUS;

Members

• ClipUnion
  A ULONG value into which the driver will add a specific bit through a bitwise OR operation each time a primitive intersects the clipping plane corresponding to that bit.

• ClipIntersection
  A ULONG value into which the driver will add a specific bit through a bitwise AND operation each time a primitive intersects the clipping plane corresponding to the given bit.

Remarks

The bits in each member are identified by macro values corresponding to each clipping plane: D3DMCS_LEFT, D3DMCS_RIGHT, D3DMCS_TOP, D3DMCS_BOTTOM, D3DMCS_FRONT, and D3DMCS_BACK, see D3DMCS Values. You can use the macro D3DMCS_ALL to access all of the bits at once.

After it has retrieved the clip code bits, the application, can determine — by examining the union and intersection values — if the primitive is entirely inside the frustum, entirely outside, or clipped .

Clipping may occur in any space that is convenient for the driver, so long as the resulting output behavior is correct.

Requirements

See Also

Reference

Direct3D Mobile Structures