play-streaming-audio-clip ( audio-engine source generator buffer-count -- audio-clip/f )
Audio playback engine

Prev:	<streaming-audio-clip> ( audio-engine source generator buffer-count -- audio-clip/f )
Next:	Audio source protocol

Vocabulary
audio.engine

Inputs

audio-engine	an audio-engine
source	an object implementing the Audio source protocol
generator	an object implementing the Audio generator protocol
buffer-count	an integer

Outputs

audio-clip/f

an audio-clip or f

Word description
Constructs and immediately starts playing a streaming-audio-clip tied to source and playing audio generated by generator. buffer-count buffers will be allocated for the clip. The clip will automatically be disposed by the audio-engine when the generator stops supplying data and all the buffered data has played. The clip will in turn dispose its generator when it is disposed. If the engine has no available voices, no clip will be constructed, the generator will be disposed, 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-streaming-audio-clip
    ( audio-engine source generator buffer-count -- audio-clip/f )
    <streaming-audio-clip> dup [ play-clip ] when* ;