geo3d.visualization.web
=======================

.. py:module:: geo3d.visualization.web

.. autoapi-nested-parse::

   Web visualization session using Open3D WebRTC.



Attributes
----------

.. autoapisummary::

   geo3d.visualization.web._WEBRTC_ENABLED


Classes
-------

.. autoapisummary::

   geo3d.visualization.web.WebVisualizerSession


Functions
---------

.. autoapisummary::

   geo3d.visualization.web.enable_webrtc_once


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

.. py:data:: _WEBRTC_ENABLED
   :value: False


.. py:function:: enable_webrtc_once() -> None

   Enable Open3D WebRTC support for the current process.

   This function is intentionally safe to call multiple times; the WebRTC
   backend is initialized only once.


.. py:class:: WebVisualizerSession(background: tuple[float, float, float] = (1, 1, 1), point_size: int = 3, port: int = 8888)

   Bases: :py:obj:`altametris.geo3d.visualization.session.VisualizerSession`


   Web-based Open3D visualization session managed in a separate process.


   .. py:attribute:: background
      :value: (1, 1, 1)



   .. py:attribute:: point_size
      :value: 3



   .. py:attribute:: port
      :value: 8888



   .. py:attribute:: queue
      :type:  multiprocessing.queues.Queue[Any] | None


   .. py:attribute:: process
      :type:  multiprocessing.process.BaseProcess | None


   .. py:method:: show(geometries: list[open3d.geometry.PointCloud], title: str) -> None

      Show geometries in the web visualizer.

      :param geometries: List of Open3D geometries to display.
      :type geometries: list[o3d.geometry.PointCloud]
      :param title: Title shown in the web page.
      :type title: str



   .. py:method:: update(geometries: list[open3d.geometry.PointCloud], title: str) -> None

      Send geometries to the web visualization process for rendering.

      :param geometries: List of Open3D geometries to display.
      :type geometries: list[o3d.geometry.PointCloud]
      :param title: Title shown in the web page.
      :type title: str



   .. py:method:: close() -> None

      Gracefully close the web visualizer process and release resources.



   .. py:method:: _run(queue: multiprocessing.Queue, background: tuple[float, float, float], point_size: int, port: int) -> None
      :staticmethod:


      Start the web visualization worker process.

      This method is executed inside the spawned child process. It initializes
      Open3D WebRTC on the configured port, listens for geometry update
      messages from the parent process, and applies received geometries
      to the web-based viewer.

      :param queue: Multiprocessing queue used to receive update messages.
      :type queue: mp.Queue
      :param background: Background color for the visualization as normalized RGB.
      :type background: tuple(float, float, float)
      :param point_size: Rendered point size for displayed points.
      :type point_size: int
      :param port: HTTP port for the WebRTC server.
      :type port: int