mvMovieRect(3dm)					      mvMovieRect(3dm)

NAME    [Toc]    [Back]

     mvMovieRect:  mvSetMovieRect, mvGetMovieRect, mvGetMovieBoundsRect,
     mvGetMovieBoundingRect - Set/get movie rectangle

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>

     DMstatus mvSetMovieRect( MVid movie, MVrect rect );

     DMstatus mvGetMovieRect( MVid movie, MVrect *rect );

     DMstatus mvGetMovieBoundsRect( MVid movie,	MVrect *rect, DMboolean	enabledTracksOnly );

     DMstatus mvGetMovieBoundingRect( MVid movie, MVrect *rect );

DESCRIPTION    [Toc]    [Back]

     An	MVrect is defined as:


     typedef struct
     {
	 int	    left, bottom;
	 int	    right, top;
     } MVrect;


     The movie rectangle governs how the movie is to be	rendered to the
     screen when mvRenderMovieToOpenGL is called.  The values of the movie
     rectangle are expressed in	screen coordinates.  The movie library uses
     this to set the viewport for the rendering	context.  The image of the
     movie library is resized to fit into the movie rect.

     The bounding rectangle is the rectangle in	the movie coordinate space
     that encloses all the visual tracks.  This	rectangle is calculated
     from the movie matrices, track matrices and track display width and
     height.

     mvSetMovieRect sets the rectangle of movie	to rect.

     mvGetMovieRect returns the	rectangle of the movie in the
     structure pointed to by rect.  The	user is	responsible for	the
     allocation	of the rect struct before passing it into the movie
     library, and the deallocation of it afterwards.

     mvGetMovieBoundsRect returns the bounding rectangle of the	movie
     in	rect. enabledTracksOnly	is a flag that tells the movie
     library whether you want the bounding rectangle of	only the enabled
     tracks (enabledTracksOnly=DM_TRUE)	or all tracks
     (DM_FALSE). mvGetMovieBoundsRect with



									Page 1






mvMovieRect(3dm)					      mvMovieRect(3dm)



     enabledTracksOnly=DM_FALSE	is functionally	equivalent to
     mvGetMovieBoundingRect.

     mvGetMovieBoundingRect returns the	bounding rectangle of the
     movie in rect.  It	uses ALL tracks	(enabled and disabled).	If
     The user is responsible for the allocation	of the rect struct
     before passing it into the	movie library, and the deallocation of it
     afterwards.

SEE ALSO    [Toc]    [Back]

     mvRenderToOpenGL(3dm), mvSetTrackEnable(3dm), mvMatrix(3dm).


									PPPPaaaaggggeeee 2222