QMedia Movie prefs commands |

### 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.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:40:35