Map -> JPEG converter v1.7                           by TechnoDuck
http://www.scinfinity.com/                technoduck@lycosmail.com
------------------------------------------------------------------


** features **
 o  Works with SCM, SCX, and CHK Starcraft map files
 o  Output looks exactly like in-game Starcraft terrain
 o  3 image sizes: minimap, normal, and huge (really big!)
 o  Built in JPEG compression to save valuable disk space
 o  Native Windows interface, including shell integration

** known bugs **
 o  Too many popups if you 'make jpeg' multiple files at once
 o  Trees and other tall/3-D doodads are cut off at the base
 o  Certain animated doodads display incorrectly or not at all


To install or upgrade:
- If you have WinZip 7.0 (http://www.winzip.com/) then you can just
  double-click on Setup.exe from inside the archive.  WinZip should
  extract everything and all will be well.
- Otherwise extract all the files to a temporary directory (doesn't
  matter where) and run Setup.exe from there.  You can delete this
  temporary directory after Setup completes.

## If a setup error occurs, check out the very end of this file. ##


Once installed, run the program by any of these methods:
 - Right-click on any SCM, SCX, or CHK file and choose 'make jpeg'
 - Drag and drop any map or multiple maps onto the desktop icon
 - Run the program and select any desired map(s) for conversion

More details on operation:
 - When you run the program by itself, an Open Map dialog box will
   appear.  You can select one map or multiple maps.  If you choose
   multiple maps, you will not be able to specify the output file
   names or the map sizes.  A normal image and a minimap image will
   be created for each map you selected; these will be saved with
   default names in the same directory the map comes from.
 - When you drag-and-drop, the same logic applies.  Dragging one
   file will let you specify output name and size; dragging multiple
   files will follow the default behavior outlined above.
 - When using the 'make jpeg' option, you can always choose name and
   output size.  It is NOT recommended to use the 'make jpeg' option
   with multiple files selected, because this will open up multiple
   output dialogs at the same time!  This can flood your screen.


Changes from previous version:
 +  New "batch processing" feature
 +  Smarter command-line detection for drag-and-drop
 +  Reorganized source code (no noticable effect)


Credits to:
===========
. Campaign Creations for their documention of the CHK map format
. Camelot Systems for revealing the mystical secrets of tilesets
. Sean Mims for releasing the source code for his MPQ extractor
. brainspin@hanmail.net for making a C code version of Sean's
  MPQ extractor, from which I have stolen extraction routines
. The Independant JPEG Group for creating the wonderful libjpeg
  compression interface, which I use to create JPEG images
. Blizzard for creating this wonderful game that let me waste...
  er, spend countless hours doing "background research"

Special no-thanks to Blizzard for using that damned unreadable
MPQ archive format.  I'll forgive them, but just this once :P


                 ------- Legal stuff -------
 The program is not related to, endorsed or supported by Blizzard
 Entertainment in any way.  It is an independant third-party tool
 created by an individual, not an official Blizzard tool.

 You use this program at your own risk.  By installing, you agree
 that the creator is not responsible for any damages occuring due
 to use (or misuse) of the program.  There is no promise that the
 software will work on your computer; it should, but it may not.

 Blizzard, Starcraft and the Campaign Editor are all intellectual
 property of Blizzard Entertainment. Blizzard does not endorse or
 support the use of the Map Image Generator.  I am not affiliated
 in any way, shape, or form with Blizzard Entertainment.
                  --- End of legal stuff ---


SETUP ERRORS:

If setup cannot find your Starcraft directory, your copy of SC
is not properly installed.  This will affect more than just my
program; chances are your campaign editor doesn't work either.
Try re-installing the game.  Note that the shareware version
is not enough!  You need a copy of the Campaign Editor, which
doesn't come with Starcraft shareware.

If it can't copy SCMJPEG.EX_, SCMJPEG.EXE, or STORMING.DLL,
make sure that your Starcraft directory is NOT read-only!
Right-click on the Starcraft folder, choose Properties,
and clear the read-only check box.  Also delete any existing
copies of these files (there shouldn't be any).

If it could not register the "make jpeg" commands, do not worry.
You will not have the "make jpeg" command on the drop-down menu
for map files, but you will still be able to run the program from
the desktop link.  Drag-and-drop will also work.  This only
affects a few users, probably if they are not Administrator but
are running under Windows NT.
