Short:        Making SAP files from Atari XL/XE's music formats
Author:       Piotr Fusik/Fox/Taquart (fox@scene.pl). Amiga port: Voy/SSG/Dial
Uploader:     Wojciech Pasiecznik/Voy/SSG/Dial (voydial wp pl)
Type:         util/conv
Version:      1.1
Requires:     MC68000+
Architecture: m68k-amigaos
Distribution: Public Domain

Ported with use of vbcc - portable ANSI C compiler by Volker Barthelmann.
Amiga port still bases on the SAP Maker 4 by Fox/Taquart.

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 can convert files from the
following Atari XL/XE music formats:

CMC     - standard Chaos Music Composer 2.0 files
CMR     - Chaos Music Composer 2.0 files with changed bass table
          (created with "CMC Rzog")
MPT     - Music ProTracker 2.4 files
          This extension is for tunes without samples
MD1/D15 - Music ProTracker 2.4 tunes with single 15 kHz digi
          Such music consists of two files: MPT music and samples data.
          These files should have same name and MD1 and D15 extensions
          respectively
MD1/D8  - Music ProTracker 2.4 tunes with single 7.5 kHz digi
          Same as above except for lower quality of samples
MD2/D8  - Music ProTracker 2.4 tunes with two digi channels
          Music in MD2 file, samples in D8.
TMC     - Theta Music Composer files
          This extension is for tunes which can be played with single POKEY
TM8     - Theta Music Composer STEREO tunes (with 2 POKEYs on-board)
AMS     - Advanced Music System (?) files (experimental)


Installation
------------
1. Copy "SAP Maker" drawer where you want...
2. Add following lines to your startup-sequence or user-startup, where
   'your path' means ie. "dh0:Tools/":

   Assign >NIL: SPM: "your path/SAP Maker"
   Path >NIL: SPM: ADD

3. If you want to, you can copy an icon from the "Default icon" drawer to
"ENVARC:Sys/", execute DefIconsPrefs and add below items: 

project/music/sap

PATTERN  #?.sap
MATCH    0 "SAP\x0D\x0A"  Case sensitive
SEARCH   "AUTHOR"         Case sensitive
SEARCH   "NAME"           Case sensitive
SEARCH   "DATE"           Case sensitive
SEARCH   "TYPE"           Case sensitive


Usage:
------
For more info please read 'sapmaker.txt' file. Example music files are
included in the archive. Please increase stack to ca. 40kB :) before startup.

 From CLI:  sapmaker <filename>   (where 'filename' stands for text file with
                                   SAP tags)

History:
--------
v1.1 - recompiled with code optimization (ca. 2kB of gain ;-).
     - FIXED: messages strings.
     - ADDED: support for assignment.
     - ADDED: "Docs" drawer.
     - ADDED: .SAP file default icon (you can download my set of Atari deficons
              from the Aminet's pix/icon/AtariGlowIcons.lha :).
v??? - ADDED: title strings.


Additional info
---------------
If you want to listen to the .SAP files, you can download a great SAP
player, ported to Amiga by Sebastian Jedruszkiewicz (elf@frogger.rules.pl),
based on the sapLib 1.51 by Adam Bienias (Soused Teat/Slight):

   http://frogger.rules.pl/bin/sap.lha

or from this place:

   http://asma.dspaudio.com/bin/sap2.lha

PPC is recommended for the biggest satisfaction from SAP player! ^_^