home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Programming / XMPlayer-library / xmplayer.readme < prev   
Encoding:
Text File  |  2001-04-17  |  3.8 KB  |  150 lines
  1. Short:        xmplayer.library - plays a FastTracker modules
  2. Author:       crust@go2.pl (Michaî Skorupka)
  3. Uploader:     ymi@inetia.pl (Marcin Wieczorek)
  4. Type:         dev/asm
  5. Version:      1.0a
  6. Requires:     OS2.04
  7. Date:          17-Apr-2001
  8.  
  9. This  library  is  designed  for  coders - for more details see the autodoc
  10. file.   It plays FastTracker (XM) modules.Package contains xmplayer.library
  11. which  was written in assembler, and needed developer files :  includes (C,
  12. assembler)  and  autodoc file.  You can also find an example XM by Madman /
  13. Amnesty.Library  was  written  based  on  source code of PS3M Copyright (c)
  14. Jarno Paananen a.k.a.  Guru / S2 1994-96.
  15.  
  16. *** History ***
  17.  
  18. 1.0a (17-Apr-2001) -  First public release...
  19.  
  20. *** Copyright ***
  21.  
  22. Package  have  mailware  status so if you want use it you have to send me a
  23. mail (see ***Contact***).  Library was written based on source code of PS3M
  24. Copyright (c) Jarno Paananen a.k.a.  Guru / S2 1994-96.
  25.  
  26. *** Contents ***
  27.  
  28. Package  contains  xmplayer.library  which  was  written  in assembler, and
  29. needed  developer  files  :  includes (C, assembler) and autodoc file.  You
  30. can also find an example XM by Madman / Amnesty.
  31.  
  32. *** Background ***
  33.  
  34. Package  was  designed  to  use  for  demos  and games, because FastTracker
  35. modules,  as  you  know,  are  multichannels, it supports 16bit samples and
  36. mixing  routines  are fast (more XMs you can play on 020 with fast).  Here
  37. are list of supported effects:
  38.  
  39. *************************
  40. *   Standard effects:   *
  41. *************************
  42.  
  43.  
  44. 0    Arpeggio
  45. 1    Porta up
  46. 2    Porta down
  47. 3    Tone porta
  48. 4    Vibrato
  49. 5    Tone porta+Volume slide
  50. 6    Vibrato+Volume slide
  51. 7    Tremolo
  52. 8    Set panning
  53. 9    Sample offset
  54. A    Volume slide
  55. B    Position jump
  56. C    Set volume
  57. D    Pattern break
  58. E1    Fine porta up
  59. E2    Fine porta down
  60. E3    Set gliss control
  61. E4    Set vibrato control
  62. E5    Set finetune
  63. E6    Set loop begin/loop
  64. E7    Set tremolo control
  65. E9    Retrig note
  66. EA    Fine volume slide up
  67. EB    Fine volume slide down
  68. EC    Note cut
  69. ED    Note delay
  70. EE    Pattern delay
  71. F    Set tempo/BPM
  72. G    Set global volume
  73. H    Global volume slide
  74. K    Key off
  75. L    Set envelope position
  76. P    Panning slide
  77. R    Multi retrig note
  78. T    Tremor
  79. X1    Extra fine porta up
  80. X2    Extra fine porta down
  81.  
  82. *********************************
  83. *   Effects in volume column:   *
  84. *********************************
  85. Value      Meaning
  86.  
  87.    0       Do nothing
  88.  $10-$50   Set volume Value-$10
  89.    :          :        :
  90.    :          :        :
  91.   $60-$6f   Volume slide down
  92.   $70-$7f   Volume slide up
  93.   $80-$8f   Fine volume slide down
  94.   $90-$9f   Fine volume slide up
  95.   $a0-$af   Set vibrato speed
  96.   $b0-$bf   Vibrato
  97.   $c0-$cf   Set panning
  98.   $d0-$df   Panning slide left
  99.   $e0-$ef   Panning slide right
  100.   $f0-$ff   Tone porta
  101.  
  102. *** Requirements ***
  103.  
  104. Library  for  correct working needs OS 2.04 and of course some memory...  I
  105. didnt  remove  mixing  routine  for  68000  but im not sure if it will be
  106. working on this processor because i cant check it.
  107.  
  108. *** Usage ***
  109.  
  110. Library is for coders - for more details see the autodoc file.
  111.  
  112. *** Future ***
  113.  
  114. If  there  will  be  an  interest  in my library, maybe I will add some new
  115. effects, fix bugs, speed up and when MisterQ finish his sound card (Martina
  116. - www.martina.3d.pl) i will add support for it.
  117.  
  118. *** Bugs ***
  119.  
  120. Library  dont  play  some  XM  files, and some plays wrongly.  Its not my
  121. fault  but PS3M player - on which my library was based, so if there will be
  122. an  interest  in  my  library, mayby I will add some new effects, fix bugs,
  123. etc..
  124.  
  125. *** Thanks ***
  126.  
  127. Thanks for:
  128.  
  129. -  Jarno  Paananen  for  release  PS3M source code, without it this library
  130.    cannot be written.
  131. - Igor / TCG for C includes and example.
  132. - Madman/ Amnesty for example XM.
  133. - ...and for everyone i forgot.
  134.  
  135. *** Contact ***
  136.  
  137. Contact me by email:
  138.  
  139. crust@go2.pl
  140. crust@viper.pl
  141. crust@amigascne.org
  142.  
  143. My home page (only polish now...)
  144.  
  145. http://viper.pl/~crust/index.html
  146.  
  147. *** Sorry ***
  148.  
  149. Sorry for my bad english... it's not my native language...
  150.