home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / mus / soundmachine-1.5.lha / SoundMachine / SoundMachine.DOC < prev    next >
Text File  |  1994-07-08  |  11KB  |  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 lo