play-static-audio-clip ( audio-engine source audio loop? -- audio-clip/f )

play-static-audio-clip ( audio-engine source audio loop? -- audio-clip/f )
Audio playback engine

Prev:	<static-audio-clip> ( audio-engine source audio loop? -- audio-clip/f )
Next:	Audio generator protocol

Vocabulary
audio.engine

Inputs

audio-engine	an audio-engine
source	an object implementing the Audio source protocol
audio	an audio
loop?	a boolean

Outputs

audio-clip/f

an audio-clip or f

Word description
Constructs and immediately starts playing a static-audio-clip tied to source and playing audio generated by generator. If loop? is true, the clip will repeat indefinitely until stopped with stop-clip. Otherwise, the clip will automatically be dispose d by the audio-engine when it finishes playing. If the engine has no available voices, no clip will be constructed, and f will be returned.

Notes
Use play-clips with <static-audio-clip> and <streaming-audio-clip> to synchronize the playing of multiple clips.

Definition

USING: kernel ;

IN: audio.engine

: play-static-audio-clip
( audio-engine source audio loop? -- audio-clip/f )
<static-audio-clip> dup [ play-clip ] when* ;