Collapse all Symbian^3 Application Developer Library

CPreProcessorInfo Class Reference

class CPreProcessorInfo : public CBase

This class contains information about the pre-processing capabilities that an encoder or a pre-processor hardware has. Although it mainly contains static data, it is defined as a complete CBase-derived class since the data is relatively complex and proper memory management is necessary.

The objects are created by the pre-processor or encoder devices, and used by the MSL video client code.

Inherits from

CPreProcessorInfo
- CBase

Public Member Functions
	~CPreProcessorInfo ()
IMPORT_C TBool	Accelerated ()
IMPORT_C const TDesC &	Identifier ()
IMPORT_C const TDesC8 &	ImplementationSpecificInfo ()
IMPORT_C const TDesC &	Manufacturer ()
IMPORT_C CPreProcessorInfo *	NewL ( TUid , const TDesC &, const TDesC &, TVersion , TBool , TBool , const TArray < TUncompressedVideoFormat > &, const TArray < TUncompressedVideoFormat > &, const TArray < TUint32 > &, TBool , TBool , const TArray < TScaleFactor > &, const TYuvToYuvCapabilities &, TUint32 , TUint32 , const TDesC8 &)
IMPORT_C const RArray < TUint32 > &	SupportedCombinations ()
IMPORT_C const RArray < TUncompressedVideoFormat > &	SupportedInputFormats ()
IMPORT_C const RArray < TUncompressedVideoFormat > &	SupportedOutputFormats ()
IMPORT_C TUint32	SupportedRgbRanges ()
IMPORT_C TUint32	SupportedRotations ()
IMPORT_C const RArray < TScaleFactor > &	SupportedScaleFactors ()
IMPORT_C TBool	SupportsAntiAliasedScaling ()
IMPORT_C TBool	SupportsArbitraryScaling ()
IMPORT_C TBool	SupportsCombination ( TUint32 )
IMPORT_C TBool	SupportsDirectCapture ()
IMPORT_C TBool	SupportsInputFormat (const TUncompressedVideoFormat &)
IMPORT_C TBool	SupportsOutputFormat (const TUncompressedVideoFormat &)
IMPORT_C TUid	Uid ()
IMPORT_C TVersion	Version ()
IMPORT_C const TYuvToYuvCapabilities &	YuvToYuvCapabilities ()

Private Member Functions
	CPreProcessorInfo ( TUid , TVersion , TBool , TBool , TBool , TBool , const TYuvToYuvCapabilities &, TUint32 , TUint32 )
void	ConstructL (const TDesC &, const TDesC &, const TArray < TUncompressedVideoFormat > &, const TArray < TUncompressedVideoFormat > &, const TArray < TUint32 > &, const TArray < TScaleFactor > &, const TDesC8 &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Attributes
TBool	iAccelerated
HBufC *	iIdentifier
HBufC8 *	iImplementationSpecificInfo
RArray < TUncompressedVideoFormat >	iInputFormats
HBufC *	iManufacturer
RArray < TUncompressedVideoFormat >	iOutputFormats
RArray < TUint32 >	iSupportedCombinations
TUint32	iSupportedRgbRanges
TUint32	iSupportedRotations
RArray < TScaleFactor >	iSupportedScaleFactors
TBool	iSupportsAntiAliasedScaling
TBool	iSupportsArbitraryScaling
TBool	iSupportsDirectCapture
TUid	iUid
TVersion	iVersion
TYuvToYuvCapabilities	iYuvToYuvCapabilities

Constructor & Destructor Documentation

CPreProcessorInfo(TUid, TVersion, TBool, TBool, TBool, TBool, const TYuvToYuvCapabilities &, TUint32, TUint32)

CPreProcessorInfo	(	TUid	aUid,
		TVersion	aVersion,
		TBool	aAccelerated,
		TBool	aSupportsDirectCapture,
		TBool	aSupportsArbitraryScaling,
		TBool	aSupportsAntiAliasedScaling,
		const TYuvToYuvCapabilities &	aYuvToYuvCapabilities,
		TUint32	aSupportedRgbRanges,
		TUint32	aSupportedRotations
	)	[private]

Parameters

TUid aUid
TVersion aVersion
TBool aAccelerated
TBool aSupportsDirectCapture
TBool aSupportsArbitraryScaling
TBool aSupportsAntiAliasedScaling
const TYuvToYuvCapabilities & aYuvToYuvCapabilities
TUint32 aSupportedRgbRanges
TUint32 aSupportedRotations

~CPreProcessorInfo()

IMPORT_C

~CPreProcessorInfo

(

)

Destructor.

Member Functions Documentation

Accelerated()

IMPORT_C TBool

Accelerated

(

)

const

Returns whether the plug-in is hardware-accelerated. Hardware-accelerated pre-processors can run on an application DSP or dedicated hardware.

ConstructL(const TDesC &, const TDesC &, const TArray< TUncompressedVideoFormat > &, const TArray< TUncompressedVideoFormat > &, const TArray< TUint32 > &, const TArray< TScaleFactor > &, const TDesC8 &)

void	ConstructL	(	const TDesC &	aManufacturer,
			const TDesC &	aIdentifier,
			const TArray < TUncompressedVideoFormat > &	aInputFormats,
			const TArray < TUncompressedVideoFormat > &	aOutputFormats,
			const TArray < TUint32 > &	aSupportedCombinations,
			const TArray < TScaleFactor > &	aSupportedScaleFactors,
			const TDesC8 &	aImplementationSpecificInfo
		)	[private]

Parameters

const TDesC & aManufacturer
const TDesC & aIdentifier
const TArray < TUncompressedVideoFormat > & aInputFormats
const TArray < TUncompressedVideoFormat > & aOutputFormats
const TArray < TUint32 > & aSupportedCombinations
const TArray < TScaleFactor > & aSupportedScaleFactors
const TDesC8 & aImplementationSpecificInfo

Identifier()

IMPORT_C const TDesC &

Identifier

(

)

const

Returns the hardware device manufacturer-specific identifier. The combination of the manufacturer and identifier uniquely identifies the plug-in.

ImplementationSpecificInfo()

IMPORT_C const TDesC8 &

ImplementationSpecificInfo

(

)

const

Returns implementation-specific information about the pre-processor.

Manufacturer()

IMPORT_C const TDesC &

Manufacturer

(

)

const

Returns the hardware device manufacturer.

NewL(TUid, const TDesC &, const TDesC &, TVersion, TBool, TBool, const TArray< TUncompressedVideoFormat > &, const TArray< TUncompressedVideoFormat > &, const TArray< TUint32 > &, TBool, TBool, const TArray< TScaleFactor > &, const TYuvToYuvCapabilities &, TUint32, TUint32, const TDesC8 &)

IMPORT_C CPreProcessorInfo *	NewL	(	TUid	aUid,
			const TDesC &	aManufacturer,
			const TDesC &	aIdentifier,
			TVersion	aVersion,
			TBool	aAccelerated,
			TBool	aSupportsDirectCapture,
			const TArray < TUncompressedVideoFormat > &	aInputFormats,
			const TArray < TUncompressedVideoFormat > &	aOutputFormats,
			const TArray < TUint32 > &	aSupportedCombinations,
			TBool	aSupportsArbitraryScaling,
			TBool	aSupportsAntiAliasedScaling,
			const TArray < TScaleFactor > &	aSupportedScaleFactors,
			const TYuvToYuvCapabilities &	aYuvToYuvCapabilities,
			TUint32	aSupportedRgbRanges,
			TUint32	aSupportedRotations,
			const TDesC8 &	aImplementationSpecificInfo
		)	[static]

Creates and returns a new CPreProcessorInfo object. All data passed into this method is copied.

leave: "This method may leave with one of the system-wide error codes.

Parameters

TUid aUid	"The uid of the pre-processor."
const TDesC & aManufacturer	"The manufacturer of the pre-processor."
const TDesC & aIdentifier	"The manufacturer-specific identifier of the pre-processor."
TVersion aVersion	"The version of the pre-processor."
TBool aAccelerated	"Whether the pre-processor is hw accelerated or not."
TBool aSupportsDirectCapture	"Whether the pre-processor supports direct capture."
const TArray < TUncompressedVideoFormat > & aInputFormats	"An array of the supported input formats."
const TArray < TUncompressedVideoFormat > & aOutputFormats	"An array of the supported output formats."
const TArray < TUint32 > & aSupportedCombinations	"An array of the supported combinations."
TBool aSupportsArbitraryScaling	"Whether the pre-processor supports arbitrary scaling."
TBool aSupportsAntiAliasedScaling	"Whether the pre-processor supports anti-alias filtering on scaling."" @param "aSupportedScaleFactors" "An array of the supported scale factors if arbitrary scaling isn't suported" @param "aYuvToYuvCapabilities" "The yuv to yuv conversion capabilities of the pre-processor." @param "aSupportedRgbRanges" "The supported rgb ranges." @param "aSupportedRotations" "The supported rotations." @param "aImplementationSpecificInfo" "Implementation-specific information." @return"The newly created CPreProcessorInfo object."
const TArray < TScaleFactor > & aSupportedScaleFactors
const TYuvToYuvCapabilities & aYuvToYuvCapabilities
TUint32 aSupportedRgbRanges
TUint32 aSupportedRotations
const TDesC8 & aImplementationSpecificInfo

SupportedCombinations()

IMPORT_C const RArray < TUint32 > &

SupportedCombinations

(

)

const

Lists all supported pre-processing combinations.

SupportedInputFormats()

IMPORT_C const RArray < TUncompressedVideoFormat > &

SupportedInputFormats

(

)

const

Returns the input formats that the pre-processor supports.

SupportedOutputFormats()

IMPORT_C const RArray < TUncompressedVideoFormat > &

SupportedOutputFormats

(

)

const

Returns the output formats that the pre-processor supports.

SupportedRgbRanges()

IMPORT_C TUint32

SupportedRgbRanges

(

)

const

Returns RGB value ranges the hardware device supports for RGB to YUV conversion.

SupportedRotations()

IMPORT_C TUint32

SupportedRotations

(

)

const

Returns the rotation types the plug-in supports.

SupportedScaleFactors()

IMPORT_C const RArray < TScaleFactor > &

SupportedScaleFactors

(

)

const

Returns the scaling factors the plug-in supports. If the plug-in supports arbitrary scaling the list is empty - use SupportsArbitraryScaling() first.

SupportsAntiAliasedScaling()

IMPORT_C TBool

SupportsAntiAliasedScaling

(

)

const

Returns whether the hardware device supports anti-aliasing filtering for scaling.

SupportsArbitraryScaling()

IMPORT_C TBool

SupportsArbitraryScaling

(

)

const

Returns whether the pre-processor supports arbitrary scaling.

SupportsCombination(TUint32)

IMPORT_C TBool

SupportsCombination

(

TUint32

aCombination

)

const

Returns whether the pre-processor supports the given pre-processing combination.

Parameters

TUint32 aCombination

"Pre-processing combination, a bitwise OR of values from TPrePostProcessType."

SupportsDirectCapture()

IMPORT_C TBool

SupportsDirectCapture

(

)

const

Returns whether the hardware device supports direct capture. Pre-processors supporting direct capture can get the input pictures directly from a camera, possibly using an efficient hardware-dependent data path.

SupportsInputFormat(const TUncompressedVideoFormat &)

IMPORT_C TBool

SupportsInputFormat

(

const TUncompressedVideoFormat &

aFormat

)

const

Returns whether the pre-processor supports the given input format.

Parameters

const TUncompressedVideoFormat & aFormat

"The format to be checked."

SupportsOutputFormat(const TUncompressedVideoFormat &)

IMPORT_C TBool

SupportsOutputFormat

(

const TUncompressedVideoFormat &

aFormat

)

const

Returns whether the pre-processor supports the given output format.

Parameters

const TUncompressedVideoFormat & aFormat

"The format to be checked."

Uid()

IMPORT_C TUid

Uid

(

)

const

Returns the pre-processor UID.

Version()

IMPORT_C TVersion

Version

(

)

const

Returns the pre-processor version.

YuvToYuvCapabilities()

IMPORT_C const TYuvToYuvCapabilities &

YuvToYuvCapabilities

(

)

const

Returns the YUV to YUV conversion capabilities for the pre-processor.

Member Data Documentation

TBool iAccelerated

TBool

iAccelerated

[private]

HBufC * iIdentifier

HBufC *

iIdentifier

[private]

HBufC8 * iImplementationSpecificInfo

HBufC8 *

iImplementationSpecificInfo

[private]

RArray< TUncompressedVideoFormat > iInputFormats

RArray < TUncompressedVideoFormat >

iInputFormats

[private]

HBufC * iManufacturer

HBufC *

iManufacturer

[private]

RArray< TUncompressedVideoFormat > iOutputFormats

RArray < TUncompressedVideoFormat >

iOutputFormats

[private]

RArray< TUint32 > iSupportedCombinations

RArray < TUint32 >

iSupportedCombinations

[private]

TUint32 iSupportedRgbRanges

TUint32

iSupportedRgbRanges

[private]

TUint32 iSupportedRotations

TUint32

iSupportedRotations

[private]

RArray< TScaleFactor > iSupportedScaleFactors

RArray < TScaleFactor >

iSupportedScaleFactors

[private]

TBool iSupportsAntiAliasedScaling

TBool

iSupportsAntiAliasedScaling

[private]

TBool iSupportsArbitraryScaling

TBool

iSupportsArbitraryScaling

[private]

TBool iSupportsDirectCapture

TBool

iSupportsDirectCapture

[private]

TUid iUid

TUid

iUid

[private]

TVersion iVersion

TVersion

iVersion

[private]

TYuvToYuvCapabilities iYuvToYuvCapabilities

TYuvToYuvCapabilities

iYuvToYuvCapabilities

[private]