home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / AWE / AWEMP131.ZIP / AWEMP.DOC next >
Encoding:
Text File  |  1995-09-10  |  11.6 KB  |  280 lines
  1. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  2.                        Sound Blaster AWE32 Module Player
  3.                          Copyright (C) 1995 by B.Boer
  4.                              All rights reserved
  5.                                  Documentation
  6. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  7.  
  8.  
  9. What is AWEMP?
  10. --------------
  11.  
  12. AWEMP is a module player programmed for Creative Labs' Sound Blaster AWE32.
  13. The Sound Blaster AWE32 (for short AWE32) is capable of mixing multiple (max.
  14. 30) channels by hardware, i.e. the EMU8000 chip. The AWE32 has 512 kb onboard
  15. RAM, which you can upgrade to 28 Mb (unless you've got the VE version).
  16. Music sounds very real with this card, because there are two LFO's, two
  17. envelopes and a reverb & chorus effects processor for each of the 30 channels.
  18. With these LFO's and envelopes you can create very special (and natural)
  19. effects to the sound samples, and if you select one of the 16 effect types or
  20. one of the 26 filters, you'll get superb sound!
  21.  
  22.  
  23. Is AWEMP freeware?
  24. ------------------
  25.  
  26. AWEMP is *cardware*, which means that if you like the program, you must send me
  27. a nice postcard, so I can see how much it is used around the world. See the
  28. section about how to contact the author for the mail address.
  29.  
  30.  
  31. How do I use AWEMP?
  32. -------------------
  33.  
  34. Well, this is very easy; just type AWEMP [module.ext]. AWEMP will give error
  35. messages (if necessary) in case your module is not supported, or it doesn't
  36. fit into your AWE32's memory (see below), or simply because it couldn't find
  37. your module(s). If there are no error messages, AWEMP will load the samples
  38. into the AWE32 and play the module.
  39.  
  40. For commandline options, type at the DOS prompt: AWEMP /?
  41. While AWEMP is playing, press 'H' to display the helptext.
  42.  
  43.  
  44. Commandline options for AWEMP.
  45. ------------------------------
  46.  
  47.   /Cxxx  Sets chorus depth, range for xxx is 0-255.
  48.  
  49.   /D     Doubles sampling RAM on AWE32. AWEMP will convert all 8 bit samples to
  50.          16 bit while the samplesize remains the same. With this option added
  51.          to the commandline you can load modules up to 512 kb with 512 kb
  52.          onboard RAM, 4 Mb modules with 4 Mb, etc. You will however hear some
  53.          loss of sample quality, especially with hi-hats and high quality
  54.          strings, but this is totally dependant on the sample rate at which
  55.          the samples are recorded.
  56.          => This option is temporarily disabled in this version (v1.31).
  57.  
  58.   /Exy   Set reverb and chorus effect types, where x is the reverb effect and
  59.          y the chorus effect. Range for both x and y is 1-8;
  60.  
  61.   /I     Ignores all warning messages, that is, they don't appear at all.
  62.  
  63.   /L     Disables module looping, useful when using in combination with option
  64.          '/O'.
  65.  
  66.   /O     Plays the specified modules in a random order. Useful when you
  67.          specify more than one module at the DOS prompt, i.e. AWEMP *.MOD /O.
  68.  
  69.   /Rxxx  Sets reverb depth, range for xxx is 0-255.
  70.  
  71.   /Vxxx  Sets main volume, range for xxx is 0-255.
  72.  
  73. A few examples:
  74.  
  75.   AWEMP D:\MODS\*.MOD                  play all MODs in directory D:\MODS.
  76.   AWEMP D:\MODS\*.MOD /O               the same but in random order.
  77.   AWEMP D:\MODS\*.MOD D:\MODS2\*.MOD   play all MODs in both directories.
  78.   AWEMP D:\MODS\B*.MOD                 play all MODs containing the B as
  79.                                        the first character in the filename.
  80.  
  81.   To play three specified modules type this:
  82.   AWEMP D:\MODS\CORTOUCH.MOD D:\MODS2\BEYOND.MOD D:\MODS3\WATERFNK.MOD
  83.  
  84.   Or what do you think about this:
  85.   AWEMP D:\MODS\REAL????.MOD D:\MODS2\*.MOD D:\MODS3\WATERFNK.MOD
  86.  
  87. Note that all extensions may be omitted.
  88.  
  89.  
  90. What keys can you use while AWEMP is playing?
  91. ---------------------------------------------
  92.  
  93. Following keys do something useful:
  94.  
  95.     Esc  Stop playing and exit AWEMP.
  96.  
  97.       A  Display the sample names of the current module. Use the cursor keys
  98.          to scroll through the sample names.
  99.       B  Play the previous module in the play list.
  100.       D  Shell to DOS while music keeps playing.
  101.       E  Select reverb and chorus effects.
  102.       H  Display the helptext.
  103.       L  Enter play list, you can then select a module by moving the selector
  104.          bar over a filename and then press the Enter key.
  105.       N  Play the next module in the play list.
  106.       P  Pause the playing of the song.
  107.  
  108.       -  Decrease main volume by 8.
  109.       +  Increase main volume by 8.
  110.  
  111.       [  Decrease reverb depth by 8.
  112.       ]  Increase reverb depth by 8.
  113.  
  114.       {  Decrease chorus depth by 8.
  115.       }  Increase chorus depth by 8.
  116.  
  117.    Left  Decrease song position by one.
  118.   Right  Increase song position by one, at the end of the song, AWEMP jumps
  119.          to position 0 (unless option '/L' is used).
  120.  
  121.   Enter  Play current pattern again at line 0.
  122.  
  123.  
  124. Which effects are currently supported?
  125. --------------------------------------
  126.  
  127. Nearly all effects are supported, except for a few which I do not know how to
  128. implement them.
  129.  
  130. Effects supported (MOD):  0xy - arpeggio
  131.                           1xx - portamento up
  132.                           2xx - portamento down
  133.                           3xx - portamento to note
  134.                           4xy - vibrato
  135.                           5xx - tone portamento + volume slide
  136.                           6xx - vibrato + volume slide
  137.                           7xy - tremolo
  138.                           8xx - set pan position
  139.                           9xx - sample offset
  140.                           Axy - volume slide up/down
  141.                           Bxx - position jump
  142.                           Cxx - set volume
  143.                           Dxx - pattern break
  144.                           E1x - fine portamento up
  145.                           E2x - fine portamento down
  146.                           E4x - set vibrato waveform
  147.                           E5x - set looppoint
  148.                           E6x - jump to looppoint
  149.                           E7x - set tremolo waveform
  150.                           E9x - retrig note
  151.                           EAx - fine volume slide up
  152.                           EBx - fine volume slide down
  153.                           ECx - note cut
  154.                           EDx - note delay
  155.                           EEx - pattern delay
  156.                           Fxx - set speed/bpm
  157.  
  158.  
  159. Common Questions and Answers (Q&A).
  160. -----------------------------------
  161.  
  162. Q: You said that 15-instruments MODs are supported, but AWEMP won't load my
  163.    MOD!!
  164.  
  165. A: AWEMP checks the module if it has some sort of identification (such as M.K.
  166.    or FLT8), if it hasn't, AWEMP assumes it's a 15-instruments MOD. Before
  167.    AWEMP loads the samples, a small check is processed on the module to see
  168.    whether it's a real 15-instruments MOD or not. AWEMP does this by comparing
  169.    the filesize with the total sum of <patterndata-offset + patterndatasize +
  170.    sampledatasize>. If this is not equal, the module will be discarded.
  171.  
  172. Q: I've got an AWE32 with 8 Mb onboard, but AWEMP tells me that there's only
  173.    512 kb onboard.
  174.  
  175. A: There is only one possible reason that AWEMP detects only 512kb: you did
  176.    forget to remove jumper JP7 on the card, which is necessary to use the SIMM
  177.    banks. See also the manual which came with your card.
  178.  
  179. Q: What about all those clicks? It sounds just like I'm listening to an old
  180.    gramophone.
  181.  
  182. A: Because of the high frequency rate (44.1 khz, 16 bit) the AWE32 is playing,
  183.    you will hear every small detail of the samples played. Because the AWE32
  184.    only accepts 16 bit samples, AWEMP must convert the 8 bit samples used in
  185.    MODs to 16 bit samples. The clicks you hear, are probably caused by badly
  186.    set looppoints. In the future I will use sample smoothing, so those clicks
  187.    will be gone.
  188.  
  189. Q: Some samples are playing at a very low volume, is this a bug?
  190.  
  191. A: Previous versions of AWEMP did use the standard linear volume table, which
  192.    contains values from 0 to 127. From version 1.11 of AWEMP, the volume table
  193.    is calculated using a math-formula based on logarithms. The result is that
  194.    the samples will now play at the right volume.
  195.  
  196. Q: My system sometimes hangs when shelling to DOS. Am I doing something wrong?
  197.  
  198. A: You're doing nothing wrong. :( This is a known problem, it has something
  199.    to do with the timer. The timer interrupts the system at a specified
  200.    frequency. When you shell to DOS and the timer interrupts the system at
  201.    the same time, the system crashes, while the music keeps playing (or not).
  202.    This error seems not to occur when using NDOS or 4DOS as the commandline
  203.    interpreter (instead of COMMAND.COM).
  204.  
  205. Q: When will AWEMP support S3Ms or XMs?
  206.  
  207. A: I'm not sure about XM, but S3M will be supported as soon as I have
  208.    implemented all the effects used in MODs. At the moment I'm busy figuring
  209.    out the MTM module format.
  210.  
  211.  
  212. About the author.
  213. -----------------
  214.  
  215. I am 17 years old and I attend the sixth class of a secondary school. I live
  216. in the Netherlands, better known as Holland.
  217.  
  218. This program is my first real try to make a modplayer. I know it isn't perfect
  219. yet, but it already sounds very nice. The future of this program depends on
  220. how much reply I get and the difficulties I will encounter when implementing
  221. new effects or improving the player.
  222.  
  223. I would like to thank two persons who have already helped me very much; they
  224. are Gemini (Klaasjan Brand) and Raiden (Gerard Veldman), thanks guys.
  225.  
  226.  
  227. How can I contact the author?
  228. -----------------------------
  229.  
  230. If you experience problems when using AWEMP, or you have found bugs, or you
  231. have some very nice ideas, or you know how to implement new effects, or
  232. something else I should know, write to me:
  233.  
  234. Mail address : Bert Boer
  235.                Schapendrift 30
  236.                8091 GW  Wezep
  237.                The Netherlands
  238.  
  239. Internet     : kjb@dds.nl    (<= This is not my address! I have currently no
  240.                              Internet access, but you can reach me via this
  241.                              address.)
  242.  
  243. Remember, AWEMP is cardware, so if you haven't sent your postcard yet, please
  244. send one now. As soon as I receive your card, your name will be added to the
  245. people-who-encouraged-me list (see the file SUPPORT.ERS).
  246.  
  247.  
  248. Where can I get AWEMP?
  249. ----------------------
  250.  
  251. AWEMP is spread across the world via the SDC, this net covers almost every
  252. country in the world. In case there isn't any board in your country which has
  253. access to SDC, you can always get the latest version of AWEMP on this board:
  254.  
  255.   Sound Distribution Channel (SDC) Dutch HQ
  256.   TH Rijswijk (THR)
  257.   +31(0)70-3401534   (speeds up to 28k8 V34/VFC)
  258.  
  259. The filename of the archive looks like this: AWEMPxyy.RAR or AWEMPxyy.ZIP,
  260. where x is the major and yy the minor version number, e.g. AWEMP131.RAR is
  261. the archive of AWEMP version 1.31.
  262.  
  263.  
  264. A final message to all GUS users.
  265. ---------------------------------
  266.  
  267. Now you can see that the AWE32 is capable of doing the same things as the GUS,
  268. and a lot more, you all should stop those wars against Creative Labs and their
  269. Sound Blasters. I think it's rather childish to say that the GUS is better,
  270. only because *previous* Sound Blasters couldn't do what the GUS can do. Each
  271. company has it's own specialities in making soundcards.
  272. Advanced Gravis was the first to do the mixing of music channels by hardware,
  273. Creative Labs the next. Only because Advanced Gravis was the first, the GUS
  274. has become very popular by the (demo)programmers. Imagine what would have
  275. happened if Creative Labs was the first . . . .
  276.  
  277.  
  278. -  -  -  - - - --------------------*-*-*-*-*-------------------- - - -  -  -  -
  279.  
  280.