mvVideoStillFrame(3dm)                                  mvVideoStillFrame(3dm)


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


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

     void mvSetVideoStillFrame(MVid movieId, DMboolean still);

     DMboolean mvGetVideoStillFrame(MVid movieId);

DESCRIPTION
     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
     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.
     The currently supported systems include Octane when using Octane
     Compression.


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


                                                                        Page 1