robokudo.types.cv
=================

.. py:module:: robokudo.types.cv

.. autoapi-nested-parse::

   Computer vision types for Robokudo.

   This module provides types for computer vision operations including:

   * 2D and 3D point representations
   * Rectangle and region of interest definitions
   * 3D bounding box specifications

   The types support integration with:
   * OpenCV for image processing
   * Open3D for point cloud handling
   * Transform system for poses



Classes
-------

.. autoapisummary::

   robokudo.types.cv.Point2D
   robokudo.types.cv.Points3D
   robokudo.types.cv.Rect
   robokudo.types.cv.ImageROI
   robokudo.types.cv.BoundingBox3D


Module Contents
---------------

.. py:class:: Point2D

   Bases: :py:obj:`robokudo.types.core.Type`


   2D point representation.

   Represents a point in 2D image coordinates.


   .. py:attribute:: x
      :type:  int
      :value: 0


      X coordinate



   .. py:attribute:: y
      :type:  int
      :value: 0


      Y coordinate



.. py:class:: Points3D

   Bases: :py:obj:`robokudo.types.core.Type`


   3D point cloud container.

   Wraps an Open3D point cloud for 3D point operations.


   .. py:attribute:: points
      :type:  open3d.geometry.PointCloud
      :value: None


      The actual Open3D point cloud object



.. py:class:: Rect

   Bases: :py:obj:`robokudo.types.core.Type`


   2D rectangle representation.

   Defines a rectangle by its top-left corner position and dimensions.


   .. py:attribute:: pos
      :type:  Point2D

      Top-left corner position



   .. py:attribute:: width
      :type:  int
      :value: 0


      Rectangle width in pixels



   .. py:attribute:: height
      :type:  int
      :value: 0


      Rectangle height in pixels



.. py:class:: ImageROI

   Bases: :py:obj:`robokudo.types.core.Type`


   Image region of interest.

   Defines a region of interest in an image using:
   * Binary mask for arbitrary shapes
   * Rectangle for bounding region


   .. py:attribute:: mask
      :type:  numpy.typing.NDArray
      :value: None


      Binary opencv mask image



   .. py:attribute:: roi
      :type:  Rect

      Rectangular region of interest



.. py:class:: BoundingBox3D

   Bases: :py:obj:`robokudo.types.core.Type`


   3D oriented bounding box.

   Represents a 3D box with:
   * Dimensions along each axis
   * 6-DOF pose defining orientation and position


   .. py:attribute:: x_length
      :type:  float
      :value: 0.0


      Box length along x-axis



   .. py:attribute:: y_length
      :type:  float
      :value: 0.0


      Box length along y-axis



   .. py:attribute:: z_length
      :type:  float
      :value: 0.0


      Box length along z-axis



   .. py:attribute:: pose
      :type:  robokudo.types.tf.Pose

      Box pose in 3D space