	            extractor for pak-archieves and media converter
	            ===============================================	
	                                (c) by Joachim Schiele 2001

License for using this tool:
============================
	                                
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  
  Copyright (C) 2001   Joachim Schiele <js@dune2.de>

HOW TO USE THIS TOOL(S):
========================

1. What are the tools for?
2. To extract something out of the *pak files:
3. To convert cps/shp/wsa/... files to pngs:
4. debuging
5. specifications about all this files?
6. little notice about this code

1. What are the tools for?
==========================

This tools "sandtools" are able to extract files out off some old games.
You got several tools in the directory and they all have a special function,
here in detail:

tool	| meaning (in short words)
----------------------------------
unpack 	| to extract the pak files (a bit like a tar-archieve)
cps2png | cps is a graphic compression for single graphics
shp2png | shp is a graphic compression for multiple graphics
wsa2png | wsa is a graphic compression for multiple graphics xor'ed to each

2. To extract something out of the *pak files:
==============================================

"unpack --unpack pakfile.pak" or
"unpack --unpack dir/*" would extract all pakfiles
-> the program will create a new dir in the same dir the *pak files are,
so /home/linus/file.pak will be extracted to /home/linus/file/

3. To convert cps/wsa/shp/... files to pngs:
============================================

cps2png -i seed.cps -o ./ 	(saves file.cps after convertion to same dir) 
wsa2png -i seed.wsa -o /home/ 	(saves to /home/)
shp2png -i seed.shp -o / 	(saves to /)

-> because shp-files usualy do not only store one single graphic it's saved as
shp2png -i seed.shp -o /home/linus/
seed_1.png, seed_2.png, seed_3.png, ... (as many graphics as inside)
This can be up to 120 and more as i found out ;-)

4. debuging
===========

If you want to debug something you have to set the "#debug -g" variable in the
Makefile to "debug -g" not "#debug -g" and you can use gdb for further
experiments. Also inside some single .c files you can set the DEBUG flag with
"#define DEBUG"
and you should get some more output.

5. specifications about all this files?
=======================================

Specifications about wsa, shp, cps, pak and some other
formats used here can be found on my homepage www.dune2.de
You will find there what you are searching for, hopefully.

6. litle notice about this code
===============================

This code is meant to be absolutely free and i don't mind anyone taking it 
for his projects or games without even giving me a note. It would be nice
to hear if someone is using it or takes some benefit of it ;-)
It took me hours to write this all down and to hack all the stuff.

so:
happy hacking

qknight
