=> | R0 | pointer to file name |
R1 | sample format | |
R2 | frame rate | |
R3,R4 | range of sample data | |
R5 | auxiliary parameter (only used by ADPCM formats) |
R0 | pointer to file name | |
R1 | auto-detect mode (0=normal) | |
R3 | file offset to look for header (if R1=1) |
<= | For non auto-detect; R1-R5 preserved. |
For auto-detect ok; R1-R5 are updated to reflect the detected format. | |
For auto-detect error; R0=error, R1=partial format (see below) | |
If no error occurs R0 points to PlayIt's internal copy of the filename |
Note that prior to 1.36 auto-detect required that the format word was zero whereas now only the number of channels (bits 8-11) need be zero. This is so that bits 0-7 of the format word can be used as an auto-detect parameter:
0 | normal auto-detect (as in previous versions) |
1 | format header is at the offset contained in R3 |
If an error occurs trying to open the file (either a filing error or type-detection error) then any previously open sample is preserved.
From v1.59, if an error is returned when using auto-detect
then the format word (R1) will give partial information. If the file is not recognised at all then R1 will be zero otherwise the xx field (bits 24-31) will indicate the format. Other fields may be filled in too (eg yy, channels) depending on how far it got before encountering a problem.
Once the file has been opened PlayIt is effectively in pause mode at the first frame in the file. Playback can be started with PlayIt_Play
or calls like PlayIt_BeginEnd
, PlayIt_PauseAt
, PlayIt_SetPtr
can be used to set up things before playing.
[ Parent ] [ Manual root ]