SimplificationMesh.SimplificationMesh(Mesh,GraphicsStream,Single[]) Constructor (Microsoft.DirectX.Direct3D)

How Do I...?

  • Simplify a Mesh

Creates a new instance of the SimplificationMesh class.

Definition

Visual Basic Public Sub New( _
    ByVal mesh As Mesh, _
    ByVal adjacency As GraphicsStream, _
    ByVal vertexWeights() As Single _
)
C# public SimplificationMesh(
    Mesh mesh,
    GraphicsStream adjacency,
    float[] vertexWeights
);
C++ public:
 SimplificationMesh(
    Meshmesh,
    GraphicsStreamadjacency,
    array<float>^ vertexWeights
);
JScript public function SimplificationMesh(
    mesh : Mesh,
    adjacency : GraphicsStream,
    vertexWeights : float[]
);

Parameters

mesh Microsoft.DirectX.Direct3D.Mesh
A Mesh object that represents the mesh to simplify.
adjacency Microsoft.DirectX.GraphicsStream
A GraphicsStream containing three Int32Leave Site values per face that specify the three neighbors for each face in the source mesh.
vertexWeights System.Single[]
Array of vertex weights. If this parameter is omitted, all vertex weights are set to 1.0. Note that the higher the vertex weight is for a given vertex, the less likely it is to be simplified away.

Remarks

If param_AttributeWeights_vertexAttributeWeights is omitted, the following values are assigned to the default AttributeWeights structure (C# code shown).

[C#]
AttributeWeights aWeights;

aWeights.Position  = 1.0;
aWeights.Boundary =  1.0;
aWeights.Normal   =  1.0;
aWeights.Diffuse  =  0.0;
aWeights.Specular =  0.0;
aWeights.Tex[8]   =  {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0};

This default structure is what most applications should use because it considers only geometric and normal adjustment. Only in special cases do the other member fields need to be modified.

Exceptions

InvalidCallException

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

CannotAttributeSortException

Attribute sort is not supported as an optimization technique.

OutOfMemoryExceptionLeave Site

Microsoft Direct3D could not allocate sufficient memory to complete the call.

How Do I...?

Simplify a Mesh

This example demonstrates how to simplify a mesh.

The mesh is simplified by 25 vertices.

In the following C# code example, mesh is assumed to be a Mesh instance that has been properly loaded and cleaned, adjacency is a GraphicsStream instance that contains the mesh adjacency data, and device is the rendering Device.

              [C#]
              

SimplificationMesh simplifiedMesh = new SimplificationMesh(mesh, adjacency);

simplifiedMesh.ReduceVertices(mesh.NumberVertices - 25);

mesh.Dispose();
mesh = simplifiedMesh.Clone(simplifiedMesh.Options.Value, 
                            simplifiedMesh.VertexFormat, device);
simplifiedMesh.Dispose();