Symaptic: os/mm/imagingandcamerafws/camerafw/Include/ECam/ecamadvsettingsintf.h@bde4ae8d615e (annotated)

sl@0	1	// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0	2	// All rights reserved.
sl@0	3	// This component and the accompanying materials are made available
sl@0	4	// under the terms of "Eclipse Public License v1.0"
sl@0	5	// which accompanies this distribution, and is available
sl@0	6	// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0	7	//
sl@0	8	// Initial Contributors:
sl@0	9	// Nokia Corporation - initial contribution.
sl@0	10	//
sl@0	11	// Contributors:
sl@0	12	//
sl@0	13	// Description:
sl@0	14	//
sl@0	15
sl@0	16	/**
sl@0	17	@file
sl@0	18	@publishedPartner
sl@0	19	@released
sl@0	20	*/
sl@0	21
sl@0	22	#ifndef ECAMADVSETTINGSINTF_H
sl@0	23	#define ECAMADVSETTINGSINTF_H
sl@0	24
sl@0	25	#include <ecamadvsettings.h>
sl@0	26	#include <ecam/ecamimageprocessingintf.h>
sl@0	27	#include <ecam/ecamadvsettingsintfuids.hrh>
sl@0	28
sl@0	29	/** This is the UID which is used to obtain the interface MCameraPresets, via the
sl@0	30	CCamera::CustomInterface() call, which provides implementation of the M-class interface.
sl@0	31	*/
sl@0	32	static const TUid KECamMCameraPresetsUid = {KECamMCameraPresetsUidValue};
sl@0	33
sl@0	34	/**
sl@0	35	This is the UID which is used to obtain the interface MCameraPresets2, via the
sl@0	36	CCamera::CustomInterface() call, which provides implementation of the M-class interface.
sl@0	37	@publishedPartner
sl@0	38	@prototype
sl@0	39	*/
sl@0	40	static const TUid KECamMCameraPresets2Uid = {KECamMCameraPresets2UidValue};
sl@0	41
sl@0	42	/** This is the UID which is used to obtain the interface MCameraAdvancedSettings, via the
sl@0	43	CCamera::CustomInterface() call, which provides implementation of the M-class interface. */
sl@0	44	static const TUid KECamMCameraAdvancedSettingsUid = {KECamMCameraAdvancedSettingsUidValue};
sl@0	45
sl@0	46	/** This is the UID which is used to obtain the interface MCameraAdvancedSettings2, via the
sl@0	47	CCamera::CustomInterface() call, which provides implementation of the M-class interface. */
sl@0	48	static const TUid KECamMCameraAdvancedSettings2Uid = {KECamMCameraAdvancedSettings2UidValue};
sl@0	49
sl@0	50	/**
sl@0	51	This is the UID which is used to obtain the interface MCameraAdvancedSettings3, via the
sl@0	52	CCamera::CustomInterface() call, which provides implementation of the M-class interface.
sl@0	53	*/
sl@0	54	static const TUid KECamMCameraAdvancedSettings3Uid = {KECamMCameraAdvancedSettings3UidValue};
sl@0	55
sl@0	56	/**
sl@0	57	This is the UID which is used to obtain the interface MCameraAdvancedSettings4, via the
sl@0	58	CCamera::CustomInterface() call, which provides implementation of the M-class interface.
sl@0	59	@publishedPartner
sl@0	60	@prototype
sl@0	61	*/
sl@0	62	static const TUid KECamMCameraAdvancedSettings4Uid = {KECamMCameraAdvancedSettings4UidValue};
sl@0	63
sl@0	64	/**
sl@0	65	This is the UID which is used to obtain the interface MCameraContinuousZoom, via the
sl@0	66	CCamera::CCameraAdvancedSettings::CreateContinuousZoomImpl() call, which provides
sl@0	67	implementation of the M-class interface.
sl@0	68	@internalTechnology
sl@0	69	@prototype
sl@0	70	*/
sl@0	71	static const TUid KECamMCameraContinuousZoomUid = {KECamMCameraContinuousZoomUidValue};
sl@0	72
sl@0	73	/**
sl@0	74	Mixin class for implementation by providers of the Advanced Settings Camera Extension API.
sl@0	75	CCamera advanced settings class exposes an API for controlling individually
sl@0	76	digital camera advanced settings. These settings directly relate to the
sl@0	77	image acquisition phase both for still images and video.
sl@0	78
sl@0	79	@publishedPartner
sl@0	80	@released
sl@0	81	*/
sl@0	82	class MCameraAdvancedSettings
sl@0	83	{
sl@0	84
sl@0	85	public:
sl@0	86
sl@0	87	/**
sl@0	88	Releases the interface.
sl@0	89	*/
sl@0	90	virtual void Release()=0;
sl@0	91
sl@0	92	/**
sl@0	93	Gets the type of this camera.
sl@0	94	@see TCameraType
sl@0	95
sl@0	96	@return a TCameraType value.
sl@0	97	*/
sl@0	98	virtual CCamera::CCameraAdvancedSettings::TCameraType CameraType() const=0;
sl@0	99
sl@0	100	/**
sl@0	101	Get the type of a specific camera denoted by its index. A pluggable camera
sl@0	102	may not necessarily be physically present. The type denotes whether the slot allocated
sl@0	103	to that index is for pluggable or onboard camera.
sl@0	104
sl@0	105	@param aCameraIndex
sl@0	106	An integer in the range of [0: CCamera::CamerasAvailable()-1].
sl@0	107
sl@0	108	@return the TCameraType value for the specific camera.
sl@0	109	If the index is out of range, the return value is ECameraUnknown.
sl@0	110	*/
sl@0	111	virtual CCamera::CCameraAdvancedSettings::TCameraType CameraType(TInt aCameraIndex) const=0;
sl@0	112
sl@0	113	/**
sl@0	114	Checks whether the current camera is present.
sl@0	115
sl@0	116	@return Whether the camera is currently present.
sl@0	117	ETrue if camera is present, EFalse otherwise.
sl@0	118	For example ECameraOnBoard (built-in) cameras are always present.
sl@0	119	*/
sl@0	120	virtual TBool IsCameraPresent() const=0;
sl@0	121
sl@0	122	/**
sl@0	123	Checks whether the camera, denoted by its index, is currently present.
sl@0	124	The index uniquely identifies the camera on the device.
sl@0	125
sl@0	126	@param aCameraIndex
sl@0	127	An integer in the range of [0:CCamera::CamerasAvailable()-1] specifying the
sl@0	128	camera device to use
sl@0	129
sl@0	130	@return Whether the camera is currently present.
sl@0	131	ETrue if camera is present, EFalse otherwise.
sl@0	132	For example built-in (ECameraOnBoard) cameras
sl@0	133	are always present.
sl@0	134	*/
sl@0	135	virtual TBool IsCameraPresent(TInt aCameraIndex) const=0;
sl@0	136
sl@0	137	/**
sl@0	138	Gets current camera index. The index uniquely identifies the camera on the device.
sl@0	139
sl@0	140	@return camera index in the inclusive range of [0:CCamera::CamerasAvailable() - 1].
sl@0	141	*/
sl@0	142	virtual TInt CameraIndex() const=0;
sl@0	143
sl@0	144	/**
sl@0	145	Gets all of the supported stabilization modes on the device. The result is a bitfield
sl@0	146	of the valid TStabilizationMode flags.
sl@0	147
sl@0	148	@return a bitfield of all supported stabilization modes.
sl@0	149	*/
sl@0	150	virtual TInt SupportedStabilizationModes() const=0;
sl@0	151
sl@0	152	/**
sl@0	153	Gets current stabilization mode on the device.
sl@0	154	The result is a valid TStabilizationMode value.
sl@0	155
sl@0	156	@return current stabilization mode of type TStabilizationMode.
sl@0	157	*/
sl@0	158	virtual CCamera::CCameraAdvancedSettings::TStabilizationMode StabilizationMode() const=0;
sl@0	159
sl@0	160	/**
sl@0	161	Sets a specific stabilization mode on the device.
sl@0	162
sl@0	163	Stabilization mode change fires a KUidECamEventCameraSettingStabilizationMode
sl@0	164	event to all MCameraObserver2 clients of this specific camera.
sl@0	165
sl@0	166	@param aStabilizationMode
sl@0	167	new stabilization mode of TStabilizationMode type.
sl@0	168	*/
sl@0	169	virtual void SetStabilizationMode(CCamera::CCameraAdvancedSettings::TStabilizationMode aStabilizationMode)=0;
sl@0	170
sl@0	171	/**
sl@0	172	Gets all of the supported focus modes on the device. The result is a bitfield
sl@0	173	of the valid TFocusMode flags.
sl@0	174
sl@0	175	@return a bitfield of all supported focus modes.
sl@0	176	*/
sl@0	177	virtual TInt SupportedFocusModes() const=0;
sl@0	178
sl@0	179	/**
sl@0	180	Gets current focus mode on the device.
sl@0	181	The result is a valid TFocusMode value.
sl@0	182
sl@0	183	@return current focus mode.
sl@0	184	*/
sl@0	185	virtual CCamera::CCameraAdvancedSettings::TFocusMode FocusMode() const=0;
sl@0	186
sl@0	187	/**
sl@0	188	Sets a specific focus mode on the device.
sl@0	189	Focus mode change fires a KUidECamEventCameraSettingFocusMode event
sl@0	190	to all MCameraObserver2 clients of the camera.
sl@0	191
sl@0	192	@param aFocusMode
sl@0	193	new focus mode of TFocusMode type.
sl@0	194	*/
sl@0	195	virtual void SetFocusMode(CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode)=0;
sl@0	196
sl@0	197	/**
sl@0	198	Gets all supported focus ranges on the device.
sl@0	199
sl@0	200	@return an integer - a bitfield of all supported TFocusRange values.
sl@0	201	*/
sl@0	202	virtual TInt SupportedFocusRanges() const=0;
sl@0	203
sl@0	204	/**
sl@0	205	Gets current focus range on the device.
sl@0	206
sl@0	207	@return the current TFocusRange value.
sl@0	208	*/
sl@0	209	virtual CCamera::CCameraAdvancedSettings::TFocusRange FocusRange() const=0;
sl@0	210
sl@0	211	/**
sl@0	212	Sets a specific focus range on the device.
sl@0	213	The focus range change fires both, KUidECamEventCameraSettingFocusRange and
sl@0	214	KUidECamEventCameraSettingFocusRange2 event to all MCameraObserver2 clients of the camera.
sl@0	215	@see KUidECamEventCameraSettingFocusRange
sl@0	216
sl@0	217	@param aFocusRange
sl@0	218	newly selected focus range.
sl@0	219	*/
sl@0	220	virtual void SetFocusRange(CCamera::CCameraAdvancedSettings::TFocusRange aFocusRange)=0;
sl@0	221
sl@0	222	/**
sl@0	223	Gets all supported auto focus types on the device.
sl@0	224
sl@0	225	@return an integer - a bitfield of all supported TAutoFocusType values.
sl@0	226	*/
sl@0	227	virtual TInt SupportedAutoFocusTypes() const=0;
sl@0	228
sl@0	229	/**
sl@0	230	Gets current auto focus type on the device.
sl@0	231
sl@0	232	@return a CCamera::TAutoFocusType value.
sl@0	233	*/
sl@0	234	virtual CCamera::CCameraAdvancedSettings::TAutoFocusType AutoFocusType() const=0;
sl@0	235
sl@0	236	/**
sl@0	237	Sets a specific auto focus type on the device.
sl@0	238	The focus type change fires both, KUidECamEventCameraSettingAutoFocusType and
sl@0	239	KUidECamEventCameraSettingAutoFocusType2 event to all MCameraObserver2 clients of the camera.
sl@0	240	@see KUidECamEventCameraSettingAutoFocusType
sl@0	241
sl@0	242	@param aAutoFocusType
sl@0	243	Autofocus selection.
sl@0	244	*/
sl@0	245	virtual void SetAutoFocusType(CCamera::CCameraAdvancedSettings::TAutoFocusType aAutoFocusType)=0;
sl@0	246
sl@0	247	/**
sl@0	248	Gets all supported auto focus areas on the device.
sl@0	249
sl@0	250	@return an integer - a bitfield of al supported TAutoFocusArea values.
sl@0	251	*/
sl@0	252	virtual TInt SupportedAutoFocusAreas() const=0;
sl@0	253
sl@0	254	/**
sl@0	255	Gets current chosen auto focus area on the device.
sl@0	256
sl@0	257	@return a CCamera::TAutoFocusArea value.
sl@0	258	*/
sl@0	259	virtual CCamera::CCameraAdvancedSettings::TAutoFocusArea AutoFocusArea() const=0;
sl@0	260
sl@0	261	/**
sl@0	262	Sets a specific auto focus area on the device.
sl@0	263	Focus area change fires a KUidECamEventCameraSettingAutoFocusArea event
sl@0	264	to all MCameraObserver2 clients of the camera.
sl@0	265
sl@0	266	@param aAutoFocusArea
sl@0	267	Autofocus area selection.
sl@0	268	*/
sl@0	269	virtual void SetAutoFocusArea(CCamera::CCameraAdvancedSettings::TAutoFocusArea aAutoFocusArea)=0;
sl@0	270
sl@0	271	/**
sl@0	272	Get focus distance in millimetres.
sl@0	273
sl@0	274	@return the current focus distance in millimetres, directly from user setting of lenses.
sl@0	275	*/
sl@0	276	virtual TInt FocusDistance() const=0;
sl@0	277
sl@0	278	/**
sl@0	279	Set focus distance in millimetres. Focus distance change fires a KUidECamEventCameraSettingFocusDistance event
sl@0	280	to all MCameraObserver2 clients of the camera.
sl@0	281
sl@0	282	@param aDistance
sl@0	283	the current value in millimetres, directly from user setting of lenses.
sl@0	284	*/
sl@0	285	virtual void SetFocusDistance(TInt aDistance)=0;
sl@0	286
sl@0	287	/**
sl@0	288	Get minimum focus distance in millimetres.
sl@0	289
sl@0	290	@return the minimum (35 camera equivalent) focal length of a device.
sl@0	291	@note Current Focal length is calculated as
sl@0	292	focalLength = opticalZoom * minFocalLength;
sl@0	293	*/
sl@0	294	virtual TInt GetMinFocalLength() const=0;
sl@0	295
sl@0	296	/**
sl@0	297	Gets the set of camera supported ISO rates.
sl@0	298
sl@0	299	@param aSupportedIsoRates
sl@0	300	an array of integers which gets filled in with the supported ISO rates.
sl@0	301
sl@0	302	@note When camera device is incapable of revealing the ISO rates supported, it has to be assumed that
sl@0	303	camera will work only on the parmanently set value. If this value is not known, empty array should be
sl@0	304	returned, and the corresponding getter/setters for this feature for this feature should not be used.
sl@0	305	*/
sl@0	306	virtual void GetSupportedIsoRatesL(RArray<TInt>& aSupportedIsoRates) const=0;
sl@0	307
sl@0	308	/**
sl@0	309	Gets current ISO rate.
sl@0	310
sl@0	311	@return current ISO rate as a TInt value.
sl@0	312
sl@0	313	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	314	*/
sl@0	315	virtual TInt IsoRate() const=0;
sl@0	316
sl@0	317	/**
sl@0	318	Set current ISO rate for the camera.
sl@0	319	Triggers a KUidECamEventCameraSettingIsoRate event to all MCameraObserver2 clients of the camera.
sl@0	320
sl@0	321	@param aRate
sl@0	322	required new ISO rate.
sl@0	323	*/
sl@0	324	virtual void SetIsoRate(TInt aRate)=0;
sl@0	325
sl@0	326	/**
sl@0	327	Gets the current discrete aperture steps (F-stops) supported by the device.
sl@0	328
sl@0	329	@param aFStops
sl@0	330	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	331	the specific supported values. If the array is empty on return,
sl@0	332	the camera supports all integer values in the aperture range. Each value is multiplied by
sl@0	333	a factor of KECamFineResolutionFactor.
sl@0	334
sl@0	335	@param aInfo
sl@0	336	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	337
sl@0	338	@leave KErrNoMemory Out of memory.
sl@0	339
sl@0	340	@note When camera device is incapable of revealing the aperture openings supported, it has to be assumed that
sl@0	341	camera will work only on the parmanently set value. If this value is not known, empty array should be
sl@0	342	returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
sl@0	343	*/
sl@0	344	virtual void GetAperturesL(RArray<TInt>& aFStops, TValueInfo& aInfo) const=0;
sl@0	345
sl@0	346	/**
sl@0	347	Get current aperture value.
sl@0	348	The default aperture value is ECAM implementation specific and could be either auto aperture or any other supported value.
sl@0	349
sl@0	350	@return Current aperture value as an integer, multiplied by KECamFineResolutionFactor.
sl@0	351	For example the function will return 280 for the actual aperture of F2.8.
sl@0	352
sl@0	353	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	354	*/
sl@0	355	virtual TInt Aperture() const=0;
sl@0	356
sl@0	357	/**
sl@0	358	Set a new aperture value.
sl@0	359	All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingAperture
sl@0	360	event notification when aperture value is changed.
sl@0	361
sl@0	362	@note The aperture parameter value is an integer, multiplied by KECamFineResolutionFactor.
sl@0	363	For example to set an aperture of F2.8, call SetAperture(280).
sl@0	364
sl@0	365	@param aFStop
sl@0	366	a new aperture value in the supported by the device range.
sl@0	367	*/
sl@0	368	virtual void SetAperture(TInt aFStop)=0;
sl@0	369
sl@0	370	/**
sl@0	371	Gets the set of supported shutter speeds
sl@0	372
sl@0	373	@param aShutterSpeeds
sl@0	374	a reference to an RArray of TInt representing the discrete shutter speeds supported
sl@0	375	currently by the device.
sl@0	376
sl@0	377	@param aInfo
sl@0	378	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	379
sl@0	380	@return the populated array with all shutter speeds in microseconds.
sl@0	381
sl@0	382	@leave KErrNoMemory Out of memory.
sl@0	383
sl@0	384	@note When camera device is incapable of revealing the shutter speeds supported, it has to be assumed that
sl@0	385	camera will work only on the parmanently set value. If this value is not known, empty array should be
sl@0	386	returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
sl@0	387	*/
sl@0	388	virtual void GetShutterSpeedsL(RArray<TInt>& aShutterSpeeds, TValueInfo& aInfo) const=0;
sl@0	389
sl@0	390	/**
sl@0	391	Gets the current shutter speed
sl@0	392
sl@0	393	@return the current shutter speed in microseconds.
sl@0	394
sl@0	395	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	396	*/
sl@0	397	virtual TInt ShutterSpeed() const=0;
sl@0	398
sl@0	399	/**
sl@0	400	Sets the current shutter speed. When set, all MCameraObserver2 clients of the camera
sl@0	401	receive a KUidECamEventCameraSettingShutterSpeed event
sl@0	402
sl@0	403	@param aShutterSpeed
sl@0	404	the required shutter speed in microseconds.
sl@0	405
sl@0	406	*/
sl@0	407	virtual void SetShutterSpeed(TInt aShutterSpeed)=0;
sl@0	408
sl@0	409	/**
sl@0	410	Get all supported metering modes on this device represented as bitfield of type TMeteringMode.
sl@0	411
sl@0	412	@return the set of supported metering modes.
sl@0	413	*/
sl@0	414	virtual TInt SupportedMeteringModes() const=0;
sl@0	415
sl@0	416	/**
sl@0	417	Get current metering mode.
sl@0	418
sl@0	419	@return a value of type TMeteringMode.
sl@0	420	*/
sl@0	421	virtual CCamera::CCameraAdvancedSettings::TMeteringMode MeteringMode() const=0;
sl@0	422
sl@0	423	/**
sl@0	424	Set the current metering mode. When set, all MCameraObserver2 clients are notified
sl@0	425	with a KUidECamEventCameraSettingMeteringMode event.
sl@0	426
sl@0	427	@param aMeteringMode
sl@0	428	a new selection for metering mode of type TMeteringMode.
sl@0	429	*/
sl@0	430	virtual void SetMeteringMode(CCamera::CCameraAdvancedSettings::TMeteringMode aMeteringMode)=0;
sl@0	431
sl@0	432	/**
sl@0	433	Get all supported drive modes as bitfields of TDriveMode type.
sl@0	434
sl@0	435	@return the set of supported drive modes.
sl@0	436	*/
sl@0	437	virtual TInt SupportedDriveModes() const=0;
sl@0	438
sl@0	439	/**
sl@0	440	Gets currently active drive mode.
sl@0	441
sl@0	442	@return current drive mode.
sl@0	443	*/
sl@0	444	virtual CCamera::CCameraAdvancedSettings::TDriveMode DriveMode() const=0;
sl@0	445
sl@0	446	/**
sl@0	447	Set the current metering mode. When set all MCameraObserver2 clients are notified with a
sl@0	448	KUidECamEventCameraSettingDriveMode event.
sl@0	449
sl@0	450	@param aDriveMode
sl@0	451	new selection for drive mode value of type TDriveMode.
sl@0	452
sl@0	453	@note Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or PerformantStopVideoCaptureL())
sl@0	454	if an image/video capture is still outstanding, this method may report error KErrInUse.
sl@0	455	*/
sl@0	456	virtual void SetDriveMode(CCamera::CCameraAdvancedSettings::TDriveMode aDriveMode)=0;
sl@0	457
sl@0	458	/**
sl@0	459	Get all supported bracket modes as bitfields.
sl@0	460
sl@0	461	@return the set of all supported bracket modes.
sl@0	462	*/
sl@0	463	virtual TInt SupportedBracketModes() const=0;
sl@0	464
sl@0	465	/**
sl@0	466	Get current bracket mode.
sl@0	467
sl@0	468	@return the current bracket mode TBracketMode.
sl@0	469	*/
sl@0	470	virtual CCamera::CCameraAdvancedSettings::TBracketMode BracketMode() const=0;
sl@0	471
sl@0	472	/**
sl@0	473	Set new bracket mode. All MCameraObserver2 clients are notified with a
sl@0	474	KUidECamEventCameraSettingBracketMode event.
sl@0	475
sl@0	476	@param aBracketMode
sl@0	477	new selection for bracket mode of type TBracketMode.
sl@0	478	*/
sl@0	479	virtual void SetBracketMode(CCamera::CCameraAdvancedSettings::TBracketMode aBracketMode)=0;
sl@0	480
sl@0	481	/**
sl@0	482	Get all supported bracket parameters as bitfields.
sl@0	483
sl@0	484	@return the set of all currently supported bracket modes.
sl@0	485	*/
sl@0	486	virtual TInt SupportedBracketParameters() const=0;
sl@0	487
sl@0	488	/**
sl@0	489	Get current bracket parameter.
sl@0	490
sl@0	491	@return the current bracket mode TBracketParameter.
sl@0	492	*/
sl@0	493	virtual CCamera::CCameraAdvancedSettings::TBracketParameter BracketParameter() const=0;
sl@0	494
sl@0	495	/**
sl@0	496	Set new bracket parameter
sl@0	497	When set all clients are notified with a
sl@0	498	KUidECamEventCameraSettingBracketParameter event.
sl@0	499
sl@0	500	@param aBracketParameter
sl@0	501	new selection for parameter type of type TBracketParameter.
sl@0	502	*/
sl@0	503	virtual void SetBracketParameter(CCamera::CCameraAdvancedSettings::TBracketParameter aBracketParameter)=0;
sl@0	504
sl@0	505	/**
sl@0	506	Get all supported bracket steps as bitfields.
sl@0	507
sl@0	508	@return the set of all supported bracket modes.
sl@0	509	*/
sl@0	510	virtual TInt SupportedBracketSteps() const=0;
sl@0	511
sl@0	512	/**
sl@0	513	Get current bracket step.
sl@0	514
sl@0	515	@return the current bracket mode TBracketStep.
sl@0	516	*/
sl@0	517	virtual CCamera::CCameraAdvancedSettings::TBracketStep BracketStep() const=0;
sl@0	518
sl@0	519	/**
sl@0	520	Set new bracket step. All MCameraObserver2 clients are notified with
sl@0	521	KUidECamEventCameraSettingBracketStep.
sl@0	522
sl@0	523	@param aBracketStep
sl@0	524	new selection for step of type TBracketStep.
sl@0	525	*/
sl@0	526	virtual void SetBracketStep(CCamera::CCameraAdvancedSettings::TBracketStep aBracketStep)=0;
sl@0	527
sl@0	528	/**
sl@0	529	Gets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
sl@0	530	@note there must be at least two images to merge. All are assumed to form a sequence and
sl@0	531	are identified using the first frame index and number of frames e.g. to merge two frames - one
sl@0	532	on and one +1, when in EBracketMode3Image, one sets the start index to 1 and frames to two.
sl@0	533	@note It is very much TBracketMode setting dependent.
sl@0	534
sl@0	535	@param aStartIndex
sl@0	536	the index of the start frame, starts from 0.
sl@0	537
sl@0	538	@param aFrames
sl@0	539	the number of frames to be merged.
sl@0	540	*/
sl@0	541	virtual void GetBracketMerge(TInt& aStartIndex, TInt& aFrames) const=0;
sl@0	542
sl@0	543	/**
sl@0	544	Sets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
sl@0	545	@note there must be at least two images to merge. All are assumed to form a sequence and
sl@0	546	are identified using the first frame index and number of frames e.g. to merge two frames - one
sl@0	547	on and one +1, when in EBracketMode3Image, one sets the start index to 1 and frames to 2.
sl@0	548	MCameraObserver2 clients are notified with a KUidECamEventBracketMerge event.
sl@0	549
sl@0	550	@note It is very TBracketMode setting dependent.
sl@0	551
sl@0	552	@param aStartIndex
sl@0	553	the index of the start frame, starts from 0.
sl@0	554
sl@0	555	@param aFrames
sl@0	556	the number of frames to be merged.
sl@0	557	*/
sl@0	558	virtual void SetBracketMerge(TInt aStartIndex, TInt aFrames)=0;
sl@0	559
sl@0	560	/**
sl@0	561	Get camera all supported flash modes CCamera::TFlash
sl@0	562
sl@0	563	@return the set of all supported flash modes as bitfields in an integer.
sl@0	564	*/
sl@0	565	virtual TInt SupportedFlashModes() const=0;
sl@0	566
sl@0	567	/**
sl@0	568	Gets the currently set flash mode.
sl@0	569
sl@0	570	@return The currently set flash mode.
sl@0	571	*/
sl@0	572	virtual CCamera::TFlash FlashMode() const=0;
sl@0	573
sl@0	574	/**
sl@0	575	Sets the flash mode.
sl@0	576
sl@0	577	Triggers a KUidECamEventCameraSettingFlashMode event to all camera
sl@0	578	MCameraObserver2 clients.
sl@0	579
sl@0	580	@param aMode
sl@0	581	The required flash mode.
sl@0	582	*/
sl@0	583	virtual void SetFlashMode(CCamera::TFlash aMode)=0;
sl@0	584
sl@0	585	/**
sl@0	586	Gets whether the flash red eye reduction is switched on.
sl@0	587
sl@0	588	@return The present state - ETrue for switched on and EFalse for switched off.
sl@0	589	*/
sl@0	590	virtual TBool RedEyeReduceOn() const=0;
sl@0	591
sl@0	592	/**
sl@0	593	Sets the flash red eye reduction on or off.
sl@0	594
sl@0	595	Triggers a KUidECamEventCameraSettingFlashRedEyeReduce event to all camera
sl@0	596	MCameraObserver2 clients.
sl@0	597
sl@0	598	@param aState
sl@0	599	The required state ETrue for switching it on and EFalse for switching it off.
sl@0	600	*/
sl@0	601	virtual void SetRedEyeReduceOn(TBool aState)=0;
sl@0	602
sl@0	603	/**
sl@0	604	Get flash compensation steps as integers multiplied by KECamFineResolutionFactor.
sl@0	605	For example 0.5 EV is 50.
sl@0	606
sl@0	607	@param aFlashCompensationSteps
sl@0	608	an RArray of integers which is populated on return to reflect the supported
sl@0	609	flash compensation steps.
sl@0	610
sl@0	611	@param aInfo
sl@0	612	an TValueInfo reference, which establishes the organization of the returned data.
sl@0	613
sl@0	614	@see TValueInfo
sl@0	615
sl@0	616	@leave KErrNoMemory Out of memory.
sl@0	617
sl@0	618	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	619	and the corresponding getter/setters for this feature should not be used.
sl@0	620	When camera device is incapable of revealing the flash compensation steps supported,
sl@0	621	it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty
sl@0	622	array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
sl@0	623	*/
sl@0	624	virtual void GetFlashCompensationStepsL(RArray<TInt>& aFlashCompensationSteps, TValueInfo& aInfo) const=0;
sl@0	625
sl@0	626	/**
sl@0	627	@deprecated Use TInt GetFlashCompensationStep(TInt& aFlashCompensationStep);
sl@0	628
sl@0	629	Get current flash power compensation step.
sl@0	630
sl@0	631	@return current flash compensation step.
sl@0	632	*/
sl@0	633	virtual TInt FlashCompensationStep() const=0;
sl@0	634
sl@0	635	/**
sl@0	636	Get current flash power compensation step.
sl@0	637
sl@0	638	@param aFlashCompensationStep
sl@0	639	Reference to the current flash power compensation step.
sl@0	640
sl@0	641	@return system wide error code.
sl@0	642	*/
sl@0	643	virtual TInt GetFlashCompensationStep(TInt& aFlashCompensationStep) const=0;
sl@0	644
sl@0	645	/**
sl@0	646	Set current flash compensation step as an integer multiplied by KECamFineResolutionFactor.
sl@0	647	For example to set a compensation of -0.3 EV, one should use a parameter with value -30.
sl@0	648	All clients receive a KUidECamEventCameraSettingFlashCompensationStep event, when the value has changed.
sl@0	649
sl@0	650	@param aFlashCompensationStep
sl@0	651	a new value for the flash compensation step.
sl@0	652	*/
sl@0	653	virtual void SetFlashCompensationStep(TInt aFlashCompensationStep)=0;
sl@0	654
sl@0	655	/**
sl@0	656	Get current flash power compensation range measured in a already selected compensation step.
sl@0	657	@note This range may change if a different compensation step is selected.
sl@0	658	For example if flash compensation range is in the range -1EV 1.5EV and the selected flash compensation
sl@0	659	step is selected to be 0.3 EV, the result of this call will be
sl@0	660	aNegativeCompensation = -3 and aPositiveCompensation = 5.
sl@0	661	as there can be only three full steps for negative compensation (1/0.3) and five for flash power boost (1.5/0.3).
sl@0	662	In this way developers, having pre-selected a step value from the supported set, would need to provide
sl@0	663	just the multplier (in steps) and the direction (the sign). Steps are always assumed integers.
sl@0	664
sl@0	665	@param aNegativeCompensation
sl@0	666	reference to an integer returning the maximum number of steps available for negative compensation.
sl@0	667
sl@0	668	@param aPositiveCompensation
sl@0	669	reference to an integer returning the maximum number of steps available for positive compensation.
sl@0	670	*/
sl@0	671	virtual void GetFlashCompensationRangeInSteps(TInt& aNegativeCompensation, TInt& aPositiveCompensation) const=0;
sl@0	672
sl@0	673	/**
sl@0	674	@deprecated Use TInt GetFlashCompensation(TInt& aFlashCompensation);
sl@0	675
sl@0	676	Get the current flash compensation value as integer steps. Positive values boost flash power,
sl@0	677	negative reduce flash power. The change is not cumulative i.e. the change is stateless.
sl@0	678	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	679
sl@0	680	@note if returned value is 2 (compensation steps) and the current flash compensation step is 0.3 EV,
sl@0	681	then the actual compensation effect will be 0.6 EV.
sl@0	682
sl@0	683	@return the current number compensation steps as an integer.
sl@0	684	*/
sl@0	685	virtual TInt FlashCompensation() const=0;
sl@0	686
sl@0	687	/**
sl@0	688	Get the current flash compensation value as integer steps. Positive values boost flash power,
sl@0	689	negative reduce flash power. The change is not cumulative i.e. the change is stateless.
sl@0	690	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	691
sl@0	692	@note if retrieved value is 2 (compensation steps) and the current flash compensation step is 0.3 EV,
sl@0	693	then the actual compensation effect will be 0.6 EV.
sl@0	694
sl@0	695	@param aFlashCompensation
sl@0	696	Reference to the current number of compensation steps as an integer.
sl@0	697
sl@0	698	@return system wide error code.
sl@0	699	*/
sl@0	700	virtual TInt GetFlashCompensation(TInt& aFlashCompensation) const=0;
sl@0	701
sl@0	702	/**
sl@0	703	Set the current flash compensation value as integer steps.
sl@0	704	Positive values increase power, negative reduce power. The change is not cumulative i.e. the change is stateless.
sl@0	705	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	706	Triggers a KUidECamEventCameraSettingFlashCompensation event.
sl@0	707
sl@0	708	@param aFlashCompensationSteps
sl@0	709	a required compensation steps - negative value reduce the flash power
sl@0	710	positive boosts up the flash power.
sl@0	711	*/
sl@0	712	virtual void SetFlashCompensation(TInt aFlashCompensationSteps)=0;
sl@0	713
sl@0	714	/**
sl@0	715	Check whether there is an external flash source.
sl@0	716
sl@0	717	@return ETrue if an external flash source is present, EFalse otherwise
sl@0	718	*/
sl@0	719	virtual TBool IsExternalFlashPresent() const=0;
sl@0	720
sl@0	721	/**
sl@0	722	Gets the current discrete manual flash power levels supported by the device in range 0-100
sl@0	723	as a percentage of maximum power level.
sl@0	724
sl@0	725	@param aManualFlashPowerLevels
sl@0	726	An empty array of TInt which would be populated by the implementation with
sl@0	727	the specific supported values. If the array is empty on return,
sl@0	728	the camera does not support this functionality.
sl@0	729	@param aInfo
sl@0	730	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	731
sl@0	732	@leave KErrNoMemory Out of memory.
sl@0	733
sl@0	734	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	735	and the corresponding getter/setters for this feature should not be used.
sl@0	736	When camera device is incapable of revealing the manual flash power levels supported,
sl@0	737	it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty
sl@0	738	array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
sl@0	739	*/
sl@0	740	virtual void GetManualFlashPowerLevelsL(RArray<TInt>& aManualFlashPowerLevels, TValueInfo& aInfo) const=0;
sl@0	741
sl@0	742	/**
sl@0	743	Gets the current manual flash power level on the device.
sl@0	744
sl@0	745	@return the current manual flash power level as a value in the range [0:100].
sl@0	746
sl@0	747	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	748	*/
sl@0	749	virtual TInt ManualFlashPowerLevel() const=0;
sl@0	750
sl@0	751	/**
sl@0	752	Sets the current manual flash power level on the device.
sl@0	753	Triggers a KUidECamEventCameraSettingFlashManualPower event to all MCameraObserver2 clients.
sl@0	754
sl@0	755	@param aManualFlashPowerLevel
sl@0	756	one of the values returned in GetManualFlashPowerLevelsL().
sl@0	757	*/
sl@0	758	virtual void SetManualFlashPowerLevel(TInt aManualFlashPowerLevel)=0;
sl@0	759
sl@0	760	/**
sl@0	761	Get Supported exposure modes - bitfields of CCamera::TExposure
sl@0	762
sl@0	763	@return the set of supported exposure modes.
sl@0	764	*/
sl@0	765	virtual TInt SupportedExposureModes() const=0;
sl@0	766
sl@0	767	/**
sl@0	768	Gets the currently set exposure setting value.
sl@0	769
sl@0	770	@return The currently set exposure setting value.
sl@0	771	*/
sl@0	772	virtual CCamera::TExposure ExposureMode() const=0;
sl@0	773
sl@0	774	/**
sl@0	775	Sets the exposure mode of the device.
sl@0	776
sl@0	777	Triggers a KUidECamEventCameraSettingExposureMode event to all MCameraObserver2 clients.
sl@0	778
sl@0	779	@param aExposureMode
sl@0	780	The required exposure adjustment.
sl@0	781	*/
sl@0	782	virtual void SetExposureMode(CCamera::TExposure aExposureMode)=0;
sl@0	783
sl@0	784	/**
sl@0	785	Get exposure compensation steps as integers multiplied by KECamFineResolutionFactor.
sl@0	786	For example 0.3 EV is 30.
sl@0	787
sl@0	788	@param aExposureCompensationSteps
sl@0	789	an RArray of integers which is populated to reflect the supported
sl@0	790	exposure compensation steps, all values have been multiplied by KECamFineResolutionFactor before
sl@0	791	truncated to integers.
sl@0	792
sl@0	793	@param aInfo
sl@0	794	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	795
sl@0	796	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	797
sl@0	798	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	799	and the corresponding getter/setters for this feature should not be used.
sl@0	800	When camera device is incapable of revealing the exposure compensation steps supported,
sl@0	801	it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty
sl@0	802	array should be returned and TValueInfo should be ENotActive, and the corresponding getter/setters for this feature should not be used.
sl@0	803	*/
sl@0	804	virtual void GetExposureCompensationStepsL(RArray<TInt>& aExposureCompensationSteps, TValueInfo& aInfo) const=0;
sl@0	805
sl@0	806	/**
sl@0	807	@deprecated Use TInt GetExposureCompensationStep(TInt& aExposureCompensationStep);
sl@0	808
sl@0	809	Get current exposure compensation step.
sl@0	810
sl@0	811	@return current exposure compensation step.
sl@0	812	*/
sl@0	813	virtual TInt ExposureCompensationStep() const=0;
sl@0	814
sl@0	815	/**
sl@0	816	Get current exposure compensation step.
sl@0	817
sl@0	818	@param aExposureCompensationStep
sl@0	819	Reference to the current exposure compensation step.
sl@0	820
sl@0	821	@return system wide error code.
sl@0	822	*/
sl@0	823	virtual TInt GetExposureCompensationStep(TInt& aExposureCompensationStep) const=0;
sl@0	824
sl@0	825	/**
sl@0	826	Set current exposure compensation step as an integer multiplied by KECamFineResolutionFactor.
sl@0	827	All MCameraObserver2 clients receive a KUidECamEventCameraSettingExposureCompensationStep event,
sl@0	828	when the value has changed.
sl@0	829
sl@0	830	@param aExposureCompensationStep
sl@0	831	a new value for the exposure compensation step.
sl@0	832	*/
sl@0	833	virtual void SetExposureCompensationStep(TInt aExposureCompensationStep)=0;
sl@0	834
sl@0	835	/**
sl@0	836	Get current exposure compensation range in steps. It depends on the previously
sl@0	837	selected exposure compensation step.
sl@0	838
sl@0	839	@param aNegativeCompensation
sl@0	840	reference to an integer returning the maximum number of steps
sl@0	841	available for negative compensation.
sl@0	842
sl@0	843	@param aPositiveCompensation
sl@0	844	reference to an integer returning the maximum number of steps
sl@0	845	available for positive compensation.
sl@0	846
sl@0	847	@see GetFlashCompensationRangeInSteps()
sl@0	848	*/
sl@0	849	virtual void GetExposureCompensationRangeInSteps(TInt& aNegativeCompensation, TInt& aPositiveCompensation) const=0;
sl@0	850
sl@0	851	/**
sl@0	852	@deprecated Use TInt GetExposureCompensation(TInt& aExposureCompensation);
sl@0	853
sl@0	854	Get the current exposure compensation value as integer steps. Positive values increase exposure times,
sl@0	855	negative reduce exposure times. The change is not cumulative i.e. the change is stateless.
sl@0	856	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	857
sl@0	858	@note if returned value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV,
sl@0	859	then the actual compensation effect will be 0.6 EV.
sl@0	860
sl@0	861	@return current number compensation steps as an integer.
sl@0	862	*/
sl@0	863	virtual TInt ExposureCompensation() const=0;
sl@0	864
sl@0	865	/**
sl@0	866	Get the current exposure compensation value as integer steps. Positive values increase exposure times,
sl@0	867	negative reduce exposure times. The change is not cumulative i.e. the change is stateless.
sl@0	868	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	869
sl@0	870	@note if retrieved value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV,
sl@0	871	then the actual compensation effect will be 0.6 EV.
sl@0	872
sl@0	873	@param aExposureCompensation
sl@0	874	Reference to the current number of compensation steps as an integer.
sl@0	875
sl@0	876	@return system wide error code.
sl@0	877	*/
sl@0	878	virtual TInt GetExposureCompensation(TInt& aExposureCompensation) const=0;
sl@0	879
sl@0	880	/**
sl@0	881	Set the current exposure compensation value as integer steps.
sl@0	882	Triggers a KUidECamEventCameraSettingExposureCompensation event to all MCameraObserver2 clients.
sl@0	883
sl@0	884	@param aExposureCompensationSteps
sl@0	885	a required compensation value negative value reduce the exposure time
sl@0	886	positive increases the exposure time.
sl@0	887
sl@0	888	*/
sl@0	889	virtual void SetExposureCompensation(TInt aExposureCompensationSteps)=0;
sl@0	890
sl@0	891	/**
sl@0	892	Gets camera supported set of white balance adjustments.
sl@0	893
sl@0	894	@return bitfield of all supported CCamera::TWhiteBalance values.
sl@0	895	*/
sl@0	896	virtual TInt SupportedWhiteBalanceModes() const=0;
sl@0	897
sl@0	898	/**
sl@0	899	Gets the current white balance value.
sl@0	900
sl@0	901	@return The current white balance value.
sl@0	902	*/
sl@0	903	virtual CCamera::TWhiteBalance WhiteBalanceMode() const=0;
sl@0	904
sl@0	905	/**
sl@0	906	Sets the white balance adjustment of the device.
sl@0	907
sl@0	908	No effect if this is not supported, see TCameraInfo::iWhiteBalanceModesSupported.
sl@0	909	Triggers a KUidECamEventCameraSettingWhiteBalanceMode event to all MCameraObserver2 clients.
sl@0	910
sl@0	911	@param aWhiteBalanceMode
sl@0	912	The required white balance mode.
sl@0	913	*/
sl@0	914	virtual void SetWhiteBalanceMode(CCamera::TWhiteBalance aWhiteBalanceMode)=0;
sl@0	915
sl@0	916	/**
sl@0	917	Gets the current state for aperture and exposure lock.
sl@0	918
sl@0	919	@return ETrue if aperture and exposure values are locked together,
sl@0	920	EFalse if these are not locked.
sl@0	921	*/
sl@0	922	virtual TBool ApertureExposureLockOn() const=0;
sl@0	923
sl@0	924	/**
sl@0	925	Sets the current state for aperture and exposure lock.
sl@0	926	Triggers a KUidECamEventAELock event to all MCameraObserver2 clients.
sl@0	927
sl@0	928	@param aAELock
sl@0	929	a value whether to lock exposure and aperture together.
sl@0	930	*/
sl@0	931	virtual void SetApertureExposureLockOn(TBool aAELock)=0;
sl@0	932
sl@0	933	/**
sl@0	934	Gets the current state for button clicking sound effect.
sl@0	935
sl@0	936	@return boolean, ETrue to switch clicking sound on, EFalse sound off
sl@0	937	*/
sl@0	938	virtual TBool ShootClickOn() const=0;
sl@0	939
sl@0	940	/**
sl@0	941	Sets the button clicking sound effect on /off. Triggers a KUidECamEventSoundClick event
sl@0	942	to all MCameraObserver2 clients.
sl@0	943
sl@0	944	@param aShootClickOn
sl@0	945	boolean, ETrue to switch clicking sound on, EFalse sound is switched off.
sl@0	946	*/
sl@0	947	virtual void SetShootClickOn(TBool aShootClickOn)=0;
sl@0	948
sl@0	949	/**
sl@0	950	Get camera supported timer values. Active only when drive mode EDriveModeTimed.
sl@0	951	Time is in microseconds. As time interval is expected to be relatively short,
sl@0	952	integer value is considered sufficient.
sl@0	953
sl@0	954	@param aTimerIntervals
sl@0	955	an RArray of integers which is populated to reflect the supported
sl@0	956	timer interval steps.
sl@0	957
sl@0	958	@param aInfo
sl@0	959	an TValueInfo reference, which establishes the organization of
sl@0	960	the returned data.
sl@0	961
sl@0	962	@see TValueInfo
sl@0	963
sl@0	964	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	965	and the corresponding getter/setters for this feature should not be used.
sl@0	966	*/
sl@0	967	virtual void GetTimerIntervalsL(RArray<TInt>& aTimerIntervals, TValueInfo& aInfo) const=0;
sl@0	968
sl@0	969	/**
sl@0	970	Get current timer value. Active only when drive mode is EDriveModeTimed.
sl@0	971	Timer resolution is in microseconds.
sl@0	972
sl@0	973	@return current time interval value.
sl@0	974
sl@0	975	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	976	*/
sl@0	977	virtual TInt TimerInterval() const=0;
sl@0	978
sl@0	979	/**
sl@0	980	Set current timer value. Active only when drive mode EDriveModeTimed.
sl@0	981	This is the time interval (delay) in microseconds between user pressing the button and image is taken.
sl@0	982	The setting of the value triggers a KUidECamEventCameraSettingTimerInterval event
sl@0	983	to all MCameraObserver2 clients.
sl@0	984
sl@0	985	@param aTimerInterval
sl@0	986	The selected timer interval in microseconds
sl@0	987	*/
sl@0	988	virtual void SetTimerInterval(TInt aTimerInterval)=0;
sl@0	989
sl@0	990	/**
sl@0	991	Get camera supported time lapse period range. Active only when drive mode EDriveModeTimeLapse.
sl@0	992	The time lapse is denoted as the uniform time period between consecutive frames.
sl@0	993
sl@0	994	@param aTimeLapseMin
sl@0	995	The minimum time value.
sl@0	996
sl@0	997	@param aTimeLapseMax
sl@0	998	The maximum time value.
sl@0	999	*/
sl@0	1000	virtual void GetTimeLapsePeriodRange(TTime& aTimeLapseMin, TTime& aTimeLapseMax) const=0;
sl@0	1001
sl@0	1002	/**
sl@0	1003	Get current time lapse value. Active only when drive mode EDriveModeTimeLapse.
sl@0	1004	The time lapse is denoted as the uniform time period
sl@0	1005	between consecutive frames and operation is configurable by its start, end and a fixed interval.
sl@0	1006	@param aStart
sl@0	1007	the start of the timelapse period
sl@0	1008	@param aEnd
sl@0	1009	the end of the timelapse period; start < end.
sl@0	1010	@param aInterval
sl@0	1011	the set parameter between two successive snapshots.
sl@0	1012	*/
sl@0	1013	virtual void GetTimeLapse(TTime& aStart, TTime& aEnd, TTime& aInterval) const=0;
sl@0	1014
sl@0	1015	/**
sl@0	1016	Set current time lapse value. Active only when drive mode EDriveModeTimeLapse.
sl@0	1017	The time lapse is denoted as the uniform time period between consecutive frames.
sl@0	1018	Setting triggers a KUidECamEventCameraSettingTimeLapse event to all MCameraObserver2 camera clients.
sl@0	1019
sl@0	1020	@param aStart
sl@0	1021	the start of the timelapse period.
sl@0	1022	@param aEnd
sl@0	1023	the end of the timelapse period; start < end.
sl@0	1024	@param aInterval
sl@0	1025	the set parameter between two successive snapshots.
sl@0	1026	*/
sl@0	1027	virtual void SetTimeLapse(const TTime& aStart, const TTime& aEnd, const TTime& aInterval)=0;
sl@0	1028
sl@0	1029	/**
sl@0	1030	Get current picture orientation.
sl@0	1031
sl@0	1032	@return a TPictureOrientation value.
sl@0	1033	*/
sl@0	1034	virtual CCamera::CCameraAdvancedSettings::TPictureOrientation PictureOrientation() const=0;
sl@0	1035
sl@0	1036	/**
sl@0	1037	Set a new picture orientation
sl@0	1038	This triggers a KUidECamEventCameraSettingPictureOrientation event to all MCameraObserver2 clients.
sl@0	1039
sl@0	1040	@param aOrientation
sl@0	1041	a value of TPictureOrientation denoting the new orientation.
sl@0	1042	*/
sl@0	1043	virtual void SetPictureOrientation(CCamera::CCameraAdvancedSettings::TPictureOrientation aOrientation)=0;
sl@0	1044
sl@0	1045	/**
sl@0	1046	Get supported pixel aspect ratio.
sl@0	1047
sl@0	1048	@return a bitfield of all supported TPixelAspectRatio values.
sl@0	1049	*/
sl@0	1050	virtual TInt SupportedPixelAspectRatios() const=0;
sl@0	1051	/**
sl@0	1052	Get current pixel aspect ratio.
sl@0	1053
sl@0	1054	@return a TPixelAspectRatio value.
sl@0	1055	*/
sl@0	1056	virtual CCamera::CCameraAdvancedSettings::TPixelAspectRatio PixelAspectRatio() const=0;
sl@0	1057
sl@0	1058	/**
sl@0	1059	Set a new pixel aspect ratio.
sl@0	1060	This triggers a KUidECamEventPixelAspectRatio event to all MCameraObserver2 clients.
sl@0	1061
sl@0	1062	@param aPixelAspectRatio
sl@0	1063	a value of TPixelAspectRatio denoting the new pixel aspect ratio.
sl@0	1064	*/
sl@0	1065	virtual void SetPixelAspectRatio(CCamera::CCameraAdvancedSettings::TPixelAspectRatio aPixelAspectRatio)=0;
sl@0	1066
sl@0	1067	/**
sl@0	1068	Get supported YUV ranges.
sl@0	1069
sl@0	1070	@return a bitfileld of all supported TYuvRange values.
sl@0	1071	*/
sl@0	1072	virtual TInt SupportedYuvRanges() const=0;
sl@0	1073
sl@0	1074	/**
sl@0	1075	Get the current YUV range.
sl@0	1076
sl@0	1077	@return a TYuvRange value.
sl@0	1078	*/
sl@0	1079	virtual CCamera::CCameraAdvancedSettings::TYuvRange YuvRange() const=0;
sl@0	1080
sl@0	1081	/**
sl@0	1082	Set a new YUV range.
sl@0	1083	This triggers a KUidECamEventYuvRange event to all MCameraObserver2 clients.
sl@0	1084
sl@0	1085	@param aYuvRange
sl@0	1086	a value of TYuvRange denoting the new YUV range.
sl@0	1087	*/
sl@0	1088	virtual void SetYuvRange(CCamera::CCameraAdvancedSettings::TYuvRange aYuvRange)=0;
sl@0	1089
sl@0	1090	/**
sl@0	1091	Get the number of images captured normally under EDriveModeBurst condition.
sl@0	1092	@note: due to memory or image size limitations the actual number may be less.
sl@0	1093
sl@0	1094	@return the number of images set to capture in burst mode.
sl@0	1095	*/
sl@0	1096	virtual TInt BurstImages() const=0;
sl@0	1097
sl@0	1098	/**
sl@0	1099	Set the number of images captured normally under EDriveModeBurst condition.
sl@0	1100	Triggers a KUidECamEventBurstImages event to all MCameraObserver2 clients.
sl@0	1101	@note: due to memory or image size limitations the actual number may be less.
sl@0	1102
sl@0	1103	@param aImages
sl@0	1104	the number of images set to capture in burst mode.
sl@0	1105
sl@0	1106	@note Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or PerformantStopVideoCaptureL())
sl@0	1107	if an image/video capture is still outstanding, this method may report error KErrInUse.
sl@0	1108	*/
sl@0	1109	virtual void SetBurstImages(TInt aImages)=0;
sl@0	1110
sl@0	1111	/**
sl@0	1112	Gets the optical zoom levels.
sl@0	1113
sl@0	1114	@param aOpticalZoomSteps
sl@0	1115	Array to hold optical zoom values multiplied by KECamFineResolutionFactor to retain precision.
sl@0	1116	So that if zoom is not supported the array will return a single element of value
sl@0	1117	KECamFineResolutionFactor.
sl@0	1118
sl@0	1119	@param aInfo
sl@0	1120	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1121
sl@0	1122	@note Such approach allows for support for both linear and non-linear zoom steps.
sl@0	1123	When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	1124	and the corresponding getter/setters for this feature should not be used.
sl@0	1125
sl@0	1126	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1127	*/
sl@0	1128	virtual void GetOpticalZoomStepsL(RArray<TInt>& aOpticalZoomSteps, TValueInfo& aInfo) const=0;
sl@0	1129
sl@0	1130	/**
sl@0	1131	Gets the currently set zoom value.
sl@0	1132
sl@0	1133	@return The currently set optical zoom value. The value is multiplied by
sl@0	1134	KECamFineResolutionFactor to retain precision.
sl@0	1135
sl@0	1136	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	1137	*/
sl@0	1138	virtual TInt OpticalZoom() const=0;
sl@0	1139
sl@0	1140	/**
sl@0	1141	Sets the zoom using a specific value. Triggers a KUidECamEventCameraSettingOpticalZoom
sl@0	1142	event to all MCameraObserver2 clients.
sl@0	1143
sl@0	1144	@param aOpticalZoom
sl@0	1145	Required zoom value.
sl@0	1146	*/
sl@0	1147	virtual void SetOpticalZoom(TInt aOpticalZoom)=0;
sl@0	1148
sl@0	1149	/**
sl@0	1150	Gets the digital zoom levels.
sl@0	1151
sl@0	1152	@param aDigitalZoomSteps
sl@0	1153	Array to hold digital zoom values multiplied by KECamFineResolutionFactor to retain precision.
sl@0	1154	So that if zoom is not supported the array will return a single element of value
sl@0	1155	KECamFineResolutionFactor.
sl@0	1156
sl@0	1157	@param aInfo
sl@0	1158	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1159
sl@0	1160	@note Such approach allows for support for both linear and non-linear zoom steps.
sl@0	1161	When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive
sl@0	1162	and the corresponding getter/setters for this feature should not be used.
sl@0	1163
sl@0	1164	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1165	*/
sl@0	1166	virtual void GetDigitalZoomStepsL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo) const=0;
sl@0	1167
sl@0	1168	/**
sl@0	1169	Gets the currently set digital zoom value.
sl@0	1170
sl@0	1171	@return The currently set digital zoom value. The value is multiplied by
sl@0	1172	KECamFineResolutionFactor to retain precision.
sl@0	1173
sl@0	1174	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	1175	*/
sl@0	1176	virtual TInt DigitalZoom() const=0;
sl@0	1177
sl@0	1178	/**
sl@0	1179	Sets the digital zoom value. Triggers a KUidECamEventCameraSettingDigitalZoom event
sl@0	1180	to all MCameraObserver2 clients.
sl@0	1181
sl@0	1182	@param aDigitalZoom
sl@0	1183	Required zoom value.
sl@0	1184
sl@0	1185	*/
sl@0	1186	virtual void SetDigitalZoom(TInt aDigitalZoom)=0;
sl@0	1187
sl@0	1188	/**
sl@0	1189	Checks whether exposure value is locked or not.
sl@0	1190
sl@0	1191	@return whether exposure value is locked or not.
sl@0	1192	ETrue if locked, EFalse otherwise.
sl@0	1193	*/
sl@0	1194	virtual TBool ExposureLockOn() const=0;
sl@0	1195
sl@0	1196	/**
sl@0	1197	Sets exposure lock state. Triggers a KUidECamEventCameraSettingExposureLock event
sl@0	1198	to all MCameraObserver2 clients.
sl@0	1199
sl@0	1200	@param aState
sl@0	1201	Required new state.
sl@0	1202	*/
sl@0	1203	virtual void SetExposureLockOn(TBool aState)=0;
sl@0	1204
sl@0	1205	/**
sl@0	1206	Checks whether AutoFocus value is locked or not.
sl@0	1207
sl@0	1208	@return whether AutoFocus value is locked or not.
sl@0	1209	ETrue if locked, EFalse otherwise.
sl@0	1210	*/
sl@0	1211	virtual TBool AutoFocusLockOn() const=0;
sl@0	1212
sl@0	1213	/**
sl@0	1214	Sets autofocus lock state. Triggers a KUidECamEventCameraSettingAutoFocusLock event
sl@0	1215	to all MCameraObserver2 clients.
sl@0	1216
sl@0	1217	@param aState
sl@0	1218	Required new state.
sl@0	1219	*/
sl@0	1220	virtual void SetAutoFocusLockOn(TBool aState)=0;
sl@0	1221
sl@0	1222	/**
sl@0	1223	Gets an array of all the advanced settings parameters supported by the device.
sl@0	1224	These are identified by UIDs and relate to the set or subset of it of all defined settings UIDs.
sl@0	1225
sl@0	1226	@param aSettings
sl@0	1227	An empty array of TUids which would be populated by the implementation with
sl@0	1228	the UIDs of the supported parameters. If the array is empty on return,
sl@0	1229	the camera does not support any settings.
sl@0	1230
sl@0	1231	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1232	*/
sl@0	1233	virtual void GetSupportedSettingsL(RArray<TUid>& aSettings) const=0;
sl@0	1234
sl@0	1235	/**
sl@0	1236	Gets an array of all the advanced settings parameters currently active on the device.
sl@0	1237	These are identified by UIDs and relate to the set or subset of it of all supported
sl@0	1238	settings UIDs.
sl@0	1239
sl@0	1240	@param aActiveSettings
sl@0	1241	An empty array of TUids which would be populated by the implementation with
sl@0	1242	the active setting UIDs. If the array is empty on return,
sl@0	1243	the camera does not support any settings.
sl@0	1244
sl@0	1245	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1246	*/
sl@0	1247	virtual void GetActiveSettingsL(RArray<TUid>& aActiveSettings) const=0;
sl@0	1248
sl@0	1249	/**
sl@0	1250	Gets an array of all the advanced settings parameters currently disabled on the device.
sl@0	1251	These are identified by UIDs and relate to the set or subset of it of all supported
sl@0	1252	settings UIDs.
sl@0	1253
sl@0	1254	@param aDisabledSettings
sl@0	1255	An empty array of TUids which would be populated by the implementation with
sl@0	1256	the disabled setting UIDs. If the array is empty on return,
sl@0	1257	the camera does not support any settings.
sl@0	1258
sl@0	1259	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1260	*/
sl@0	1261	virtual void GetDisabledSettingsL(RArray<TUid>& aDisabledSettings) const=0;
sl@0	1262
sl@0	1263	/**
sl@0	1264	Retrieves the state for automatic size selection option. Default value is EFalse.
sl@0	1265
sl@0	1266	@return ETrue if the automatic selection is switched on. Default value is EFalse.
sl@0	1267	*/
sl@0	1268	virtual TBool AutomaticSizeSelectionChangeOn() const=0;
sl@0	1269
sl@0	1270	/**
sl@0	1271	Allow camera to proactively change image size due external factors.
sl@0	1272	Default value is EFalse. Triggers a KUidECamEventCameraSettingAutomaticSizeSelection event notification.
sl@0	1273	@param aSetOn
sl@0	1274	whether the option should be switched on
sl@0	1275	*/
sl@0	1276	virtual void SetAutomaticSizeSelectionChangeOn(TBool aSetOn)=0;
sl@0	1277
sl@0	1278	/**
sl@0	1279	Retrieves the timeout values camera supported by the camera when in continuous auto focus mode.
sl@0	1280	Timeouts are in microseconds.
sl@0	1281
sl@0	1282	@param aTimeouts
sl@0	1283	An empty array to hold timeout values.
sl@0	1284
sl@0	1285	@param aInfo
sl@0	1286	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1287
sl@0	1288	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1289
sl@0	1290	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive
sl@0	1291	and the corresponding getter/setters for this feature should not be used.
sl@0	1292	*/
sl@0	1293	virtual void GetSupportedContinuousAutoFocusTimeoutsL(RArray<TInt>& aTimeouts, TValueInfo& aInfo) const=0;
sl@0	1294
sl@0	1295	/**
sl@0	1296	Gets the current value for continuous autofocus timeout. Timeouts are in microseconds.
sl@0	1297
sl@0	1298	@return the timeout value in microseconds.
sl@0	1299
sl@0	1300	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	1301	*/
sl@0	1302	virtual TInt ContinuousAutoFocusTimeout() const=0;
sl@0	1303
sl@0	1304	/**
sl@0	1305	Sets new value for continuous autofocus timeout. Timeouts are in microseconds.
sl@0	1306	All MCameraObserver2 clients of the camera receive a
sl@0	1307	KUidECamEventCameraSettingsContinuousAutoFocusTimeout
sl@0	1308	event notification when timeout value is changed.
sl@0	1309
sl@0	1310	@param aTimeout
sl@0	1311	a new timeout value in microseconds.
sl@0	1312	*/
sl@0	1313	virtual void SetContinuousAutoFocusTimeout(TInt aTimeout)=0;
sl@0	1314
sl@0	1315	/**
sl@0	1316	Gets all supported stabilization effects on the device.
sl@0	1317
sl@0	1318	@return an integer - a bitfield of all supported TStabilizationEffect values.
sl@0	1319	*/
sl@0	1320	virtual TInt SupportedStabilizationEffects() const=0;
sl@0	1321
sl@0	1322	/**
sl@0	1323	Gets current active stabilization effect on the device.
sl@0	1324
sl@0	1325	@return a TStabilizationEffect value.
sl@0	1326	*/
sl@0	1327	virtual CCamera::CCameraAdvancedSettings::TStabilizationEffect StabilizationEffect() const=0;
sl@0	1328
sl@0	1329	/**
sl@0	1330	Sets a specific stabilization effect on the device.
sl@0	1331	When a value is set, MCameraObserver2 clients for that camera will receive a
sl@0	1332	KUidECamEventCameraSettingsStabilizationEffect event notification.
sl@0	1333
sl@0	1334	@param aEffect
sl@0	1335	stabilization effect selection of type TStabilizationEffect.
sl@0	1336	*/
sl@0	1337	virtual void SetStabilizationEffect(CCamera::CCameraAdvancedSettings::TStabilizationEffect aEffect)=0;
sl@0	1338
sl@0	1339	/**
sl@0	1340	Gets all supported stabilization algorithm values on the device.
sl@0	1341
sl@0	1342	@return an integer - a bitfield of all supported TStabilizationAlgorithmComplexity values.
sl@0	1343	*/
sl@0	1344	virtual TInt SupportedStabilizationComplexityValues() const=0;
sl@0	1345
sl@0	1346	/**
sl@0	1347	Gets current active stabilization algorithm selection on the device.
sl@0	1348
sl@0	1349	@return a TStabilizationAlgorithmComplexity value.
sl@0	1350	*/
sl@0	1351	virtual CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity StabilizationComplexity() const=0;
sl@0	1352
sl@0	1353	/**
sl@0	1354	Sets a specific stabilization algorithm on the device.
sl@0	1355	When a value is set, MCameraObserver2 clients for that camera will receive a
sl@0	1356	KUidECamEventSettingsStabilizationAlgorithmComplexity event notification.
sl@0	1357
sl@0	1358	@param aComplexity
sl@0	1359	stabilization effect selection of type TStabilizationAlgorithmComplexity.
sl@0	1360	*/
sl@0	1361	virtual void SetStabilizationComplexity(CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity aComplexity)=0;
sl@0	1362
sl@0	1363	/**
sl@0	1364	Gets the units in which the white balance is measured on the device. The methods used to get
sl@0	1365	or set these differ depending on the supported unit type.
sl@0	1366	It is expected that a device will support only a single type or none.
sl@0	1367
sl@0	1368	@return a value of TWBUnits type.
sl@0	1369	*/
sl@0	1370	virtual CCamera::CCameraAdvancedSettings::TWBUnits SupportedWBUnits() const=0;
sl@0	1371
sl@0	1372	/**
sl@0	1373	Get white balance value represented as a RGB triplet (TRgb)
sl@0	1374
sl@0	1375	@param aValue
sl@0	1376	a reference to TRgb object which will contain the current white balance.
sl@0	1377	*/
sl@0	1378	virtual void GetWBRgbValue(TRgb& aValue) const=0;
sl@0	1379
sl@0	1380	/**
sl@0	1381	Set white balance value using a RGB triplet (TRgb).
sl@0	1382	Change in value causes an event notification KUidECamEventCameraSettingsWBValue
sl@0	1383	to be sent to all MCameraObserver2 clients of this camera.
sl@0	1384
sl@0	1385	@param aValue
sl@0	1386	a const reference to TRgb object, which contains the new white balance.
sl@0	1387	*/
sl@0	1388	virtual void SetWBRgbValue(const TRgb& aValue)=0;
sl@0	1389
sl@0	1390	/**
sl@0	1391	Get the white balance values, as temperature measured in Kelvin, supported on the device.
sl@0	1392
sl@0	1393	@param aWBColorTemperatures
sl@0	1394	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	1395	the specific supported values.
sl@0	1396
sl@0	1397	@param aInfo
sl@0	1398	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1399
sl@0	1400	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	1401	and the corresponding getter/setters for this feature should not be used.
sl@0	1402	*/
sl@0	1403	virtual void GetWBSupportedColorTemperaturesL(RArray<TInt>& aWBColorTemperatures, TValueInfo& aInfo) const=0;
sl@0	1404
sl@0	1405	/**
sl@0	1406	Get the white balance as a temperature in Kelvin.
sl@0	1407
sl@0	1408	@return current white balance value as a temperature in Kelvins.
sl@0	1409
sl@0	1410	@note In case there is an error, a negative error value from system wide error should be returned.
sl@0	1411	*/
sl@0	1412	virtual TInt WBColorTemperature() const=0;
sl@0	1413
sl@0	1414	/**
sl@0	1415	Set white balance value using a temperature, measured in Kelvin.
sl@0	1416	Change in value causes an event notification KUidECamEventCameraSettingsWBValue
sl@0	1417	to be sent to all MCameraObserver2 clients of this camera.
sl@0	1418
sl@0	1419	@param aWBColorTemperature
sl@0	1420	the new white balance value in Kelvin.
sl@0	1421	*/
sl@0	1422	virtual void SetWBColorTemperature(TInt aWBColorTemperature)=0;
sl@0	1423	};
sl@0	1424
sl@0	1425
sl@0	1426	/**
sl@0	1427	Mixin class for implementation by providers of some enhanced functionalities of the
sl@0	1428	Advanced Settings Camera Extension API.
sl@0	1429
sl@0	1430	@publishedPartner
sl@0	1431	@released
sl@0	1432	*/
sl@0	1433	class MCameraAdvancedSettings2
sl@0	1434	{
sl@0	1435
sl@0	1436	public:
sl@0	1437	/**
sl@0	1438	Releases the interface.
sl@0	1439	*/
sl@0	1440	virtual void Release()=0;
sl@0	1441
sl@0	1442	/**
sl@0	1443	Checks whether the flash is ready.
sl@0	1444
sl@0	1445	@param aReady
sl@0	1446	A reference to a boolean set by the implementation to ETrue if the flash is ready,
sl@0	1447	EFalse otherwise.
sl@0	1448
sl@0	1449	@return KErrNotSupported if the implementation of this method is not supported.
sl@0	1450	*/
sl@0	1451	virtual TInt IsFlashReady(TBool& aReady) const=0;
sl@0	1452
sl@0	1453	/**
sl@0	1454	Get the number of focus steps for current focus mode.
sl@0	1455
sl@0	1456	@param aFocusModeSteps
sl@0	1457	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	1458	the specific supported values.
sl@0	1459
sl@0	1460	@param aInfo
sl@0	1461	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1462
sl@0	1463	@leave KErrNotSupported if the implementation of this method is not supported. May also leave as a result of other system errors.
sl@0	1464
sl@0	1465	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	1466	and the corresponding getter/setters for this feature should not be used.
sl@0	1467	*/
sl@0	1468	virtual void GetCurrentFocusModeStepsL(RArray<TInt>& aFocusModeSteps, TValueInfo& aInfo) const=0;
sl@0	1469	};
sl@0	1470
sl@0	1471	/**
sl@0	1472	Mixin class for implementation by providers of 'some of the enhanced functionalities' of the
sl@0	1473	Advanced Settings Camera Extension API.
sl@0	1474
sl@0	1475	@publishedPartner
sl@0	1476	@released
sl@0	1477	*/
sl@0	1478	class MCameraAdvancedSettings3
sl@0	1479	{
sl@0	1480
sl@0	1481	public:
sl@0	1482	/**
sl@0	1483	Releases the interface.
sl@0	1484	*/
sl@0	1485	virtual void Release()=0;
sl@0	1486
sl@0	1487	/**
sl@0	1488	Gets all supported ISO types on the device.
sl@0	1489
sl@0	1490	@param aSupportedISORateTypes
sl@0	1491	A reference to an integer which is a bitfield of all supported TISORateType values.
sl@0	1492	EISONone means feature is not supported.
sl@0	1493
sl@0	1494	@leave May leave as a result of some error.
sl@0	1495	*/
sl@0	1496	virtual void GetSupportedISORateTypeL(TInt& aSupportedISORateTypes) const=0;
sl@0	1497
sl@0	1498	/**
sl@0	1499	Set the type of ISO rate and the exposure parameter or value specified.
sl@0	1500
sl@0	1501	@param aISORateType
sl@0	1502	The type of ISO rate to be set.
sl@0	1503
sl@0	1504	@param aParam
sl@0	1505	Depending on the value of aISORateType, possible values of aParam are one of the following:-
sl@0	1506	The value of ISO rate to be used in case of manual type of ISO rate (EISOManual).
sl@0	1507	OR
sl@0	1508	Redundant parameter in case of unprioritised type of auto ISO (EISOAutoUnPrioritised). It is left to the camera hardware/firmware
sl@0	1509	to decide how the ISO rate is selected. No priority regarding exposure is specified.
sl@0	1510	OR
sl@0	1511	Highest ISO rate to be picked by the camera while deciding for the best exposure in case of ISO prioritised
sl@0	1512	type of auto ISO (EISOAutoISOPrioritised). ISO rate closest to this (and lower) may be used so that best possible exposure is achieved.
sl@0	1513	OR
sl@0	1514	Slowest shutter speed to be picked by the camera while deciding for the best exposure in case of shutter speed
sl@0	1515	prioritised type of auto ISO (EISOAutoShutterSpeedPrioritised). After using this shutter speed, ISO rate is chosen by the camera to achieve
sl@0	1516	proper exposure. Shutter speed closest to this (and faster) may be used so that best possible exposure is achieved.
sl@0	1517	OR
sl@0	1518	Minimum aperture opening (deepest depth of field) to be picked by the camera while deciding
sl@0	1519	for the best exposure in case of aperture prioritised type of auto ISO (EISOAutoAperturePrioritised). After using this aperture opening, ISO
sl@0	1520	rate is chosen by the camera to achieve proper exposure. Aperture opening closest to this (and wider) may be
sl@0	1521	used to achieve best possible exposure.
sl@0	1522
sl@0	1523	@note Triggers KUidECamEventCameraSettingIsoRateType to all MCameraObserver2 clients of the camera.
sl@0	1524	Uses HandleEvent to report the result or any possible error.
sl@0	1525	*/
sl@0	1526	virtual void SetISORate(CCamera::CCameraAdvancedSettings::TISORateType aISORateType, TInt aParam)=0;
sl@0	1527
sl@0	1528	/**
sl@0	1529	Get the type of ISO rate, exposure parameter and value set.
sl@0	1530
sl@0	1531	@param aISORateType
sl@0	1532	A reference to the type of ISO rate set. EISONone means feature is not supported.
sl@0	1533
sl@0	1534	@param aParam
sl@0	1535	Depending on the value of aISORateType, possible values of aParam are one of the following:-
sl@0	1536	A reference to the redundant parameter in case of manual type of ISO rate(EISOManual)
sl@0	1537	OR
sl@0	1538	A reference to the redundant parameter in case of unprioritised type of auto ISO(EISOAutoUnPrioritised)
sl@0	1539	OR
sl@0	1540	A reference to the highest ISO rate that may be picked up in case of ISO prioritised type of auto ISO(EISOAutoISOPrioritised)
sl@0	1541	OR
sl@0	1542	A reference to the slowest shutter speed that may be picked up in case of shutter speed prioritised type of auto ISO(EISOAutoShutterSpeedPrioritised)
sl@0	1543	OR
sl@0	1544	A reference to the minimum aperture opening that may be picked up in case of aperture prioritised type of auto ISO(EISOAutoAperturePrioritised)
sl@0	1545
sl@0	1546	@param aISORate
sl@0	1547	A reference to the value of ISO rate currently being used, if camera device is capable of doing that.
sl@0	1548	Otherwise KErrNotFound should be retrieved indicating the incapability of camera.
sl@0	1549
sl@0	1550	@leave May leave as a result of some other error.
sl@0	1551
sl@0	1552	@note Since camera hardware may be incapable of providing the actual ISO value when one of the auto ISO type has
sl@0	1553	been set, then, in these cases, the 3rd argument should be retrieved as KErrNotFound.
sl@0	1554	*/
sl@0	1555	virtual void GetISORateL(CCamera::CCameraAdvancedSettings::TISORateType& aISORateType, TInt& aParam, TInt& aISORate) const=0;
sl@0	1556
sl@0	1557	/**
sl@0	1558	Provide reference screen for orientation information.
sl@0	1559
sl@0	1560	@param aScreenDevice
sl@0	1561	A reference to the screen device.
sl@0	1562
sl@0	1563	@note For consistency, when DSA view finder runs, it also provides a screen device. So, the DSA view finder's internal implementation
sl@0	1564	should call this method with the screen device passed ( 2nd argument to DSA view finder) to avoid disparity in knowing the refeence screen.
sl@0	1565	Triggers KUidECamEventCameraSettingReferenceScreen to all MCameraObserver2 clients of the camera.
sl@0	1566	Uses HandleEvent to report the result or any possible error.
sl@0	1567	*/
sl@0	1568	virtual void SetReferenceScreen(CWsScreenDevice& aScreenDevice)=0;
sl@0	1569
sl@0	1570	/**
sl@0	1571	Get the digital zoom steps for the still image when a particular image format and size are specified.
sl@0	1572
sl@0	1573	@param aDigitalZoomSteps
sl@0	1574	A reference to an empty array of TInt to hold digital zoom step values for still image and multiplied by
sl@0	1575	KECamFineResolutionFactor to retain precision. If list returned is empty, this means feature is not supported.
sl@0	1576
sl@0	1577	@param aInfo
sl@0	1578	A reference to TValueInfo, which establishes the type of the returned data.
sl@0	1579
sl@0	1580	@param aSizeIndex
sl@0	1581	A value providing the size index which must be in the range 0 to TCameraInfo::iNumImageSizesSupported-1
sl@0	1582	inclusive.
sl@0	1583
sl@0	1584	@param aFormat
sl@0	1585	A value providing the image format which must be one of the formats supported. (see
sl@0	1586	TCameraInfo::iImageFormatsSupported)
sl@0	1587
sl@0	1588	@param aIsInfluencePossible
sl@0	1589	If True, signals that digital zoom step values may be influenced by some hardware factor like stabilization etc.
sl@0	1590	If False, no influence possible.
sl@0	1591
sl@0	1592	@leave KErrNoMemory Out of memory. May leave with any other error code.
sl@0	1593
sl@0	1594	@note This method retrieves the supported digital zoom steps irrespective of any stabilization influence.
sl@0	1595	In case of stabilization etc. influence, the setting function should set the best possible digital zoom value
sl@0	1596	and return error KErrECamDigitalZoomLimited along with dedicated event.
sl@0	1597
sl@0	1598	@note When camera device doesn't support this feature, empty array should be returned and TValueInfo should be ENotActive,
sl@0	1599	and the corresponding getter/setters for this feature should not be used.
sl@0	1600
sl@0	1601	@note Implementation recommendation for old methods which are used to retrieve the supported digital zoom values, is
sl@0	1602	to provide only safe values suitable in every cases.
sl@0	1603	*/
sl@0	1604	virtual void GetDigitalZoomStepsForStillL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo, TInt aSizeIndex,
sl@0	1605	CCamera::TFormat aFormat, TBool& aIsInfluencePossible) const=0;
sl@0	1606
sl@0	1607	/**
sl@0	1608	Get the digital zoom steps for the video when a particular video frame format, size and rate are specified.
sl@0	1609
sl@0	1610	@param aDigitalZoomSteps
sl@0	1611	A reference to an empty array of TInt to hold digital zoom step values for video and multiplied by
sl@0	1612	KECamFineResolutionFactor to retain precision. If list returned is empty, this means feature is not supported.
sl@0	1613
sl@0	1614	@param aInfo
sl@0	1615	A reference to TValueInfo, which establishes the type of the returned data.
sl@0	1616
sl@0	1617	@param aFrameRateIndex
sl@0	1618	A value providing the rate index must be in the range 0 to TCameraInfo::iNumVideoFrameRatesSupported-1
sl@0	1619	inclusive.
sl@0	1620
sl@0	1621	@param aSizeIndex
sl@0	1622	A value providing the size index which must be in the range 0 to TCameraInfo::iNumVideoFrameSizesSupported-1
sl@0	1623	inclusive.
sl@0	1624
sl@0	1625	@param aFormat
sl@0	1626	A value providing the format which must be one of the video frame formats supported. (see
sl@0	1627	TCameraInfo::iVideoFrameFormatsSupported)
sl@0	1628
sl@0	1629	@param aIsInfluencePossible
sl@0	1630	If True, signals that digital zoom step values may be influenced by some hardware factor like stabilization etc.
sl@0	1631	If False, no influence possible.
sl@0	1632
sl@0	1633	@param aExposure
sl@0	1634	The exposure mode.
sl@0	1635
sl@0	1636	@leave KErrNoMemory Out of memory. May leave with any other error code.
sl@0	1637
sl@0	1638	@note This method retrieves the supported digital zoom steps irrespective of any stabilization influence.
sl@0	1639	In case of stabilization etc. influence, the setting function should set the best possible digital zoom value
sl@0	1640	and return error KErrECamDigitalZoomLimited along with dedicated event.
sl@0	1641
sl@0	1642	@note When camera device doesn't support this, empty array should be returned and TValueInfo should be ENotActive,
sl@0	1643	and the corresponding getter/setters for this feature should not be used.
sl@0	1644
sl@0	1645	@note Implementation recommendation for old methods which are used to retrieve the supported digital zoom values, is
sl@0	1646	to provide only safe values suitable in every cases.
sl@0	1647	*/
sl@0	1648	virtual void GetDigitalZoomStepsForVideoL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo, TInt aFrameRateIndex,
sl@0	1649	TInt aSizeIndex, CCamera::TFormat aFormat, TBool& aIsInfluencePossible, CCamera::TExposure aExposure) const=0;
sl@0	1650	/**
sl@0	1651	Retrieves the pre capture warnings supported for a given camera mode
sl@0	1652
sl@0	1653	@param aCameraMode
sl@0	1654	Desired camera mode for which the supported pre capture warnings may be retrieved.
sl@0	1655
sl@0	1656	@param aPreCaptureWarningSupported
sl@0	1657	A bitfield of all supported TPreCaptureWarning to be issued in the given camera mode.
sl@0	1658	If no pre capture warning supported for the given camera mode, EPCWNone is retrieved.
sl@0	1659
sl@0	1660	@leave May leave with any error.
sl@0	1661	*/
sl@0	1662	virtual void GetPreCaptureWarningSupportedL(CCamera::CCameraAdvancedSettings::TCameraMode aCameraMode, TInt& aPreCaptureWarningSupported) const=0;
sl@0	1663
sl@0	1664	/**
sl@0	1665	Subscribe in order to receive event which indicates warnings on occurrence of some specific unfavourable
sl@0	1666	conditions before image/video capture.
sl@0	1667
sl@0	1668	@param aPreCaptureWarning
sl@0	1669	A bitfield specifying all the TPreCaptureWarning types to be subscribed for.
sl@0	1670
sl@0	1671	@note When any of the subscribed warnings (represented by aPreCaptureWarning) get generated by the camera device,
sl@0	1672	event KUidECamEventCameraSettingPreCaptureWarning is issued. TECAMEvent2 class should be used in order to
sl@0	1673	provide the status of every PreCaptureWarning.
sl@0	1674
sl@0	1675	@leave May leave with any error.
sl@0	1676	*/
sl@0	1677	virtual void SubscribeToPreCaptureWarningL(TInt aPreCaptureWarning)=0;
sl@0	1678
sl@0	1679	/**
sl@0	1680	Unsubscribe so that further events are not received when warnings get issued.
sl@0	1681
sl@0	1682	@leave May leave with any error.
sl@0	1683	*/
sl@0	1684	virtual void UnSubscribePreCaptureWarningL()=0;
sl@0	1685
sl@0	1686	/**
sl@0	1687	Get the status of every warnings defined.
sl@0	1688
sl@0	1689	@param aPreCaptureWarning
sl@0	1690	A reference to the integer - bitfield representing all the TPreCaptureWarning types issued.
sl@0	1691
sl@0	1692	@leave May leave with any error.
sl@0	1693
sl@0	1694	@note This method may be called after receiving the event KUidECamEventCameraSettingPreCaptureWarning OR
sl@0	1695	user may also opt for polling on this.
sl@0	1696	*/
sl@0	1697	virtual void GetPreCaptureWarningL(TInt& aPreCaptureWarning) const=0;
sl@0	1698
sl@0	1699	/**
sl@0	1700	Retrieve the different supported AF assistant light.
sl@0	1701
sl@0	1702	@param aSupportedAFAssistantLight
sl@0	1703	A reference to integer - bitfield indicating the supported AF assistant light.
sl@0	1704	If EAFAssistantLightOff, this means AF assistant light is not supported.
sl@0	1705	If EAFAssistantLightManualOn, then manual AF assistant light is supported.
sl@0	1706	If EAFAssistantLightAuto, auto assistant light is supported.
sl@0	1707	If combination of EAFAssistantLightManualOn\|\|EAFAssistantLightAuto , then both manual and Auto assistant light are supported.
sl@0	1708
sl@0	1709	@leave May leave with any error.
sl@0	1710	*/
sl@0	1711	virtual void GetSupportedAFAssistantLightL(TInt& aSupportedAFAssistantLight) const=0;
sl@0	1712
sl@0	1713	/**
sl@0	1714	Get the type ( and state) of AF assistant light currently set.
sl@0	1715
sl@0	1716	@param aAFAssistantLight
sl@0	1717	A reference to AF assistant light.
sl@0	1718	If EAFAssistantLightOff, then manual and auto assistant light are switched off.
sl@0	1719	If EAFAssistantLightManualOn, manual assistant light is switched on.
sl@0	1720	If EAFAssistantLightAuto, AF assistant light is set to auto.
sl@0	1721
sl@0	1722	@leave May leave with any error.
sl@0	1723	*/
sl@0	1724	virtual void GetAFAssistantLightL(CCamera::CCameraAdvancedSettings::TAFAssistantLight& aAFAssistantLight) const=0;
sl@0	1725
sl@0	1726	/**
sl@0	1727	Set a particular type ( and state) of AF assistant light.
sl@0	1728
sl@0	1729	@param aAFAssistantLight
sl@0	1730	Type of AF assistant light to be set.
sl@0	1731	If EAFAssistantLightOff, switch off the manual or auto assistant light.
sl@0	1732	If EAFAssistantLightManualOn, manually switch on the assistant light.
sl@0	1733	If EAFAssistantLightAuto, camera will automatically switch it on/off as per the conditions.
sl@0	1734
sl@0	1735	@note Triggers KUidECamEventCameraSettingAFAssistantLight to all MCameraObserver2 clients of the camera.
sl@0	1736	Uses HandleEvent to report the result or any possible error.
sl@0	1737	*/
sl@0	1738	virtual void SetAFAssistantLight(CCamera::CCameraAdvancedSettings::TAFAssistantLight aAFAssistantLight)=0;
sl@0	1739	};
sl@0	1740
sl@0	1741	/**
sl@0	1742	Mixin class for implementation by providers of 'advanced camera feature extensions' of the
sl@0	1743	Advanced Settings Camera Extension API.
sl@0	1744
sl@0	1745	@publishedPartner
sl@0	1746	@prototype
sl@0	1747	*/
sl@0	1748	class MCameraAdvancedSettings4
sl@0	1749	{
sl@0	1750
sl@0	1751	public:
sl@0	1752	/**
sl@0	1753	Releases the interface.
sl@0	1754	*/
sl@0	1755	virtual void Release()=0;
sl@0	1756
sl@0	1757	/**
sl@0	1758	Retrieves the supported continuous zoom types.
sl@0	1759
sl@0	1760	@param aSupportedContinuousZoomType
sl@0	1761	Retrieves a bitfield of TUint which indicates the supported continuous zoom type as given by
sl@0	1762	CCamera::CCameraAdvancedSettings::TContinuousZoomType
sl@0	1763
sl@0	1764	@leave May leave with any error code.
sl@0	1765	*/
sl@0	1766	virtual void GetSupportedContinuousZoomTypeL(TUint& aSupportedContinuousZoomType) const=0;
sl@0	1767
sl@0	1768	/**
sl@0	1769	Retrieves the minimum, current and maximum focal length in millimeters. This information is useful to find out
sl@0	1770	which zoom directions can be used on the fly.
sl@0	1771
sl@0	1772	@param aMinFocalLength
sl@0	1773	Minimum focal length if positive.
sl@0	1774	Error value if negative (for example, KErrNotFound if information not available).
sl@0	1775
sl@0	1776	@param aCurrentFocalLength
sl@0	1777	Current focal length if positive.
sl@0	1778	Error value if negative (for example, KErrNotFound if information not available).
sl@0	1779
sl@0	1780	@param aMaxFocalLength
sl@0	1781	Maximum focal length if positive.
sl@0	1782	Error value if negative (for example, KErrNotFound if information not available).
sl@0	1783
sl@0	1784	@leave May leave with any error code.
sl@0	1785	*/
sl@0	1786	virtual void GetFocalLengthInfoL(TInt& aMinFocalLength, TInt& aCurrentFocalLength, TInt& aMaxFocalLength) const=0;
sl@0	1787
sl@0	1788	/**
sl@0	1789	Retrieves the total number of operation preferences supported by the implementation. Operation preferences are
sl@0	1790	specified in terms of performance vectors, that is, speed, quality, low memory consumption and low power consumption.
sl@0	1791
sl@0	1792	@param aNumOperationPreferenceSupported
sl@0	1793	Retrieves the number of operation preferences supported.
sl@0	1794
sl@0	1795	@leave May leave with any error code.
sl@0	1796	*/
sl@0	1797	virtual void GetNumOperationPreferenceL(TUint& aNumOperationPreferenceSupported) const=0;
sl@0	1798
sl@0	1799	/**
sl@0	1800	Enumerate the available operation preferences.
sl@0	1801
sl@0	1802	@param aOperationPreferenceIndex
sl@0	1803	A particular index which represents an operation preference. The level of different performance vectors may be known
sl@0	1804	through other arguments. This varies from 0 to n-1, where n is given by GetNumOperationPreferenceL(n).
sl@0	1805
sl@0	1806	@param aSpeedLevel
sl@0	1807	A TPerformanceLevel which specifies the speed level related to the index aOperationPreferenceIndex.
sl@0	1808
sl@0	1809	@param aQualityLevel
sl@0	1810	A TPerformanceLevel which specifies the quality level related to the index aOperationPreferenceIndex.
sl@0	1811
sl@0	1812	@param aLowMemoryConsumptionLevel
sl@0	1813	A TPerformanceLevel which specifies the low memory consumption level related to the index aOperationPreferenceIndex.
sl@0	1814	The lower the memory consumption, the higher the level.
sl@0	1815
sl@0	1816	@param aLowPowerConsumptionLevel
sl@0	1817	A TPerformanceLevel which specifies the low power consumption level related to the index aOperationPreferenceIndex.
sl@0	1818	The lower the power consumption, the higher the level.
sl@0	1819
sl@0	1820	@note It is up to the implementation how the performance levels are achieved. For example, shutter opening, JPEQ quality
sl@0	1821	and parallel buffering in case of streamed image output can be controlled in order to provide the desired
sl@0	1822	performance.
sl@0	1823
sl@0	1824	@leave May leave with any error code.
sl@0	1825	*/
sl@0	1826	virtual void EnumerateOperationPreferenceL(TUint aOperationPreferenceIndex, CCamera::CCameraAdvancedSettings::
sl@0	1827	TPerformanceLevel& aSpeedLevel, CCamera::CCameraAdvancedSettings::TPerformanceLevel& aQualityLevel,
sl@0	1828	CCamera::CCameraAdvancedSettings::TPerformanceLevel& aLowMemoryConsumptionLevel,
sl@0	1829	CCamera::CCameraAdvancedSettings::TPerformanceLevel& aLowPowerConsumptionLevel) const=0;
sl@0	1830
sl@0	1831	/**
sl@0	1832	Set a particular operation preference.
sl@0	1833
sl@0	1834	@param aOperationPreferenceIndex
sl@0	1835	An index which reveals a set of levels to be used for performance vectors, that is, speed, quality, low memory
sl@0	1836	consumption and low power consumption.
sl@0	1837
sl@0	1838	@note Event KUidECamEventCameraSettingOperationPreference is used to notify clients about setting an operation preference.
sl@0	1839	*/
sl@0	1840	virtual void SetOperationPreference(TUint aOperationPreferenceIndex)=0;
sl@0	1841
sl@0	1842	/**
sl@0	1843	Get the current operation preference being used.
sl@0	1844
sl@0	1845	@param aOperationPreferenceIndex
sl@0	1846	Currently used operation preference index.
sl@0	1847
sl@0	1848	@leave May leave with any error code.
sl@0	1849	*/
sl@0	1850	virtual void GetOperationPreferenceL(TInt& aOperationPreferenceIndex) const=0;
sl@0	1851
sl@0	1852	/**
sl@0	1853	Retrieves the event uids which the underlying implementation supports. The client may use these events notifications as
sl@0	1854	milestones in their application.
sl@0	1855
sl@0	1856	@param aSupportedEvents
sl@0	1857	Retrieves as array of TUid. Every member of the array represents a supported event uid. These events are ECAM
sl@0	1858	component wide.
sl@0	1859
sl@0	1860	@leave May leave with any error code.
sl@0	1861
sl@0	1862	@note This method may retrieve unrecognized events which may be introduced later on.
sl@0	1863	*/
sl@0	1864	virtual void GetSupportedEventsL(RArray<TUid>& aSupportedEvents) const=0;
sl@0	1865
sl@0	1866	/**
sl@0	1867	Retrieves the indirect feature changes which occur because of a particular requested feature change.
sl@0	1868	Since the camera setting operation is asynchronous in nature, changing a particular camera feature, in certain cases,
sl@0	1869	involves indirectly changing another feature. In order to notify the ECam client about this indirect feature change,
sl@0	1870	event KUidECamEvent2IndirectFeatureChange is issued. After this notification, the client may use this method to retrieve
sl@0	1871	the full list of indirect feature changes.
sl@0	1872
sl@0	1873	@param aRequestedSetting
sl@0	1874	The actual requested feature change. This uid is supposed to be ECAM component wide and not restricted to
sl@0	1875	advanced camera settings.
sl@0	1876
sl@0	1877	@param aIndirectFeatureChanges
sl@0	1878	An array of uids which retrieves the indirect feature changes. These uids are supposed to be ECAM component wide
sl@0	1879	and not restricted to advanced camera settings.
sl@0	1880
sl@0	1881	@leave May leave with any error code.
sl@0	1882	*/
sl@0	1883	virtual void GetIndirectFeatureChangesL(TUid aRequestedSetting, RArray<TUid>& aIndirectFeatureChanges) const=0;
sl@0	1884
sl@0	1885	/**
sl@0	1886	Retrieves the concrete factory handle for the continuous zoom implementation.
sl@0	1887
sl@0	1888	@param aImplFactoryPtr
sl@0	1889	The concrete factory handle for the continuous zoom implementation.
sl@0	1890
sl@0	1891	@leave May leave with any error code.
sl@0	1892	*/
sl@0	1893	virtual void CreateContinuousZoomImplFactoryL(MImplementationFactory*& aImplFactoryPtr) const=0;
sl@0	1894	};
sl@0	1895
sl@0	1896	/**
sl@0	1897	Mixin class for implementation by providers of the Presets Camera Extension API.
sl@0	1898
sl@0	1899	This API is used to simplify user - camera interaction by allowing simultaneous
sl@0	1900	setting of various advanced camera hardware settings using a single parameter.
sl@0	1901
sl@0	1902	A preset is identified by a single UID and relates to a known predefined outcome.
sl@0	1903	For example the 'Night' Preset is used to set the camera into a night mode
sl@0	1904	so that the user can take photos in dark conditions.
sl@0	1905
sl@0	1906	The settings associated with a particular preset and their specific values and ranges
sl@0	1907	are specific to each type of camera hardware and are therefore not defined by the API.
sl@0	1908
sl@0	1909	@publishedPartner
sl@0	1910	@released
sl@0	1911	*/
sl@0	1912	class MCameraPresets
sl@0	1913	{
sl@0	1914
sl@0	1915	public:
sl@0	1916
sl@0	1917	/**
sl@0	1918	Releases the interface.
sl@0	1919	*/
sl@0	1920	virtual void Release()=0;
sl@0	1921
sl@0	1922	/**
sl@0	1923	Gets the presets supported by the device. These are identified by UIDs
sl@0	1924	and relate to a known expected outcome.
sl@0	1925	The settings associated with a particular preset and their specific values and ranges are
sl@0	1926	specific to each type of camera hardware and are therefore not defined by the API.
sl@0	1927
sl@0	1928	@param aPresets
sl@0	1929	An empty array of TUids which the API implementation must populate with the specific supported preset values. If the array is empty on return,
sl@0	1930	the camera does not support presets.
sl@0	1931
sl@0	1932	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1933	*/
sl@0	1934	virtual void GetSupportedPresetsL(RArray<TUid>& aPresets) const=0;
sl@0	1935
sl@0	1936	/**
sl@0	1937	Sets a specific preset supported by the camera.
sl@0	1938	All clients, implementing the MCameraObserver2 interface will receive a notification
sl@0	1939	with the UID of the specific preset, signalling a new preset has been selected.
sl@0	1940
sl@0	1941	@param aPreset
sl@0	1942	The UID of the new requested preset.
sl@0	1943
sl@0	1944	@note A particular preset is only active if it was established (through a call to
sl@0	1945	MCameraPresets ::SetPreset()) as the most recent operation affecting camera settings.
sl@0	1946	If some other camera setting is changed after calling MCameraPresets ::SetPreset()
sl@0	1947	then the preset is no longer active.
sl@0	1948	*/
sl@0	1949	virtual void SetPreset(TUid aPreset)=0;
sl@0	1950
sl@0	1951	/**
sl@0	1952	Gets the preset that was established by the last call to MCameraPresets ::SetPreset()
sl@0	1953
sl@0	1954	@return The UID of the preset. If there is no active preset then the
sl@0	1955	returned value is KNullUid.
sl@0	1956
sl@0	1957	@note A particular preset is only active if it was established (through a call to
sl@0	1958	MCameraPresets ::SetPreset()) as the most recent operation affecting camera settings.
sl@0	1959	If some other camera setting is changed after calling MCameraPresets ::SetPreset()
sl@0	1960	then the preset is no longer active.
sl@0	1961	*/
sl@0	1962	virtual TUid Preset() const=0;
sl@0	1963
sl@0	1964	/**
sl@0	1965	Gets all settings affected by the current preset. All settings that are related to
sl@0	1966	the preset in question will be included in the list, including any whose values
sl@0	1967	have not changed as a result of applying the preset.
sl@0	1968
sl@0	1969	@param aSettings
sl@0	1970	An empty array of TUids which the API implementation must populate with the specific settings.
sl@0	1971
sl@0	1972	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1973	*/
sl@0	1974	virtual void GetAffectedSettingsL(RArray<TUid>& aSettings) const=0;
sl@0	1975
sl@0	1976	/**
sl@0	1977	Gets all settings associated with a specific preset. This function does not require a preset to have been set prior the call as in
sl@0	1978	GetAffectedSettingsL() function.
sl@0	1979	The returned array will contain the UIDs of all settings which are associated and
sl@0	1980	potentially affected by that particular preset.
sl@0	1981
sl@0	1982	@param aPreset
sl@0	1983	the UID of the preset in question.
sl@0	1984
sl@0	1985	@param aSettings
sl@0	1986	An empty array of TUids which would be populated by the implementation with
sl@0	1987	the UIDs of the settings associated with that preset.
sl@0	1988
sl@0	1989	@leave KErrArgument if the preset UID is not recognised
sl@0	1990	@leave KErrNoMemory Out of memory. May also leave as a result of other system errors.
sl@0	1991	*/
sl@0	1992	virtual void GetAssociatedSettingsL(TUid aPreset, RArray<TUid>& aSettings) const=0;
sl@0	1993	};
sl@0	1994
sl@0	1995	/**
sl@0	1996	Mixin class for implementation of extra methods of the Presets Camera Extension API.
sl@0	1997
sl@0	1998	@publishedPartner
sl@0	1999	@prototype
sl@0	2000	*/
sl@0	2001	class MCameraPresets2
sl@0	2002	{
sl@0	2003
sl@0	2004	public:
sl@0	2005
sl@0	2006	/**
sl@0	2007	Releases the interface.
sl@0	2008	*/
sl@0	2009	virtual void Release()=0;
sl@0	2010
sl@0	2011	/**
sl@0	2012	Retrieves those settings for which ranges have been restricted in order to let the camera work in a given preset mode.
sl@0	2013	The client will be notified of range restrictions through uid KUidECamEventRangeRestricted. After receiving this
sl@0	2014	notification, the client may use this method to retrieve those settings whose ranges have been restricted.
sl@0	2015
sl@0	2016	@param aRangeRestrictedSettings
sl@0	2017	An array of uid which represents those settings whose ranges have been restricted. These settings are ECam
sl@0	2018	component wide. For each of the settings, the client can query about the restricted range as per the usual way.
sl@0	2019
sl@0	2020	@leave May leave with any error code.
sl@0	2021	*/
sl@0	2022	virtual void GetRangeRestrictedSettingsL(RArray<TUid>& aRangeRestrictedSettings) const=0;
sl@0	2023
sl@0	2024	/**
sl@0	2025	Retrieves those settings which have been restricted (settings no longer supported) in order to let the camera work in a given preset mode.
sl@0	2026	The client will be notified of feature restrictions through uid KUidECamEventFeatureRestricted. After receiving this
sl@0	2027	notification, the client may use this method to retrieve these settings.
sl@0	2028
sl@0	2029	@param aFeatureRestrictedSettings
sl@0	2030	An array of uid which represents those settings which have been restricted. These settings are ECam
sl@0	2031	component wide.
sl@0	2032
sl@0	2033	@leave May leave with any error code.
sl@0	2034	*/
sl@0	2035	virtual void GetFeatureRestrictedSettingsL(RArray<TUid>& aFeatureRestrictedSettings) const=0;
sl@0	2036
sl@0	2037	/**
sl@0	2038	Retrieves information about whether the preset unlock feature is supported or not. Unlocking the preset helps in making some
sl@0	2039	further changes in the setting after the camera works in a particular preset mode
sl@0	2040
sl@0	2041	@param aUnlockSupported
sl@0	2042	ETrue indicates preset unlock feature is supported.
sl@0	2043	EFalse indicates preset lock feature is not supported.
sl@0	2044
sl@0	2045	@leave May leave with any error code.
sl@0	2046	*/
sl@0	2047	virtual void IsPresetUnlockSupportedL(TBool& aUnlockSupported) const=0;
sl@0	2048
sl@0	2049	/**
sl@0	2050	Locks the preset for any further setting changes.
sl@0	2051
sl@0	2052	@note Event KUidECamEventPresetLocked is used to notify clients that the preset has been locked.
sl@0	2053	*/
sl@0	2054	virtual void LockPreset()=0;
sl@0	2055
sl@0	2056	/**
sl@0	2057	Unlocks the preset to apply further setting changes.
sl@0	2058
sl@0	2059	@note Event KUidECamEventPresetUnlocked is used to notify clients that the preset has been unlocked.
sl@0	2060	*/
sl@0	2061	virtual void UnlockPreset()=0;
sl@0	2062	};
sl@0	2063
sl@0	2064	/**
sl@0	2065	Mixin class for implementation of extra methods of the Continuous Zoom API.
sl@0	2066
sl@0	2067	@internalTechnology
sl@0	2068	@prototype
sl@0	2069	*/
sl@0	2070	class MCameraContinuousZoom
sl@0	2071	{
sl@0	2072	public:
sl@0	2073
sl@0	2074	/**
sl@0	2075	Passes both the continuous zoom observer and pointer to the continuous zoom class to the implementation so callbacks
sl@0	2076	can be sent to the client along with the continuous zoom handle.
sl@0	2077
sl@0	2078	@param aObserver
sl@0	2079	The reference to the continuous zoom observer.
sl@0	2080
sl@0	2081	@param aContinuousZoomHandle
sl@0	2082	The pointer to the continuous zoom class object.
sl@0	2083
sl@0	2084	@see MContinuousZoomObserver
sl@0	2085	*/
sl@0	2086	virtual void SetContinuousZoomObserverAndHandle(MContinuousZoomObserver& aObserver, CCamera::CCameraContinuousZoom* aContinuousZoomHandle)=0;
sl@0	2087
sl@0	2088	/**
sl@0	2089	Starts the continuous zoom operation. Clients will receive MContinuousZoomObserver::ContinuousZoomProgress() callback for intermediate zoom factors
sl@0	2090	achieved. It is up to the implementation to choose the zoom factors for which it will issue this callback. Implementation will not use this callback to notify
sl@0	2091	reaching the target zoom factor. This will be done via MContinuousZoomObserver::ContinuousZoomComplete() callback.
sl@0	2092
sl@0	2093	@param aContinuousZoomParameters
sl@0	2094	The desired parameters to be used for the continuous zoom operation.
sl@0	2095
sl@0	2096	@note If the implementation does not support re-configuring of zoom parameters whilst an existing continuous zoom operation is active then
sl@0	2097	StartContinuousZoomL() will leave with KErrInUse.
sl@0	2098
sl@0	2099	@note If client has selected EDirectionTele zoom direction and the current zoom factor is greater than the target zoom factor, StartContinuousZoomL()
sl@0	2100	will leave with KErrArgument. Similarly, StartContinuousZoomL() will also leave with KErrArgument if client has selected EDirectionWide zoom
sl@0	2101	direction and current zoom factor is less than target zoom factor.
sl@0	2102
sl@0	2103	@leave May leave with any error code.
sl@0	2104	*/
sl@0	2105	virtual void StartContinuousZoomL(CCamera::CCameraAdvancedSettings::TContinuousZoomParameters aContinuousZoomParameters)=0;
sl@0	2106
sl@0	2107	/**
sl@0	2108	Stop any exisiting continuous zoom operation.
sl@0	2109	Since this method is synchronous, no callback shall be issued for the concerned continuous zoom operation.
sl@0	2110	*/
sl@0	2111	virtual void StopContinuousZoom()=0;
sl@0	2112
sl@0	2113	/**
sl@0	2114	Retrieves information about the supported settings related to continuous zoom support.
sl@0	2115
sl@0	2116	@param aContinuousZoomInfo
sl@0	2117	The information of supported continuous zoom functionality.
sl@0	2118
sl@0	2119	@leave May leave with any error code.
sl@0	2120	*/
sl@0	2121	virtual void GetContinuousZoomSupportInfoL(CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo& aContinuousZoomInfo) const=0;
sl@0	2122
sl@0	2123	/**
sl@0	2124	Retrieves the unique id of the continuous zoom object.
sl@0	2125	This is used to identify the continuous zoom handle returned to clients via the MContinuousZoomObserver callback.
sl@0	2126
sl@0	2127	@param aZoomId
sl@0	2128	The unique id of this Continuous Zoom object.
sl@0	2129	*/
sl@0	2130	virtual void GetContinuousZoomId(TInt& aZoomId) const=0;
sl@0	2131
sl@0	2132	/**
sl@0	2133	Releases the interface.
sl@0	2134	*/
sl@0	2135	virtual void Release()=0;
sl@0	2136	};
sl@0	2137
sl@0	2138	#endif // ECAMADVSETTINGSINTF_H

author	sl@SLION-WIN7.fritz.box
	Fri, 15 Jun 2012 03:10:57 +0200
changeset 0	bde4ae8d615e
permissions	-rw-r--r--