Name

libgii — A flexible library for input handling

Description

LibGII is an input library developed by the GGI Project (http://www.ggi-project.org). 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.)

Environment variables

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

GII_INPUT

The default input source to use. The format is:

	    input
	    [
	    :inputargs
	    ]
	    

Multiple inputs can be specified by this notation:

	  (i1)
	  :
	  (i2) ...
	  

Note

This setting does not affect LibGGI visuals automatically opening inputs. Use the GGI_INPUTx 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.