mvGetMoviePlayVolume(3dm)			     mvGetMoviePlayVolume(3dm)

NAME    [Toc]    [Back]

     mvGetMoviePlayVolume, mvGetTrackPlayVolume, mvSetMoviePlayVolume,
     mvSetTrackPlayVolume - get	and set	the volume of a	movie or track

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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
SEE ALSO    [Toc]    [Back]

     mvIntro(3dm), mvClose(3dm), mvGetFileFormat(3dm), mvGetAudioWidth(3dm),
     mvGetErrno(3dm).


									PPPPaaaaggggeeee 1111
 [ Back ]