*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> movie/mvGetTrackTimeScale (3d)              


mvGetTrackTimeScale(3dm)			      mvGetTrackTimeScale(3dm)

NAME    [Toc]    [Back]

     mvGetMovieTimeScale, mvSetMovieTimeScale, mvGetTrackTimeScale,
     mvSetTrackTimeScale - get and set a movie or track	timescale.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>

     MVtimescale mvGetTrackTimeScale( MVid track );
     DMstatus mvSetTrackTimeScale( MVid	track, MVtimescale timeScale );

     MVtimescale mvGetMovieTimeScale( MVid movie );
     DMstatus mvSetMovieTimeScale( MVid	track, MVtimescale timeScale );

DESCRIPTION    [Toc]    [Back]

     For information one how to	interpret a time, timeScale pair, please see
     the ``Time	and Timescale''	section	of mvIntro.

     These function in the movie library are provided to allow the user	to get
     or	set the	default	timescale for either a track or	a movie.

     mvGetTrackTimeScale allows	the user to learn what timescale the movie
     library is	using internally to represent track edits. It allows an
     application to know the finest resolution at which	edits can be made to a
     track without losing precision.

     mvSetTrackTimeScale allows	the user to set	a track's time scale, although
     most users	will want not want to use this function	and should use the
     track time	scale selected by the movie library. (If the user does not
     call mvSetTrackTimeScale, the movie library will select a "reasonable"
     track timescale based on the DM_IMAGE_RATE	which was passed in to
     mvAddTrack.) Furthermore, the only	time that mvSetTrackTimeScale should
     be	called is immediately after a track has	been created--before any data
     has been added to the track or the	track has been edited. Changing	a
     track's timescale after the track contains	data will cause	data loss.

     mvGetMovieTimeScale is only needed	by certain classes of applications
     which are very knowledgeable about	specifics of the file format of	the
     files which they are editing.

     mvGetMovieTimeScale provides the application access to a timescale	that
     is	associated with	the entire movie. Due to the design of the
     QuickTime(tm) file	format,	this is	the finest editing resolution that can
     be	saved to disk as a QuickTime file, although for	other file formats it
     may be used for other purposes, or	ignored.

     mvSetMovieTimeScale allows	the user to set	this time scale. It is not
     recommended that users set	this time scale	after a	movie has been edited.

									Page 1

mvGetTrackTimeScale(3dm)			      mvGetTrackTimeScale(3dm)

     If	the user does not set a	movie time scale, the movie library will
     automatically select a ``reasonable'' one.

RETURN VALUES    [Toc]    [Back]

     The set functions return either DM_SUCCESS	or DM_FAILURE.	The get
     functions will return -1 on error (e.g., bad movie	id).

NOTES    [Toc]    [Back]

     QuickTime is a registered trademark of Apple Computer, Inc.

SEE ALSO    [Toc]    [Back]

     mvIntro(3dm), mvGetErrno(3dm).

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
mvParams IRIX get and set the parameters of a movie or track
mvGetMoviePlayVolume IRIX get and set the volume of a movie or track
mvEditByFrame IRIX edit/manipulate a movie track
mvInsertFramesAtTime IRIX edit/manipulate a movie track
mvGetTrackDuration IRIX get and set movie/track offset and duration.
mvMatrix IRIX Matrix manipulation of movie and track
mvDeleteFramesAtTime IRIX edit/manipulate a movie track
iflMT IRIX a multi-track movie file
mvGetBoundary IRIX get timing information about movie or track
mvGetTrackUserDataListHandle IRIX get user data dmParams of the track/movie
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service