| 1 | General information
|
|---|
| 2 | ~~~~~~~~~~~~~~~~~~~
|
|---|
| 3 | SAP file divides into two parts. First part (in text format) describes
|
|---|
| 4 | player/music type. Second part (in binary format) contains player and music
|
|---|
| 5 | data formed into Atari Binary File Format. This format has two bytes header
|
|---|
| 6 | FF,FF. Next two bytes tell loader, where to load data, and next two bytes
|
|---|
| 7 | describes where the data end.
|
|---|
| 8 | Init data block ($02E2,$02E3) is not supported.
|
|---|
| 9 |
|
|---|
| 10 |
|
|---|
| 11 | Player Description format (first part of .sap file)
|
|---|
| 12 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 13 | This description (in text format) is loaded line per line. Each line contains
|
|---|
| 14 | command with parameters. Other lines which are not recognized are treated as
|
|---|
| 15 | comment lines. Right now only these commands are supported:
|
|---|
| 16 |
|
|---|
| 17 | TYPE - player type
|
|---|
| 18 | PLAYER - address of player part which will be executed in 1/50 sec
|
|---|
| 19 | intervals
|
|---|
| 20 | MUSIC - address with data
|
|---|
| 21 | INIT - address of player part which will init player
|
|---|
| 22 | SONGS - number of songs
|
|---|
| 23 | DEFSONG - first song which will be played when .sap will be loaded
|
|---|
| 24 | FASTPLAY - number of lines between each call of playing routine (312 by
|
|---|
| 25 | default, which is one screen - 1/50 of sec.). For example for
|
|---|
| 26 | double-speed tune put here the value 156 (312/2). 99% of tunes
|
|---|
| 27 | are single-speed which means that you don't have to define the
|
|---|
| 28 | FASTPLAY variable for them.
|
|---|
| 29 |
|
|---|
| 30 | commands PLAYER, MUSIC, INIT contain addresses in hexadecimal format:
|
|---|
| 31 |
|
|---|
| 32 | PLAYER A000
|
|---|
| 33 | PLAYER 1234
|
|---|
| 34 | MUSIC F400
|
|---|
| 35 |
|
|---|
| 36 | commands SONGS, DEFSONG contain decimal numbers:
|
|---|
| 37 |
|
|---|
| 38 | SONGS 10
|
|---|
| 39 | DEFSONG 9
|
|---|
| 40 |
|
|---|
| 41 | command TYPE contains single character which describes player type. Right now
|
|---|
| 42 | only the following characters are supported:
|
|---|
| 43 |
|
|---|
| 44 | TYPE C
|
|---|
| 45 | TYPE B
|
|---|
| 46 | TYPE M
|
|---|
| 47 |
|
|---|
| 48 | TYPE C - player from CMC (Chaos Music Composer). In this case, also these
|
|---|
| 49 | commands must appear: PLAYER, MUSIC, SONGS, and DEFSONG. Player will
|
|---|
| 50 | be initialized as follows:
|
|---|
| 51 |
|
|---|
| 52 | lda #$70
|
|---|
| 53 | ldx #<MUSIC
|
|---|
| 54 | ldy #>MUSIC
|
|---|
| 55 | jsr PLAYER+6
|
|---|
| 56 | lda #$00
|
|---|
| 57 | ldx #DEFSONG
|
|---|
| 58 | jsr PLAYER+6
|
|---|
| 59 |
|
|---|
| 60 | in 1/50 intervals will be executed:
|
|---|
| 61 |
|
|---|
| 62 | jsr PLAYER+3
|
|---|
| 63 |
|
|---|
| 64 | TYPE M - player from ???????? (this player was used by composers like Adam
|
|---|
| 65 | Gilmore, David Whittaker, etc). In this case, also these commands
|
|---|
| 66 | must appear: PLAYER, INIT, SONGS, and DEFSONG. Player will be
|
|---|
| 67 | initialized as follows:
|
|---|
| 68 |
|
|---|
| 69 | lda #DEFSONG
|
|---|
| 70 | jsr INIT
|
|---|
| 71 |
|
|---|
| 72 | in 1/50 intervals will be executed:
|
|---|
| 73 |
|
|---|
| 74 | jsr PLAYER
|
|---|
| 75 |
|
|---|
| 76 | TYPE B - any player. In this case, also these commands must appear: PLAYER,
|
|---|
| 77 | INIT, SONGS, and DEFSONG. Player will be initialized as follows:
|
|---|
| 78 |
|
|---|
| 79 | lda #DEFSONG
|
|---|
| 80 | jsr INIT
|
|---|
| 81 |
|
|---|
| 82 | in 1/50 intervals will be executed:
|
|---|
| 83 |
|
|---|
| 84 | jsr PLAYER
|
|---|
| 85 |
|
|---|
| 86 | TYPE B is right now exactly the same like TYPE M but this
|
|---|
| 87 | distinguish is for future SAP releases.
|
|---|
| 88 |
|
|---|
| 89 |
|
|---|
| 90 | How to create .SAP file
|
|---|
| 91 | ~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 92 | First of all we need to rip music from a game or a demo and save it in atari
|
|---|
| 93 | binary file. Next we can create text file with commands (described above),
|
|---|
| 94 | then we can make .sap file by linking thwse two files. We can do that using
|
|---|
| 95 | DOS command "copy", e.g.:
|
|---|
| 96 |
|
|---|
| 97 | copy /b music.txt+music.bin music.sap
|
|---|
| 98 |
|
|---|
| 99 | The file is done!
|
|---|
