PointTable
==========

.. py:class:: py3dm.PointTable

   Python wrapper providing access to ``ON_Point`` objects stored in an
   ``ONX_Model``.

   This class offers a convenient interface for adding, retrieving, counting,
   and iterating over points objects.

   ``PointTable`` does not own the underlying data; it operates on the
   associated ``ONX_Model`` instance.


   .. py:method:: __iter__() -> collections.abc.Iterator[PointGeometry]


   .. py:method:: __len__() -> int


   .. py:method:: add(x: float, y: float, z: float, obj_attr: None | ObjectAttributes = None) -> uuid.UUID
                  add(point: PointGeometry, obj_attr: None | ObjectAttributes = None) -> uuid.UUID
                  add(point: Point3d, obj_attr: None | ObjectAttributes = None) -> uuid.UUID

      Returns the ``UUID`` of the point in case of successful addition, or
      an empty ``UUID`` otherwise. If the point is in the model, then the
      ``UUID`` is unique for all components in the model and is locked.



   .. py:method:: count() -> int

      Returns the number of objects of type ``ON::point_object`` in the
      model.



   .. py:method:: get_by_uuid(object_uuid: uuid.UUID) -> PointGeometry | None

      Returns the object with the given ``object_uuid`` or ``None`` if
      ``object_uuid`` is not found.