LIBGII(I)             LibGII Reference            LIBGII(I)



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 combi-
       nation 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 out-
              put buffers before returning from DPRINT calls.



GGI                       22 August 2001             LIBGII(I)