-*-text-*-

All configuration options from all sources are specified using the
syntax:

'option name' = 'option value';

Note the equals sign (=) and the semi-colon at the end (;)

The option sources are parsed in the following order:

XBOBBLE1_OPTIONS      Environment variable for additional
		      options (read first)

Global config file    The file named in the config option
		      'global_cfg_file' is opened for additional
		      config options

Personal config file  The file '~/.xbobble1.cfg' is then parsed
		      for more options

Sorry, command line options aren't implemented yet.  Use the
environment variable.

Config options:
---------------

Note: things marked as 'INTERNAL USE ONLY' can't be set by the user.
They are for me.


width: width of output window.  MUST be an integer.
       Default: 640

height: height of output window.  MUST be an integer.
	Default: 640

fullscreen: integer value indicating whether or not to use fullscreen
            mode.  0 is false (window mode), anything else is true
            (fullscreen mode).
	    Default: 0

data_root: path to the game data.  Can be absolute or relative to
	   starting dir.
	   Default: <unset> - MUST be set somewhere in config areas.

global_cfg_file: Global configuration file name, possibly the same or
		 different for each user.
		 Default: <unset> (ie no global config file)

joyindex: Name of joystick device to use, or unset to not have a
	  joystick.
	  Default: <unset> (no joystick)

joyaxis: joystick axis number to use for movement (0 for first, n-1
	 nth).  Note, that variable axes are supported.
	 Default: <unset>

joydeadzone: the inner deadzone in % for a variable axis.  The max
	     deadzone is 80%, in which case, GET A NEW JOYSTICK! :0)
	     Default: 0

GL_TEXTURE_MAG_FILTER: Either GL_NEAREST (fast, ugly, use if using
		       software OpenGL (ie Mesa)) or GL_LINEAR (all
		       accelerated graphics cards should support
		       this.)
		       Default: GL_LINEAR

GL_TEXTURE_MIN_FILTER: As above, although in this case it shouldn't
		       make that much difference, so setting it to
		       GL_NEAREST should be ok.
		       Default: GL_LINEAR

lod: An integer value between 1 and 3 (values more than 3 are clamped
     to 3, less than 1 to 1) specifying the level of detail of the
     graphics. 1 is max detail (many polygons and lights, textures,
     etc.), 2 is good looking graphics (less lights, less polygons,
     but still textured), 3 is crap graphics (1 light, minimum
     polygons, no textures)
     Default: 1

alpha_enabled: If '1' in configuration: turns on alpha blending.  If
	       set to '0' or any value other '1' in configuration:
	       Doesn't do alpha blending
	       Default: '1'

sound_buffer_size: Size of the sound buffer.  Too small and sound will
		   skip.  Too big, and sound will be delayed.
		   512/1024 should be good, 256 for super
		   high-performance and SMP boxes.
		   Default: 1024

highest_level: (INTERNAL USE ONLY) An integer specifying the highest
	       level number to load.  At load time, parses the
	       data/levels directory to find out the highest level
	       available and sets this option.


