====== tsp_spoolsoundfile ======

Plays an AIFF sound file from a thread using the advanced sound player.

==== Synopsis ====

''%%tsp_spoolsoundfile <sound file> [<num repeats>]%%''

==== Description ====

Plays an AIFF sound file using a thread to manage playback.

This is a variation on the original SpoolSoundfile program that used the original sound file player-see ''%%CreateSoundFilePlayer()%%''. This version uses the Advanced Sound Player (see ''%%spCreatePlayer())%%'', which supports looping sound file playback.

==== Arguments ====

  * **sound file** Name of an AIFF file to play.

  * **num repeats** Optional number of times to repeat the sound file. Defaults to 1.

==== Caveats ====

Calls ''%%ScanSample()%%'' to get information used to pick a sample player which prevents playing AIFF files with sustain or release loops (see ''%%ScanSample()%%'' Caveats).

==== Associated Files ====

tsp_spoolsoundfile.c

==== Location ====

examples/Audio/Advanced_Sound_Player

==== See Also ====

''%%spCreatePlayer,  spoolsoundfile,  tsp_algorithmic,  tsp_rooms%%''