===============================================
		   TGA2JPG II			
            A Borderfield production
===============================================

This is a small tool to grab a TGA, cut out a
specific portion of interest, resize to a given
dimension, overlay another TGA, and save the
result to JPG format.

USAGE
-----
Run the TGA2JPG program; open an explorer window and 
drag and drop the files you want to convert to the
TGA2JPG dialog window.  All files ending in .tga will
be added to the list, everything else is ignored.
You can also click "Add...", and select multiple files
you want to add.
  Select the area you would like to cut out from the
list of available configurations (see CONFIG FILE
below).  Next, if you want to overlay an image,
click "Pick..." and browse to the .TGA image you
wish to overlay.  Finally, specify the output
dimensions of the JPG and hit 'Go'.  When the tool
is finished processing, the list of files will be
cleared.
  Note that you can only pick one configuration for
the entire batch of files.  Thus, if you have a number
of shots which must be cut out as CTF files and another
batch which is 4:4 DM shots, then you'll need to
drag and drop the CTF files first, select CTF, hit Go,
and then process the remaining files.

OVERLAYS
--------
  You can pick a targa file to be overlaid on every
file.  The overlay happens *after* the resizing, so
normally you'll create an overlay (eg in photoshop)
which already has the exact dimensions of the desired
output.  The overlay can be put in any of the 4
corners using the dropdown box.
  If the overlay is too large, it will be clipped; if it
is too small (ie the dimensions specified in the dialog
are larger than the overlay) the remaining pixels in
the resized image will not be affected.
  Currently the following modes are supported :
- Chromakey black : the pixels in the overlay replace the
pixels in the file whenever the overlay is not (0, 0, 0).
- Additive : the two images are added together and clipped
to (255, 255, 255)
- Subtractive : the overlay is subtracted from the original
image, clipping to (0, 0, 0)
- Filter : the images are multiplied, so the overlay filters
the underlying pixels.
- Alphablend : assumes the overlay is 32 bit, alphablends
shot and overlay assuming premultiplied RGB.  Alpha white = 
opaque overlay, black = screenshot visible.

CONFIG FILE
-----------
  The basic idea of this tool is to allow people to set up
a list of games, listing for every common resolution what
part of a screenshot contains the scoreboard.  For instance,
in Quake2 LFire CTF only the central 320x240 area is
important, and anything else is decoration.  The config
file is simply a text version of this list : a game (or
game mod) followed by a list of resolutions, and the
area to cut out when a screenshot of that resolution
is found.  The config file has comments in it explaining
the easy format.
  You're encouraged to modify this file and send your
results back to rat@planetquake.com.  If you have a MOD
of a game you play often and find that the tool can assist
in cutting out a specific portion, then write down the
coordinates in the config files, test, and if it looks
ok send back your changes and they'll be included in the
next version of the .cfg file (which is available for
download separately and will hopefully grow steadily).

INFO
----

TGA2JPG II	Version 1.0, 22/02/2000
A Borderfield production
http://www.planetquake.com/borderfield
Author : Bert 'rat' Peers -- rat@planetquake.com
This program uses the Independent JPEG group's
library : http://www.ijg.org
See tga2jpg2.cfg for a list of contributors.
