Define a point at which to automatically pause.

=> | R0 = | frame at which to pause (-1 to disable, 0 to read)

<= | R0 = | frame actually marked as pause point

This SWI is to allow playback up to a defined point then enter pause mode. This is not the same as the end point defined in PlayIt_BeginEnd which executes a stop (hence closing the file) when the end is reached. As PlayIt remains in pause mode, the sample can be restarted without reopening it and all the information relating to the sample (eg frame position) remains defined. Note that the play pointer and/or pause point will need to be moved before playback can be restarted otherwise nothing will happen.

If the pause point is at the same place as the stop point (see PlayIt_BeginEnd ) then the pause has priority. Setting the pause point at the end point allows playback of the entire file without closing it at the end.

[ Parent ] [ Manual root ]