Bento4 MP4 SDK: AP4_SyntheticSampleTable Class Reference

previous page next page

AP4_SyntheticSampleTable Class Reference

Classes
class	SampleDescriptionHolder
Public Member Functions
	AP4_SyntheticSampleTable (AP4_Cardinal chunk_size=AP4_SYNTHETIC_SAMPLE_TABLE_DEFAULT_CHUNK_SIZE)
virtual	~AP4_SyntheticSampleTable ()
virtual AP4_Result	GetSample (AP4_Ordinal index, AP4_Sample &sample)
virtual AP4_Cardinal	GetSampleCount ()
virtual AP4_Result	GetSampleChunkPosition (AP4_Ordinal sample_index, AP4_Ordinal &chunk_index, AP4_Ordinal &position_in_chunk)
virtual AP4_Cardinal	GetSampleDescriptionCount ()
virtual AP4_SampleDescription *	GetSampleDescription (AP4_Ordinal index)
virtual AP4_Result	GetSampleIndexForTimeStamp (AP4_UI64 ts, AP4_Ordinal &index)
virtual AP4_Ordinal	GetNearestSyncSampleIndex (AP4_Ordinal index, bool before)
virtual AP4_Result	AddSampleDescription (AP4_SampleDescription *description, bool transfer_ownership=true)
	Add a sample description to the sample table.
virtual AP4_Result	AddSample (AP4_ByteStream &data_stream, AP4_Position offset, AP4_Size size, AP4_UI32 duration, AP4_Ordinal description_index, AP4_UI64 dts, AP4_UI32 cts_delta, bool sync)
	Add a sample to the sample table, where the sample duration is given.

Definition at line 54 of file Ap4SyntheticSampleTable.h.

AP4_SyntheticSampleTable::AP4_SyntheticSampleTable ( AP4_Cardinal chunk_size = AP4_SYNTHETIC_SAMPLE_TABLE_DEFAULT_CHUNK_SIZE )

virtual AP4_SyntheticSampleTable::~AP4_SyntheticSampleTable ( ) [virtual]

virtual AP4_Result AP4_SyntheticSampleTable::AddSample	(	AP4_ByteStream &	data_stream,
		AP4_Position	offset,
		AP4_Size	size,
		AP4_UI32	duration,
		AP4_Ordinal	description_index,
		AP4_UI64	dts,
		AP4_UI32	cts_delta,
		bool	sync
	)			`[virtual]`

Add a sample to the sample table, where the sample duration is given.

Parameters:

	data_stream	The byte stream that contains the sample data. The sample object added to the track will keep a reference to that byte stream.
	offset	Position of the first byte of sample data within the stream
	size	Size in bytes of the sample data
	duration	Duration of the sample (in the timescale of the media). This value can be 0 if the duration is not known. In that case, the next sample added to the table MUST have a non-zero value for the DTS (decoding timestamp), which will allow the actual duration of this sample to be computed.
	description_index	Index of the sample description that applies to this sample (typically 0).
	dts	DTS (decoding timestamp) of the sample. If this value is 0, and there already are samples in the table, the DTS of the sample will be automatically computed based on the DTS and duration of the preceding sample. If this value is not equal to the DTS+duration of the preceding sample, the duration of the preceding sample is automatically adjusted, unless it has a non-zero value, in which case AP4_ERROR_INVALID_PARAMETERS is returned. The DTS of the first sample in the table MUST always be 0.
	cts_delta	Difference between the CTS (composition/display timestamp) and DTS (decoding timestamp) of the sample (in the timescale of the media)
	sync	Boolean flag indicating whether this is a sync sample or not.

virtual AP4_Result AP4_SyntheticSampleTable::AddSampleDescription	(	AP4_SampleDescription *	description,
		bool	transfer_ownership = `true`
	)			`[virtual]`

Add a sample description to the sample table.

Each added sample description will have the next available index, starting at 0

Parameters:

	description	Pointer to the sample description to add
	transfer_ownership	Boolean flag indicating whether the ownership of the sample description object is transfered to the sample table object (true by default). If true, the sample table object will own the sample description object, and will delete it when it is itself deleted. If false, the ownership remains with the caller, and only a referencing pointer is kept, thus the caller must ensure that the object is not deleted before the sample table is deleted.

virtual AP4_Ordinal AP4_SyntheticSampleTable::GetNearestSyncSampleIndex	(	AP4_Ordinal	index,
		bool	before
	)			`[virtual]`

virtual AP4_Result AP4_SyntheticSampleTable::GetSample	(	AP4_Ordinal	index,
		AP4_Sample &	sample
	)			`[virtual]`

virtual AP4_Result AP4_SyntheticSampleTable::GetSampleChunkPosition	(	AP4_Ordinal	sample_index,
		AP4_Ordinal &	chunk_index,
		AP4_Ordinal &	position_in_chunk
	)			`[virtual]`