QM_SetPreferredRate

QM_SetPreferredRate(movieRef; prefRate):error
	movieRef	Longint	Movie reference
	prefRate	Real	Preferred playback rate
	error	Longint	Error result

Sets the preferred playback rate of a movie.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile or QM_NewMovieFromURL.

Parameter prefRate specifies the movie's preferred playback rate. It is a real number in the -5.0 ... +5.0 range. Positive rates mean forward playback and negative rates mean reverse playback.

The default preferred playback rate of a movie is set to 1.0 when the movie is created.

Example

`Set the preferred playback rate of movie $movieRef to 1

$error:=QM_SetPreferredRate ($movieRef;1)

Related commands

QM_GetPreferredRate

Returns the movie's preferred playback rate.