mvVideoStillFrame(3dm)					mvVideoStillFrame(3dm)

NAME    [Toc]    [Back]

     mvSetVideoStillFrame, mvGetVideoStillFrame	- Set/get movie	video output
     still frame

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>
     #include <dmedia/movieplay.h>

     void mvSetVideoStillFrame(MVid movieId, DMboolean still);

     DMboolean mvGetVideoStillFrame(MVid movieId);

DESCRIPTION    [Toc]    [Back]

     Because of	temporal differences between fields, still frames derived from
     interlaced	video often "shimmer" or "jitter".  An application can counter
     this effect by setting the	movie's	video still frame to DM_TRUE. When the
     video still frame is set to DM_TRUE, the Movie Playback Library will send
     2 copies of either	the first or second field (and zero copies of the
     other field) for a	still frame.  The Movie	Library	chooses	which field is
     sent so as	to minimize jitter.  When the video still frame	is set to
     DM_FALSE, the movie library sends 1 copy of each field for	a still	frame.


     The default value for a movie's still frame is DM_FALSE.

NOTES    [Toc]    [Back]

     The video still frame only	affects	what is	displayed on MV_PORT_VIDEO.
     The still frame does not, in general, affect the optional graphics
     display associated	with MV_PORT_VIDEO.  The graphics window will show
     both fields for still frames.


     For some systems (those that use a	video->graphics	path for the optional
     graphics display) the video still frame does affect the graphics display.
     These systems include Indy	when using Cosmo Compress, Indigo2 when	using
     Impact Compression, and Octane when using Octane Compression.

SEE ALSO    [Toc]    [Back]

     mvIntro(3dm), mvPlay(3dm),	mvPort(3dm), vlIntro(3dm).


									PPPPaaaaggggeeee 1111