================================================ Updated:
Environment variables affecting LibGGI behaviour 990514
================================================
DISPLAY- If set, assumes you want to use the X target. Can be
overriden by the GGI_DISPLAY variable.
GGI_DISPLAY- Target to use when ggiOpen() is called with a NULL argument.
Format: <target>[:<targetargs>]
A list of targets with descriptions can be found in the
targets.txt file.
If neither this or DISPLAY is set targets are tried in the
following order: fbdev, svga, aa
GGI_INPUT_<targetname>
- Specify extra input sources and/or filters for visuals
using <targetname>.
Format: <input>[:<inputargs>]
Multiple inputs can be specified using the notation:
(<i1>):(<i2>):(<i3>) etc...
GGI_INPUT- Specify extra input sources and/or filters for all other
visuals.
Same format as above.
GGI_DEFMODE- The default mode for LibGGI to use. When GGI_AUTO or GT_AUTO
are specified in a mode setting call they will be replaced
with values from GGI_DEFMODE before calling the target's
setmode function.
Format: size virt dpp frames graphtype
size = ['S'] X 'x' Y [ 'x' depth ]
virt = 'V' X 'x' Y
dpp = 'D' X 'x' Y
frames = 'F' frames
graphtype = '[' scheme depth '/' size ']' | scheme depth
scheme = 'C' | 'P' | 'K' | 'T'
All parameters can be specified in any order. Anything and
Everything (!) can be omitted, all ommitted values default
to GGI_AUTO (and GT_AUTO for the graphtype). Whitespace and
'.' symbols ignored. Case insensitive.
Examples include:
640x480 just a visible size
640x480V640x960 same size, but double-height virtual screen
V1024x768 only virtual size defined
80x40[T] (default-bitsized) text mode with 80x40
characters
Vx100[T] text mode with 100 virtual lines
640x400[8] 640x400 at 8 bits per pixel
640x400[GT_8BIT] same as above, but palettized
320x200x15 320x200 with 32768 colors
320x200[C15] 320x200 with 32768 colors (hicolor)
320x200[C/16] 320x200 with 16 bit pixels (also hicolor)
320x200[C24/32] 320x200, 32 bit pixels, 16777216 colors
(truecolor)
320x200[GT_32BIT] same as above
GGI_DEBUG- Debug level for LibGGI:
0 or unset - debug output is offdebugging is off
255 - all debug output is on
You may also 'or' any of the following together:
2 - debug core
4 - debug mode setting
8 - debug color handling
16 - debug drawing
32 - misc debugging output
64 - debug dynamic library handling
128 - debug event handling
GGI_DEBUGSYNC- Turn on synchronous debug output. Flush the output buffers
before returning from GGIDPRINT calls.
FRAMEBUFFER- Specifies which device file the fbdev target should use.
GGI_NEWVT- Will cause a new VT to be allocated for some Linux-console
based targets (currently fbdev and glide).
GGI_MANSYNC_FPS - Specify the framerate for targets using mansync to do
SYNC mode. The default is 20fps.
If you are experiencing problems with the X target over
relatively slow remote connections it might be due to
connection overload. You might want to try with a lower
GGI_MANSYNC_FPS setting.
GGI_FBDEV_OPTIONS, GGI_FILE_OPTIONS, GGI_GLIDE_MAXFREQ, GGI_GLIDE_MAXHFREQ,
GGI_GLIDE_HALTONSWITCH, GGI_PALEMU_OPTIONS, and GGI_TRUEEMU_OPTIONS are target
specific environment variables. See the file targets.txt for descriptions of
those.