mvMovieRect(3dm)                                              mvMovieRect(3dm)


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


SYNOPSIS
     #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
     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


     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
     mvRenderToOpenGL(3dm), mvSetTrackEnable(3dm), mvMatrix(3dm).


                                                                        Page 2