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