From 5558ac5546476545f207301966053090a688e5e2 Mon Sep 17 00:00:00 2001 From: Ian Chen Date: Tue, 15 Aug 2023 12:06:44 -0700 Subject: [PATCH] Add wayland troubleshooting section (#356) Signed-off-by: Ian Chen --- fortress/troubleshooting.md | 17 +++++++++++++++++ garden/troubleshooting.md | 17 +++++++++++++++++ harmonic/troubleshooting.md | 17 +++++++++++++++++ 3 files changed, 51 insertions(+) diff --git a/fortress/troubleshooting.md b/fortress/troubleshooting.md index 277f2b0fc..9d5d132ab 100644 --- a/fortress/troubleshooting.md +++ b/fortress/troubleshooting.md @@ -165,6 +165,23 @@ that's working by running a world which uses Ogre 1 instead of Ogre 2, such as: If that loads, you can continue to use Ignition with Ogre 1, just use the `--render-engine ogre` option. +### Wayland issues + +For users on Wayland, you will need to make sure Gazebo is launched with +XWayland. + +If you see an error message like the one below: + +``` +Unable to create the rendering window: OGRE EXCEPTION(3:RenderingAPIException): currentGLContext was specified with no current GL context in GLXWindow::create at ./RenderSystems/GL3Plus/src/windowing/GLX/OgreGLXWindow.cpp (line 165) +``` + +try unsetting the `WAYLAND_DISPLAY` environment variable, e.g. + +```sh +env -u WAYLAND_DISPLAY ign gazebo -v 4 shapes.sdf +``` + ## Windows ### VisualStudioVersion is not set, please run within a Visual Studio Command Prompt. diff --git a/garden/troubleshooting.md b/garden/troubleshooting.md index e53e629ba..db9dc0136 100644 --- a/garden/troubleshooting.md +++ b/garden/troubleshooting.md @@ -168,6 +168,23 @@ that's working by running a world which uses Ogre 1 instead of Ogre 2, such as: If that loads, you can continue to use Gazebo with Ogre 1, just use the `--render-engine ogre` option. +### Wayland issues + +For users on Wayland, you will need to make sure Gazebo is launched with +XWayland. + +If you see an error message like the one below: + +``` +Unable to create the rendering window: OGRE EXCEPTION(3:RenderingAPIException): currentGLContext was specified with no current GL context in GLXWindow::create at ./RenderSystems/GL3Plus/src/windowing/GLX/OgreGLXWindow.cpp (line 165) +``` + +try unsetting the `WAYLAND_DISPLAY` environment variable, e.g. + +```sh +env -u WAYLAND_DISPLAY gz sim -v 4 shapes.sdf +``` + ## Windows ### VisualStudioVersion is not set, please run within a Visual Studio Command Prompt. diff --git a/harmonic/troubleshooting.md b/harmonic/troubleshooting.md index 94536837a..cd2e5fc76 100644 --- a/harmonic/troubleshooting.md +++ b/harmonic/troubleshooting.md @@ -163,6 +163,23 @@ that's working by running a world which uses Ogre 1 instead of Ogre 2, such as: If that loads, you can continue to use Ignition with Ogre 1, just use the `--render-engine ogre` option. +### Wayland issues + +For users on Wayland, you will need to make sure Gazebo is launched with +XWayland. + +If you see an error message like the one below: + +``` +Unable to create the rendering window: OGRE EXCEPTION(3:RenderingAPIException): currentGLContext was specified with no current GL context in GLXWindow::create at ./RenderSystems/GL3Plus/src/windowing/GLX/OgreGLXWindow.cpp (line 165) +``` + +try unsetting the `WAYLAND_DISPLAY` environment variable, e.g. + +```sh +env -u WAYLAND_DISPLAY gz sim -v 4 shapes.sdf +``` + ## Windows ### VisualStudioVersion is not set, please run within a Visual Studio Command Prompt.