geo3d.visualization.web

Web visualization session using Open3D WebRTC.

Attributes

_WEBRTC_ENABLED

Classes

WebVisualizerSession

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

Functions

enable_webrtc_once(→ None)

Enable Open3D WebRTC support for the current process.

Module Contents

geo3d.visualization.web._WEBRTC_ENABLED = False
geo3d.visualization.web.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.

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

Bases: altametris.geo3d.visualization.session.VisualizerSession

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

background = (1, 1, 1)
point_size = 3
port = 8888
queue: multiprocessing.queues.Queue[Any] | None
process: multiprocessing.process.BaseProcess | None
show(geometries: list[open3d.geometry.PointCloud], title: str) → None

Show geometries in the web visualizer.

Parameters:

  • geometries (list[o3d.geometry.PointCloud]) – List of Open3D geometries to display.

  • title (str) – Title shown in the web page.

update(geometries: list[open3d.geometry.PointCloud], title: str) → None

Send geometries to the web visualization process for rendering.

Parameters:

  • geometries (list[o3d.geometry.PointCloud]) – List of Open3D geometries to display.

  • title (str) – Title shown in the web page.

close() → None

Gracefully close the web visualizer process and release resources.

static _run(queue: multiprocessing.Queue, background: tuple[float, float, float], point_size: int, port: int) → None

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.

Parameters:

  • queue (mp.Queue) – Multiprocessing queue used to receive update messages.

  • background (tuple(float, float, float)) – Background color for the visualization as normalized RGB.

  • point_size (int) – Rendered point size for displayed points.

  • port (int) – HTTP port for the WebRTC server.