XORMAP.ZIP
~~~~~~~~~~

This archive contains:

XORMAP.C     -- Source code
XORMAP.EXE   -- Compiled executable (DOS 16-bit)
XORICON.BMP  -- Symbols used to create map (BMP/WindowsRGB)
XORELEMS.TXT -- Hex->symbols listing (DOS Text)
XOR??.       -- Raw map file (Amstrad CPC tape -- but see text)
XOR??.PNG    -- Map image (Portable Network Graphics)
(In both the above, ?? is in the range 01 to 15.)

This ZIP is copyright (c) 1999 Robert J Baker (robert.bak@bigfoot.com).
It is freely distributable, but only in the original, intact form.

If you wish to make your own map file(s) (perhaps of a partly-finished
level), you probably need to be playing on an Amstrad CPC emulator (such
as CPCEMU -- I don't know if any other CPC emulator has a memory-dump
facility) or to use one of the supplied dumps.  If playing on a CPC emu,
dump memory from 0x3c00, length 0x400 (1024) -- last address dumped
should be 0x3fff.

XORICON.BMP must be in the directory from which you run XORMAP, and the
dump file must be broadly in the format saved by CPCEMU v1.4 (128-byte
header).  I say "broadly" because the first 128 bytes can be anything,
as they are ignored by XORMAP.  So, if playing XOR on (e.g.) a Spectrum
emulator (the map data are likely to be in the same format, but might
not be), dump a memory block from (map start)-128, length 1152.

Simply type XORMAP name (where "name" is the file name, including type,
of the memory dump) and, in a few seconds, a map-image file of the same
name (but with a BMP type) will be created.  This will be in the format
BMP/WindowsRGB, which being uncompressed is very large, so you may then
want to convert it to a compressed format.

(For some reason, dragging a dump file and dropping it onto XORMAP.EXE
does not work, or at least didn't when I tried it.  It doesn't take much
effort to open a DOS prompt and use this to run XORMAP.  Tip:  If your
dump files all have similar names, e.g. if you're regenerating the BMP
files from the supplied maze dumps, use the DOS FOR command to automate
this, for example:

for %a in (xor??) do xormap %a

The above is how I generated the BMP files from which the supplied PNGs
were created.)

N.B.  To dump the map area in CPCEMU (you must be in a level, or the
results are undefined), press [F10] (debug), then "v 3c00" (saVe block --
without the quotes, of course).  Specify whatever file name you want,
and a length of 400 (0x400=1024).  The block will be saved to your tape
directory.  Enter r (run) to return to the emulation.

