Index: /tags/asma-1.1/Docs/Asma.txt
===================================================================
--- /tags/asma-1.1/Docs/Asma.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Asma.txt	(revision 15)
@@ -0,0 +1,90 @@
+                                        ___
+        yy yyy yy          ,gp.      ,gS$$$Sp.  d$$.     ,$$b     ,gp.
+        $$ $$$ $$         :$$$$:    ,$$$$A$$$$. $$$b     d$$$    :$$$$:
+        $$ $$$ $$         $$$$$$    $$$'   `?$P $$$$.   ,$$$$    $$$$$$
+        $$ $$$ $$        :$$P?$$:   $$$         $$$$b   d$$$$   :$$P?$$:
+        $$ $$$ $$        d$$'`$$b   ?$$b.       $$$$$. ,$$$$$   d$$'`$$b
+        $$ $$$ $$        $$P  ?$$    `$$$$$o.   $$$?$b d$P$$$   $$P  ?$$
+       ,$7 $$$ ?$.      :$$'  `$$:     `?$$$$b  $$$`$$v$$'$$$  :$$'  `$$:
+       d$  $$$  $b      d$$$$$$$$b        `?$$b $$$ ?$$$P $$$  d$$$$$$$$b
+     ,d$'  $$$  `$b.    $$$$$$$$$$          $$$ $$$ `$$$' $$$  $$$$$$$$$$
+   y$$$'   $$$   `$$$y :$$P    ?$$: d$b.   ,$$P $$$  ?$P  $$$ :$$:    ?$$:
+   $$P'    $$$    `t$$ $$$'    `$$b `$$$$S$$$$' $$$  `S'  $$$ $$$'    `$$b
+   "~      """      ~" $$P      ?$$  `?$$$$$P'  $$$       $$$ $$P      ?$$
+                       ~~~      ~~~     ~~~     ~~~       ~~~ ~~~      ~~~
+
+                            Atari SAP Music Archive
+                                  Version 1.1
+
+                           Started on 4th of August 1999
+                        Last updated on 13th of November 1999
+
+                        Total number of tunes: 407 (48 new)
+
+
+ Introduction
+ ~~~~~~~~~~~~
+ This is the pre-release testing version of the first Atari XL/XE chip-music
+ collection. There is some kind of structure in the archive, anyway, it can
+ change till the full version. The whole collection outfit was inspired by
+ the HVSC collection (with some differences).
+
+
+ Statistics
+ ~~~~~~~~~~
+ Number of tunes:      407
+ Compared to HVSC 3.3: 3.5% (HVSC contains 11660 tunes)
+ Unsorted tunes:       58
+ Number of musicians:  27
+ Most active musician: Tomasz Liebich     (30 tunes)
+ Biggest SAP tune:     Exodus.sap         (38481 bytes)
+ Smallest SAP tune:    Self_Test.sap      (159 bytes)
+
+ Help!
+ ~~~~~
+ As you can see, there are lots of tunes in the 'Unsorted' directory. If
+ you're 100%ly sure about origin of any of these tunes (Who did it, where
+ does it come from, when was it composed), please let us know immediately
+ so that we can complete the information about the tune in ASMA (or move it
+ to the right directory). We would welcome if you sent us also the binary
+ file (or an ATR/XFD disk image) with the original peace of software with
+ that tune. Mail any such information to pg@pinknet.cz. Our aim is to
+ completely annihilate the 'Unsorted' directory :-)
+
+
+ For contributors
+ ~~~~~~~~~~~~~~~~
+ If you want to send me some tunes, they must be already converted to SAP
+ format and should include all the information needed (author, name, date,
+ number of songs). If you're unsure about any information needed, you can
+ send me the music as well, maybe we can find the info together. If you don't
+ know how to create SAP files, send me the binary file with the INIT and PLAY
+ addresses and memory location where the tune has to be loaded. See SAP.TXT
+ for SAP format description. The filenames must not be longer than 26
+ characters (plus .sap) e.g.:
+
+ 12345678901234567890123456.123
+ Intel_Outside_Fractal_Part.sap - all right
+ Jocky_Wilsons_Darts_Challenge.sap - wrong!
+
+ Because of compatibility reasons only characters 'A..Z', 'a..z', and '0..9'
+ can be used in the filenames. All spaces must be replaced with underscore
+ ("_").
+
+
+ Creator & Contributors
+ ~~~~~~~~~~~~~~~~~~~~~~
+ Zdenek Eisenhammer (PG of Unreal) - maintainer of the archive, ripped about
+                                     15% of the tunes
+ Adam Bienias (SoTe of Slight) - ripped almost 75% of the tunes
+ Piotr Fusik (Fox of Taquart) - ripped about 10% of the tunes (now he's my
+                                main contributor)
+ Tamas Bene (??? of Hard) - ripped about 2% of the tunes :)
+ Jindrich Kubec - ripped some tunes as well :)
+ Radek Sterba - sent most of his tunes. Thanx!
+
+
+ Contact
+ ~~~~~~~
+ For any suggestions write to pg@pinknet.cz.
+ Homepage: http://mp3.musichall.cz/Unreal/ASMA (temporary site)
Index: /tags/asma-1.1/Docs/Bugs.txt
===================================================================
--- /tags/asma-1.1/Docs/Bugs.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Bugs.txt	(revision 15)
@@ -0,0 +1,6 @@
+Classics/Gilmore_Adam/Las_Vegas_Casino.sap - tune 0 doesn't exist (silence)
+Classics/Munns_Richard/Rebound.sap - tune doesn't play first note (drum)
+Various/Husak_Jakub/Bank_Bang_2.sap - strange note at the end of subsong #1
+Various/Liebich_Tomasz/Deimos.sap - tune 0 doesn't exist (distorted sounds)
+Demos/Time_To_Enjoy.sap - Tune falls out of synch after some time
+Games/Classic/Mule.sap - Tune falls out of synch after about 35 secs
Index: /tags/asma-1.1/Docs/Composers.txt
===================================================================
--- /tags/asma-1.1/Docs/Composers.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Composers.txt	(revision 15)
@@ -0,0 +1,33 @@
+Known Atari composers and handles                                 13 Nov 1999
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This list contains only composers who have made at least 3 songs on Atari
+XL/XE. The composers are sorted in ABC order according to their surnames (if 
+known, otherwise by their handles). There are 27 composers in this list.
+
+Badkowski, Marek - Bac
+Bienias, Adam - SoTe
+Brooke, Jason C.
+Czartynski, Marci - Cedyn
+Daglish, Ben
+Drozdowski, Marek - Marucha
+Duesterhoeft_Stephan - Benjy
+Galinski, Adrian - Daxey
+Gilmore, Adam
+Gwozdziej, Mirek - Zur-soft 1/2
+Hubbard, Rob
+Husak, Jakub
+Kalinowski, Bartosz - Bartman
+Kwiatek, Grzegorz - Greg
+Liebich, Tomasz
+Majewski, Jerzy - Zur-soft 2/2
+Makowski, Robert - Gutek
+Martin, Aleksander - Alex
+Munns, Richard
+Pelc, Janusz
+Sterba, Radek - RASTER
+Swierszcz, Piotr - Samurai
+Sychowicz, Lukasz - X-Ray
+Szymczuk, Daniel
+Trokowicz, B.
+Vogt, Dariusz - DJ V
+Whittaker, David
Index: /tags/asma-1.1/Docs/STIL.txt
===================================================================
--- /tags/asma-1.1/Docs/STIL.txt	(revision 15)
+++ /tags/asma-1.1/Docs/STIL.txt	(revision 15)
@@ -0,0 +1,17 @@
+# STIL betaversion
+# Just an attempt how it would look like. The fileformat is 100% C-64 STIL 
+# compatible
+
+### Galinski_Adrian ##########################################################
+
+/Various/Galinski_Adrian/Abdicus.sap
+COMMENT: 1st place at Shadows Party music compo.
+
+/Various/Galinski_Adrian/Bells.sap
+COMMENT: 3rd place at Shadows Party music compo.
+
+/Various/Sychowicz_Lukasz/Hypek.sap
+COMMENT: 1st place at Intel Outside 4 music compo.
+
+/Various/Sychowicz_Lukasz/X_Ray_2.sap
+COMMENT: Orneta music compo contribution.
Index: /tags/asma-1.1/Docs/Sap.txt
===================================================================
--- /tags/asma-1.1/Docs/Sap.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Sap.txt	(revision 15)
@@ -0,0 +1,138 @@
+SAP file divides into two parts. First part (in text format) describes
+player/music type. Second part (in binary format) contains player and music
+data formed into Atari Binary File Format. This format has two bytes header
+FF,FF. Next two bytes tell loader, where to load data, and next two bytes
+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.
+
+
+Player Description format (first part of .sap file)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This description (in text format) is loaded line per line. Each line contains
+command with parameters. Other lines which are not recognized are treated as
+comment lines. Right now only these commands are supported:
+
+   TYPE      - player type
+   PLAYER    - address of player part which will be executed in 1/50 sec
+               intervals
+   MUSIC     - address with data
+   INIT      - address of player part which will init player
+   SONGS     - number of songs
+   DEFSONG   - first song which will be played when .sap will be loaded
+   FASTPLAY  - number of lines between each call of playing routine (312 by
+               default, which is one screen - 1/50 of sec.). For example for
+               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. Works for player TYPE "B".
+
+commands PLAYER, MUSIC, INIT contain addresses in hexadecimal format:
+
+PLAYER A000
+PLAYER 1234
+MUSIC  F400
+
+commands SONGS, DEFSONG contain decimal numbers:
+
+SONGS 10
+DEFSONG 9
+
+command TYPE contains single character which describes player type. Right now
+only the following characters are supported:
+
+TYPE C
+TYPE B
+TYPE M
+TYPE S
+TYPE D
+TYPE R
+
+TYPE C - player from CMC (Chaos Music Composer). In this case, also these
+         commands must appear: PLAYER, MUSIC, SONGS, and DEFSONG. Player will
+         be initialized as follows:
+
+         lda #$70
+         ldx #<MUSIC
+         ldy #>MUSIC
+         jsr PLAYER+6
+         lda #$00
+         ldx #DEFSONG
+         jsr PLAYER+6
+
+         in 1/50 intervals will be executed:
+
+         jsr PLAYER+3
+
+TYPE M - player from ???????? (this player was used by composers like Adam
+         Gilmore, David Whittaker, etc). In this case, also these commands
+         must appear: PLAYER, INIT, SONGS, and DEFSONG. Player will be
+         initialized as follows:
+
+         lda #DEFSONG
+         jsr INIT
+
+         in 1/50 intervals will be executed:
+
+         jsr PLAYER
+
+TYPE B - any player. In this case, also these commands must appear: PLAYER,
+         INIT, SONGS, and DEFSONG. Player will be initialized as follows:
+
+         lda #DEFSONG
+         jsr INIT
+
+         in 1/50 intervals will be executed:
+
+         jsr PLAYER
+
+         TYPE B is right now exactly the same like TYPE M but this
+         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
+~~~~~~~~~~~~~~~~~~~~~~~
+First of all we need to rip music from a game or a demo and save it in atari
+binary file. Next we can create text file with commands (described above),
+then we can make .sap file by linking thwse two files. We can do that using
+DOS command "copy", e.g.:
+
+copy /b music.txt+music.bin music.sap
+
+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.
Index: /tags/asma-1.1/Docs/Update01.txt
===================================================================
--- /tags/asma-1.1/Docs/Update01.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Update01.txt	(revision 15)
@@ -0,0 +1,76 @@
+ASMA Update #01
+
+These rips together with the original ASMA collection will make version 1.1
+of the ASMA (out of version 1.0).
+
+Number of new tunes: 48
+Credits fixes: 7
+Filename changes: 4
+
+New tunes:
+----------
+/Demos/Annael.sap
+/Demos/Chip.sap
+/Demos/Dead.sap
+/Demos/Halle_Project_Another_Part.sap
+/Demos/Halle_Project_Bitplans.sap
+/Demos/Halle_Project_CSS_Vector.sap
+/Demos/Halle_Project_Greetz.sap
+/Demos/Halle_Project_MCMXCII.sap
+/Demos/Halle_Project_Visdom.sap
+/Demos/Halle_Project_Waves.sap
+/Demos/Hobbytronic_90_Vector_Ball.sap
+/Demos/Hobbytronic_90_Vector_Part.sap
+/Demos/Hobbytronic_92_3.sap
+/Demos/Logic.sap
+/Demos/Small.sap
+/Demos/Suspic.sap
+/Demos/The_Top_1.sap
+/Demos/Top_Crew_Part.sap
+/Games/Various/Herbert.sap
+/Games/Various/Hydraulik.sap
+/Games/Various/Streets.sap
+/Games/Various/Streets_Ingame.sap
+/Unsorted/Abbuc_20.sap
+/Unsorted/Abbuc_25.sap
+/Unsorted/Abbuc_35.sap
+/Various/Sterba_Radek/Flop_Magazin_30_Just_Now.sap
+/Various/Sterba_Radek/Flop_Magazin_31.sap
+/Various/Sterba_Radek/Flop_Magazin_31_Christmas.sap
+/Various/Sterba_Radek/Flop_Magazin_32.sap
+/Various/Sterba_Radek/Flop_Magazin_33.sap
+/Various/Sterba_Radek/Flop_Magazin_34.sap
+/Various/Sterba_Radek/Flop_Magazin_35_BH90210.sap
+/Various/Sterba_Radek/Flop_Magazin_36_38.sap
+/Various/Sterba_Radek/Flop_Magazin_37.sap
+/Various/Sterba_Radek/Flop_Magazin_39.sap
+/Various/Sterba_Radek/Flop_Magazin_40.sap
+/Various/Sterba_Radek/Flop_Magazin_41.sap
+/Various/Sterba_Radek/Gunhead.sap
+/Various/Sterba_Radek/Illusion_2.sap
+/Various/Sterba_Radek/Illusion_4.sap
+/Various/Sterba_Radek/Imagine.sap
+/Various/Sterba_Radek/Magnetit_Ingame.sap
+/Various/Sterba_Radek/Naturix.sap
+/Various/Sterba_Radek/Naturix_Demo.sap
+/Various/Sterba_Radek/Naturix_Demo_Tune_2.sap
+/Various/Sterba_Radek/Naturix_Tune_2.sap
+/Various/Sterba_Radek/Naturix_Tune_3.sap
+/Various/Sterba_Radek/Turrican_2_Experiment.sap
+
+Credits fixes & updates
+-----------------------
+/Classics/Munns_Richard/Plastron_Ingame.sap
+/Demos/The_Top_2_Digi_Part.sap
+/Games/Various/Magia_Krysztalu.sap
+/Various/Galinski_Adrian/Drop_It.sap
+/Various/Husak_Jakub/Bank_Bang_2.sap
+/Various/Husak_Jakub/Bank_Bang_Title.sap
+/Various/Trokowicz_B/Miecze_Valdgira_Title.sap
+
+Renamed files
+-------------
+/Games/Various/U235_2.sap > U235_Ingame.sap
+/Various/Husak_Jakub/Bank_Bang_2.sap > Bank_Bang_Ingame_Tunes.sap
+/Various/Husak_Jakub/Bank_Bang_Title.sap > Bank_Bang.sap
+/Various/Trokowicz_B/Miecze_Valdgira_Title.sap > Miecze_Valdgira.sap
Index: /tags/asma-1.1/Docs/Wanted.txt
===================================================================
--- /tags/asma-1.1/Docs/Wanted.txt	(revision 15)
+++ /tags/asma-1.1/Docs/Wanted.txt	(revision 15)
@@ -0,0 +1,20 @@
+At the time we are searching for these tunes:
+
+Richard Munns:
+Crumble's Crisis, Space Lobsters, any other tunes...
+
+Ben Daglish
+Gauntlet
+
+Fred Brooker
+Lemmintro, Balleantro, Vaxeen, Digisynth, Rabbacan, Brutal Recall
+Demo, any other tunes...
+(Unfortunately most of these titles aren't probably converted to PC disk
+images. I've got them on my T2000 tapes but many of them had some kind of copy
+protection.)
+
+Alex
+Sheol
+
+Unknown composers:
+Decathlon, Gyruss, Megablast, Zeppelin, Zorro, any other tunes...
