https://jogamp.org/wiki/index.php?action=history&feed=atom&title=How_to_use_X11_displays 2026-04-21T13:21:52Z Revision history for this page on the wiki MediaWiki 1.44.0 https://jogamp.org/wiki/index.php?title=How_to_use_X11_displays&diff=936&oldid=prev 2013-06-13T10:24:46Z

<p>Created page with &#039;In JOGL, there is always one X11 display that is designated as the &#039;&#039;default display&#039;&#039;. By default, this is the display specified by the environment variable &#039;&#039;&#039;DISPLAY&#039;&#039;&#039;. When …&#039;</p> <p><b>New page</b></p><div>In JOGL, there is always one X11 display that is designated as the &#039;&#039;default display&#039;&#039;. By default, this is the display specified by the environment variable &#039;&#039;&#039;DISPLAY&#039;&#039;&#039;. When running a Desktop Linux this variable is inherited to all processes such that nothing special has to be done to use JOGL for this standard case.<br /> <br /> Using a different default display is possible by either changing the &#039;&#039;&#039;DISPLAY&#039;&#039;&#039; environment variable prior to running the Java process, or alternatively by specifying the Java system property &#039;&#039;&#039;nativewindow.x11.display.default&#039;&#039;&#039; prior to invoking any JOGL code (see [https://github.com/sgothel/jogl/blob/master/src/test/com/jogamp/opengl/test/junit/jogl/acore/TestX11DefaultDisplay.java?source=cc| this test case]). The system property has precedence over the environment variable if both are set. Using the system property can be useful in situations where the environment variable cannot be changed before running the Java process. This might be the case if the logic for choosing the right display is only known at runtime (think about server-based rendering with several available virtual displays (using X virtual framebuffers) where each render node (a Java process) reads its configuration (the display to use) on program start).<br /> <br /> Apart from changing the default display, JOGL allows to connect to additional (e.g. remote) displays. See [https://github.com/sgothel/jogl/blob/master/src/test/com/jogamp/opengl/test/junit/newt/TestRemoteGLWindows01NEWT.java?source=cc| this example] or [https://github.com/sgothel/jogl/blob/master/src/test/com/jogamp/opengl/test/junit/newt/TestRemoteWindow01NEWT.java?source=cc| this example].</div>

Mriechert