Changeset 8 for trunk/asma/Docs/Sap.txt

Timestamp:

Sep 25, 1999, 4:33:18 PM (26 years ago)

Author:

pfusik

Message:

Imported ASMA 0.8

File:

• trunk/asma/Docs/Sap.txt (modified) (6 diffs)

trunk/asma/Docs/Sap.txt

@@ -1 @@
-General information
-~~~~~~~~~~~~~~~~~~~
 SAP file divides into two parts. First part (in text format) describes
 player/music type. Second part (in binary format) contains player and music
@@ -7 +5 @@
 describes where the data end.
 Init data block ($02E2,$02E3) is not supported.
+
+A little example:
+
+FF FF 00 20 05 20 01 42 A3 04 D5
+\___/ \_________/ \____________/
+  A        B            C
+
+A - Binary file header identification (always FF FF)
+B - Load addres (StartAddr, EndAddr in LO,HI order - $2000 to $2005)
+C - Data (that will be loaded from StartAddr)
+
+This example will load values 01,42,A3,04,D5 into memory from $2000 to
+$2005.
 
 
@@ -26 +37 @@
                double-speed tune put here the value 156 (312/2). 99% of tunes
                are single-speed which means that you don't have to define the
-               FASTPLAY variable for them.
-   
+               FASTPLAY variable for them. Works for player TYPE "B".
+
 commands PLAYER, MUSIC, INIT contain addresses in hexadecimal format:
 
@@ -45 +56 @@
 TYPE B
 TYPE M
+TYPE S
+TYPE D
+TYPE R
 
 TYPE C - player from CMC (Chaos Music Composer). In this case, also these
@@ -87 +101 @@
          distinguish is for future SAP releases.
 
+TYPE S - SoftSynth. Like type "C", this type is temporary, and is used only
+         for special type of songs, that where composed using program
+         SoftSynth.
+TYPE D - Digital. In SAP file with this type, must be also defined commands
+         "INIT" and "PLAYER". "PLAYER" (like in type "B") sets address of
+         procedure that will be called in 1/50s intervals and (like in type
+         "B") must end with RTS opcode. INIT this time is a bit different. It
+         sets address of procedure that will be called (with number of song
+         in register A) to initialize program, but it can't end with RTS. It
+         should start playing digis in endless loop. In SAP player there are
+         emulated two ANTIC registers $D40A and $D40B that can help playing
+         samples. D40B register increases its contents each two screen lines.
+         D40A holds CPU till the end of actually created line. SAP emulates
+         Atari in PAL with disabled screen. It means that we have 312 PAL
+         lines, while each lines has 105 CPU cycles and 9 cycles of memory
+         refresh (114 cycles per line).
+
+Planned features:
+TYPE R - Registers. In this type, binary part is not an Atari binary file.
+         This part contains values that will be directly written to Pokey
+         registers ($D200-$D208) in 1/50s intervals.
+TIME xx:xx - song duration
 
 How to create .SAP file
@@ -97 +133 @@
 copy /b music.txt+music.bin music.sap
 
-The file is done!
+The file is done now!
+If you didn't find that song in ASMA, feel free to send it to pg@pinknet.cz
+with all needed information (see ASMA.TXT for detailed information). The song
+should be included in the nearest ASMA update.