SAP MAKER
CMC,MPT,MD1,TMC,TM8 -> SAP file converter
Public Domain
=========================================

Introduction
------------
This simple utility was made for making SAP files from common music formats
easier. With it you only have to specify names of files to convert
and SAP MAKER will do the rest. It automatically recognizes type of file
(it's too much said, it only checks file name extension :) ) and creates
SAP file containing the music.

SAP MAKER is distributed with full C source as public domain, so that
everyone is allowed to make changes in it and distribute changed version.
I only ask for writing down all changes made and adding name or nick
to credits, because I don't want to be blamed for others' mistakes nor
be glorified for things I haven't done.

Source is portable and is able to be compiled on any system (at least I hope
so). If you have can make some changes to make it even more portable,
please feel free to distribute corrected version.

I also include the executable for PC/WIN compiled with DJGPP gcc 2.8.1
with -s option. If you can produce smaller executable, please distribute it.
Note long file names have to be supported.

Six *.plr files are simply Jaskier's players compiled at $0500 and $f500.

About SAP files
---------------
SAP stands for Slight Atari Player. File in .SAP format contains all data
necessary for playing music emulating POKEY sound chip and 6502 processor,
and some information about music. SAP MAKER is able to create the binary part,
but of course it can't guess the name or the author.

Usage
-----
First, collect all files you want to convert in a single directory.
Give them proper file name extensions:

CMC 	- for standard Chaos Music Composer files
	  At the moment no 'Double play' nor 'Changed bass table' features
	  are supported
MPT	- for Music ProTracker 2.4 files
	  This extension is for tunes without samples
MD1/D15	- for Music ProTracker 2.4 tunes with single digi
	  Such music consists of two files: MPT music and samples data.
	  These files should have same name and MD1 and D15 extensions
	  respectively
TMC	- for Theta Music Composer files
	  This extension is for tunes which can be played with single POKEY
TM8	- for Theta Music Composer STEREO tunes

The directory should also contain SAP MAKER executable and six *.plr files.

You should create a file containing information for all tunes. This file
must contain at least file names. The easiest way to create it on an PC
is to use:

dir /b/on >sapinfo.txt

This command creates sapinfo.txt file containing alphabetical list of all
files in current directory. You can edit this file with any text editor.
Leave only lines containing names of files you want to convert.
You have to delete lines with sapinfo.txt, sapmaker.txt and *.plr files.
Note when converting MD1/D15 you give only MD1 file name.

Then you are already able to convert. Simply run SAP MAKER with name of info
file:
sapmaker sapinfo.txt

If everything was ok, SAP MAKER doesn't display any message. Simply you have
all your files successfully converted and you may replay them.

That were the basics. SAP MAKER has some more features. To use them you edit
the info file. Each line has following syntax:
source_file sap_file.sap SONGS DEFSONG "Author" "Name" "Date"
All parameters excluding source_file are optional. Note you have to add .sap
extension to SAP file name and you have to enclose song informations
in quotation marks. You may use both spaces and tabs to separate fields.
Here is an example:
DRUCH.MPT Drunk_Chessboard.sap 1 0 "Lukasz Sychowicz (X-Ray)" "Drunk Chessboard" "1996"

You may skip SONGS if there's only one song. In fact SAP MAKER supports
subsongs only for CMC files. DEFSONG is a number of subsong which will be
replayed by default when the .SAP file is loaded. Note subsongs are numbered
starting from 0.

You can insert comment line by putting ';' as first character in line.
Blank lines are also allowed.

If you don't know the author, but only the name, please use "<?>" in meaning
"unknown". Please comply ASMA naming conventions:
- only 'A..Z', 'a..z', '0..9' and '_' characters are allowed in file names
- a file name can be up to 26 characters long (with '.sap' extension file name
  can be up to 30 characters long)

The ASMA is a collection of .SAP files. Please help to make this collection
as big as its C-64 equivalent. For details, visit
http://mp3.musichall.cz/Unreal/ASMA

Credits
-------
Idea - Pigula/Shpoon, Solo/NG
Design, code, this text - Fox/Taquart <pfusik@elka.pw.edu.pl>
All players - Jaskier/Taquart

Changes
-------
Please list here all changes you make in SAP MAKER:
