MixMaps ver 1.0 

As I said in InkWorks, I havn't spelled 'colour' wrong, I dont live in
America :)
MixMaps isn't freeware, consider it part of InkWorks so if you find it
useful you have to 'register' InkWorks - this involves mailing a Postcard.
(OOOOhhh)

This program was written quickly, it hasn't got a proper user interface so
if you screw up it might crash or spit out some meaninless error etc.
I am assuming you know how the COLORMAP tables work (if you dont and want
to learn, get the unoffical DOOM specs, playing around with InkWorks should
also give you some 'hands-on' ideas of how the system works).

MixMaps is a side-kick util for InkWorks, it should really be packaged with
InkWorks but it wasn't written when I released InkWorks. If you dont have
InkWorks get it (or MixMaps is pretty useless), it should be under the file
name INKWKS11.ZIP.

to run MixMaps you edit a text file (say 'myfile.mm') telling it what to do
and go:

mixmaps myfile.mm

it will then do its mixing/compositing and write the output to the file
MIXMAPS.WAD.

What does it do:
MixMaps takes entries from COLORMAPs in multiple WAD files and combines them
into one. The example file Light-FX.mm shows you how this is done.

Firstly, the file is comma delimited (sp?) this is important because if you
put a comma in a comment (a # signals the start of a comment) then it ends
the comment and tried to read the rest of the comment as input - crash.

Decide which WADs contain the COLORMAPs you want to combine, the first entry
(not including comments) in the file must be how many WADs you want to look
at. The next lines contain the WAD filenames and full paths (if they arn't
in the current directory). The rest of the file is for specifying which parts
of what wads you want to combine.

Each block of a COLORMAP to be copied is specified by 5 numbers:
The first two specify the range of mapping tables to copy to, there are 34
tables (0-33) so specifying say 5-36 is a dumb thing to do.
The next two specify the range of colours to copy to, there are 256 colours
in the palette (0-256).
The last number is the number of the WAD you want to copy the colours from, 1
is the first WAD on your list, 2 is the second etc. 0 means dont remap, leave
them as they are - use this for Dark Forces style lighting etc.

So if I wanted to copy colours 0-128 of the Fog WAD in tables 4, 5 and 6 into
MIXMAPs.WAD I would put this in the file:
4, 6, 0, 128, 1

(assuming that Fog.WAD was the first on the list)

Also, make sure your file doesn't end in a new line because this will also
crash mixmaps (sorry :)), DOS Edit automatically adds one I think but you can
delete it.

Sorry about the scummy UI (it's probably quite buggy to), if you have some
questions you can mail me at misc199@csc.canterbury.ac.nz

