home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / amusic11.zip / AMUSIC11.DOC next >
Text File  |  1996-01-08  |  5KB  |  244 lines
  1.  
  2.                   ·A·M·U·S·I·C·
  3.  
  4.                   v101%
  5.  
  6.  
  7.  
  8.                 1995/96  ε£¥$$ì$
  9.  
  10.             Coded 1995/96 by Conqueror
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20. Documentation for release 101% (in fact it is 1.11 :)
  21. ────────────────────────────────────────────────────
  22.  
  23.  
  24. Contents:  (1) - Information
  25.        (2) - AMUSiC-Basics
  26.        (3) - Coders stuff
  27.        (4) - How to get support ???
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36. (1)  Information
  37. ────────────────
  38.  
  39. Amusic supports Soundcards or soundcards with OPL2 chips.
  40. It needs about 200k of conventional memory and a 386 CPU, a compatible VGA
  41. and a mouse.
  42.  
  43.  
  44. What did I change in version 1.12 ???
  45.  
  46.  - Now you can load Protracker Modules
  47.  
  48.  - thats all :)
  49.  
  50.  
  51.  
  52.  
  53. (2)  Basics
  54. ───────────
  55.  
  56. This version of AMUSiC supports the following formats:
  57.  
  58.  AMD - our Adlib Module format (packed and linear)
  59.  SA2 - Surprise Adlib Tracker (Verion 2)
  60.  HSC - Adlib-Tune-Format by Chicken
  61.  RAD - Reality Adlib Tracker
  62.  MOD - Protracker Modules
  63.  
  64.  INS - Screamtracker Instrument
  65.  AIE - Adlib Instrument format by Ryu/D+P+S
  66.  
  67. Information about the supported song commands or keyboard shortcuts are
  68. provided in the online help (while pressing [F1] in the editor).
  69.  
  70. Is there anythin else to tell ya???   Dont think so!
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81. (3)  Coders stuff
  82. ─────────────────
  83.  
  84. If you want support Adlib music in your project, you can use our modules of
  85. course. If you want, you can use the provided objectfile to play amd's.
  86.  
  87.  
  88. Amusic supports two kinds of modules. The packed module and the normal
  89. module format. The normal format is easier to code but modules are bigger
  90. in size (often 10 times bigger!!!). Its up to you!!!
  91.  
  92.  
  93.  
  94. Adlib-MOD-Format: (c)23.8.1995 - 20:10:30 by Conqueror :)
  95. -----------------
  96.  hex  -  dec  -  function
  97.  
  98.  000h      0     name of song + nullbyte
  99.  018h     24     name of autor + nullbyte
  100.  030h     48     [...]  26 instruments (26*34 byte)
  101.  3A4h    932     songlen
  102.  3A5h    933     number of patterns-1
  103.  3A6h    934     patterntable (128 Byte)
  104.  426h   1062     id: "<o∩QUεRoR"
  105.  42Fh   1071     version 10h=normal module
  106.              11h=packed module
  107.  
  108. if the module isn't packed:
  109.  
  110.  430h   1072     all patterns (count*9*3*64 Bytes)
  111.  
  112.  END!!!
  113.  
  114.  
  115. if the module is packed:
  116.  
  117.  
  118.  430h   1072     table with Trax (ptncount*9*2)
  119.  
  120. - A pattern is divided into 9 tracks. Here comes a table that contains a
  121.   number (offset) for each track saved in the file.
  122.   This is because many tracks in the song can be identical copies of only
  123.   one track saved in the file.
  124.  
  125.  xxxx   xxxx     number of trax  (WORD)
  126.  xxxx+2 xxxx+2   [...] traxdatas
  127.  
  128.  END!!!
  129.  
  130.  
  131.  
  132. A track is written in the following manner: First comes a word that contains
  133. the position of the track in song. (pattern*9+tracknr)
  134. Then follows the events. One event takes 3 bytes. But empty events takes
  135. only 1 byte ! You can distinguish real events from empty events
  136. with the most significant bit of the first saved byte of the event.
  137. If the bit is zero than you have a real event. But if the bit isn't zero
  138. than you have to create some empty events in your current track. To get
  139. the number of empty events just read the lower 7 bits of the byte.
  140.  
  141. Got it??? Hope so!!!
  142.  
  143.  
  144. Here comes the format of an event:
  145.  
  146.  
  147.  BYTES: x,y,z:
  148.  
  149.  xxxxxxxxyyyyyyyyzzzzzzzz
  150.  000011122222333354444444
  151.  
  152.  0 - pitch of the event (0-12)
  153.  1 - octave of the event (0-7)
  154.  2 - instrumentnumber of the event (0-26)
  155.  3 - eventcommand (0-9)
  156.  4 - parameter of the command (0-99)
  157.  
  158.  5 - if this bit is turned on and the file is a packed module than 4 stands
  159.      for the number of empty tracks. But you already know that!!!
  160.  
  161.  
  162.  
  163. Note: Read the event from the file in this direction:
  164.  
  165.     z y x     !!!!
  166.  
  167.  
  168.  
  169.  
  170.  
  171. Here comes the instrument format of the modules:
  172.  
  173. (decimal offsets)
  174.  
  175. 0-22 Name
  176.   23 Mod-Charakt.
  177.   24 Mod-Amplit.
  178.   25 Mod-AD
  179.   26 Mod-SR
  180.   27 Mod-Waveform
  181.   28 Carr-Charakt.
  182.   29 Carr-Amplit.
  183.   30 Carr-AD
  184.   31 Carr-SR
  185.   32 Carr-Waveform
  186.   33 Conntect
  187.  
  188.  
  189.  
  190.  
  191.  
  192. ;-------
  193.  
  194. I am too lazy now to explain the object code. I give you some sourcecodes
  195. in PASCAL and ASSEMBLER !  (Can bee found in sources-directory.)
  196.  
  197.  
  198.  
  199. But, what you perhaps need to know is the structure of the work buffer:
  200.  
  201.  
  202. WrkBuff_TrackBase       equ 0           ;PRiVAT!!!
  203. WrkBuff_TrackPtr        equ 480h        ;PRiVAT!!!
  204. WrkBuff_TrackDelay      equ 492h        ;PRiVAT!!!
  205.  
  206. WrkBuff_CurrPtn         equ 49Bh        ;
  207. WrkBuff_CurrLine        equ 49Ch        ;
  208. WrkBuff_SongDelay       equ 49Dh        ;
  209. WrkBuff_CurrSpeed       equ 49Eh        ;
  210. WrkBuff_CurrEvent       equ 49Fh        ;
  211. WrkBuff_LastEvent       equ 4A4h        ;
  212. WrkBuff_CarrVol         equ 510h
  213. WrkBuff_ModVol          equ 519h
  214.  
  215. WrkBuffSize equ 522h
  216.  
  217. Keep in mind: ALL DATAS ARE READ ONLY!!!
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226. (4)  How to get support ???
  227. ───────────────────────────
  228.  
  229. The newest version of Amusic is available at:
  230.  
  231. ε£¥$$ì$ WHQ     -    X-PRESS  +49-30-4013654
  232.                 
  233.  
  234. Send Bugreports, Criticism and suggestions to Conqueror, reachable
  235. on our whq or send mail to Steffen Kiefer 2:2410/615.11@Fido
  236.  
  237.  
  238. That's all - hope to get some reactions!
  239.  
  240. See ya soon!!!
  241.  
  242.  
  243.  
  244.