D3DMPRIMITIVETYPE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This enumeration defines the primitives supported by Microsoft® Direct3D Mobile®.

Syntax

typedef enum _D3DMPRIMITIVETYPE {
  D3DMPT_POINTLIST     = 1,
  D3DMPT_LINELIST      = 2,
  D3DMPT_LINESTRIP     = 3,
  D3DMPT_TRIANGLELIST  = 4,
  D3DMPT_TRIANGLESTRIP = 5,
  D3DMPT_TRIANGLEFAN   = 6,
  D3DMPT_FORCE_ULONG   = 0x7fffffff,
} D3DMPRIMITIVETYPE;

Elements

  • D3DMPT_POINTLIST
    Renders the vertices as a collection of isolated points.
  • D3DMPT_LINELIST
    Renders the vertices as a list of isolated straight line segments. Calls using this primitive type fail if the count is less than 2 or is odd.
  • D3DMPT_LINESTRIP
    Renders the vertices as a single polyline. Calls using this primitive type fail if the count is less than 2.
  • D3DMPT_TRIANGLELIST
    Renders the specified vertices as a sequence of isolated triangles. Each group of three vertices defines a separate triangle.

    Backface culling is affected by the current winding-order render state.

  • D3DMPT_TRIANGLESTRIP
    Renders the vertices as a triangle strip. The backface-culling flag is automatically flipped on even-numbered triangles.
  • D3DMPT_TRIANGLEFAN
    Renders the vertices as a triangle fan.
  • D3DMPT_FORCE_ULONG
    Forces the compiler to interpret the enumeration as a ULONG value. This value is not used directly in Direct3D Mobile programming.

Remarks

Because fewer vertices are duplicated when triangle strips or triangle fans are used, using them is more efficient than using triangle lists.

Requirements

Header d3dmtypes.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Direct3D Mobile Enumerations