Set the playback limits on the sample file.

=> | R0 = | frame offset to start from (-ve to read)
| R1 = | frame offset to end at+1

<= | R0 = | start start actually used
| R1 = | end frame+1 actually used

If R0 is negative no action is performed (R1 is ignored) and the current frame bounds are returned. Otherwise:

R1 is the frame after the last one to play so that R1 = R0 + #frames to play). If R1<=R0 it will play to the end of the file.

An error is generated if there is no file open. R0 and R1 are bound to the limits defined in PlayIt_Open and for blocked formats like ADPCM the frames will be rounded down to the start of the nearest block. The returned values of R0 and R1 reflect any such rounding.
If the current play position is outside the new range then it is set to the new start (R0).

When the play pointer reached the end point defined by R1 sound stops and file is closed.

[ Parent ] [ Manual root ]