home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / jËzyki_programowania / logo / powerlogo / sound / sound.doc < prev    next >
Text File  |  1992-11-14  |  5KB  |  129 lines
  1.  
  2.                            ***  Sound.DOC  ***
  3.  
  4.     "Sound" is copyright © 1988 by:
  5.  
  6.                            Richard Lee Stockton
  7.                             21305 60th Ave W.
  8.                        Mountlake Terrace, WA 98043
  9.                        Voice phone: (206) 776-1253
  10.  
  11. but may be freely distributed as long as no profit is made from its
  12. distribution or sale without my written permission.  I call this concept
  13. "FreeWare", you can call it whatcha want.
  14.  
  15.     I also include the source code, (Manx 3.4/3.6), in the hope that it will
  16. be of benefit to someone in the Amiga programming community.  Feel free to
  17. alter it at will (but at your own risk!).  I _would_ appreciate receiving a
  18. copy of whatever it may become, and it is always nice to be credited,
  19.  perhaps just a few lines of glowing tribute. ;^)
  20.  
  21.               Long Live Leo and All the Little Schwabie's!
  22.  
  23.  
  24.                           ***  DESCRIPTION  ***
  25.  
  26.     Sound will attempt to feed <SOUNDfilename>'s data to the audio device.
  27. It will "sound" files containing ANY kind of data (try "Sound Sound" :-) and
  28. of ANY length.  If you have expansion memory, "Sound" will store data in
  29. FAST RAM, and use only 4-5K of CHIP RAM to actually sound the data.  This is
  30. the magic of "double-buffering".
  31.  
  32.    If the STEREO flag is turned ON, the data will be split and played in
  33. stereo.  Otherwise, identical data is sent to left and right channels. 
  34. Perfect Sound (tm) samples in stereo will automatically sound in stereo. 
  35. These are the only stereo samples I've seen, so I don't know if the code
  36. used is universal (in IFF) for STEREO.
  37.  
  38.     If called from WorkBench by double-clicking on a project icon, Sound
  39. will search the "ToolTypes" entries in the project icon for "STEREO",
  40. "CHANNEL", "CYCLES", and "SAMPLES_PER_SECOND".  If found, these values will
  41. override any IFF values read from the SOUNDfile.
  42.      WorkBench "extended selection" is supported.  Hold down the [SHIFT] key
  43. and select (click) a group of sound-file icons.  Double-click the last one
  44. to hear them "sound"ed in order.
  45.  
  46.     If called from CLI, over-riding values for STEREO, CHANNEL, CYCLES,
  47. and/or SAMPLES_PER_SECOND may be specified in the command line (See below).
  48.  
  49.     If no settings for STEREO, CYCLES, CHANNEL, and/or SAMPLES_PER_SECOND
  50. are found, in the file itself or in the calling arguments, STEREO defaults
  51. to OFF, CYCLES to 1, left and right both on, and SAMPLES_PER_SECOND to 10000.
  52.  
  53.  
  54.                             ***   ABORT!   ***
  55.  
  56.    !!!  Sound may be aborted by typing CTRL-C from the keyboard.  !!!
  57.  
  58.   If CTRL-C  does NOT abort the sound, click on the Sound "Status"
  59.       line, (the top line), then CTRL-C again.
  60.  
  61.  
  62.                              ***  USAGE  ***
  63.  
  64. NOTE!!!  "Sound" should be in your "C:" directory (ie, "copy Sound C:"),
  65.          before the following USAGEs will work!
  66.  
  67.         USAGE: (from CLI)
  68.  
  69. Sound <filename> [CHANNEL] [STEREO] [CYCLES] [SAMPLES_PER_SECOND] [QUIET]
  70.  
  71.     The filename MUST be the first argument, then the other arguments may be
  72. in any order or missing (see below for valid values).  "Sound" alone will
  73. display a USAGE message.  Sound will "sound" the file, then display the
  74. SAMPLES_PER_SECOND (if the file was found) and STEREO if the sample was
  75. played in stereo.
  76.  
  77.     There is one additional command when called from CLI (or a scriptfile)
  78. QUIET or just "Q" will disable the StatusLine that usually appears on the
  79. top line.
  80.  
  81. (SAMPLES_PER_SECOND=10000 probably means it wasn't an IFF sound file.)
  82.  
  83.     Although maximum CYCLES = 65535, from CLI the maximum is 55.
  84.  
  85.  
  86.         USAGE: (from WorkBench)
  87.  
  88.    Double-click on project icon whose Default Tool is set to "C:Sound".
  89.    Extended selection is supported.  See above.
  90.  
  91.      ToolTypes:   STEREO=      CYCLES=      SAMPLES_PER_SECOND=
  92.                   CHANNEL=     SOURCE=      AUTHOR=
  93.  
  94.    Valid Values:  (these values stored in the .info file)
  95.  
  96.        STEREO                ON -   OFF   default=off.  Not case sensitive.
  97.                                            File is split left/right.
  98.        CYCLES                 0 - 65535   0 = sound loops until aborted.
  99.                                            Use Abort Button to stop.
  100.        SAMPLES_PER_SECOND  1000 - 65535   greater than 30000 seems to have
  101.                                            no effect, but MAX = 64k.
  102.        CHANNEL            RIGHT or LEFT   (r or l) Useful for effects.
  103.        SOURCE                 any text    Where did this sound come from?
  104.        AUTHOR                 any text    Immortality, if ya want it...
  105.  
  106.  
  107.                       ***  ARGUMENT PRIORITIES  ***
  108.  
  109.    Arguments from CLI or in the WorkBench Icon override any IFF info.
  110.  
  111.               IFF file info overrides the default values.
  112.  
  113.     Defaults: STEREO = off, CYCLES = 1, both CHANNELS,
  114.                    SAMPLES_PER_SECOND = 10000
  115.  
  116.  
  117.                           ***  OTHER STUFF  ***
  118.  
  119.      Included in this arc file are a sample project icon and its related
  120. data file (Gunshot.info and Gunshot) as well as Sound, Sound.c and this
  121. file.  The source code was compiled using Manx Aztec 3.6.
  122.  
  123.      Feel free to design your own icons, any project icon should work.
  124. Just make the Default Tool in the icon "C:Sound" and make sure that Sound is
  125. in your C: directory.
  126.  
  127. Updated 12-2-88                           Stay Warm & Enjoy!  - Richard
  128.  
  129.