Minimum required version: 1.37
=> | R0 = reason code |
other parameters depend on reason code |
<= | see individual reason codes |
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 ]