
------------------------------------------------------------------------
                         LuxMan `Hackers Guide'
------------------------------------------------------------------------

(1) Bitmaps and level maps:
---------------------------

If you feel inclined to edit the bitmaps or levels, you will want
to check out the programs `maped' and `mapchk':

	maped: (/lux/gtools/maped)
	------------------------------------------------

	One of the utils in the `gtools' directory is named
	`maped'. This is a bitmap editor that lets you edit the
	level maps as well as the images.

	The maps are stored in files named `mNN.map', where
	NN is a number. Note that they are not really in
	numerical order. Sorry. There is a structure in
	./lux/src/play.cc around line 53 that defines which
	maps are which.

	The map editor requires a mouse.

	Put down WHITE square for tiles, {LIGHTBLUE,RED,GREEN,MAGENTA}
     	for each of the 4 ghosts, and LIGHTCYAN for luxman.

	There is an additional `transparent' color. It is located
	on the right side of the screen just above the main color
	palette. Painting with `transparent' indicates areas where
	you do NOT want `dots'.

	See the file `./lux/src/colors.h' to get the most up-to-date
	definition of what the colors mean.

        If you want to change the tile used to paint the walls,
        use `maped' to edit the file `tile.map'.

        The ghosts are in files `ghost_x.map' where `x' is (l,r,u,d).

        LuxMan images are in files `lux_dn.map' where `d' is (l,r,u,d -
	the 4 directions) and `n' is 1-4, indicating animation cycle
	number.

	mapchk:	(/lux/src/mapchk)
	-------------------------

	This program checks a mapfile to ensure that the `eyes'
	will never get stuck (not be able to find their way back
	to `home').
	If it tells you there is a failure, you can try either
	editing the mapfile to fix the problem area, or
	try increasing the maximum search depth with the
	`--depth' switch.
	If you find a different `--depth' setting works nicely,
	you can pass the depth argument to `map' also.

	IF YOU MODIFY THE MAPS YOU SHOULD DEFINATELY CHECK THEM
	WITH `mapchk'!!! If there is a problem, the program
	WILL CRASH when the eyes can't find a path. (It will
	crash `nicely' though, i.e. you won't have to reboot.)

(2) Sounds
----------

	See ./lux/11k/README for a description of each .snd file.
	If you want to substitute your own sounds, simply copy
	the new file over the old file.
	
---------------------------------------------------------------------------


