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