Move the play position to a new frame.

=> | R0 = | frame number to jump to

<= | R0 = | actual frame number jumped to

The play pointer is moved to the given frame. Frame 0 is the first frame which physically lies at the beginning point defined in PlayIt_Open not the one defined in PlayIt_BeginEnd . If R0 is outside the range defined by PlayIt_BeginEnd it is set to the start defined in that SWI. For block samples like ADPCM the frame is rounded down to the start of the nearest block (the returned R0 reflects this).

Presently if the file is currently playing (as opposed to being paused) PlayIt_SetPtr will momentarily pause playback while it resets the pointer to force the buffer to resync to the new position immediately.

An error is generated if no file is open.

[ Parent ] [ Manual root ]