home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / audio / utils / superplay / superplay.doc < prev    next >
Text File  |  1990-12-14  |  3KB  |  73 lines
  1. *******************************************************************************
  2.  
  3.                                   SuperPlay
  4.  
  5.                      Copyright © 1990 by Jonathan Potter
  6.  
  7. *******************************************************************************
  8.  
  9. SuperPlay is a sound player. It will play any file at all, IFF 8SVX or
  10. otherwise. If the file is 8SVX, the speed information in that file is used.
  11. Otherwise, a speed of 10000 cycles/sec is assumed.
  12.  
  13. SuperPlay also allows you to specify a "list file". This file is simply a
  14. list (of indefinite length) of files you wish to play. If this list file is
  15. specified, it is read in, and the first file in the list is played. A command
  16. line flag (-c) causes SuperPlay to play each file in turn, until stopped.
  17. Another flag (-r) causes SuperPlay to pick files at random from the list,
  18. instead of sequentially.
  19.  
  20. SuperPlay runs only from the CLI. The command line flags are :
  21.  
  22.      -v           Set volume (64 default and maximum)
  23.      -s           Set speed (10000 default unless file is 8SVX)
  24.      -f           Name of "list file" to play files from
  25.      -c           Play files continuously
  26.      -r           Play randomly from the list.
  27.  
  28. These flags may be in any order. Some example usages :
  29.  
  30.   SuperPlay sound1                    - play the file "sound1".
  31.   SuperPlay -v50 -s4000 sound3        - play the file "sound3" with volume
  32.                                         50 and speed 4000 cycles/sec.
  33.   SuperPlay -fs:soundlist -r          - play one file at random from
  34.                                         "s:soundlist".
  35.   SuperPlay -fmylist -c -v30          - play files continuously from
  36.                                         "mylist" with volume 30.
  37.   SuperPlay -fdh0:list -r -c          - play random files continuously from
  38.                                         "dh0:list".
  39.  
  40. SuperPlay ? will give you a list of command line flags.
  41.  
  42. The "list file" is simply a list of filenames (including complete pathnames
  43. if necessary) - one on each line. On the line after each filename must be
  44. either a * or the volume and speed for that file. A sample "list file" is :
  45.  
  46. dh0:sounds/sound1
  47. *                                              use default volume and speed
  48. dh0:sounds/sound2
  49. 50 -1                                          use volume 50 and default speed
  50. c:explosion
  51. 64 8000                                        volume 64 and speed 8000
  52. s:moomoocow
  53. -1 10000                                       default volume and speed 10000
  54.  
  55. There is no restriction on the length of each line, or on the length of the
  56. list. -1 for either the volume or the speed will use the default; a * is the
  57. same as -1 -1. The list MUST be in this format, or strange things will happen.
  58.  
  59. To exit SuperPlay before it has finished (or to break out if playing
  60. continuously) click the close gadget on the small window that is opened.
  61.  
  62. This program is freely distributable. If you use this program the author would
  63. appreciate a $5 donation. Send donations, bug reports, suggestions and general
  64. correspondance to :
  65.  
  66.  
  67.                                Jonathan Potter
  68.                                  P.O. Box 289
  69.                               Goodwood, SA 5034
  70.                                   Australia
  71.  
  72.                               Phone (08) 2932788
  73.