NAME
MP4Create - Create a new mp4 file
SYNTAX
#include <mp4.h>
MP4FileHandle MP4Create(
const char* fileName,
u_int32_t verbosity = 0,
u_int32_t createFlags = 0
);
ARGUMENTS
fileName
Specifies the path name of the file to be created.
verbosity
Specifies a bitmask of diagnostic details the library should
print to stdout during its functioning. See MP4SetVerbosity()
for values.
createFlags
Bit mask that allows the user to set 64 bit values for file size
or for time. Values are:
MP4_CREATE_64BIT_DATA create 64 bit data atoms
MP4_CREATE_64BIT_TIME create 64 bit time atoms
RETURN VALUES
Upon successful completion the function returns a handle to the newly
create mp4 file. This is used in subsequent calls to the library to
modify the file. Upon an error, MP4_INVALID_FILE_HANDLE is returned.
DESCRIPTION
MP4Create is the first call that should be used when you want to create
a new, empty mp4 file. It is equivalent to opening a file for writing,
but also involved the creation of the necessary mp4 framework
structures. I.e. a MP4Create() followed by an MP4Close() will result in
a file with a non-zero size.
Caveat: If MP4Create() is called with a file name that already exists
the contents of the existing file will be lost, assuming the system
permissions allow the calling process to truncate the existing file.
SEE ALSO
MP4(3)