mvGetMoviePlayVolume(3dm)mvGetMoviePlayVolume(3dm)NAME
mvGetMoviePlayVolume, mvGetTrackPlayVolume, mvSetMoviePlayVolume,
mvSetTrackPlayVolume - get and set the volume of a movie or track
SYNOPSIS
#include <dmedia/moviefile.h>
float mvGetMoviePlayVolume( MVid movie )
float mvGetTrackPlayVolume( MVid track )
DMstatus mvSetMoviePlayVolume( MVid movie, float volume )
DMstatus mvSetTrackPlayVolume( MVid track, float volume )
DESCRIPTION
These functions are used to get and set the volume of a movie or track.
mvSetMoviePlayVolume takes a movie id and a float volume between 0 and
1.0. The Movie Playback Library's engine will scale the volume of all
the audio tracks in the movie by volume during playback.
mvGetMoviePlayVolume returns the current volume of movie. If no volume
is set with mvSetMoviePlayVolume the default volume of 1.0 is returned.
mvSetTrackPlayVolume takes a track id and a float volume between 0 and
1.0. This function can be used to control the volume of an individual
audio track. mvSetTrackPlayVolume is useful to control the relative
volumes of the tracks in movies that have more than one audio track.
mvGetTrackPlayVolume returns the current play volume of track. If no
volume has been set with mvSetTrackPlayVolume the default volume of 1.0
is returned.
Both mvSetMoviePlayVolume and mvSetTrackPlayVolume return DM_SUCCESS if
they are successful and DM_FAILURE otherwise.
If the movie instance is a QuickTime movie then the movie and track
volume values are saved into the QuickTime file when the movie instance
is written with mvWrite(3dm) or closed with mvClose(3dm).
SEE ALSOmvIntro(3dm), mvClose(3dm), mvGetFileFormat(3dm), mvGetAudioWidth(3dm),
mvGetErrno(3dm).
Page 1
