.. _group__a3d__multiple__vertex:

######################################
Vertex defined with multiple positions
######################################

Entity type is :c:enumerator:`~kA3DTypeTopoMultipleVertex`\ .

A multiple vertex is defined as the average position of several 3D points, which are typically the endpoints of edge curves that end at this vertex.




   In general, no constraint is given to the 3D points stored in the array referenced by the :c:member:`A3DTopoMultipleVertexData::m_pPts <A3DTopoMultipleVertexData.m_pPts>`\ member. In particular, the same point (same coordinates) may appear multiple times in that array. This is a common behavior, and all these points must be taken into account to evaluate the tolerance.


**Returns**


   ``A3D_SUCCESS``\ on success, or an error code on failure


.. rst-class:: kind-group kind-record

.. rubric:: Structures
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:struct:`~A3DTopoMultipleVertexData`

.. rst-class:: kind-group kind-function

.. rubric:: Functions
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:func:`~A3DTopoMultipleVertexGet`
* :c:func:`~A3DTopoMultipleVertexCreate`

.. toctree::
   :maxdepth: 1
   :hidden:

   ../structures/A3DTopoMultipleVertexData
   ../functions/A3DTopoMultipleVertexGet
   ../functions/A3DTopoMultipleVertexCreate


