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, _
    ByRef vertexRemap As GraphicsStream _
)

C# public void WeldVertices(
    WeldEpsilonsFlags flags,
    WeldEpsilons epsilons,
    int[] adjacencyIn,
    out GraphicsStream vertexRemap
);

C++ public:
void WeldVertices(
    WeldEpsilonsFlags flags,
    WeldEpsilons epsilons,
    array<int>^ adjacencyIn,
    [Out] GraphicsStream^% vertexRemap
);

JScript public function WeldVertices(
    flags : WeldEpsilonsFlags,
    epsilons : WeldEpsilons,
    adjacencyIn : int[],
    vertexRemap : GraphicsStream
);

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

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 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.

vertexRemap Microsoft.DirectX.GraphicsStream
A GraphicsStream object that contains the new index for each vertex.

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 Microsoft Direct3D could not allocate sufficient memory to complete the call.

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

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 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.
vertexRemap	Microsoft.DirectX.GraphicsStream A GraphicsStream object that contains the new index for each vertex.

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