Running GtkGLExt Applications

Running GtkGLExt Applications — How to run and debug your GtkGLExt application

Running and debugging GtkGLExt Applications

Common command line options

All GtkGLExt applications support the following command line options. These are removed from argv by gtk_gl_init().

--install-gl-colormap Install OpenGL window's colormap to the top-level window. If window manager doesn't watch the WM_COLORMAP_WINDOWS property on the top-level window, we have to set OpenGL window's colormap to the top-level window, especially in color index mode (color index mode uses own private colormap).

--gtk-gl-debug options A list of debug options to turn on in addition to those specified in the GTK_GL_DEBUG environment variable. This option is only available if GtkGLExt has been configured with --enable-debug=yes.

--gtk-gl-no-debug options A list of debug options to turn off. This option is only available if GtkGLExt has been configured with --enable-debug=yes.

The following options are really used by GdkGLExt library.

--gdk-gl-debug options A list of debug options to turn on in addition to those specified in the GDK_GL_DEBUG environment variable. This option is only available if GtkGLExt has been configured with --enable-debug=yes.

--gdk-gl-no-debug options A list of debug options to turn off. This option is only available if GtkGLExt has been configured with --enable-debug=yes.


Environment variables

GtkGLExt inspects the following environment variables.

GTK_GL_INSTALL_COLORMAP If this variable is set to 1, GtkGLExt will try to install colormap to the top-level window. If window manager doesn't watch the WM_COLORMAP_WINDOWS property on the top-level window, we have to set OpenGL window's colormap to the top-level window.

GTK_GL_DEBUG If GtkGLExt has been configured with --enable-debug=yes, this variable can be set to a list of debug options, which cause GtkGLExt library to print out different types of debugging information.

misc

Miscellaneous information

func

Show function call information

The special value all can be used to turn on all debug options.

GDK_GL_DEBUG If GtkGLExt has been configured with --enable-debug=yes, this variable can be set to a list of debug options, which cause GdkGLExt library to print out different types of debugging information.

misc

Miscellaneous information

func

Show function call information

impl

Show window system specific (GLX, WGL) function call information

The special value all can be used to turn on all debug options.