Collapse all Symbian^3 Product Developer Library

CMceCameraSource Class Reference

class CMceCameraSource : public CMceMediaSource

Class representing camera in MCE.

CMceCameraSource can be used to record video from camera.

Enable (continue) and Disable (pause) operations to it are considered to be local, so they are not signalled to remote terminal.

In common situation camera source is combined with display sink which acts as a viewfinder for the camera.

mceclient.lib

Inherits from

CMceCameraSource
- CMceMediaSource
  - CBase

Public Member Functions
	~CMceCameraSource()
IMPORT_C TInt	BrightnessL()
IMPORT_C TInt	CamerasAvailable()
IMPORT_C TInt	ContrastL()
IMPORT_C TInt	DigitalZoomFactorL()
IMPORT_C void	DisableL()
IMPORT_C void	EnableL()
IMPORT_C CCamera::TExposure	ExposureL()
IMPORT_C void	GetCameraInfo(TCameraInfo &)
void	InitializeL(CMceManager *)
IMPORT_C CMceCameraSource *	NewL(CMceManager &)
CMceCameraSource *	NewL()
IMPORT_C CMceCameraSource *	NewLC(CMceManager &)
CMceCameraSource *	NewLC()
IMPORT_C void	SetBrightnessL(TInt)
IMPORT_C void	SetCameraIndexL(TInt)
IMPORT_C void	SetContrastL(TInt)
IMPORT_C void	SetDigitalZoomFactorL(TInt)
IMPORT_C void	SetExposureL(CCamera::TExposure)
IMPORT_C void	SetWhiteBalanceL(CCamera::TWhiteBalance)
IMPORT_C void	SetZoomFactorL(TInt)
IMPORT_C CCamera::TWhiteBalance	WhiteBalanceL()
IMPORT_C TInt	ZoomFactorL()

Private Member Functions
	CMceCameraSource()
void	ConstructL(CMceManager *)
void	GetITCCameraInfoL(CMceManager &, TCameraInfo &)
TInt	GetITCValueL(TUint8)
TCameraInfo	SetITCCameraIndexL(TInt)
TInt	SetITCValueL(TUint8, TInt)

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()
	CMceMediaSource::CMceMediaSource()
	CMceMediaSource::CancelDtmfToneSequenceL()
	CMceMediaSource::ConstructL(CMceComMediaSource *)
	CMceMediaSource::DoDisableL()
	CMceMediaSource::DoEnableL()
	CMceMediaSource::DtmfActive()
	CMceMediaSource::DtmfAvailable()
	CMceMediaSource::Enabled(TBool)
	CMceMediaSource::EventReceivedL(TMceEvent &)
	CMceMediaSource::ExternalizeFlatL(RWriteStream &)
	CMceMediaSource::ExternalizeL(MMceComSerializationContext &)
	CMceMediaSource::Factory()
	CMceMediaSource::HandleEvent(TMceEvent &)
	CMceMediaSource::Id()const
	CMceMediaSource::InitializeL(CMceMediaStream &)
	CMceMediaSource::InternalizeFlatL(RReadStream &)
	CMceMediaSource::InternalizeL(MMceComSerializationContext &)
	CMceMediaSource::IsEnabled()const
	CMceMediaSource::ReferenceCount()
	CMceMediaSource::SendDtmfToneL(const TChar &,TTimeIntervalMicroSeconds32)
	CMceMediaSource::SendDtmfToneSequenceL(const TDesC &)
	CMceMediaSource::SerializationId()const
	CMceMediaSource::StartDtmfToneL(const TChar &)
	CMceMediaSource::StopDtmfToneL()
	CMceMediaSource::StreamAddedL(CMceMediaStream &)
	CMceMediaSource::Type()const
	CMceMediaSource::UnInitialize(CMceMediaStream &)
	CMceMediaSource::UpdateL(CMceMediaSource &)
	CMceMediaSource::Updated()
	CMceMediaSource::~CMceMediaSource()

Private Attributes
TAny *	iReserved

Inherited Attributes
	CMceMediaSource::iFlatData
	CMceMediaSource::iParents
	CMceMediaSource::iStream

Constructor & Destructor Documentation

CMceCameraSource()

CMceCameraSource

(

)

[private]

C++ constructor.

~CMceCameraSource()

IMPORT_C

~CMceCameraSource

(

)

Destructor.

Member Functions Documentation

BrightnessL()

IMPORT_C TInt

BrightnessL

(

)

Gets the currently set brightness adjustment value.

CamerasAvailable()

IMPORT_C TInt

CamerasAvailable

(

)

const

Gets the number of cameras on the device.

ConstructL(CMceManager *)

void

ConstructL

(

CMceManager *

aManager

)

[private]

Second-phase constructor.

Parameters

CMceManager * aManager

Pointer to the manager

ContrastL()

IMPORT_C TInt

ContrastL

(

)

Gets the current contrast value.

DigitalZoomFactorL()

IMPORT_C TInt

DigitalZoomFactorL

(

)

Gets the currently set digital zoom factor.

DisableL()

IMPORT_C void

DisableL

(

)

[virtual]

Disables the source explicitly.

EnableL()

IMPORT_C void

EnableL

(

)

[virtual]

Enables the source explicitly.

ExposureL()

IMPORT_C CCamera::TExposure

ExposureL

(

)

Gets the currently set exposure setting value.

GetCameraInfo(TCameraInfo &)

IMPORT_C void

GetCameraInfo

(

TCameraInfo &

aInfo

)

const

Gets information about the camera device.

Parameters

TCameraInfo & aInfo

on return information about the camera device

GetITCCameraInfoL(CMceManager &, TCameraInfo &)

void	GetITCCameraInfoL	(	CMceManager &	aManager,
			TCameraInfo &	aInfo
		)	const [private]

Gets camera info

Parameters

CMceManager & aManager
TCameraInfo & aInfo

GetITCValueL(TUint8)

TInt

GetITCValueL

(

TUint8

aITCFunction

)

[private]

Handles ITC

Parameters

TUint8 aITCFunction

InitializeL(CMceManager *)

void

InitializeL

(

CMceManager *

aManager

)

[virtual]

Initializes

Parameters

CMceManager * aManager

the manager. Ownership is NOT transferred

NewL(CMceManager &)

IMPORT_C CMceCameraSource *

NewL

(

CMceManager &

aManager

)

[static]

Two-phased constructor.

Parameters

CMceManager & aManager

reference to the manager

NewL()

CMceCameraSource *

NewL

(

)

[static]

Two-phased constructor.

NewLC(CMceManager &)

IMPORT_C CMceCameraSource *

NewLC

(

CMceManager &

aManager

)

[static]

Two-phased constructor.

Parameters

CMceManager & aManager

reference to the manager

NewLC()

CMceCameraSource *

NewLC

(

)

[static]

Two-phased constructor.

SetBrightnessL(TInt)

IMPORT_C void

SetBrightnessL

(

TInt

aBrightness

)

Sets the brightness adjustment of the device. No effect if this is not supported, see TCameraInfo::TOptions.

leave: KErrNotSupported if brightness adjustment is not supported, see TCameraInfo::TOptions

leave: KErrArgument if the brightness adjustment is out of range

Parameters

TInt aBrightness

required brightness adjustment; This must be in the range of -100 to +100 or CCamera::EBrightnessAuto

SetCameraIndexL(TInt)

IMPORT_C void

SetCameraIndexL

(

TInt

aCameraIndex

)

Sets index of physical camera to be used.

Parameters

TInt aCameraIndex

Index of the camera to be used; First camera has index 0 and number of available cameras can be retrieved by calling CMceCameraSource::CamerasAvailable

SetContrastL(TInt)

IMPORT_C void

SetContrastL

(

TInt

aContrast

)

Sets the contrast adjustment of the device.

leave: KErrNotSupported if contrast adjustment is not supported, see TCameraInfo::TOptions

leave: KErrArgument if the specified contrast value is out of range

Parameters

TInt aContrast

required contrast value; This must be in the range of -100 to +100 or CCamera::EContrastAuto.

SetDigitalZoomFactorL(TInt)

IMPORT_C void

SetDigitalZoomFactorL

(

TInt

aDigitalZoomFactor

)

Sets the digital zoom factor. This must be in the range of 0 to TCameraInfo::iMaxDigitalZoom inclusive.

leave: KErrArgument if the zoom factor is out of range

Parameters

TInt aDigitalZoomFactor

The required digital zoom factor

SetExposureL(CCamera::TExposure)

IMPORT_C void

SetExposureL

(

CCamera::TExposure

aExposure

)

Sets the exposure adjustment of the device.

leave: KErrNotSupported if the specified exposure adjustment is not supported, see CameraInfo::iExposureModesSupported

Parameters

CCamera::TExposure aExposure

required exposure adjustment

SetITCCameraIndexL(TInt)

TCameraInfo

SetITCCameraIndexL

(

TInt

aCameraIndex

)

const [private]

Parameters

TInt aCameraIndex

SetITCValueL(TUint8, TInt)

TInt	SetITCValueL	(	TUint8	aITCFunction,
			TInt	aValue
		)	[private]

Handles ITC

Parameters

TUint8 aITCFunction
TInt aValue

SetWhiteBalanceL(CCamera::TWhiteBalance)

IMPORT_C void

SetWhiteBalanceL

(

CCamera::TWhiteBalance

aWhiteBalance

)

Sets the white balance adjustment of the device.

leave: KErrNotSupported if the specified white balance adjustment is not supported, see TCameraInfo::iWhiteBalanceModesSupported

Parameters

CCamera::TWhiteBalance aWhiteBalance

required white balance adjustment

SetZoomFactorL(TInt)

IMPORT_C void

SetZoomFactorL

(

TInt

aZoomFactor

)

Sets the zoom factor. This must be in the range of TCameraInfo::iMinZoom to TCameraInfo::iMaxZoom inclusive.

leave: KErrArgument if the specified zoom factor is out of range

Parameters

TInt aZoomFactor

required zoom factor

WhiteBalanceL()

IMPORT_C CCamera::TWhiteBalance

WhiteBalanceL

(

)

Gets the currently set white balance adjustment value.

ZoomFactorL()

IMPORT_C TInt

ZoomFactorL

(

)

Gets the currently set zoom factor.

Member Data Documentation

TAny * iReserved

TAny *

iReserved

[private]