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 ALSO
     mvIntro(3dm), mvOpen(3dm), mvCreate(3dm), mvGetErrno(3dm).


                                                                        Page 1