Microsoft DirectX 9.0 SDK Update (October 2004)

PrimitiveType Enumeration

Language:

Note: This documentation is preliminary and is subject to change.
How Do I...?

Defines the primitives supported by Microsoft® Direct3D®.

Definition

Visual Basic .NET Public Enum PrimitiveType
C# public enum PrimitiveType
Managed C++ __value public enum PrimitiveType
JScript .NET public enum PrimitiveType

Members

Member Value Description
TriangleFan 6 Renders the vertices as a triangle fan.
TriangleStrip 5 Renders the vertices as a triangle strip. The back face culling flag is flipped automatically on even-numbered triangles.
TriangleList 4 Renders the specified vertices as a sequence of isolated triangles. Each group of three vertices defines a separate triangle. Back face culling is affected by the current winding-order render state.
LineStrip 3 Renders the vertices as a single polyline. Calls that use this primitive type fail if the count is less than two.
LineList 2 Renders the vertices as a list of isolated straight line segments. Calls that use this primitive type fail if the count is less than two or is odd.
PointList 1 Renders the vertices as a collection of isolated points. This value is unsupported for indexed primitives.

Remarks

Using Triangle Strips or Triangle Fans is often more efficient than using Triangle Lists because fewer vertices are duplicated.

How Do I...?

Generate a Scene

This example shows how to begin scene generation and draw primitives.

The SetStreamSource method binds a vertex buffer to a device data stream to create an association between the vertex data and one of several data stream ports that feed the primitive processing functions. The parameters for this method are the number of the data stream, the name of the VertexBuffer object, and the stream vertex stride.

In the following C# code example, it is assumed that the device is the rendering Device, and vBuffer is a vertex buffer filled with CustomVertex.PositionNormal data.

              [C#]
              
device.BeginScene(); device.SetStreamSource(0, vBuffer, 0); device.VertexFormat = CustomVertex.PositionNormal.Format; device.DrawPrimitives(PrimitiveType.TriangleList, 0, 1); device.EndScene();

Enumeration Information

Namespace Microsoft.DirectX.Direct3D
Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name Microsoft.DirectX.Direct3D,  Version=1.0.2902.0,  Culture=neutral,  PublicKeyToken=31bf3856ad364e35

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center