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

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


mvGetTrackUserDataListHandle(3dm)	     mvGetTrackUserDataListHandle(3dm)

NAME    [Toc]    [Back]

     mvGetTrackUserDataListHandle, mvGetMovieUserDataListHandle	- get user
     data dmParams of the track/movie

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>

     DMstatus mvGetTrackUserDataListHandle( MVid track,	DMparams ** userData );
     DMstatus mvGetMovieUserDataListHandle( MVid movie,	DMparams ** userData );

DESCRIPTION    [Toc]    [Back]

     These functions return a pointer to the user data dmParams, which you can
     then examine and modify using dmParamsGet*	and dmParamsSet*. You should
     not free this pointer, as it is owned by the movie	library. The params
     set in this fashion will be stored	in the file when it is written,	if the
     file format supports user data. Note that currently, the QuickTime	file
     format is the only	file format that supports user data.


     The names of QuickTime user data atoms are	required to be four characters
     by	the file format, and that Apple	has reserved all lowercase user	data
     type values. (Please see Inside Macintosh:	 QuickTime, published by
     Addisson Wesley.)

     If	the paramName used is a	4 character string, this is what will be
     written in	the QuickTime file, and	it will	be natively accessible via the
     QuickTime API. However, if	you choose to use a paramName that is not four
     characters	long, these will be written in a Silicon Grahics extended user
     data atom,	and will not be	easy to	access on other	platforms (although it
     will be readable, and will	be a fully compatible QuickTime	file).

     For this reason, Silicon Graphics suggests	the use	of four	capital	letter
     character paramNames when interoperability	with other QuickTime platforms
     is	desired.

     If	you have called	mvWrite	after getting a	user data list dmParams, and
     wish to change a user data	entry later, you need to call
     mvGet*UserDataListHandle again, in	order for the next change to be
     written to	the file the next time mvWrite or mvClose is called.

SEE ALSO    [Toc]    [Back]

     dmParamsGetInt(3dm), dmParamsSetInt(3dm), mvGetTitle(3dm),	mvIntro(3dm),
     mvWrite(3dm), Inside Macintosh: QuickTime.

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
afSetVirtualFormatParams IRIX set/get the virtual audio data format in an AFfilehandle for a specified audio track via dmParams
afInitFormatParams IRIX initialize the audio data format in an AFfilesetup for a specified audio track via dmParams
afGetFormatParams IRIX get the audio data format in an AFfilehandle for a specified audio track via dmParams
afSetConversionParams IRIX set/get the parameters associated with format conversion for a specified audio track via dmParams
mvParams IRIX get and set the parameters of a movie or track
mvGetTrackTimeScale IRIX get and set a movie or track timescale.
mvGetMoviePlayVolume IRIX get and set the volume of a movie or track
iflMT IRIX a multi-track movie file
mvInsertFramesAtTime IRIX edit/manipulate a movie track
mvMatrix IRIX Matrix manipulation of movie and track
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service