
This is version 3.0 of rplay.

rplay provides the ability to play sounds on both local and remote machines.
rplay also provides a library to make adding sound to any application
very simple.  Originally rplay was developed to add sound to xtank, however,
rplay has been used to add sound to many programs which include xpilots1.2
and olvwm3.3.  Included with this distribution is a contrib directory which
has some rplay applications.

Remember if you are looking for sound files we have over a gigabyte of them
available via anonymous ftp from sounds.sdsu.edu.

Have fun and let me know of any problems/suggestions/comments.

Mark Boyns
boyns@sdsu.edu

--------------------------------------------------------------------------------

rplay3.0 major improvements and changes from rplay2.0:

o rplayd is no longer based on Sun's lwp library.  This will make rplay
  portable to machines other than SPARCstations.  Hopefully soon rplay will
  work with BSDI, Linux, and maybe 386bsd.  Only 8 bit ulaw audio files are 
  currently supported.

o The rplay library has been rewritten and is now much more flexible for rplay
  additions.  This new library is not compatible with the rplay2.0 library,
  what I mean is that old rplay programs will not compile.
  See WARNING and README.LIBRPLAY for conversion help.  

o A more flexible rplay protocol is used.  The rplay2.0 protocol can still 
  be supported.  See conf.h.

o Host authentication can be used to allow only certain machines access to
  play sounds.  See conf.h and INSTALL.

o Compile time option to use mmap or malloc and read to load sound files.
  See conf.h.

o inetd support can be disabled with a command line option

o rplayd timeouts can be changed or disabled with command line options

o rplayd has many other options, run rplay -h to see them.

o rplayd speed enhancements

--------------------------------------------------------------------------------

rplay2.0 major improvements and changes from rplay1.2:

o Sounds are no longer indexed by id, the sound names are now used.

o Sounds can be played, paused, continued, and stopped.

o Each sound can have a volume associated with it.  A volume is
  a number between 0 and 255 and it is relative to the actual volume
  of the audio device.

o Sequences of sounds are supported.  This is useful for playing
  sentences or sounds that need to be played sequentially.

o mmap is now used to read sounds.  This increases performance
  and saves a lot of memory.  Thanks to stripes@pix.com for this
  suggestion.

o Broadcasting sounds.  To use this just use a broadcast address
  instead of a hostname.  For example, I use:
  rplay 130.191.255.255 burp.au
  to play burp.au on all our machines running rplayd on our subnet.

o The Sun audio stuff is no longer used.  Thanks to libst.c and 
  libst.h from Sound Tools.  See these files for more information.

