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 ALSOmvIntro(3dm), mvPlay(3dm), mvPort(3dm), vlIntro(3dm).
Page 1
