DragonFly On-Line Manual Pages

BUGLE-EXTOVERRIDE(7)           Bugle user manual          BUGLE-EXTOVERRIDE(7)

NAME
       bugle-extoverride - hide OpenGL extensions from an application

SYNOPSIS
       filterset extoverride
       {
           version "1.5"
           disable "all"
           disable "extension"
           enable "extension"
       }

DESCRIPTION
       The extoverride filter-set modifies the version and extension strings
       to hide driver capabilities from the application. The primary use is to
       test an application to ensure that it works correctly on drivers that
       do not offer these capabilities.

       Apart from modifying these strings, a warning is printed to the log if
       any function from one of these extensions is called.

OPTIONS
       version
           Sets a new value for GL_VERSION. However, if the true value is
           lexicographically smaller than this value, the true value is used.

       disable "all"
           By default, extensions are exposed unless explicitly disabled. This
           option reverses the behaviour to hide all extensions that are not
           explicitly enabled.

       disable "extension"
           Hides the named extension from the application. A warning is
           printed if the extension was not known at the time bugle was
           compiled; in this case it will still be hidden, but there will not
           be any warning if it is used anyway.

       enable "extension"
           Like the disable option, but enables an extension when the default
           is disabled.

BUGS
       Warnings are only printed if functions from the disabled extensions are
       called. At present, no warning will be printed if tokens from those
       extensions are passed (which is difficult to determine, since multiple
       tokens may share the same numeric value). Furthermore, some extensions
       alter semantics without explicit functions or tokens, such as
       GL_ARB_texture_non_power_of_two; no warnings are issued if these
       extensions are used.

       Also note that extension loader libraries may interfere with the
       warning mechanism. For example, GLee uses wrappers that cause illegal
       function calls to be silently ignored.

AUTHOR
       bugle is written and maintained by Bruce Merry.

SEE ALSO
       bugle(3), bugle-log(7), bugle-showextensions(7)

BUGLE 0.0.20091026               October 2007             BUGLE-EXTOVERRIDE(7)