The first four forms of the constructor initializes the BMediaFile to read the file specified by ref or by source. Once this has been done, be sure to call InitCheck() to ensure that the file was successfully sniffed. If sniffing was successful, the BMediaFile object can then be used to instantiate the BMediaTrack objects necessary to read the file's data.

The second two forms prepare a BMediaFile object for writing to a media file, which is specified by either ref or destination. The format of the file to be written is specified by fileFormat.

The flags can be a combination of the following values:

Destructor.

Writes a user-defined chunk of data to the file (if doing so is supported by the encoder). The type argument indicates the chunk type, data points to the data to be written, and size indicates the size of the data to write to the file.

Warning

The BMediaFile class doesn't automatically perform any locking to prevent multiple writes to the file from occurring at the same time. If you have multiple threads writing into the same BMediaFile, you must use a locking mechanism (such as a semaphore) to keep writes from overlapping.

AddCopyright() sets the file's copyright notice to the string specified by data. Any existing notice is replaced. The string is copied, so the original belongs to you.

Copyright() returns the media file's copyright notice, or NULL if there isn't one. This string belongs to the BMediaFile, so don't delete or change it.

Warning

The BMediaFile class doesn't automatically perform any locking to prevent multiple writes to the file from occurring at the same time. If you have multiple threads writing into the same BMediaFile, you must use a locking mechanism (such as a semaphore) to keep writes from overlapping.

Once all media data has been written to all tracks, you need to call CloseFile() so the BMediaFile object can tidy up the file and finish the writing tasks. If you forget to call CloseFile(), the resulting file may not be complete.

After you've finished adding new tracks to a file, you need to call CommitHeader() to let the BMediaFile set up the file's header. This helps optimize the file writing process.

Returns the number of tracks in the media file. The return value is undefined if the initialization failed.

Creates a new track in the file and returns a BMediaTrack object referencing it. The track is configured to use the media format specified by mediaFormat, and will be written using the codec described by codecInfo. You can only use BMediaTrack::WriteFrames() to write into the track.

If you use the second form of the constructor, without a codecInfo argument, the track will be written containing raw media data. You can only use BMediaTrack::WriteChunk() to write into the track.

The mediaFormat indicates the format of the buffers you'll be passing along to the write function, and codecInfo specifies the codec you want to use to encode the data into the track.

Note

The mediaFormat can't contain any wildcards; you have to specify the exact format that you're going to be providing. mediaFormat must also be the same structure you passed to get_next_encoder().

When writing new media files, you should create all your tracks at once before writing any media data. Once all the tracks have been created, be sure to call CommitHeader() to write the header to disk. This is necessary since the header size may vary depending on the number of tracks you put in the file, and once you start writing media data into the tracks, it would be difficult (and inefficient) to resize the header.

If an error occurs while creating the new track, NULL is returned.

Fills the specified media_file_format structure with information describing the file format of the file referenced by the BMediaFile object.

Returns a BView containing controls for adjusting the file format's parameters. Returns NULL if there isn't a view available.

Returns the result code from the constructor. You should always call this after instantiating a BMediaFile object, but before using it.

ReleaseTrack() releases the resources used by the specified track. Doing so reduces your application's memory usage. If you want to release every track you're using, you can call ReleaseAllTracks().

Once released, a track can't be used any longer until you use TrackAt() again.

If the BMediaFile wasn't properly initialized, or the index is invalid, NULL is returned.

SetParameterValue() sets the value of the parameter specified by id to the data pointed to by value; this data is size bytes long.

GetParameterValue() returns in value the value of the specified parameter, and the size of the value in bytes in the size argument.

Returns a BMediaTrack object referencing the track at the specified index into the file. The index must be a value between 0 and CountTracks() - 1.

If the BMediaFile wasn't properly initialized, or the index is invalid, NULL is returned.

Note

You must call ReleaseTrack() when you're finished with the track.

Returns a BParameterWeb that can be used for configuring the file format's parameters. Returns NULL if the codec doesn't support user configuration.

Declared in: media/MediaFile.h

These flags control the behavior of the constructor.