1MP4(3)                      MP4 File Format Library                     MP4(3)
2
3
4

NAME

6       MP4Create - Create a new mp4 file
7

SYNTAX

9       #include <mp4.h>
10
11       MP4FileHandle MP4Create(
12            const char* fileName,
13            u_int32_t verbosity = 0,
14            u_int32_t createFlags = 0
15       );
16
17

ARGUMENTS

19       fileName
20              Specifies the path name of the file to be created.
21
22       verbosity
23              Specifies  a  bitmask  of  diagnostic details the library should
24              print to stdout during its  functioning.  See  MP4SetVerbosity()
25              for values.
26
27       createFlags
28              Bit mask that allows the user to set 64 bit values for file size
29              or for time.  Values are:
30                   MP4_CREATE_64BIT_DATA   create 64 bit data atoms
31                   MP4_CREATE_64BIT_TIME   create 64 bit time atoms
32

RETURN VALUES

34       Upon successful completion the function returns a handle to  the  newly
35       create  mp4  file.  This  is used in subsequent calls to the library to
36       modify the file.  Upon an error, MP4_INVALID_FILE_HANDLE is returned.
37

DESCRIPTION

39       MP4Create is the first call that should be used when you want to create
40       a  new, empty mp4 file. It is equivalent to opening a file for writing,
41       but also involved the creation of the necessary  mp4  framework  struc‐
42       tures.  I.e.  a  MP4Create() followed by an MP4Close() will result in a
43       file with a non-zero size.
44
45       Caveat: If MP4Create() is called with a file name that  already  exists
46       the  contents  of  the  existing file will be lost, assuming the system
47       permissions allow the calling process to truncate the existing file.
48

SEE ALSO

50       MP4(3)
51
52
53
54Cisco Systems Inc.                Version 1.0                           MP4(3)