#include <devvideorecord.h>
Link against: devvideo.lib

This item is not part of the S60 5th Edition SDK

Class `CPreProcessorInfo`

class CPreProcessorInfo : public CBase;

Description

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.

Derivation

CBase - Base class for all classes to be instantiated on the heap.

CPreProcessorInfo - This class contains information about the pre-processing capabilities that an en...

Members

Defined in CPreProcessorInfo:

Accelerated()constReturns whether the plug-in is hardware-accelerated. Hardware-accelerated pre-pr...
Identifier()constReturns the hardware device manufacturer-specific identifier. The combination of...
ImplementationSpecificInfo()constReturns implementation-specific information about the pre-processor.
Manufacturer()constReturns 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 &)Creates and returns a new CPreProcessorInfo object. All data passed into this me...
SupportedCombinations()constLists all supported pre-processing combinations.
SupportedInputFormats()constReturns the input formats that the pre-processor supports.
SupportedOutputFormats()constReturns the output formats that the pre-processor supports.
SupportedRgbRanges()constReturns RGB value ranges the hardware device supports for RGB to YUV conversion....
SupportedRotations()constReturns the rotation types the plug-in supports.
SupportedScaleFactors()constReturns the scaling factors the plug-in supports. If the plug-in supports arbitr...
SupportsAntiAliasedScaling()constReturns whether the hardware device supports anti-aliasing filtering for scaling...
SupportsArbitraryScaling()constReturns whether the pre-processor supports arbitrary scaling.
SupportsCombination(TUint32)constReturns whether the pre-processor supports the given pre-processing combination....
SupportsDirectCapture()constReturns whether the hardware device supports direct capture. Pre-processors supp...
SupportsInputFormat(const TUncompressedVideoFormat &)constReturns whether the pre-processor supports the given input format.
SupportsOutputFormat(const TUncompressedVideoFormat &)constReturns whether the pre-processor supports the given output format.
Uid()constReturns the pre-processor UID.
Version()constReturns the pre-processor version.
YuvToYuvCapabilities()constReturns the YUV to YUV conversion capabilities for the pre-processor.
~CPreProcessorInfo()Destructor.

Inherited from CBase:

Delete(CBase *)Deletes the specified object.
Extension_(TUint,TAny *&,TAny *)Extension function
operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TAny *)Initialises the object to binary zeroes.
operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Construction and destruction

`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 static 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);

Description

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

Parameters

`TUid aUid`	"The uid of the pre-processor."
`const TDesC16 &aManufacturer`	"The manufacturer of the pre-processor."
`const TDesC16 &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.""
`const TArray< TScaleFactor > &aSupportedScaleFactors`	"An array of the supported scale factors if arbitrary scaling isn't suported"
`const TYuvToYuvCapabilities &aYuvToYuvCapabilities`	"The yuv to yuv conversion capabilities of the pre-processor."
`TUint32 aSupportedRgbRanges`	"The supported rgb ranges."
`TUint32 aSupportedRotations`	"The supported rotations."
`const TDesC8 &aImplementationSpecificInfo`	"Implementation-specific information."

Return value

CPreProcessorInfo *

"The newly created CPreProcessorInfo object."

Leave codes

"This

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

`~CPreProcessorInfo()`

IMPORT_C ~CPreProcessorInfo();

Description

Destructor.

Member functions

`Uid()const`

IMPORT_C TUid Uid() const;

Description

Returns the pre-processor UID.

Return value

TUid

"Pre-processor UID."

`Manufacturer()const`

IMPORT_C const TDesC& Manufacturer() const;

Description

Returns the hardware device manufacturer.

Return value

const TDesC16 &

"The hardware device manufacturer. The reference is valid until this is destroyed."

`Identifier()const`

IMPORT_C const TDesC& Identifier() const;

Description

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

Return value

const TDesC16 &

"The hardware device identifier. The reference is valid until this object is destroyed."

`Version()const`

IMPORT_C TVersion Version() const;

Description

Returns the pre-processor version.

Return value

TVersion

"Pre-processor version."

`Accelerated()const`

IMPORT_C TBool Accelerated() const;

Description

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

Return value

TBool

"True if the pre-processor is hardware-accelerated."

`SupportsDirectCapture()const`

IMPORT_C TBool SupportsDirectCapture() const;

Description

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.

Return value

TBool

"True if the pre-processor supports direct capture."

`SupportsInputFormat(const TUncompressedVideoFormat &)const`

IMPORT_C TBool SupportsInputFormat(const TUncompressedVideoFormat &aFormat) const;

Description

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

Parameters

const TUncompressedVideoFormat &aFormat

"The format to be checked."

Return value

TBool

"True if the pre-processor supports the given input format."

`SupportedInputFormats()const`

IMPORT_C const RArray< TUncompressedVideoFormat >& SupportedInputFormats() const;

Description

Returns the input formats that the pre-processor supports.

Return value

const RArray< TUncompressedVideoFormat > &

"An RArray table of supported video formats (TUncompressedVideoFormat). The reference is valid until the CPreProcessorInfo object is destroyed."

`SupportsOutputFormat(const TUncompressedVideoFormat &)const`

IMPORT_C TBool SupportsOutputFormat(const TUncompressedVideoFormat &aFormat) const;

Description

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

Parameters

const TUncompressedVideoFormat &aFormat

"The format to be checked."

Return value

TBool

"True if the pre-processor supports the given input format."

`SupportedOutputFormats()const`

IMPORT_C const RArray< TUncompressedVideoFormat >& SupportedOutputFormats() const;

Description

Returns the output formats that the pre-processor supports.

Return value

const RArray< TUncompressedVideoFormat > &

"An RArray table of supported video formats (TUncompressedVideoFormat). The reference is valid until the CPreProcessorInfo object is destroyed."

`SupportsCombination(TUint32)const`

IMPORT_C TBool SupportsCombination(TUint32 aCombination) const;

Description

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

Parameters


                                 						TUint32 aCombination

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

Return value

TBool

"True if the pre-processing combination is supported."

`SupportedCombinations()const`

IMPORT_C const RArray< TUint32 >& SupportedCombinations() const;

Description

Lists all supported pre-processing combinations.

Return value

const RArray< TUint32 > &

"An RArray table of pre-processing combinations. Each value is a bitwise OR of values from TPrePostProcessType. The reference is valid until the CPreProcessorInfo object is destroyed."

`SupportsArbitraryScaling()const`

IMPORT_C TBool SupportsArbitraryScaling() const;

Description

Returns whether the pre-processor supports arbitrary scaling.

Return value

TBool

"True if arbitrary scaling is supported. If arbitrary scaling is not supported, some specific scale factors can still be available."

`SupportsAntiAliasedScaling()const`

IMPORT_C TBool SupportsAntiAliasedScaling() const;

Description

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

Return value

TBool

"True if anti-aliasing filtering is supported."

`SupportedScaleFactors()const`

IMPORT_C const RArray< TScaleFactor >& SupportedScaleFactors() const;

Description

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

Return value

const RArray< TScaleFactor > &

"An RArray list of supported scale factors (TScaleFactor). The reference is valid until the CPreProcessorInfo object is destroyed. If the pre-processor supports arbitrary scaling or no scaling at all, the list is empty."

`YuvToYuvCapabilities()const`

IMPORT_C const TYuvToYuvCapabilities& YuvToYuvCapabilities() const;

Description

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

Return value

const TYuvToYuvCapabilities &

"The conversion capabilities, as a TYuvToYuvCapabilities structure. The reference is valid until the CPreProcessorInfo object is destroyed."

`SupportedRgbRanges()const`

IMPORT_C TUint32 SupportedRgbRanges() const;

Description

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

Return value

TUint32

"The supported RGB ranges as a bitwise OR of TRgbRange values."

`SupportedRotations()const`

IMPORT_C TUint32 SupportedRotations() const;

Description

Returns the rotation types the plug-in supports.

Return value

TUint32

"The supported rotation types as a bitwise OR of TRotationType values. If the pre-processor does not support rotation, the return value is zero."

`ImplementationSpecificInfo()const`

IMPORT_C const TDesC8& ImplementationSpecificInfo() const;

Description

Returns implementation-specific information about the pre-processor.

Return value

const TDesC8 &

"Implementation- specific information about the pre-processor. The data format is implementation-specific, and defined separately by the pre-processor supplier. The reference is valid until the CPreProcessorInfo object is destroyed."

Class CPreProcessorInfo

Description

Derivation

Members

Construction and destruction

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 &)

Description

Parameters

Return value

Leave codes

~CPreProcessorInfo()

Description

Member functions

Uid()const

Description

Return value

Manufacturer()const

Description

Return value

Identifier()const

Description

Return value

Version()const

Description

Return value

Accelerated()const

Description

Return value

SupportsDirectCapture()const

Description

Return value

SupportsInputFormat(const TUncompressedVideoFormat &)const

Description

Parameters

Return value

SupportedInputFormats()const

Description

Return value

SupportsOutputFormat(const TUncompressedVideoFormat &)const

Description

Parameters

Return value

SupportedOutputFormats()const

Description

Return value

SupportsCombination(TUint32)const

Description

Parameters

Return value

SupportedCombinations()const

Description

Return value

SupportsArbitraryScaling()const

Description

Return value

SupportsAntiAliasedScaling()const

Description

Return value

SupportedScaleFactors()const

Description

Return value

YuvToYuvCapabilities()const

Description

Return value

SupportedRgbRanges()const

Description

Return value

SupportedRotations()const

Description

Return value

ImplementationSpecificInfo()const

Description

Return value

Class `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 &)`

`~CPreProcessorInfo()`

`Uid()const`

`Manufacturer()const`

`Identifier()const`

`Version()const`

`Accelerated()const`

`SupportsDirectCapture()const`

`SupportsInputFormat(const TUncompressedVideoFormat &)const`

`SupportedInputFormats()const`

`SupportsOutputFormat(const TUncompressedVideoFormat &)const`

`SupportedOutputFormats()const`

`SupportsCombination(TUint32)const`

`SupportedCombinations()const`

`SupportsArbitraryScaling()const`

`SupportsAntiAliasedScaling()const`

`SupportedScaleFactors()const`

`YuvToYuvCapabilities()const`

`SupportedRgbRanges()const`

`SupportedRotations()const`

`ImplementationSpecificInfo()const`