Bento4 MP4 SDK: AP4_Processor Class Reference

Bento4 MP4 SDK

previous page next page

AP4_Processor Class Reference

#include <Ap4Processor.h>

Classes
class	ExternalTrackData
class	FragmentHandler
	Abstract class that defines the interface implemented by concrete fragment handlers. More...
class	ProgressListener
	Abstract class that defines the interface implemented by progress listeners. More...
class	TrackHandler
	Abstract class that defines the interface implemented by concrete track handlers. More...
Public Member Functions
virtual	~AP4_Processor ()
	Default destructor.
AP4_Result	Process (AP4_ByteStream &input, AP4_ByteStream &output, ProgressListener *listener=NULL, AP4_AtomFactory &atom_factory=AP4_DefaultAtomFactory::Instance)
	Process the input stream into an output stream.
virtual AP4_Result	Initialize (AP4_AtomParent &top_level, AP4_ByteStream &stream, ProgressListener *listener=NULL)
	This method can be overridden by concrete subclasses.
virtual AP4_Result	Finalize (AP4_AtomParent &top_level, ProgressListener *listener=NULL)
	This method can be overridden by concrete subclasses.
virtual TrackHandler *	CreateTrackHandler (AP4_TrakAtom *)
	This method can be overridden by concrete subclasses.
virtual FragmentHandler *	CreateFragmentHandler (AP4_ContainerAtom *)
	This method can be overridden by concrete subclasses.
Protected Member Functions
AP4_Result	ProcessFragments (AP4_MoovAtom moov, AP4_List< AP4_MoofLocator > &moofs, AP4_ContainerAtom mfra, AP4_ByteStream &input, AP4_ByteStream &output)
Protected Attributes
AP4_List< ExternalTrackData >	m_ExternalTrackData

Detailed Description

Definition at line 53 of file Ap4Processor.h.

Constructor & Destructor Documentation

virtual AP4_Processor::~AP4_Processor ( ) [inline, virtual]

Default destructor.

Definition at line 158 of file Ap4Processor.h.

References AP4_List< T >::DeleteReferences(), and m_ExternalTrackData.

Member Function Documentation

virtual FragmentHandler* AP4_Processor::CreateFragmentHandler ( AP4_ContainerAtom * ) [inline, virtual]

This method can be overridden by concrete subclasses.

It is called once for each fragment in the input file.

Parameters:

track

Pointer to the fragment for which a handler should be created.

Returns:: A pointer to a fragment handler, or NULL if no handler needs to be created for that fragment.

Reimplemented in AP4_PiffEncryptingProcessor.

Definition at line 213 of file Ap4Processor.h.

virtual TrackHandler* AP4_Processor::CreateTrackHandler ( AP4_TrakAtom * ) [inline, virtual]

This method can be overridden by concrete subclasses.

It is called once for each track in the input file.

Parameters:

track

Pointer to the track for which a handler should be created.

Returns:: A pointer to a track handler, or NULL if no handler needs to be created for that track.

Reimplemented in AP4_IsmaEncryptingProcessor, AP4_MarlinIpmpDecryptingProcessor, AP4_MarlinIpmpEncryptingProcessor, AP4_OmaDcfEncryptingProcessor, AP4_PiffEncryptingProcessor, and AP4_StandardDecryptingProcessor.

Definition at line 203 of file Ap4Processor.h.

virtual AP4_Result AP4_Processor::Finalize	(	AP4_AtomParent &	top_level,
		ProgressListener *	listener = `NULL`
	)			`[virtual]`

This method can be overridden by concrete subclasses.

It is called just after the tracks have been processed.

virtual AP4_Result AP4_Processor::Initialize	(	AP4_AtomParent &	top_level,
		AP4_ByteStream &	stream,
		ProgressListener *	listener = `NULL`
	)			`[virtual]`

This method can be overridden by concrete subclasses.

It is called just after the input stream has been parsed into an atom tree, before the processing of the tracks.

Parameters:

top_level

Container atom containing all the atoms parsed from the input stream. Note that this atom does not actually exist in the file; it is a synthetised container created for the purpose of holding together all the input's top-level atoms.

Reimplemented in AP4_MarlinIpmpDecryptingProcessor, AP4_MarlinIpmpEncryptingProcessor, AP4_OmaDcfDecryptingProcessor, AP4_OmaDcfEncryptingProcessor, AP4_PiffEncryptingProcessor, and AP4_StandardDecryptingProcessor.

AP4_Result AP4_Processor::Process	(	AP4_ByteStream &	input,
		AP4_ByteStream &	output,
		ProgressListener *	listener = `NULL`,
		AP4_AtomFactory &	atom_factory = `AP4_DefaultAtomFactory::Instance`
	)

Process the input stream into an output stream.

Parameters:

	input	Reference to the file to process.
	output	Output stream to which the processed input will be written.
	listener	Pointer to a listener, or NULL. The listener will be called one or more times before this method returns, with progress information.

AP4_Result AP4_Processor::ProcessFragments	(	AP4_MoovAtom *	moov,
		AP4_List< AP4_MoofLocator > &	moofs,
		AP4_ContainerAtom *	mfra,
		AP4_ByteStream &	input,
		AP4_ByteStream &	output
	)			`[protected]`