1MP4(3) MP4 File Format Library MP4(3)
2
3
4
6 MP4Create - Create a new mp4 file
7
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
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
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
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
50 MP4(3)
51
52
53
54Cisco Systems Inc. Version 1.0 MP4(3)