================================================ Updated: Environment variables affecting LibGGI behaviour 990514 ================================================ DISPLAY - If set, assumes you want to use the X target. Can be overridden 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 DPRINT 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.