mvCreate(3dm)                                                    mvCreate(3dm)


NAME
     mvCreateFile, mvCreateFD, mvCreateMem - create new movie instances


SYNOPSIS
     #include <dmedia/moviefile.h>

     DMstatus mvCreateFile( const char* fileName, const DMparams* params,
                    DMparams* paramsUsedOrNULL, MVid* returnMovie )

     DMstatus mvCreateFD( int fd, const DMparams* params, DMparams*
                             paramsUsedOrNULL, MVid* returnMovie )

     DMstatus mvCreateMem( void* pointer, size_t size, const DMparams* params,
                    DMparams* paramsUsedOrNULL, MVid* returnMovie )

DESCRIPTION
     These are the functions that are used to create new movie instances.  A
     movie instance is a handle that allows you to read, write, edit, and play
     a movie file.  It contains information about the different tracks (audio
     and image) in a movie.

     mvCreateFile, mvCreateFD, and mvCreateMem all create a new empty movie,
     initialized with the parameters params (see mvSetMovieDefaults(3dm)).
     The actual parameters set for the movie are returned in paramsUsedOrNULL
     (see mvParams(3dm)).  Any movie that was already present in the file or
     memory location will be destroyed.  The identifier for the new movie is
     returned in returnMovie.  If everything goes well, DM_SUCCESS is
     returned; if not, DM_FAILURE is returned.


EXAMPLE
          #include <dmedia/moviefile.h>

          void CreateMovie()
          {
              DMparams* params;
              MVid      movie;

              if ( dmParamsCreate( &params ) != DM_SUCCESS ) {
               /* handle error */
              }

              if ( mvSetMovieDefaults( params, MV_FORMAT_SGI_3 )
                   != DM_SUCCESS ) {
                  /* handle error */
              }

              if ( mvCreateFile( "new-movie", params, NULL, &movie )
                   != DM_SUCCESS ) {
                  /* handle error */
              }


              /* Add tracks, insert frames, etc. */

              mvClose( movie );
          }


SEE ALSO
     mvIntro(3dm), mvOpen(3dm), mvClose(3dm), mvSetMovieDefaults(3dm),
     mvGetErrno(3dm).


                                                                        Page 2