diff --git a/dome/index.yaml b/dome/index.yaml index dbe67c226..1a3230791 100644 --- a/dome/index.yaml +++ b/dome/index.yaml @@ -84,3 +84,6 @@ pages: - name: actors title: Actors file: actors.md + - name: web_visualization + title: Web Visualization + file: web_visualization.md diff --git a/dome/web_visualization.md b/dome/web_visualization.md new file mode 100644 index 000000000..6305f2f34 --- /dev/null +++ b/dome/web_visualization.md @@ -0,0 +1,70 @@ +# Overview + +Web visualization supports rendering and interacting with running Ignition +Gazebo simulations. You may find web visualization useful +when interacting with remote or headless Ignition Gazebo simulations. No +additionally dependencies, other than a browser and internet connection, are +required. + +## How to use web visualization + +The following steps will guide you through the process of running Ignition +Gazebo with a websocket server and connecting to the websocket for +visualization. + +1. Start an Ignition Gazebo instance as usual. We will use the `fuel.sdf` + world and run it headless. +``` +ign gazebo -v 4 -s -r fuel.sdf +``` + +1. Create an Ignition Launch file with the websocket server plugin. +``` +echo " + + + 9002 + +" > websocket.ign +``` + +1. Run the websocket server using +``` +ign launch -v 4 websocket.ign +``` + +1. Visualize the simulation by going to + [https://app.ignitionrobotics.org/visualization](https://app.ignitionrobotics.org/visualization) and pressing the Connect button. + +1. It may take a few seconds for the scene to load. Your browser needs to + fetch all of the models in the world. + +## Websocket server customization + +The following parameters are available in the websocket server plugin. + + * `` : If this is set, then a connection must provide the matching key using an "auth" call on the websocket. If the `` is set, then the connection can provide that key. + * `` : If this is set, then a connection must provide the +matching key using an "auth" call on the websocket. If the `` is set, then the connection can provide that key. + * `` : An integer that is the maximum number of simultaneous connections. + * `` : An integer that is websocket port. + * `` : An integer that is the maximum publication hertz rate. + +## Code and Support + +1. The code for the web application, + [app.ignitionrobotics.org](https://app.ignitionrobotics.org), lives at + [https://gitlab.com/ignitionrobotics/web/app](https://gitlab.com/ignitionrobotics/web/app). + +1. The javascript library used to render the 3D scene lives at + [https://gitlab.com/ignitionrobotics/web/gz3d](https://gitlab.com/ignitionrobotics/web/gz3d). + +1. Is you notice an issue with web visualization, then please + file a ticket at + [https://gitlab.com/ignitionrobotics/web/app/-/issues](https://gitlab.com/ignitionrobotics/web/app/-/issues). + +## Troubleshooting + +1. If you are running Ignition Gazebo in a docker container, make sure to + use the [--network host](https://docs.docker.com/network/network-tutorial-host/) Docker commandline option. Without `--network host` the web application won't be able to connect to the websocket server.