
This is version 3.0 PL2 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 Xpilot
and olvwm.  Included with this distribution is a contrib directory which
has some rplay applications.  See the INSTALL file for rplay installation
instructions.

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

I would thank Andrew Scherpbier (turtle@sciences.sdsu.edu) and John Denune 
(jdenune@sciences.sdsu.edu) for their suggestions and help.  I would also
like to thank them for their patience, our office gets really noisy sometimes!

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

Mark Boyns
boyns@sdsu.edu

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

rplay3.0 PL2 major improvements and changes from rplay3.0 PL1:

o Use strchr and strrchr instead of index and rindex.

o Added -r (random pick) option to the rplay client.

o Added RPLAY_RANDOM_SOUND attribute which will pick a sound randomly from
  a sound list.  See README.LIBRPLAY for an example.

o Added jukebox to the contrib directory.  See contrib/jukebox1.1/README for more
  details.  (Thanks quinet@montefiore.ulg.ac.be)

o Changed rplayd to handle filenames with spaces correctly.

o Fixed librplay.c and rplayd.c prototypes to support non ANSI C compilers.
  (Thanks infmx!cheetah!dranney@uunet.UU.NET)

o Added the following to the rplay library to make playing sounds even easier:
  (See README.LIBRPLAY for more information)

  int rplay_open_display(void);
  int rplay_display(char *sound);
  int rplay_local(char *sound);
  int rplay_host(char *host, char *sound);
  int rplay_sound(int rplay_fd, char *sound);

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

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

o Changed conf.h to '#undef AUTH' (host authentication).

o Changed rplay_set to strdup() sound filenames.

o Added -n (count), -N (list count), and -P (priority) options to the rplay
  client.

o Added RPLAY_PRIORITY attribute.  Priorities range from 0 to 255 (0 being
  the lowest priority).  Sounds with higher priorities will replace lower
  priority sounds when the sound spool is full.

o Sounds can be referenced using complete pathnames.  This helps to avoid
  problems when different sound files have the same name.

o Sound filename extensions are now optional.  If extensions are used they
  are enforced.

o Added RPLAY_LIST_COUNT attribute.  The sound list will be played count
  number of times.

o Added RPLAY_COUNT attribute.  Each sound in a sound list will be played
  count number of times.

o Fixed select's usage of timeval struct (sinster@scintilla.capitola.ca.us)

o Cleaned up the code a little.  Added better ANSI C support and put in
  a little more documentation.

o Fixed some spelling mistakes.

o Removed -V option from the rplay client.

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

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.

