mp4(3)
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.