create_connection#

Omniverse.create_connection(omniverse_path: str, include_camera: bool = False, normalize_geometry: bool = False, live: bool = True, debug_filename: str = '') None#

Ensure that an EnSight dsg -> omniverse server is running

Connect the current EnSight session to an Omniverse server. This is done by launching a new service that makes a dynamic scene graph connection to the EnSight session and pushes updates to the Omniverse server. The initial EnSight scene will be pushed after the connection is established.

Parameters:
omniverse_pathstr

The URI to the Omniverse server. It will look like this: “omniverse://localhost/Users/test”

include_camerabool

If True, apply the EnSight camera to the Omniverse scene. This option should be used if the target viewer is in AR/VR mode. Defaults to False.

normalize_geometrybool

Omniverse units are in meters. If the source dataset is not in the correct unit system or is just too large/small, this option will remap the geometry to a unit cube. Defaults to False.

livebool

If True, one can call ‘update()’ to send updated geometry to Omniverse. If False, the Omniverse connection will push a single update and then disconnect. Defaults to True.

debug_filenamestr

If the name of a file is provided, it will be used to save logging information on the connection between EnSight and Omniverse.