home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / DEMO / SND / RR_CH6-1.ZIP / X-PLAY.DOC < prev    next >
Encoding:
Text File  |  1995-03-31  |  15.7 KB  |  207 lines
  1. ╔────-∙∙-∙-──-──--─-─-─-────────────────────────-─-─-─-─-─--─-──-∙ ∙∙──────╗
  2. │         █▓  ▄█      █▓▀▀█▄ █▓     ▄▓▀▀█▄ █▓  ██ █▓▀▀██ █▓▀▀█▄            │
  3. │         █▓  ██   ▄  █▓  ██ █▓     █▓  ██ █▓  ██ █▓     █▓  ██            │
  4. │         ▀▓ ▄█▀  ▓█  █▓  ██ █▓     █▓  ██ █▓  ██ █▓▄    █▓  ██            │ 
  5. │         ▄▓ ▀█▄  ▓█  █▓ ■██ █▓     █▓ ■██ █▓  ██ █▓▀    █▓ ■█▀            │
  6. │         █▓  ██  ▓▀  █▓▀▀▀  █▓     █▓▀▀██ ▀▓███▀ █▓  ██ █▓▀▀▄             │
  7. │         █▓  ██ ──── █▓ ─── █▓▄▄██ █▓  ██ ─ ██ ─ █▓▄▄██ █▓  ██ V2·99ß     │
  8. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  9. │   PROGRAMMER ■ RAY^[RADiCAL RHYTHMS]^[BLANK]                             │
  10. │       DESiGN ■ COSMiC^[RADiCAL RHYTHMS]^[D-LUSiON]^[K.L.F]               │
  11. │   (C)1994,95 ■ RAY & COSMiC                                              │
  12. │ PORTiONS (C) ■ ANGUiLLA SOFTWARE iNTL. & D-LUSiON iNTERACTiVE SOFTWARE   │
  13. │ DiSTRiBUTiON ■ UNDERCOVER & RADiCAL RHYTHMS                              │
  14. │      RELEASE ■ VERSiON V2.99ß -/- 03/09/1994                             │
  15. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  16. │                                                                          │
  17. │ ■ X-PLAY ReQUiRES ■                                                      │
  18. │                     [ FREE MEMORY, 4 MEGS OF RAM SHOULD WORK           ] │
  19. │                     [ AT LeAST a 386SX/16                              ] │
  20. │                     [ A SoUNDCARD (GUS/SB/SBPRO/SB16ASP/SBAWE32)       ] │
  21. │                                                                          │
  22. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  23. │                                                                          │
  24. │ ■ X-PLAY - AN OVERViEW ■                                                 │
  25. │                                                                          │
  26. │ What is X-PLAY? X-PLAY is a player for DMF files, created  using the one │
  27. │ and only tracker - X-TRACKER ( ;)) ). Playback is  possible with  nearly │
  28. │ any  soundcard  and, to be exact, these  are: SoundBlaster, SoundBlaster │
  29. │ Pro, SoundBlaster  16 (ASP), SoundBlaster  AWE  32 and  the Gravis Ultra │
  30. │ Sound card. You  may  also  use  any clone  of the  above, but  we can't │
  31. │ guarantee  playback on  these. As we  can't guarantee  playback  on  the │
  32. │ original cards either, this should not matter <smile>.                   │
  33. │                                                                          │
  34. │ X-PLAY features a command line only interface for settings, but  you may │
  35. │ use its add-on, X-SHELL, to keep track of these. X-PLAY is also intended │
  36. │ for quick and successful playback which means that no brilliant gfx have │
  37. │ been included for your pleasure.                                         │
  38. │                                                                          │
  39. │ X-PLAY normally (except for beta releases) is accompanied by X-SHELL, an │
  40. │ easy-to-use, userfriendly shell. Please read its doc for more info!      │
  41. │                                                                          │
  42. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  43. │                                                                          │
  44. │ DISCLAIMER: You use this software at your own risk. The authors  can not │  
  45. │ be held reliable for any damage  caused  by  this program. By  using the │
  46. │ program you state that you agree with the above.                         │
  47. │ This program  is  copyrighted  software. It is not free. You may use and │
  48. │ copy it as long as the following restrictions are obeyed.                │
  49. │ The copyright and all other rights remain with the authors.              │
  50. │ You  must not disassemble, manipulate or reverse engineer X-PLAY and its │
  51. │ code.                                                                    │
  52. │ The program (X-PLAY) may NOT be distributed by any commercial company or │
  53. │ person. You must  NOT  distribute  this  program  on  a  CD-ROM. You may │
  54. │ distribute  this program on  disk but  NOT if  this disk is sold for any │
  55. │ price (it does  not  matter if  the disk is sold or if the customer pays │
  56. │ for copying the disk). This  program  must NOT  be sold on any so called │
  57. │ "PD", "FREEWARE" or "SHAREWARE" disk.                                    │
  58. │ By copying, distributing or using this program you agree with the above. │
  59. │ If  you  want  to do  anything apart from the above you need the written │
  60. │ permission of the authors.                                               │
  61. │ And  just to let you know: "We don't  make  money with this stuff, so we │  
  62. │ do not want other people making money of it either!"                     │
  63. │ A word of warning: "We already got some people selling our stuff. Now we │
  64. │ got more than we would have taken if they had asked us before."          │
  65. │                                                                          │
  66. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  67. │                                                                          │
  68. │ ■ HOW TO CONTACT THE AUTHORS ■                                           │
  69. │                                                                          │
  70. │ You can contact the authors at the following address:                    │
  71. │                                                                          │
  72. │ RAY^RADiCAL RHYTHMS                                                      │
  73. │ c/o Christian Bartsch                                                    │
  74. │ Flottmannstr. 117                                                        │
  75. │ 44625 Herne                                                              │
  76. │ Germany                                                                  │
  77. │                                                                          │
  78. │ Tel.: from Germany         -   0 23 23 460 525                           │
  79. │       from other countries - +49 23 23 460 525                           │
  80. │                                                                          │
  81. │ Please do call between 10 am and 11 pm.                                  │
  82. │ When you're calling from  the other side of the globe, our local time is │
  83. │ different from yours - please check! I love American  dudes calling, but │
  84. │ not at 4 am! ;)                                                          │
  85. │                                                                          │
  86. │ Mailbox: Germany           -   0 23 23 460 094                           │
  87. │          other countries   - +49 23 23 460 094                           │
  88. │                                                                          │
  89. │ You may call this number 25 hours a day (hm?). Leave a mail to COSMIC or │
  90. │ RAY. Call the UNDERCOVER!                                                │
  91. │                                                                          │
  92. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  93. │                                                                          │
  94. │ ■ HOW TO USE THE PLAYER ■                                                │
  95. │                                                                          │
  96. │ As we already stated, X-PLAY works by using the command line. The syntax │
  97. │ is:                                                                      │
  98. │                                                                          │
  99. │ X-PLAY filename.DMF <parameter1 parameter2 ...>                          │
  100. │                                                                          │
  101. │ "filename"  can be  any valid DMF file. If  no file is  found, ".DMF" is │
  102. │ added as its extension. If  the  file  can't be  located  hereafter, the │
  103. │ the execution of X-PLAY is aborted.                                      │
  104. │                                                                          │
  105. │ "parameter1" and  so  on  are  additional, optional parameters. They are │
  106. │ single words, separated by a space (" "). You may add as many of them as │
  107. │ you like.                                                                │
  108. │                                                                          │
  109. │ Valid key words are:                                                     │
  110. │                                                                          │
  111. │   "/Cx"    - sets color                                                  │
  112. │   "/O"     - overrides .INI file sound card settings.                    │
  113. │   "/V:xxx" - sets the output volume (ranges from 1-255).                 │
  114. │   "/W"     - waits for a keypress before starting / stopping the music.  │
  115. │   "/NF"    - turns off fading.                                           │
  116. │   "/NSB"   - turns off ShowBeat(tm).                                     │
  117. │   "/NSH"   - turns off internal "Shell to DOS" function.                 │
  118. │                                                                          │
  119. │ Running X-PLAY without parameters will pop up an info screen:            │
  120. │                                                                          │
  121. │  ───-∙∙-∙-──-──--─-─-─-───────────────────────-─-─-─-─-─--─-──-∙ ∙∙───── │
  122. │          █▓  ▄█   ▄  █▓▀▀█▄ █▓     ▄▓▀▀█▄ █▓  ██ █▓▀▀██ █▓▀▀█▄           │
  123. │          ▀▓ ▄█▀  ▓█  █▓  ██ █▓     █▓  ██ █▓  ██ █▓▄    █▓  ██           │
  124. │          ▄▓ ▀█▄  ▓█  █▓ ■██ █▓     █▓ ■██ █▓  ██ █▓▀    █▓ ■█▀           │
  125. │          █▓  ██  ▓▀  █▓▀▀▀  █▓     █▓▀▀██ ▀▓███▀ █▓  ██ █▓▀▀▄            │
  126. │          █▓  ██ ──── █▓ ─── █▓▄▄██ █▓  ██ ─ ██ ─ █▓▄▄██ █▓  ██ Version   │
  127. │  ─-─-───────═════] featuring ShowBeat (tm) technology [═──════─══───-─-- │
  128. │         X-PLAY Version / Date - (c) 1994, 1995 by RAY & COSMIC           │
  129. │                                                                          │
  130. │ PROGRAMMiNG ■ RAY^[RADiCAL RHYTHMS]^[BLANK]                              │
  131. │      DESiGN ■ COSMiC^[RADiCAL RHYTHMS]^[D-LUSiON]^[K.L.F.]               │
  132. │  (C)1994,95 ■ RAY & COSMiC, REPLAY ROUTiNES BY D-LUSiON                  │
  133. │                                                                          │
  134. │ USAGE: X-PLAY <MusicFile.DMF> [/Cx] [/NF] [/NSB] [/O] [/V:xxx] [/W]      │
  135. │  e.g.: X-PLAY RAN-JUST.DMF /W /V:222                                     │
  136. │                                                                          │
  137. │/Cx sets color: /C0 = normal, /C1 = red, /C2 = green, /C3 = blue, /C4 = ..│
  138. │/O overrides .INI file sound card settings.                               │
  139. │/V:xxx sets the output volume (ranges from 1-255).                        │
  140. │/W waits for a keypress before starting / stopping the music.             │
  141. │/NF turns off fading. /NSB turns off ShowBeat(tm).                        │
  142. │                                                                          │
  143. │ After checking the file, X-PLAY sets up the memory manager and will look │
  144. │ for a file called "X-PLAY.INI". This  file  is  stored  in the same path │
  145. │ where  the  X-PLAY executable is placed. If this file is present, X-PLAY │
  146. │ will take  all  player  information (soundcard  and  settings) from this │
  147. │ file. If this file can't be  found,  X-PLAY will prompt you to enter the │
  148. │ settings on the setup screen:                                            │
  149. │                                                                          │
  150. │ First, you'll be prompted  to enter  the sound  device  you wish to use. │
  151. │ Use the cursor keys (left&right) to choose the device. X-PLAY will check │
  152. │ and see if this device is present lateron.                               │
  153. │ If you  choose "SB", "SBPRO" or "SB16" you  will then be asked to choose │
  154. │ the mixing frequency. This  will affect  the  quality  of the output and │
  155. │ depends on the power of your processor. You can not  play back a song on │
  156. │ an ordinary "SB"  with  a  386  using  a mixing frequency of "44000" Hz. │
  157. │ Try - if  you  have any  pops or  drop outs, your  processor is not fast │
  158. │ enough. Delete  the .INI file  and try with a  smaller mixing frequency. │
  159. │ Use the cursor keys (up&down) to select the value.                       │
  160. │ If you use the Gravis  Ultra Sound  or the SoundBlaster AWE 32  you will │
  161. │ not be  prompted  to enter the  value because the  mixing is done by the │
  162. │ hardware itself. Therefore, the mixing  frequency is  always the maximum │
  163. │ the card can use.                                                        │
  164. │ Enter the other functions as desired, using the cursor keys.             │
  165. │                                                                          │
  166. │ SB 16 users please note: when  selecting  an 8-bit DMA channel (<5), you │
  167. │ will loose your 16-bit features and will hear 8-bit mixed music.         │
  168. │                                                                          │
  169. │ AWE Users please note: The replay routines on the AWE work without using │
  170. │ any DMA  or  IRQ functions. X-PLAY  will  display IRQ 2  and DMA 1  when │
  171. │ selecting the  AWE 32 but will  not use  them. So: don't worry, you only │
  172. │ need the correct base address.                                           │
  173. │                                                                          │
  174. │ The  main player  screen will  show  some information about the song and │
  175. │ a function overview. On the right, the 32 channels are shown with a peak │
  176. │ meter, which is only  updated when an instrument is played on a channel. │
  177. │ If you want hot graphics, use other players. ;)                          │
  178. │                                                                          │
  179. │ You can leave the player at any time by pressing ESCape.                 │
  180. │                                                                          │
  181. │ Other functions can be  activated by pressing the corresponding key and, │
  182. │ as they are self explanatory, will not be discussed within this doc.     │
  183. │                                                                          │
  184. │ Some general notes:                                                      │
  185. │                                                                          │
  186. │ If the cards memory is written in RED chars, double sound mem is active. │
  187. │ This happens if  the on board memory (only GUS&AWE) is  to small to keep │
  188. │ hold of the song's samples. In  this case, all  samples are recalculated │
  189. │ to fit into half  the memory  they'd normally need. If  your  card's mem │
  190. │ is still to small after this operation, X-PLAY will abort execution.     │
  191. │                                                                          │
  192. │ The DOS Shell is not very safe to use - it is there, so  use  it on your │
  193. │ own risk. If it crashes.. well, shit happens!                            │
  194. │                                                                          │
  195. │ Some modules contain  Show Beat (screen  flashing while playing). If you │
  196. │ experience  any loss  in sound  quality just  disable  this function and │
  197. │ there you are.                                                           │
  198. │                                                                          │
  199. │  Greetings from RAY go to: everybody at RADiCAl RhYthMS, BlANk,          │
  200. │  D-lUSiON, lEGENd dESiGN, k.l.f. (Germany), klf (USA), CREW 242.         │
  201. │  Persona grata: MANhUNtER.CYbERdECk, RAP.CYbERdECk, ChiCkEN.ECR.S!P.     │
  202. │  Sorry, if I forgot your name in this list. Just let me know...          │
  203. │                                                                          │
  204. │                                   Goodbye and keep on raving - yours RAY │
  205. │                                 And remember: "Winners don't use drugs!" │
  206. ╚═════════════════════════════════──═───═══════════════════════════════════╝
  207.