/**
 * \page BoxAlgorithm_SoundPlayer Sound Player
__________________________________________________________________

Detailed description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Description|
 The Sound Player box can play a sound in WAV or OGG format. It is based on the OpenAL library.
 The box has to be configured to define the stimulations used as "play" and "stop" triggers.
 When the playback is stopped, manually or not, the "stop" stimulation is output.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Description|
__________________________________________________________________

Inputs description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Inputs|
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Inputs|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Input1|
 The stimulations that trigger "play" or "stop".
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Input1|
__________________________________________________________________

Outputs description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Outputs|
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Outputs|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Output1|
 The box outputs the "play" and "stop" triggers when the sound is actually started and stopped (manually or at the end of file). These stimulations are synchronized with the OpenAL engine, which timing may differ slightly with the input triggers. Note that this output is deprecated.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Output1|
__________________________________________________________________

Settings description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Settings|
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Settings|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Setting1|
  The stimulation that triggers the sound play.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Setting1|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Setting2|
 The stimulation that triggers the sound stop.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Setting2|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Setting3|
 The sound file, in OGG or WAV format.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Setting3|

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Setting4|
 This setting indicates if the file has to be played in a loop once started.
 \b note: when enabled the output stimulation is not sent after each loop, but only when a "stop" stimulation is received.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Setting4|
__________________________________________________________________

Examples description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Examples|
The box can be used to design auditory BCI scenarios or to launch audio events for Event-Related Potential (ERP) data recording.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Examples|
__________________________________________________________________

Miscellaneous description
__________________________________________________________________

 * |OVP_DocBegin_BoxAlgorithm_SoundPlayer_Miscellaneous|
 This box is based on OpenAL (through Alut) and uses the libogg and libvorbis libraries.
 
 The box sends the recognized stimulations to the Acquisition Server using TCP Tagging after the corresponding play or stop events have triggered. This is the mechanism to replace the deprecated stimulation output of the box.
 * |OVP_DocEnd_BoxAlgorithm_SoundPlayer_Miscellaneous|
 */
