Share via

ProgressiveMesh.ProgressiveMesh(Mesh,Int32[],AttributeWeights,Int32,MeshFlags) Constructor (Microsoft.DirectX.Direct3D)

  • Article

Creates a new instance of the ProgressiveMesh class.

Definition

Visual Basic Public Sub New( _
    ByVal mesh As Mesh, _
    ByVal adjacency() As Integer, _
    ByVal vertexAttributeWeights As AttributeWeights, _
    ByVal minValue As Integer, _
    ByVal options As MeshFlags _
)
C# public ProgressiveMesh(
    Mesh mesh,
    int[] adjacency,
    AttributeWeights vertexAttributeWeights,
    int minValue,
    MeshFlags options
);
C++ public:
 ProgressiveMesh(
    Mesh^ mesh,
    array<int>^ adjacency,
    AttributeWeights vertexAttributeWeights,
    int minValue,
    MeshFlags options
);
JScript public function ProgressiveMesh(
    mesh : Mesh,
    adjacency : int[],
    vertexAttributeWeights : AttributeWeights,
    minValue : int,
    options : MeshFlags
);

Parameters

mesh Microsoft.DirectX.Direct3D.Mesh
A Mesh object that represents the source mesh.
adjacency System.Int32[]
Array of three Int32Leave Site values per face that specify the three neighbors for each face in the created progressive mesh.
vertexAttributeWeights Microsoft.DirectX.Direct3D.AttributeWeights
An AttributeWeights structure that contains the weight for each vertex component. If this parameter is omitted, a default structure is used. See Remarks.
minValue System.Int32
Number of vertices or faces (depending on which flag is set in the param_MeshFlags_options parameter) by which to simplify the source mesh.
options Microsoft.DirectX.Direct3D.MeshFlags
Simplification options for the mesh. Either SimplifyFace or SimplifyVertex can be set.

Remarks

This method generates a mesh in which the level of detail (LOD) can be adjusted from the current value to the param_Int32_minValue vertices or faces.

If the simplification process cannot reduce the mesh to param_Int32_minValue, the call still succeeds, because param_Int32_minValue is a desired minimum, not an absolute minimum.

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

CannotAttributeSortException

Attribute sort (D3DXMESHOPT_ATTRSORT) is not supported as an optimization technique.

InvalidCallException

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

OutOfMemoryExceptionLeave Site

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