MeshFlags Enumeration (Microsoft.DirectX.Direct3D)

Article
06/30/2006

Defines flags used to specify creation options for a mesh.

Definition

Visual Basic Public Enum MeshFlags

C# public enum MeshFlags

C++ public enum class MeshFlags

JScript public enum MeshFlags

Members

Member Value Description

SimplifyFace 2 Simplifies the mesh by the number of faces specified in the minValue parameter of the Mesh.Simplify method.

SimplifyVertex 1 Simplifies the mesh by the number of vertices specified in the minValue parameter of the Mesh.Simplify method.

OptimizeDeviceIndependent 4194304 Specifies a default vertex cache size that works well on older hardware.

OptimizeDoNotSplit 536870912 Specifies that vertices shared between attribute groups should not be split during attribute sorting.

OptimizeIgnoreVerts 268435456 Optimizes the faces only; does not optimize the vertices.

OptimizeStripeReorder 134217728 Reorders faces to maximize the length of adjacent triangles.

OptimizeVertexCache 67108864 Reorders faces to increase the cache hit rate of vertex caches.

OptimizeAttributeSort 33554432 Reorders faces to optimize for fewer attribute bundle state changes and enhanced BaseMesh.DrawSubset performance.

OptimizeCompact 16777216 Reorders faces to remove unused vertices and faces.

SoftwareProcessing 98304 Equivalent to specifying both VbSoftwareProcessing and IbSoftwareProcessing.

Dynamic 2176 Equivalent to specifying both VbDynamic and IbDynamic.

WriteOnly 1088 Equivalent to specifying both VbWriteOnly and IbWriteOnly.

Managed 544 Equivalent to specifying both VbManaged and IbManaged.

SystemMemory 272 Equivalent to specifying both VbSystemMem and IbSystemMem.

UseHardwareOnly 8192 Specifies use of hardware processing only. For mixed-mode devices, this flag causes the system to use hardware processing if it is supported, and software processing otherwise.

VbShare 4096 Forces the cloned meshes to share vertex buffers.

IbSoftwareProcessing 65536 Specifies use of the SoftwareProcessing usage flag for index buffers.

IbDynamic 2048 Specifies use of the Dynamic usage flag for index buffers.

IbWriteOnly 1024 Specifies use of the WriteOnly usage flag for index buffers.

IbManaged 512 Specifies use of the Managed memory class for index buffers.

IbSystemMem 256 Specifies use of the SystemMemory memory class for index buffers.

VbSoftwareProcessing 32768 Specifies use of the SoftwareProcessing usage flag for vertex buffers.

VbDynamic 128 Specifies use of the Dynamic usage flag for vertex buffers.

VbWriteOnly 64 Specifies use of the WriteOnly usage flag for vertex buffers.

VbManaged 32 Specifies use of the Managed memory class for vertex buffers.

VbSystemMem 16 Specifies use of the SystemMemory memory class for vertex buffers.

NPatches 16384 Causes the vertex and index buffer of the mesh to be created with the NPatches flag. This is required if the mesh object will be rendered using N-patch enhancement with Microsoft Direct3D.

RtPatches 8 Used for vertex and index buffers.

Points 4 Used for vertex and index buffers.

DoNotClip 2 Used for vertex and index buffers.

Use32Bit 1 Specifies 32-bit indices instead of 16-bit indices for the mesh.

Member	Value	Description
SimplifyFace	2	Simplifies the mesh by the number of faces specified in the minValue parameter of the Mesh.Simplify method.
SimplifyVertex	1	Simplifies the mesh by the number of vertices specified in the minValue parameter of the Mesh.Simplify method.
OptimizeDeviceIndependent	4194304	Specifies a default vertex cache size that works well on older hardware.
OptimizeDoNotSplit	536870912	Specifies that vertices shared between attribute groups should not be split during attribute sorting.
OptimizeIgnoreVerts	268435456	Optimizes the faces only; does not optimize the vertices.
OptimizeStripeReorder	134217728	Reorders faces to maximize the length of adjacent triangles.
OptimizeVertexCache	67108864	Reorders faces to increase the cache hit rate of vertex caches.
OptimizeAttributeSort	33554432	Reorders faces to optimize for fewer attribute bundle state changes and enhanced BaseMesh.DrawSubset performance.
OptimizeCompact	16777216	Reorders faces to remove unused vertices and faces.
SoftwareProcessing	98304	Equivalent to specifying both VbSoftwareProcessing and IbSoftwareProcessing.
Dynamic	2176	Equivalent to specifying both VbDynamic and IbDynamic.
WriteOnly	1088	Equivalent to specifying both VbWriteOnly and IbWriteOnly.
Managed	544	Equivalent to specifying both VbManaged and IbManaged.
SystemMemory	272	Equivalent to specifying both VbSystemMem and IbSystemMem.
UseHardwareOnly	8192	Specifies use of hardware processing only. For mixed-mode devices, this flag causes the system to use hardware processing if it is supported, and software processing otherwise.
VbShare	4096	Forces the cloned meshes to share vertex buffers.
IbSoftwareProcessing	65536	Specifies use of the SoftwareProcessing usage flag for index buffers.
IbDynamic	2048	Specifies use of the Dynamic usage flag for index buffers.
IbWriteOnly	1024	Specifies use of the WriteOnly usage flag for index buffers.
IbManaged	512	Specifies use of the Managed memory class for index buffers.
IbSystemMem	256	Specifies use of the SystemMemory memory class for index buffers.
VbSoftwareProcessing	32768	Specifies use of the SoftwareProcessing usage flag for vertex buffers.
VbDynamic	128	Specifies use of the Dynamic usage flag for vertex buffers.
VbWriteOnly	64	Specifies use of the WriteOnly usage flag for vertex buffers.
VbManaged	32	Specifies use of the Managed memory class for vertex buffers.
VbSystemMem	16	Specifies use of the SystemMemory memory class for vertex buffers.
NPatches	16384	Causes the vertex and index buffer of the mesh to be created with the NPatches flag. This is required if the mesh object will be rendered using N-patch enhancement with Microsoft Direct3D.
RtPatches	8	Used for vertex and index buffers.
Points	4	Used for vertex and index buffers.
DoNotClip	2	Used for vertex and index buffers.
Use32Bit	1	Specifies 32-bit indices instead of 16-bit indices for the mesh.

Remarks

A 32-bit mesh can theoretically support (2³²)-1 faces and vertices. However, allocating memory for such a large mesh is not practical on a 32-bit operating system.

Enumeration Information

Namespace Microsoft.DirectX.Direct3D

Assembly Microsoft.DirectX.Direct3DX (microsoft.directx.direct3dx.dll)

Strong Name Microsoft.DirectX.Direct3DX, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Visual Basic	Public Enum MeshFlags
C#	public enum MeshFlags
C++	public enum class MeshFlags
JScript	public enum MeshFlags

Namespace	Microsoft.DirectX.Direct3D
Assembly	Microsoft.DirectX.Direct3DX (microsoft.directx.direct3dx.dll)
Strong Name	Microsoft.DirectX.Direct3DX, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

MeshFlags Enumeration (Microsoft.DirectX.Direct3D)

Additional resources