SoundEnv - dec 97 - by Sébastien METROT
Rev. 2.0 - Oct. '98 - by Marc BARILLEY
Rev. 2.1 - Jan. '99 - by Patrice FAVRE
--------


IMPORTANT NOTE :
----------------
  The following actions : !stopmidi! !startmidi! !stopall! !disable! !enable!
  are provided only for backward compatibility and SHOULD NOT be used by new modules nor should they be combined with actions described below.



Overview
--------
This module is a Sound Environment module. You may choose sound files to play on the client.


Actions
-------
  + Initiating the module
      - start : this so much classical 'start' action.

  + Setting up the playing mode
      - once : plays a file only once, ie you have to explicitly fire each 'sound action' to play it (default)
      - loopOnAll : plays all the files one after the other
      - loop : loops on the last played sound
      - random : plays all the files at random
      - enable : turns the module on (default)
      - disable : turns off the module but does not destroy it
    Each of these action won't take effect until the current playing sound has stopped.

  + Playing sounds
      - playSound : restart the sound file previously played
      - stopSound : stops the sound
      Plus one more action per sound file. Each of them, when fired, plays the matching sound


Events
------
  - in : the module has started on the client
  - destroyed : the module has been destroyed on the client.
  - stopped : the sound is stopped (either after end of sound file or stopSound action).
	The sound name is given as parameter.
  Plus one more event per sound file. Each of them is fired after normal end of sound file.