man fgl_glxgears (1): display info about a GLX extension and OpenGL renderer

SYNOPSIS

fgl_glxgears [-display display] [-loop frames] [-info] [-fbo]
fgl_glxgears [-help]

DESCRIPTION

fgl_glxgears

is a modified version of the original glxgears(1) demo, which demonstrates the usage of pixel buffers (pbuffers) with an ATI graphics board and a patched version of libGL.so.

The three gear wheels are rendered to a pbuffer or frame buffer object instead of to a window. The result is texture mapped on the four faces of a cube. Using the arrow keys, you can change the position relative to the gears.

OPTIONS

Without an option, fgl_glxgears prints a brief adapter info. To get a more verbose output, you should make use of the following command line options:

-display display

: Use this option to specify the display, where the output should be redirected. Use the DISPLAY environment variable to get the default host, display number and screen (default).

-loop frames

: Exit the application after the defined number of frames.

-info

: Print GLX information (vendor etc.) to stdout. This cannot be used with -fbo option.

-fbo

: Use GL_EXT_framebuffer_object instead of GLX_SGIX_pbuffer.

-help

: Print a short summary of options and their usage.

DIAGNOSTICS

The following diagnostics may be issued:

fglX11AllocateManagedSurface: __FGLTexMgrCreateObject failed!!
FGLTexMgr: open of shared memory object failed (..)
__FGLTexMgrCreateObject: __FGLTexMgrSHMmalloc failed!!!

: You don't have POSIX shared memory enabled on your system. Please refer to your kernel documentation and mount(8) for information about how to enable POSIX shared memory support.

FGLTexMgr: open of shared memory object failed (Permission denied)

: The file /dev/shm/ATISHM00 already exists and you simply lack permission to overwrite it or the directory has bad permissions. Fix the one or the other.

Error: couldn't get fbconfig

: This error occurs if there is a problem with ATI's version of libGL.so. Maybe the diversion does not work properly or you did overwrite this library with the one derived from DRI or you have conflicting versions installed. Try updatedb(1), locate(1) and dpkg-divert(1). See also the following warning.

fglrx: libGL version undetermined - OpenGL module is using glapi fallback

: See above.

libGL error: XF86DRIQueryDirectRenderingCapable returned false

: Ensure you are loading the correct modules for your AGP chipset before you load the fglrx(4x) kernel module. To determine which modules you'll need, check lspci | grep -i agp.

libGL error: failed to open DRM: Operation not permitted
libGL error: reverting to (slow) indirect rendering

: You probably simply miss the permission to open a DRM device. Check Section "DRI" of your xorg.conf(5x).

ENVIRONMENT

DISPLAY

: To get the default host, display number and screen.

LIBGL_DEBUG

: Set this variable to verbose to print more diagnostic messages, e.g. if the DRI driver fails to load. This could be useful if you observe problems with your 3D acceleration. Any error message printed should be (hopefully) self-explanatory.

AUTHOR

Daniel Leidert <[email protected]>

: Author.

COPYRIGHT

See the file /usr/share/doc/fglrx_man/COPYING for license and warranty information.