Manipulate the queue of sample files.



Minimum required version: 1.37

=> R0 = reason code
other parameters depend on reason code

<= see individual reason codes



The file queue allows several samples files to be queued and played in a continuous unbroken stream. This allows longer sounds to be played by stringing together sound phrases. eg spoken sentences could be constructed by assembling suitable phrases. It is not intended for playlist style music players and will almost certainly be unsuitable for such as task because of certain restrictions (see below).



For queuing to work play looping needs to be disabled - it is not forced off automatically (thus it is possible to loop a sample several times then proceed to the next sample when the front-end switches off looping).



Early file closure it forcably used if the queue is not empty (ie the file closure configuration bit is ignored). This is so that the next file can be opened and buffered before the current sample file finishes. This is essential for a clean concatenation of samples.



The queueing system presently requires (and probably always will require) that all samples be of the same type (ie # channels, format, frame rate etc) although they can be in different format files. This is because when data from one file ends it simply continues filling the buffer with data from the next file. Changing format when changing files requires the playing engine to be aware of where the switch occurs and it doesn't because it and the file buffer are asynchorous. Because of the intended use of the queue system this should not be a problem. Queuing of entirely independent files for medley-type sequencing is the responsibility of front-end applications.



The queue is flushed if PlayIt_Stop is used since having files queued with no file open is not a defined state.



Reason codes in R0 are:

0 Add a file to the queue v1.37
1 Flush the queue v1.37
2 Return number of queued files v1.48


[ Parent ] [ Manual root ]


Created by SHtoHTML v1.20