mvClose(3dm)mvClose(3dm)NAME
mvWrite, mvClose, mvDestroyMovie, - write, close, and destroy movie
instances
SYNOPSIS
#include <dmedia/moviefile.h>
DMstatus mvWrite( MVid movie )
DMstatus mvClose( MVid movie )
DMstatus mvDestroyMovie( MVid movie )
DESCRIPTION
These are the functions that are used to write, close, and destroy movie
instances.
mvWrite flushes all changes that have been made to a movie and makes sure
that they are written to the file. DM_SUCCESS or DM_FAILURE is returned.
Note that not all file formats support all editing features. For example,
track gaps (also known as "Empty Edits") are currently only supported in
QuickTime files. mvWrite will return failure upon attempting to write a
file with an unsupported format-specific feature.
mvClose flushes all changes that have been made to the movie and makes
sure that they are written to the file, and destroys the movie instance
in memory. DM_SUCCESS or DM_FAILURE is returned.
mvDestroyMovie destroys the movie instance in memory, without writing a
file header to disk, thus restoring the file to the state that it was in
the last time it was written to disk (or opened, if the file has not been
written to disk). DM_SUCCESS or DM_FAILURE is returned.
If the movie is currently bound to a window, mvClose(3dm) and
mvDestroyMovie(3dm) will unbind the movie first. If the movie is bound
to ports at the time of the close or destroy, the ports will not be
closed.
SEE ALSOmvIntro(3dm), mvOpen(3dm), mvCreate(3dm), mvGetErrno(3dm).
Page 1
