QM_SetPreferredVolume

QM_SetPreferredVolume(movieRef; prefVolume):error
	movieRef	Longint	Movie reference
	prefVolume	Longint	Preferred sound volume
	error	Longint	Error result

Sets the preferred sound volume 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 prefVolume specifies the movie's preferred sound volume. It must be in the range of -255 ... 255. A value of 0 means no sound at all. Negative values also mute the movie, but they preserve the absolute sound volume value.

Example

`Set the preferred volume of movie $movieRef to 255

$error:=QM_SetPreferredVolume ($movieRef;255)

Related commands

QM_GetPreferredVolume

Returns the movie's preferred sound volume.