adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy Class Reference

#include <sample_codec_access_legacy.h>

Inherited by adtf::mediadescription::osborn::cSampleDecoderBase.

Public Types
typedef ddl::StructElement	DefinedStructElementType
	type definition for the old access_element API.

Public Member Functions
tCodecIndex	Resolve (tCodecLeafIndex nElementLeafIndex) const
adtf_util::cVariant	GetElementValue (tCodecLeafIndex nElementLeafIndex) const
	Legacy: Get the Element Value.
tResult	GetElementValue (tCodecLeafIndex nElementLeafIndex, adtf_util::cVariant &oValue) const
	Legacy: Get the Element Value.
tResult	GetElementValue (const char *strElementName, adtf_util::cVariant &oValue) const
	Legacy: Get the Element Value.
tResult	GetElementValue (tCodecLeafIndex nElementLeafIndex, void *pValue) const
	Legacy: Copies the Element Value memory into the memory pointer. Keep in MIND this function is UNSAFE in case of value memory is biger than the given one.
tResult	GetElementValue (const char *strElementName, void *pValue) const
	Legacy: Get the Element Value pointer.
adtf_util::cString	GetElementValueString (tCodecLeafIndex nElementLeafIndex) const
	Legacy: Get the Element Value as string (resolved to the enum element name if is enum type)
tResult	GetElement (tCodecLeafIndex nElementLeafIndex, const ddl::StructElement *&pElement) const
	Get the Element StructElement information.
const void *	GetElementAddress (tCodecLeafIndex nElementLeafIndex) const
	Legacy: Get the Element StructElement information.
size_t	GetElementCount () const
	Legacy: Get the Element Leaf count.

Static Public Member Functions
static const char *	GetStructElementName (const ddl::StructElement *pElement)
	Legacy: Get the Struct Element Name for access_element legacy support.

Protected Member Functions
virtual const ddl::codec::StaticDecoder *	getDecoder () const =0
	Get the base ddl::Decoder.

Detailed Description

Legacy Base Class to Support adtf_ddl::access_element API.

Member Function Documentation

getDecoder()

virtual const ddl::codec::StaticDecoder * adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::getDecoder ( ) const

protectedpure virtual

Get the base ddl::Decoder.

Returns

const ddl::codec::StaticDecoder*

GetElement()

tResult adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElement	(	tCodecLeafIndex	nElementLeafIndex,
		const ddl::StructElement *&	pElement ) const

Get the Element StructElement information.

Parameters

nElementLeafIndex	The leaf index (between 0 and GetElementCount())
pElement	The legacy StructElement

Returns

tResult

Remarks

This function does not throw! DO NOT STORE and reuse after another GetElement call!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementAddress()

const void * adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementAddress

(

tCodecLeafIndex

nElementLeafIndex

)

const

Legacy: Get the Element StructElement information.

Parameters

nElementLeafIndex

The leaf index (between 0 and GetElementCount())

Returns

tResult

Remarks

This function does not throw! DO NOT STORE and reuse after another GetElement call!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementCount()

size_t adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementCount

(

)

const

Legacy: Get the Element Leaf count.

Returns

size_t The amount of leafs.

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValue() [1/5]

tResult adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValue	(	const char *	strElementName,
		adtf_util::cVariant &	oValue ) const

Legacy: Get the Element Value.

Parameters

strElementName	The full element name
oValue	The result value to retrieve to

Returns

tResult

Remarks

This function does not throw! Use the new function with std::string parameter!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValue() [2/5]

tResult adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValue	(	const char *	strElementName,
		void *	pValue ) const

Legacy: Get the Element Value pointer.

Parameters

strElementName	The full element name
pValue	The result value pointer to retrieve to

Returns

tResult

Remarks

This function does not throw! Use the new function with std::string parameter!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValue() [3/5]

adtf_util::cVariant adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValue

(

tCodecLeafIndex

nElementLeafIndex

)

const

Legacy: Get the Element Value.

Parameters

nElementLeafIndex

The leaf index (between 0 and GetElementCount())

Returns

adtf_util::cVariant

Exceptions

Throws

a tResult if not found.

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValue() [4/5]

tResult adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValue	(	tCodecLeafIndex	nElementLeafIndex,
		adtf_util::cVariant &	oValue ) const

Legacy: Get the Element Value.

Parameters

nElementLeafIndex	The leaf index (between 0 and GetElementCount())
oValue	The result value to retrieve to

Returns

tResult

Remarks

This function does not throw!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValue() [5/5]

tResult adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValue	(	tCodecLeafIndex	nElementLeafIndex,
		void *	pValue ) const

Legacy: Copies the Element Value memory into the memory pointer. Keep in MIND this function is UNSAFE in case of value memory is biger than the given one.

Parameters

nElementLeafIndex	The leaf index (between 0 and GetElementCount())
pValue	The result value pointer to retrieve to

Returns

tResult

Remarks

This function does not throw! Use the new function with std::string parameter!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetElementValueString()

adtf_util::cString adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetElementValueString

(

tCodecLeafIndex

nElementLeafIndex

)

const

Legacy: Get the Element Value as string (resolved to the enum element name if is enum type)

Parameters

nElementLeafIndex

The leaf index (between 0 and GetElementCount())

Returns

adtf_util::cString

Remarks

This function does not throw!

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

GetStructElementName()

static const char * adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::GetStructElementName ( const ddl::StructElement * pElement )

static

Legacy: Get the Struct Element Name for access_element legacy support.

Parameters

pElement

the struct element where to retrieve the name from

Returns

const char*

Resolve()

tCodecIndex adtf::mediadescription::osborn::adtf_ddl_access::cDecoderLegacy::Resolve

(

tCodecLeafIndex

nElementLeafIndex

)

const

Legacy: Retrieves a codec index with element information for the given leaf index.

Parameters

nElementLeafIndex

The leaf index (between 0 and GetElementCount())

Returns

The codec index for this element.

Exceptions

throws

tResult if not found.

Deprecated

This is only provided for legacy reason. Use adtf::mediadescription::cSampleDecoder::GetElement instead

---

The documentation for this class was generated from the following file:

• src/libraries/mediadescription/include/adtfmediadescription/sample_codec_access_legacy.h