mvClose(3dm)							  mvClose(3dm)

NAME    [Toc]    [Back]

     mvWrite, mvClose, mvDestroyMovie, - write,	close, and destroy movie
     instances

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/moviefile.h>

     DMstatus mvWrite( MVid movie )

     DMstatus mvClose( MVid movie )

     DMstatus mvDestroyMovie( MVid movie )

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     mvIntro(3dm), mvOpen(3dm),	mvCreate(3dm), mvGetErrno(3dm).


									PPPPaaaaggggeeee 1111