home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Printer / add16.dms / in.adf / Free_Software / SoundMachine_v1.5 / SoundMachine.DOC < prev    next >
Encoding:
Text File  |  1994-08-11  |  10.7 KB  |  251 lines
  1. #########################################################################
  2. #                                                                       #
  3. #                          The Sound Machine                            #
  4. #                                                                       #
  5. #                            Version: 1.5                               #
  6. #                                                                       #
  7. # Written by Syd L. Bolton  ©1993-94 Legendary Design Technologies Inc. #
  8. #      25 Frontenac Avenue, Brantford, Ontario N3R 3B7 Canada           #
  9. #          P.O. Box 1147, Lewiston, NY  14092-8147  U.S.A.              #
  10. #                           (519)-753-6120                              #
  11. #                                                                       #
  12. #      Freely Distributable - This Program Remains Copyrighted          #
  13. #                                                                       #
  14. #########################################################################
  15.  
  16.  
  17. WHAT IS THE SOUND MACHINE?
  18. ==========================
  19.  
  20.     The Sound Machine is a set of two programs for your Amiga that will
  21. enable you to load and play sound samples that are commonly found on
  22. IBM-type systems.  It will also enable you to save files in these formats.
  23. This makes it very useful for people who frequent computer bulletin-board
  24. services, as it opens up an entire library of sound files.
  25.  
  26.     There is a simpler version of The Sound Machine called 'SMPLAY'
  27. that should have included in this archive.  It is a CLI-only version of the
  28. program that only plays sound files.  It is useful for your C directory as
  29. it takes up less memory and is good for those who like the keyboard more
  30. than the mouse.
  31.  
  32. The Sound Machine presently reads and writes the following formats:
  33.  
  34.     IFF - the format used on the Amiga, in 8SVX form.
  35.  
  36.     RAW - RAW audio data, which most sound programs will load.
  37.  
  38.     WAV - The "Wave" format, most commonly used in MicroSoft Windows.
  39.  
  40.     VOC - The "Voice" format, from Creative Labs (they make the
  41.                         SoundBlaster for the IBM).
  42.  
  43.  
  44. WHAT ISN'T THE SOUND MACHINE?
  45. =============================
  46.  
  47.     The Sound Machine is NOT A SOUND EDITOR!  Although you can change
  48. the playback rate and "flip" signed samples, it does not actually do any
  49. editing on the sound files.
  50.     The Sound Machine isn't the perfect sound converter, either.  At
  51. present, it does not support writing 16 bit samples (although it will
  52. convert them to 8-bit for playback)
  53.     For what most people will want, however, it does everything.  If
  54. you would like to see more sound formats supported, please write and we'll
  55. see what we can do.
  56.  
  57. PROGRAM REQUIREMENTS
  58. ====================
  59.  
  60.     The Sound Machine will run on any Amiga with 512k and OS 1.2 or
  61. higher.  It has been tested with an Amiga 3000 running AmigaDOS 2.1, and
  62. an Amiga 1000 running 1.3.
  63.     Under 2.x or 3.x, the program will use the ASL File Requester.
  64. Under 1.2 or 1.3, you will need to install the "REQ.LIBRARY" (provided)
  65. into your LIBS directory.  Do this with:
  66.  
  67.     copy req.library libs:
  68.  
  69.     Please note that 'SMPLAY', the companion player-only program does
  70. not require either of these libraries.
  71.  
  72. A TOUR OF THE GADGETS
  73. =====================
  74.  
  75.     When you first run the program you will see several gadgets along
  76. the bottom of the program window (The Sound Machine opens a Window on
  77. your Workbench Screen.  If your screen is interlaced, you may move the
  78. window around).  Most of these gadgets are self-explanitory:
  79.  
  80. OPEN    - Presents the file requester and lets you choose a sample.  Note
  81.       that the program automagically detects the file-format type.
  82.       If it can't identify the file, it reads it as "RAW" and sets the
  83.       playback rate to 10000.  You can change the default rate through
  84.           the tooltypes (see below) and also FORCE RAW loading.
  85.  
  86. SAVE AS - This will save the current sample (if there is one) in the
  87.       format that is highlighted.  When you load a sample, the screen
  88.       will change the show you the type of file that was loaded. You
  89.       are free at anytime to change the file type, and when you save
  90.       the file that is the format you will get.  Note that the program
  91.       will also automagically try to use an appropriate filename (ie:
  92.       if you loaded a file called "sound.iff", and then changed the
  93.       type to "WAV", and select SAVE AS, it will change the filename
  94.       to "sound.wav", though you are always free to call the file what
  95.       you want.
  96.  
  97. RAW, IFF, WAV, VOC: These gadgets reflect the format.  They will change when
  98.             a file is first loaded, and you can then change to the
  99.             format you wish to save in.
  100.  
  101. COMPRESS: This is a toggle gadget that is applicable TO THE IFF FORMAT ONLY.
  102.       Choosing compression with WAV format for example has NO EFFECT.
  103.       Choosing COMPRESSion with the IFF format is a good way to save
  104.       disk space as IFF files will be roughly 1/2 the size of an
  105.       equivalent WAV, VOC, or RAW file.  Not only that, but contrary to
  106.       popular belief, using COMPRESSion will not affect the quality of
  107.       the sound sample since the file is expanded to its original form.
  108.       It is NOT THE SAME as reducing the number of bits of definition
  109.       or anything of the sort.
  110.  
  111. FLIP: You will commonly need to use this gadget if you load RAW files that
  112.       come from another computer system, such as the IBM or the MACINTOSH.
  113.       The way sound samples are stored on these systems is often inverse
  114.       to the way the Amiga does it.  For example, all 8-bit sounds are
  115.       represented with a number from 0-255.  On the PC, a 0 means no sound
  116.       and 255 means full sound.  On the Amiga however, 128 indicates no
  117.       sound.  Therefore, if you ever see a file that has an abnormal amount
  118.       of high peaks, try FLIPping it and playing it again.  We have found
  119.       this to be true of many MACINTOSH samples.
  120.  
  121. RATE: The number in this string gadget represents the playback rate (samples
  122.       per second).  The program will automatically put the playback rate of
  123.       the file in this gadget for you.  In the case of "RAW" files, there
  124.       is no place for storing the rate, so The Sound Machine defaults to
  125.       using 10000.  You are free to change this number to get different
  126.       results.
  127.  
  128. PLAY: This gadget, like its name implies, plays the current sample.  It will
  129.       change in appearance to 'STOP' while the sample is playing. By clicking
  130.       on it in this state, the sample will stop playing.
  131.  
  132.  
  133. MENUS
  134. =====
  135.  
  136.     The Sound Machine also has a project menu, with similar options.
  137. It allows you to OPEN or SAVE a file (with keyboard shortcuts).  You will
  138. also find the ABOUT requester in here, and a QUIT option.
  139.  
  140.     There is also a special menu with the following features:
  141.  
  142.      * FORCE RAW LOADING: Use this option to force a file into RAM as RAW.
  143.        This is useful for files that are corrupt, and also for loading
  144.        multi-dac VOC files (for example, most VOC files that are large
  145.        will require this as they are broken up into segments.  The drawback
  146.        is that you might hear a 'click' every few seconds (the header info)
  147.        but then again you could always save it as IFF and edit it somewhere
  148.        else).  Thanks to Mark Odell for the idea.
  149.  
  150.      * PLAY SAMPLE AFTER LOADING: When this menu function is turned on,
  151.        samples are played automatically after being loaded.  This is handy
  152.        as it will save you time.
  153.  
  154.      * LOW PASS FILTER: Turning off the low pass filter can improve sound
  155.        playback with certain samples.  Notice your power LED may DIM or
  156.        turn off - this is completely normal.
  157.  
  158. ============================================================================
  159.  
  160. TOOLTYPES
  161. =========
  162.  
  163.     Using Workbench, you can modify the default size and position of
  164. the Window that The Sound Machine opens, as well as change some other
  165. options.  Here is what they are:  (these show the defaults)
  166.  
  167.      * WINDOWX=0         - set the upper-left X coordinate of the Window.
  168.      * WINDOWY=0         - set the upper-left Y coordinate of the Window.
  169.      * WINDOWWIDTH=640   - set the width of the Window.
  170.      * WINDOWHEIGHT=200  - set the height of the Window.
  171.      * AUTOPLAY=No       - set to Yes for auto playback after loading
  172.      * FORCERAW=No       - set to Yes for forcing RAW sample loading
  173.      * LOWPASSFILTER=Yes - set to No for improved sound quality
  174.      * DEFAULTRATE=10000 - set to the desired default playback rate for RAW
  175.  
  176. The rest of the program is basically self-explanatory.  You can load
  177. samples and the program will graph them and display information about the
  178. sample (name, size and format).
  179.  
  180. WHAT CAN BE ADDED?
  181. ==================
  182.  
  183.     The following options should/could be added to the program.  In
  184. order to do this, we need to hear from people that are interested in having
  185. these features or have suggestions of their own.  Our address is listed at
  186. the bottom of the file.
  187.  
  188. * Support for AUD and SND files.  Though basically RAW files, it would be
  189.   nice to have full support for these formats for completeness.
  190.  
  191. * Support for 16-bit playback (through some of the new 16-bit boards) and
  192.   also the ability to save in this format.
  193.  
  194. * Batch conversion support
  195.  
  196. * More DSP support, perhaps some special effects ... converting stereo
  197.   samples to mono, etc.
  198.  
  199. * The ability to work with files that are bigger than RAM.
  200.  
  201. ============================================================================
  202.  
  203.     We hope you find this product useful.  As mentioned, if you would
  204. like to see improvements made please write us a letter, send us a fax,
  205. or give us a call.  We won't make improvements without user support!
  206.  
  207.     We are presently contemplating making this a commercial product,
  208. with many more features and a reasonable price.  If you have some suggestions
  209. for a commercial version, or would like to be put on our mailing list, just
  210. drop us a line or give us a call!
  211.  
  212.     If you do find this product useful, you may find our commercial
  213. products equally as useful.  Ask your dealer for a demonstration of
  214. ADDRESS IT!, INVOICE IT!, LINK IT! or dataTAX.  If your dealer doesn't carry
  215. our products, encourage him/her to call us for more information on our
  216. Amiga products.
  217.  
  218.     Have a great day!
  219.  
  220.     Syd Bolton, President
  221.  
  222.  
  223. In Canada/International:
  224. ------------------------
  225. Legendary Design Technologies Inc.
  226. 25 Frontenac Avenue
  227. Brantford, ON  N3R 3B7
  228. CANADA
  229.  
  230. (519) 753-6120 voice/fax
  231.  
  232. In the United States:
  233. ---------------------
  234. Legendary Design Technologies Inc.
  235. P.O. Box 1147
  236. Lewiston, NY  14092-8147
  237. U.S.A.
  238.  
  239. (519) 753-6120 voice/fax
  240.  
  241.  
  242. Call our support BBS, starting August 1, 1994:  (519) 753-5052.
  243.  
  244. All trademarks mentioned in this file are recognized.
  245.  
  246. The REQ.LIBRARY was written by Bruce Dawson and Colin Fox.  For space
  247. considerations, only the main executable has been included.  If you need
  248. to use this library (1.x users) if you can't find the complete REQ.LIBRARY
  249. archive (including documentation) please contact Legendary and we will
  250. provide it free of charge.
  251.