libgii : A flexible library for input handling

LibGII is an input library developed by the GGI Project. Its design philosophy is similar to LibGGI, which deals with graphics output. LibGII is based on the concept of input streams, which virtualize access to the underlying input drivers. Events from various input devices are abstracted into easy-to-use structures. LibGII also allows the application to join streams together, receiving input from an arbitrary combination of devices.

LibGII is a separate component from LibGGI, although LibGGI depends on LibGII for input purposes. (LibGGI's input functions are simply wrappers for LibGII functions.)

The following outlines the environment variables, intended for the user, which affect the behaviour of LibGII:

GII_INPUT The default input source(s) and/or filter(s) to use when giiOpen() is called with a NULL argument. The format is: CWinput:inputargs. Multiple inputs can be specified by this notation: CW(i1):(i2) .... Note: This setting does not affect LibGGI visuals automatically opening inputs. Use the CWGGI_INPUTx variable instead.

GGI_DEBUG

The debug level for LibGII:

•

0 or unset : debug output is off; debugging is off

•

255 : all debug output is on

You may also bitwise 'or' any of the following together:

•

2 : debug core

•

32 : misc debugging output

•

64 : debug dynamic library handling

•

128 : debug event handling

GGI_DEBUGSYNC

Turn on synchronous debug output, flushing the output buffers before returning from DPRINT calls.

GGI_CONFDIR

Override compiled-in path to global config files (Win32 only, but not Cygwin).

Note that the last three environment variables really begin with GGI, and not GII.

Other environment variables specific to filters and inputs are documented in the corresponding manual page.

CWfilter-keytrans(7), CWfilter-mouse(7), CWfilter-save(7), CWfilter-tcp(7), CWinput-directx(7), CWinput-linux-kbd(7), CWinput-mouse(7), CWinput-file(7), CWinput-linux-mouse(7), CWinput-tcp(7), CWinput-linux-evdev(7), CWinput-lk201(7).