BaseMesh.DrawSubset(Int32) Method (Microsoft.DirectX.Direct3D)

Draws a subset of a mesh.

Definition

Visual Basic Public Sub DrawSubset( _
    ByVal attributeID As Integer _
)
C# public void DrawSubset(
    int attributeID
);
C++ public:
void DrawSubset(
    int attributeID
);
JScript public function DrawSubset(
    attributeID : int
);

Parameters

attributeID System.Int32
An Int32Leave Site value that specifies which subset of the mesh to draw. This value is used to differentiate faces in a mesh as belonging to one or more attribute groups.

Remarks

The subset that is specified by attributeID will be rendered by the DrawIndexedPrimitives method, using the TriangleList primitive type, so an index buffer must be properly initialized.

An attribute table is used to identify areas of the mesh that need to be drawn with different textures, render states, and materials. The application can use the attribute table to hide portions of a mesh by leaving out a given attribute identifier (attributeID) when drawing the frame. Attribute tables can also be used for application defined purposes.

Exceptions

InvalidCallException

The method call is invalid. For example, a method's parameter might contain an invalid value.

Applies To

Mesh, ProgressiveMesh

See Also