home *** CD-ROM | disk | FTP | other *** search
/ DOS Wares / doswares.zip / doswares / SOUND / XPLAY251.ZIP / X-PLAY.DOC < prev    next >
Encoding:
Text File  |  1994-12-17  |  16.9 KB  |  222 lines
  1. ╔────-∙∙-∙-──-──--─-─-─-────────────────────────-─-─-─-─-─--─-──-∙ ∙∙──────╗
  2. │         █▓  ▄█      █▓▀▀█▄ █▓     ▄▓▀▀█▄ █▓  ██ █▓▀▀██ █▓▀▀█▄            │
  3. │         █▓  ██   ▄  █▓  ██ █▓     █▓  ██ █▓  ██ █▓     █▓  ██            │
  4. │         ▀▓ ▄█▀  ▓█  █▓  ██ █▓     █▓  ██ █▓  ██ █▓▄    █▓  ██            │ 
  5. │         ▄▓ ▀█▄  ▓█  █▓ ■██ █▓     █▓ ■██ █▓  ██ █▓▀    █▓ ■█▀            │
  6. │         █▓  ██  ▓▀  █▓▀▀▀  █▓     █▓▀▀██ ▀▓███▀ █▓  ██ █▓▀▀▄             │
  7. │         █▓  ██ ──── █▓ ─── █▓▄▄██ █▓  ██ ─ ██ ─ █▓▄▄██ █▓  ██ V2·51      │
  8. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  9. │   PROGRAMMER ■ RAY^[RADICAL RHYTHMS]^[BLANK]                             │
  10. │       DESIGN ■ COSMiC^[RADICAL RHYTHMS]^[D-LUSION]^[BLANK]               │
  11. │   (C)1994,95 ■ RAY & COSMIC                                              │
  12. │ DiSTRiBUTiON ■ UNDERCOVER & RADiCAL RHYTHMS                              │
  13. │    ReLEASE   ■ VeRZiON V2.51 -/- 12/17/1994                              │
  14. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  15. │ ■ X-PLAY ReQUiRES ■                                                      │
  16. │                     [ FREE MEMORY                                      ] │
  17. │                     [ AT LeAST a 386SX/16                              ] │
  18. │                     [ A SoUNDCARD (GUS/SB/SBPRO/SB16ASP)               ] │
  19. │                     [ A COOL USER (WELL, MAYBE YOU... ;) )             ] │
  20. │-─-─-───────═════════════════════──═───════════════════─═══─══──-──-─-─-- │
  21. │ ■ HOW TO USE THE PLAYER ■                                                │
  22. │                                                                          │
  23. │  At your  command line type - X-PLAY FILENAME.DMF to  play  your desired │
  24. │  sound file (or without parameters to view the list of options).         │
  25. │                                                                          │
  26. │  After  selecting  a valid  sound file, the program prompts you to enter │
  27. │  several information. Select  your  sound  card  and  the  corresponding │
  28. │  mixer information. This of course only affects  SoundBlaster(tm) output │
  29. │  and is therefore not required if  running in GUS mode.                  │
  30. │                                                                          │ 
  31. │  The  player  main  screen  shows some information while playing and, of │
  32. │  course, a  fine, 32 channel wide  equalizer! Please  note  that the DMA │
  33. │  transfer  on SB  and  compatible cards  slows  down the systemspeed and │
  34. │  affects the frame update of the equalizer. Let there be GUS!            │
  35. │                                                                          │
  36. │  Note from RAY: I could have made the equalizer a LOT faster  in SB mode │ 
  37. │  but this would  decrease the sound qualitiy, so I decided to give maxi- │
  38. │  mum performance to quality.                                             │
  39. │                                                                          │
  40. │  This is why I implemented the "/B:xx" option which  sets the DMA buffer │
  41. │  length. The smaller  the value, the faster  the equalizer  on SB cards. │
  42. │  Just use the value you want to...                                       │
  43. │                                                                          │
  44. │  DISCLAIMER: You  use  this  software  at  your  own  risk! We  are  not │
  45. │  responsible for you putting the cat into the fridge while playing!      │
  46. │                                                                          │
  47. │  This program may be  distributed  freely  as long no fee is charged for │
  48. │  distribution. If  you  do  copy this program, then  copy it for FREE!!! │
  49. │  (Otherwise we'll get ya!)                                               │
  50. │                                                                          │
  51. │                                                                          │
  52. │  X-Tracker Player(c) 1993, 1994 by D-LUSION, RAY & COSMIC                │
  53. │  X-Tracker (c) 1993, 1994 by TBG/ASi                                     │
  54. │                                                                          │
  55. │                                                                          │
  56. │  Contact uz at:                                                          │
  57. │                                                                          │
  58. │  Undercover Support BBS +49 23 23 450 850                                │
  59. │  Ray's kewl voice line  +49 23 23 460 525                                │
  60. │                                                                          │
  61. │  Sorry for this SHORT docu, but no time to write a bigger one! ;)))      │
  62. │                                                                          │
  63. │  Greetings from RAY go to: everybody at RADiCAl RhYthMS, BlANk,          │
  64. │  D-lUSiON, lEGENd dESiGN, k.l.f. (Germany), klf (USA), CREW 242.         │
  65. │  Persona grata: MANhUNtER.CYbERdECk, RAP.CYbERdECk, ChiCkEN.ECR.S!P.     │
  66. │  Sorry, if I forgot your name in this list. Just let me know...          │
  67. │                                                                          │
  68. │  Revizion hiztory:                                                       │
  69. │   Changes from Verzion 1.o1 to 1.2o:                                     │
  70. │    - Renamed to X-PLAY because of some problems with the small D-LUSION  │
  71. │      player.                                                             │
  72. │    - Config file implemented. the first time you run the program and     │
  73. │      enter the parameters, X-PLAY will store your configuration in a     │
  74. │      special .INI file (hi BOP, CODE-X!).                                │
  75. │    - some graphical changes (yo COS) - think you feel better now!        │
  76. │    - check out the new functions! (watch the player screen!)             │
  77. │                                                                          │
  78. │   Changes from Verzion 1.2o to 1.26:                                     │
  79. │    - added support for DMA's 2,4,5,6,7,8,9 and IRQ's 2 and 12 for more   │
  80. │      success on SB 16 and GUS.                                           │
  81. │    - added a secret message scroller ;) maybe you find it!               │
  82. │                                                                          │
  83. │   Changes from Verzion 1.26 to 1.27                                      │
  84. │    - added dos exit codes, now X-PLAY sets the errorcode <> 0 if an      │
  85. │      error occured.                                                      │
  86. │                                                                          │
  87. │   Changes from Verzion 1.27 to 1.28                                      │
  88. │    - sorry dudez and dutettez! X-PLAY crashed with a player error on     │
  89. │      some systems and/or machines. This has been fixed! Sorry again! ;)  │
  90. │    - speeded up equalizer decrement on request by [ANNibAl!              │
  91. │                                                                          │
  92. │   Changes from Verzion 1.28 to 1.3o                                      │
  93. │    - added new memory manager features. Now X-PLAY will run with         │
  94. │      QEMM (tm) or EMM installed (but you must have at least one          │
  95. │      meg of XMS tough...).                                               │
  96. │                                                                          │
  97. │      *** NOTE: this feature is very new, so if it does not work - please │
  98. │      *** do not blame us for that. Please leave us a message, and we'll  │
  99. │      *** try to fix it.                                                  │
  100. │                                                                          │
  101. │    - the GUS window now shows the memory free _after_ loading a module.  │
  102. │    - added DSM support (_D_ouble _S_ound _M_em). Now X-PLAY will         │
  103. │      double the memory on your sound card (so you can play 1 meg files   │
  104. │      on 1/2 meg cards). This will result (how could it be) in a loss     │
  105. │      of quality. If you have less than one meg on your UltraSound        │
  106. │      card, this feature will be activated automatically. As soon as      │
  107. │      DSM is active, the free memory in the GUS window will be written    │
  108. │      in red chars.                                                       │
  109. │                                                                          │
  110. │   Changes from Verzion 1.3o to 2.oo                                      │
  111. │    - last final release, added support for DMF versions created using    │
  112. │      X-TRACKER V1.0 final.                                               │
  113. │    - for more information: read the (now noe more) secret scroller, the  │
  114. │      command line add-on for this is /SHOWMEASECRET (easy, huh?!)        │
  115. │                                                                          │
  116. │   Changes from Verzion 2.oo to 2.o1                                      │
  117. │    - errm, this is a new version with some changes and bugfixes. Just    │
  118. │      something to use instead of the older one. Have phun ;)             │
  119. │    - fixed DOUBLE SOUND MEM feature.                                     │
  120. │                                                                          │
  121. │   Changes from Verzion 2.o1 to 2.o2                                      │
  122. │    - ahem. Sorry! Ray did it again ;) Killed a few bugs and implemented  │
  123. │      a new one. On some systems, X-PLAY crashed. It should work now.     │
  124. │      I hope so ;) If not, just call me and tell me the error number.     │
  125. │      Thanks!                                                             │
  126. │                                                                          │
  127. │   Changes from Verzion 2.o2 to 2.o3                                      │
  128. │    - small bug fixed for CD rom usage. Now X-PLAY will also load         │
  129. │      "read-only" files. Wow, that was a cute one.... ;)                  │
  130. │      Non public version. Only available together with the commercial     │
  131. │      version of X-TRACKER.                                               │
  132. │                                                                          │
  133. │   Changes from Verzion 2.o3 to 2.1o                                      │
  134. │    - catched another bug (setting the master volume from the command     │
  135. │      line did not work) and implemented the setting for the DMA buffer.  │
  136. │      Beside finding some really minor bugs I also revised the error      │
  137. │      handling. X-PLAY should now no more reset in error cases. As I      │
  138. │      said: it SHOULD not... ;)                                           │
  139. │                                                                          │
  140. │   Changes from Verzion 2.1o to 2.2o                                      │
  141. │    - added nice color settings. Some bugs fixed, too. Added enhancements │
  142. │      for support of SB AWE32 as soon as the new drivers are ready.       │
  143. │                                                                          │
  144. │   Changes from Verzion 2.2o to 2.3o                                      │
  145. │    - GUS output should work with every GUS now.                          │
  146. │    - added DOS Shell (Hi to Simon and all the other dudez!).             │
  147. │    - DOS shell may still crash, use on your own risk. Please note that   │
  148. │      X-PLAY allocates nearly all high memory, only ca. 400KB low mem     │
  149. │      is left free. This should, however, be enough for formatting disks  │
  150. │      etc.                                                                │
  151. │                                                                          │
  152. │   Changes from Verzion 2.3o to 2.4o                                      │
  153. │    - added Show Beat (tm) (huh, just joking) technology. Songs which     │
  154. │      contain the string "#SB=xx" in the first line of the information    │
  155. │      block will cause the screen to flash as soon as there is a sample   │
  156. │      active on the corresponding channel.                                │
  157. │      This also works by setting a MusicFlag of 255 in the global track   │
  158. │      command. Remember to reset it to 0 after the beat has occured.      │
  159. │                                                                          │
  160. │      *** Note: If you experience any problems with ShowBeat you can turn │
  161. │          it of by using the "/NF" switch which also turns of fading.     │
  162. │                                                                          │
  163. │          ShowBeat only works with the GUS until now and will lateron     │
  164. │          also be available when in AWE 32 mode. No other SB support      │
  165. │          planned. Sorry!                                                 │
  166. │                                                                          │
  167. │    - you can now press SPACE while playing to change between the song    │
  168. │      info and the dmf header information. Just to keep you up to date!   │
  169. │      You can also see which version of X-Tracker the author has been     │
  170. │      using (for example, if this has been an illegal copy! ;) ).         │
  171. │    - a hint to all shell programmers! There's a (now no more) hidden     │
  172. │      command line switch in X-PLAY which deactivates the internal        │
  173. │      "shell to DOS" function. Simply use "/NS" an there you are!         │
  174. │    - people who disregard the fading when finishing X-PLAY can now press │
  175. │      ESC twice or use the "/NF" switch to turn of fading.                │
  176. │    - you can now scroll the song message by using PgUP and PgDOWN. Read  │
  177. │      and have phun.                                                      │
  178. │    - added check for output devices. You can't select a device on the    │
  179. │      options screen, if it is not there (well, you can, but X-PLAY will  │
  180. │      not continue... ;) ). This only works for base address and card.    │
  181. │      X-PLAY can not detect if IRQ and DMA are ok, so be carefull. A note │
  182. │      to SB owners: X-PLAY will treat all SB cards the same so be sure to │
  183. │      pick the correct card from the menu. X-PLAY can't see, if you've    │
  184. │      got an SB 16 or a normal SB.                                        │
  185. │    - new, revised "hidden" scroller. Read if you dare.                   │
  186. │    - double sound mem should now work with every GUS! Yeah, I know... I  │
  187. │      already said this some versions ago but this time, it should work!  │
  188. │      I hope so! ;)                                                       │
  189. │                                                                          │
  190. │    *** A note to some "clever" FIDO users: From version 2.3o on X-PLAY   │
  191. │        does no more accept DMAs lower than 5 for SB16 cards. As you      │
  192. │        *must* use a high DMA (to let you dudes know: every SB16 has a    │
  193. │        high DMA!) to get 16bit quality, X-PLAY supports only DMAs > 5!   │
  194. │        This is *no* bug! If your SB16 can't handle high DMAs - buy the   │
  195. │        original! ;)                                                      │
  196. │                                                                          │
  197. │   Changes from Verzion 2.4o to 2.5o                                      │
  198. │    - X-PLAY no longer quits if the config file is corrupted. You are now │
  199. │      prompted to reenter settings.                                       │
  200. │    - X-PLAY now supports error levels.                                   │
  201. │      The codes are different from the ones implemented in X-PLAY V1.27!  │
  202. │    - X-PLAY now comes along with X-SHELL2 by NiKOLAUS^255, the official  │
  203. │      shell for X-PLAY. Please do not mix this one up with the shell      │
  204. │      included with RADiCAL RhYthMS releases which is programmed by       │
  205. │      SLE^Q-TiP.                                                          │
  206. │    - fixed a really cute bug - I bet, nobody has seen it. If you did,    │
  207. │      put your hands up in the air!                                       │
  208. │                                                                          │
  209. │    *** Another note: Due to a SB16 FIDO stranger calling this evening, I │
  210. │        reenabled the low DMA feature. Please note that you will *ruin*   │
  211. │        the output quality by selecting a lower DMA for your SB16. More-  │
  212. │        over I can't guarantee for anything because the replay routines   │
  213. │        are not made for an 8-bit transfer on a SB16. Use at your own     │
  214. │        risk!                                                             │
  215. │                                                                          │
  216. │   Changes from Verzion 2.5o to 2.51                                      │
  217. │    - added a few more lines of support for X-SHELL to X-PLAY. You will   │
  218. │      now get no more unneccessary information dumped on screen.          │
  219. │                                                                          │
  220. │                                   Goodbye and keep on raving - yours RAY │
  221. │                                 And remember: "Winners don't use drugs!" │
  222. ╚═════════════════════════════════──═───═══════════════════════════════════╝