Mesh.WeldVertices Method

Language:

Welds together replicated vertices that have equal attributes.

Definition

Visual Basic Public Sub WeldVertices( _
    ByVal flags As WeldEpsilonsFlags, _
    ByVal epsilons As WeldEpsilons, _
    ByVal adjacencyIn() As Integer _
)
C# public void WeldVertices(
    WeldEpsilonsFlags flags,
    WeldEpsilons epsilons,
    int[] adjacencyIn
);
C++ public:
void WeldVertices(
    WeldEpsilonsFlags flags,
    WeldEpsilons epsilons,
    array<int>^ adjacencyIn
);
JScript public function WeldVertices(
    flags : WeldEpsilonsFlags,
    epsilons : WeldEpsilons,
    adjacencyIn : int[]
);

Parameters

flags Microsoft.DirectX.Direct3D.WeldEpsilonsFlags
One or more flags from WeldEpsilonsFlags.
epsilons Microsoft.DirectX.Direct3D.WeldEpsilons
A WeldEpsilons structure that specifies the epsilon values to use for this method.
adjacencyIn System.Int32[]
Array of three Int32 Leave Site values per face that specify the three neighbors for each face in the source mesh. If the edge has no adjacent faces, the value is 0. If this parameter is omitted, BaseMesh.GenerateAdjacency is called to create logical adjacency information.

Remarks

This method compares logically-welded vertices and combines those with similar components, such as normals or texture coordinates within param_WeldEpsilons_epsilons. It uses the provided adjacency information to determine which points are replicated, and performs an epsilon comparison to merge vertices. Those vertices with equal positions must already have been calculated and represented by point-representative data.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.
OutOfMemoryException Leave Site Microsoft Direct3D could not allocate sufficient memory to complete the call.


Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

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