Symaptic: os/mm/imagingandcamerafws/camerafw/source/ecamadvsettings.cpp@260cb5ec6c19 (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	#include <ecam/ecamadvsettingsintf.h>
sl@0	17	#include "ecamversion.h"
sl@0	18	#include <ecam/ecamconstants.h>
sl@0	19	#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
sl@0	20	#include <ecamadvsettingsconst.h>
sl@0	21	#include <ecamadvsettingsdef.h>
sl@0	22	#endif
sl@0	23	#include <ecam/implementationfactoryintf.h>
sl@0	24	const TInt KBaselinedFocusRanges = 0x1F;
sl@0	25	const TInt KBaselinedWhiteBalanceModes = 0x01FF;
sl@0	26	const TUint KBaselinedPixelAspectsMask = (CCamera::CCameraAdvancedSettings::EEPixelAspect59To54 << 1) - 1;
sl@0	27	const TUint KBaselinedFlashModeMask = (CCamera::EFlashManual << 1) - 1;
sl@0	28	const TUint KBaselinedPreCaptureWarning = (CCamera::CCameraAdvancedSettings::EPCWGeneralWarning << 1) - 1;
sl@0	29	const TUint KBaselinedDriveMode = (CCamera::CCameraAdvancedSettings::EDriveModeBurst << 1) - 1;
sl@0	30
sl@0	31	/**
sl@0	32	Factory function for creating the CCameraPresets object.
sl@0	33
sl@0	34	@param aCamera
sl@0	35	a reference to a CCamera object providing the settings.
sl@0	36
sl@0	37	@return a pointer to a fully constructed CCameraPresets object.
sl@0	38
sl@0	39	@leave KErrNoMemory Out of memory Or any other system-wide error code.
sl@0	40
sl@0	41	@note Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
sl@0	42	*/
sl@0	43	EXPORT_C CCamera::CCameraPresets* CCamera::CCameraPresets::NewL(CCamera& aCamera)
sl@0	44	{
sl@0	45	CCamera::CCameraPresets* self = new (ELeave)CCamera::CCameraPresets(aCamera);
sl@0	46	CleanupStack::PushL(self);
sl@0	47	self->ConstructL();
sl@0	48	CleanupStack::Pop(self);
sl@0	49
sl@0	50	return self;
sl@0	51	}
sl@0	52
sl@0	53	/**
sl@0	54	CCameraPresets Constructor.
sl@0	55
sl@0	56	@param aOwner
sl@0	57	a reference to a CCamera object providing the settings.
sl@0	58	*/
sl@0	59	EXPORT_C CCamera::CCameraPresets::CCameraPresets(CCamera& aOwner):iOwner(aOwner), iImpl(NULL), iImpl2(NULL)
sl@0	60	{
sl@0	61	}
sl@0	62
sl@0	63	/**
sl@0	64	CCameraPresets second phase constructor.
sl@0	65
sl@0	66	Function used to initialise internal state of the object. Uses reference to the camera to retrieve
sl@0	67	Camera presets interface pointer.
sl@0	68
sl@0	69	@leave KErrNoMemory Out of memory.
sl@0	70	*/
sl@0	71	EXPORT_C void CCamera::CCameraPresets::ConstructL()
sl@0	72	{
sl@0	73	iImpl = static_cast<MCameraPresets*>(iOwner.CustomInterface(KECamMCameraPresetsUid));
sl@0	74
sl@0	75	if (iImpl == NULL)
sl@0	76	{
sl@0	77	User::Leave(KErrNotSupported);
sl@0	78	}
sl@0	79
sl@0	80	iImpl2 = static_cast<MCameraPresets2*>(iOwner.CustomInterface(KECamMCameraPresets2Uid));
sl@0	81	}
sl@0	82
sl@0	83	/**
sl@0	84	Destructor
sl@0	85	*/
sl@0	86	EXPORT_C CCamera::CCameraPresets::~CCameraPresets()
sl@0	87	{
sl@0	88	if (iImpl != NULL)
sl@0	89	{
sl@0	90	iImpl->Release();
sl@0	91	}
sl@0	92	if (iImpl2 != NULL)
sl@0	93	{
sl@0	94	iImpl2->Release();
sl@0	95	}
sl@0	96	}
sl@0	97
sl@0	98	/**
sl@0	99	Gets the presets supported by the camera. These are identified by UIDs
sl@0	100	and relate to a known predefined outcome.
sl@0	101	The settings associated with a particular preset and their specific values
sl@0	102	and ranges are specific to each type of camera hardware and are therefore not defined by the API.
sl@0	103
sl@0	104	@param aPresets
sl@0	105	An empty array of TUids which would be populated by the implementation with
sl@0	106	the specific supported values. If the array is empty on return,
sl@0	107	the camera does not support presets.
sl@0	108
sl@0	109	@leave KErrNoMemory Out of memory.
sl@0	110
sl@0	111	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	112	application is not prepared to receive extra added uid values (new presets added). So, any extra uid value(unrecognised)
sl@0	113	passed from the implementation will be filtered at this point.
sl@0	114	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	115	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values.
sl@0	116
sl@0	117	@note Any preset uid, if added in future, has to have a uid value greater than KUidECamPresetFactoryDefaultUidValue
sl@0	118	otherwise unrecognized preset uids could not be checked.
sl@0	119	*/
sl@0	120	EXPORT_C void CCamera::CCameraPresets::GetSupportedPresetsL(RArray<TUid>& aPresets) const
sl@0	121	{
sl@0	122	iImpl->GetSupportedPresetsL(aPresets);
sl@0	123
sl@0	124	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	125	application is not prepared to receive extra added uid values (new presets added). So, any extra uid value(unrecognised)
sl@0	126	passed from the implementation will be filtered at this point.
sl@0	127	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	128	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	129	FilterUnrecognisedUids(aPresets, KUidECamPresetFactoryDefaultUidValue);
sl@0	130	}
sl@0	131
sl@0	132	/**
sl@0	133	Sets a specific preset supported by the device.
sl@0	134	All clients, implementing the MCameraObserver2 interface will receive a notification
sl@0	135	with the UID of the specific preset, signalling a new preset has been selected.
sl@0	136
sl@0	137	@param aPreset
sl@0	138	The UID of the new requested preset.
sl@0	139	*/
sl@0	140	EXPORT_C void CCamera::CCameraPresets::SetPreset(TUid aPreset)
sl@0	141	{
sl@0	142	iImpl->SetPreset(aPreset);
sl@0	143	}
sl@0	144
sl@0	145	/**
sl@0	146	Gets the current preset set on the camera.
sl@0	147
sl@0	148	@return The UID of the current preset. If there is no active preset then the
sl@0	149	returned value is KNullUid.
sl@0	150
sl@0	151	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that application is not
sl@0	152	prepared to receive extra added uid values (new presets added). So, any extra uid(unrecognised) value received from the
sl@0	153	implementation will be mapped to KUidECamPresetFactoryDefault at this point.
sl@0	154	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	155	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	156	*/
sl@0	157	EXPORT_C TUid CCamera::CCameraPresets::Preset() const
sl@0	158	{
sl@0	159	TUid preset = iImpl->Preset();
sl@0	160
sl@0	161	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that application is not
sl@0	162	prepared to receive extra added uid values (new presets added). So, any extra uid(unrecognised) value received from the
sl@0	163	implementation will be mapped to KUidECamPresetFactoryDefault at this point.
sl@0	164	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	165	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	166	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	167	{
sl@0	168	if(preset.iUid > KUidECamPresetFactoryDefaultUidValue)
sl@0	169	{
sl@0	170	preset = KUidECamPresetFactoryDefault;
sl@0	171	}
sl@0	172	}
sl@0	173
sl@0	174	return preset;
sl@0	175	}
sl@0	176
sl@0	177	/**
sl@0	178	Get all settings affected by the current preset. This is to say that all settings which
sl@0	179	are related to the preset in question will be included in the list, even though the value might
sl@0	180	not have changed.
sl@0	181
sl@0	182	@param aSettings
sl@0	183	An empty array of TUids which would be populated by the implementation with
sl@0	184	the specific settings.
sl@0	185
sl@0	186	@leave KErrNoMemory Out of memory.
sl@0	187
sl@0	188	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	189	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	190	from the implementation will be filtered at this point.
sl@0	191	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	192	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	193	*/
sl@0	194	EXPORT_C void CCamera::CCameraPresets::GetAffectedSettingsL(RArray<TUid>& aSettings) const
sl@0	195	{
sl@0	196	iImpl->GetAffectedSettingsL(aSettings);
sl@0	197
sl@0	198	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	199	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	200	from the implementation will be filtered at this point.
sl@0	201	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	202	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	203	FilterUnrecognisedUids(aSettings, KUidECamEventCameraSettingAutoFocusType2UidValue);
sl@0	204	}
sl@0	205
sl@0	206	/**
sl@0	207	Get all settings associated with a specific preset, identified by a UID.
sl@0	208	This function does not require a preset to have been set prior the call as in
sl@0	209	GetAffectedSettingsL() function.
sl@0	210	The returned array will contain the UIDs of all settings which are associated and
sl@0	211	potentially affected by that particular preset.
sl@0	212
sl@0	213	@param aPreset
sl@0	214	the UID of the preset in question.
sl@0	215
sl@0	216	@param aSettings
sl@0	217	An empty array of TUids which would be populated by the implementation with
sl@0	218	the UIDs of the settings associated with that preset.
sl@0	219
sl@0	220	@leave KErrArgument If the provided preset UID is not recognised.
sl@0	221	@leave KErrNoMemory Out of memory.
sl@0	222
sl@0	223	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	224	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	225	from the implementation will be filtered at this point.
sl@0	226	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	227	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	228	*/
sl@0	229	EXPORT_C void CCamera::CCameraPresets::GetAssociatedSettingsL(TUid aPreset, RArray<TUid>& aSettings) const
sl@0	230	{
sl@0	231	iImpl->GetAssociatedSettingsL(aPreset, aSettings);
sl@0	232
sl@0	233	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	234	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	235	from the implementation will be filtered at this point.
sl@0	236	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	237	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	238	FilterUnrecognisedUids(aSettings, KUidECamEventCameraSettingAutoFocusType2UidValue);
sl@0	239	}
sl@0	240
sl@0	241	void CCamera::CCameraPresets::FilterUnrecognisedUids(RArray<TUid>& aUids, const TInt aBaselineUid) const
sl@0	242	{
sl@0	243	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	244	{
sl@0	245	for(TInt index =0; index < aUids.Count(); index++)
sl@0	246	{
sl@0	247	/** aBaselineUid is the baseline. Any uid with greater uid value means that it has
sl@0	248	been added in later versions */
sl@0	249	if(aUids[index].iUid > aBaselineUid)
sl@0	250	{
sl@0	251	aUids.Remove(index);
sl@0	252	index--;
sl@0	253	}
sl@0	254	}
sl@0	255	}
sl@0	256	}
sl@0	257
sl@0	258	/**
sl@0	259	Retrieves those settings for which ranges have been restricted in order to let the camera work in a given preset mode.
sl@0	260	The client will be notified of range restrictions through ECAM event KUidECamEventRangeRestricted. After receiving this
sl@0	261	notification, the client may use this method to retrieve those settings whose ranges have been restricted.
sl@0	262
sl@0	263	@param aRangeRestrictedSettings
sl@0	264	An array of uids which represents those settings whose ranges have been restricted. These settings are ECam
sl@0	265	component wide. For each of the settings, the client can query about the restricted ranges in the usual way.
sl@0	266	Empty array indicates that there are no range restricted settings for the given preset.
sl@0	267
sl@0	268	@leave May leave with any error code.
sl@0	269
sl@0	270	@publishedPartner
sl@0	271	@prototype
sl@0	272	*/
sl@0	273	EXPORT_C void CCamera::CCameraPresets::GetRangeRestrictedSettingsL(RArray<TUid>& aRangeRestrictedSettings) const
sl@0	274	{
sl@0	275	if(iImpl2 != NULL)
sl@0	276	{
sl@0	277	iImpl2->GetRangeRestrictedSettingsL(aRangeRestrictedSettings);
sl@0	278	}
sl@0	279	else
sl@0	280	{
sl@0	281	User::Leave(KErrNotSupported);
sl@0	282	}
sl@0	283	}
sl@0	284
sl@0	285	/**
sl@0	286	Retrieves those settings which have been restricted (settings no longer supported) in order to let the camera work in
sl@0	287	a given preset mode.
sl@0	288	The client will be notified of feature restrictions through ECAM event KUidECamEventFeatureRestricted. After receiving
sl@0	289	this notification, the client may use this method to retrieve these settings.
sl@0	290
sl@0	291	@param aFeatureRestrictedSettings
sl@0	292	An array of uids which represents those settings which have been restricted. These settings are ECam
sl@0	293	component wide. Empty array indicates that there are no settings which have been been restricted for
sl@0	294	the given preset.
sl@0	295
sl@0	296	@leave May leave with any error code.
sl@0	297
sl@0	298	@publishedPartner
sl@0	299	@prototype
sl@0	300	*/
sl@0	301	EXPORT_C void CCamera::CCameraPresets::GetFeatureRestrictedSettingsL(RArray<TUid>& aFeatureRestrictedSettings) const
sl@0	302	{
sl@0	303	if(iImpl2 != NULL)
sl@0	304	{
sl@0	305	iImpl2->GetFeatureRestrictedSettingsL(aFeatureRestrictedSettings);
sl@0	306	}
sl@0	307	else
sl@0	308	{
sl@0	309	User::Leave(KErrNotSupported);
sl@0	310	}
sl@0	311	}
sl@0	312
sl@0	313	/**
sl@0	314	Retrieves information about whether the preset unlock feature is supported or not. Unlocking the preset helps in making
sl@0	315	further setting changes after the camera works in a particular preset mode.
sl@0	316
sl@0	317	@param aUnlockSupported
sl@0	318	ETrue indicates preset unlock feature is supported.
sl@0	319	EFalse indicates preset lock feature is not supported.
sl@0	320
sl@0	321	@leave May leave with any error code.
sl@0	322
sl@0	323	@publishedPartner
sl@0	324	@prototype
sl@0	325	*/
sl@0	326	EXPORT_C void CCamera::CCameraPresets::IsPresetUnlockSupportedL(TBool& aUnlockSupported) const
sl@0	327	{
sl@0	328	if(iImpl2 != NULL)
sl@0	329	{
sl@0	330	iImpl2->IsPresetUnlockSupportedL(aUnlockSupported);
sl@0	331	}
sl@0	332	else
sl@0	333	{
sl@0	334	User::Leave(KErrNotSupported);
sl@0	335	}
sl@0	336	}
sl@0	337
sl@0	338	/**
sl@0	339	Locks the preset for any further setting changes.
sl@0	340
sl@0	341	@note Event KUidECamEventPresetLocked is used to notify clients that the preset has been locked.
sl@0	342
sl@0	343	@publishedPartner
sl@0	344	@prototype
sl@0	345	*/
sl@0	346	EXPORT_C void CCamera::CCameraPresets::LockPresetL()
sl@0	347	{
sl@0	348	if(iImpl2 != NULL)
sl@0	349	{
sl@0	350	iImpl2->LockPreset();
sl@0	351	}
sl@0	352	else
sl@0	353	{
sl@0	354	User::Leave(KErrNotSupported);
sl@0	355	}
sl@0	356	}
sl@0	357
sl@0	358	/**
sl@0	359	Unlocks the preset to apply further setting changes.
sl@0	360
sl@0	361	@note Event KUidECamEventPresetUnlocked is used to notify clients that the preset has been unlocked.
sl@0	362
sl@0	363	@publishedPartner
sl@0	364	@prototype
sl@0	365	*/
sl@0	366	EXPORT_C void CCamera::CCameraPresets::UnlockPresetL()
sl@0	367	{
sl@0	368	if(iImpl2 != NULL)
sl@0	369	{
sl@0	370	iImpl2->UnlockPreset();
sl@0	371	}
sl@0	372	else
sl@0	373	{
sl@0	374	User::Leave(KErrNotSupported);
sl@0	375	}
sl@0	376	}
sl@0	377
sl@0	378	/**
sl@0	379	Factory function for creating the CCameraAdvancedSettings object.
sl@0	380
sl@0	381	@param aCamera
sl@0	382	a reference to a CCamera object providing the settings.
sl@0	383
sl@0	384	@return a pointer to a fully constructed CCameraAdvancedSettings object.
sl@0	385
sl@0	386	@leave KErrNoMemory Out of memory or any other system-wide error code.
sl@0	387
sl@0	388	@note Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
sl@0	389	*/
sl@0	390	EXPORT_C CCamera::CCameraAdvancedSettings* CCamera::CCameraAdvancedSettings::NewL(CCamera& aCamera)
sl@0	391	{
sl@0	392	CCamera::CCameraAdvancedSettings* self = new (ELeave)CCamera::CCameraAdvancedSettings(aCamera);
sl@0	393	CleanupStack::PushL(self);
sl@0	394	self->ConstructL();
sl@0	395	CleanupStack::Pop(self);
sl@0	396
sl@0	397	return self;
sl@0	398	}
sl@0	399
sl@0	400	/**
sl@0	401	CCameraAdvancedSettings Constructor.
sl@0	402
sl@0	403	@param aOwner
sl@0	404	a reference to a CCamera object providing the settings.
sl@0	405	*/
sl@0	406	EXPORT_C CCamera::CCameraAdvancedSettings::CCameraAdvancedSettings(CCamera& aOwner) : iOwner(aOwner), iImpl(NULL), iImpl2(NULL), iImpl3(NULL), iImpl4(NULL)
sl@0	407	{
sl@0	408	}
sl@0	409
sl@0	410	/**
sl@0	411	CCameraAdvancedSettings second phase constructor.
sl@0	412
sl@0	413	Function used to initialise internal state of the object. Uses reference to the camera to retrieve
sl@0	414	Camera advanced settings interface pointer.
sl@0	415
sl@0	416	@leave KErrNoMemory Out of memory.
sl@0	417	*/
sl@0	418	EXPORT_C void CCamera::CCameraAdvancedSettings::ConstructL()
sl@0	419	{
sl@0	420	iImpl = static_cast<MCameraAdvancedSettings*>(iOwner.CustomInterface(KECamMCameraAdvancedSettingsUid));
sl@0	421	if (iImpl == NULL)
sl@0	422	{
sl@0	423	User::Leave(KErrNotSupported);
sl@0	424	}
sl@0	425	iImpl2 = static_cast<MCameraAdvancedSettings2*>(iOwner.CustomInterface(KECamMCameraAdvancedSettings2Uid));
sl@0	426	iImpl3 = static_cast<MCameraAdvancedSettings3*>(iOwner.CustomInterface(KECamMCameraAdvancedSettings3Uid));
sl@0	427	iImpl4 = static_cast<MCameraAdvancedSettings4*>(iOwner.CustomInterface(KECamMCameraAdvancedSettings4Uid));
sl@0	428	}
sl@0	429
sl@0	430	/**
sl@0	431	Destructor
sl@0	432	*/
sl@0	433	EXPORT_C CCamera::CCameraAdvancedSettings::~CCameraAdvancedSettings()
sl@0	434	{
sl@0	435	if (iImpl != NULL)
sl@0	436	{
sl@0	437	iImpl->Release();
sl@0	438	}
sl@0	439	if (iImpl2 != NULL)
sl@0	440	{
sl@0	441	iImpl2->Release();
sl@0	442	}
sl@0	443	if (iImpl3 != NULL)
sl@0	444	{
sl@0	445	iImpl3->Release();
sl@0	446	}
sl@0	447	if (iImpl4 != NULL)
sl@0	448	{
sl@0	449	iImpl4->Release();
sl@0	450	}
sl@0	451	}
sl@0	452
sl@0	453	/**
sl@0	454	Gets the type of this camera.
sl@0	455	@see TCameraType
sl@0	456
sl@0	457	@return the type of this camera
sl@0	458	*/
sl@0	459	EXPORT_C CCamera::CCameraAdvancedSettings::TCameraType CCamera::CCameraAdvancedSettings::CameraType() const
sl@0	460	{
sl@0	461	return iImpl->CameraType();
sl@0	462	}
sl@0	463
sl@0	464	/**
sl@0	465	Get the type of a specific camera denoted by its index. A pluggable camera
sl@0	466	may not necessarily be physically present. The type denotes whether the slot allocated
sl@0	467	to that index is for pluggable or onboard camera.
sl@0	468	@see TCameraType
sl@0	469
sl@0	470	@param aCameraIndex
sl@0	471	An integer in the range of [0: CCamera::CamerasAvailable()-1].
sl@0	472
sl@0	473	@return the TCameraType value for the specific camera.
sl@0	474	If the index is out of range, the return value is ECameraUnknown.
sl@0	475	*/
sl@0	476	EXPORT_C CCamera::CCameraAdvancedSettings::TCameraType CCamera::CCameraAdvancedSettings::CameraType(TInt aCameraIndex)
sl@0	477	{
sl@0	478	return iImpl->CameraType(aCameraIndex);
sl@0	479	}
sl@0	480
sl@0	481	/**
sl@0	482	Checks whether the current camera is present.
sl@0	483
sl@0	484	@return Whether the camera is currently present.
sl@0	485	ETrue if camera is present, EFalse otherwise.
sl@0	486	For example ECameraOnBoard (built-in) cameras are always present.
sl@0	487	*/
sl@0	488	EXPORT_C TBool CCamera::CCameraAdvancedSettings::IsCameraPresent() const
sl@0	489	{
sl@0	490	return iImpl->IsCameraPresent();
sl@0	491	}
sl@0	492
sl@0	493	/**
sl@0	494	Checks whether the camera, denoted by its index, is currently present.
sl@0	495	The index uniquely identifies the camera on the device.
sl@0	496
sl@0	497	@param aCameraIndex
sl@0	498	An integer in the range of [0:CCamera::CamerasAvailable()-1] specifying the
sl@0	499	camera device to use
sl@0	500
sl@0	501	@return Whether the camera is currently present.
sl@0	502	ETrue if camera is present, EFalse otherwise.
sl@0	503	For example built-in (ECameraOnBoard) cameras
sl@0	504	are always present.
sl@0	505	*/
sl@0	506	EXPORT_C TBool CCamera::CCameraAdvancedSettings::IsCameraPresent(TInt aCameraIndex)
sl@0	507	{
sl@0	508	return iImpl->IsCameraPresent(aCameraIndex);
sl@0	509	}
sl@0	510
sl@0	511	/**
sl@0	512	Gets current camera index. The index uniquely identifies the camera on the device.
sl@0	513
sl@0	514	@return camera index in the inclusive range of [0:CCamera::CamerasAvailable() - 1].
sl@0	515	*/
sl@0	516	EXPORT_C TInt CCamera::CCameraAdvancedSettings::CameraIndex() const
sl@0	517	{
sl@0	518	return iImpl->CameraIndex();
sl@0	519	}
sl@0	520
sl@0	521	/**
sl@0	522	Gets all of the supported stabilization modes on the camera. The result is a bitfield
sl@0	523	of the valid TStabilizationMode flags.
sl@0	524	@see TStabilizationMode
sl@0	525
sl@0	526	@return a bitfield of all supported stabilization modes.
sl@0	527	*/
sl@0	528	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedStabilizationModes() const
sl@0	529	{
sl@0	530	return iImpl->SupportedStabilizationModes();
sl@0	531	}
sl@0	532
sl@0	533	/**
sl@0	534	Gets current stabilization mode on the camera.
sl@0	535	The result is a valid TStabilizationMode value.
sl@0	536
sl@0	537	@return current stabilization mode of type TStabilizationMode.
sl@0	538	*/
sl@0	539	EXPORT_C CCamera::CCameraAdvancedSettings::TStabilizationMode CCamera::CCameraAdvancedSettings::StabilizationMode() const
sl@0	540	{
sl@0	541	return iImpl->StabilizationMode();
sl@0	542	}
sl@0	543
sl@0	544	/**
sl@0	545	Sets a specific stabilization mode on the camera.
sl@0	546
sl@0	547	Stabilization mode change fires a KUidECamEventCameraSettingStabilizationMode
sl@0	548	event to all MCameraObserver2 clients of this specific camera.
sl@0	549
sl@0	550	@param aStabilizationMode
sl@0	551	new stabilization mode of TStabilizationMode type.
sl@0	552	*/
sl@0	553	EXPORT_C void CCamera::CCameraAdvancedSettings::SetStabilizationMode(CCamera::CCameraAdvancedSettings::TStabilizationMode aStabilizationMode)
sl@0	554	{
sl@0	555	iImpl->SetStabilizationMode(aStabilizationMode);
sl@0	556	}
sl@0	557
sl@0	558	/**
sl@0	559	Gets all of the supported focus modes on the camera. The result is a bitfield
sl@0	560	of the valid TFocusMode flags.
sl@0	561	@see TFocusMode
sl@0	562
sl@0	563	@return a bitfield of all supported focus modes.
sl@0	564	*/
sl@0	565	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedFocusModes() const
sl@0	566	{
sl@0	567	return iImpl->SupportedFocusModes();
sl@0	568	}
sl@0	569
sl@0	570	/**
sl@0	571	Gets current focus mode on the camera.
sl@0	572	The result is a valid TFocusMode value.
sl@0	573
sl@0	574	@return current focus mode.
sl@0	575	*/
sl@0	576	EXPORT_C CCamera::CCameraAdvancedSettings::TFocusMode CCamera::CCameraAdvancedSettings::FocusMode() const
sl@0	577	{
sl@0	578	return iImpl->FocusMode();
sl@0	579	}
sl@0	580
sl@0	581	/**
sl@0	582	Sets a specific focus mode on the camera.
sl@0	583	Focus mode change fires a KUidECamEventCameraSettingFocusMode event
sl@0	584	to all MCameraObserver2 clients of the camera.
sl@0	585
sl@0	586	@param aFocusMode
sl@0	587	new focus mode of TFocusMode type.
sl@0	588	*/
sl@0	589	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFocusMode(CCamera::CCameraAdvancedSettings::TFocusMode aFocusMode)
sl@0	590	{
sl@0	591	iImpl->SetFocusMode(aFocusMode);
sl@0	592	}
sl@0	593
sl@0	594	/**
sl@0	595	Gets all supported focus ranges on the camera.
sl@0	596
sl@0	597	@return an integer - a bitfield of all supported TFocusRange values.
sl@0	598
sl@0	599	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	600	application is not prepared to receive extra added enum values. So, any extra enum value passed
sl@0	601	from the implementation will be filtered at this point.
sl@0	602	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	603	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
sl@0	604	*/
sl@0	605	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedFocusRanges() const
sl@0	606	{
sl@0	607	TInt supportedFocusRanges = iImpl->SupportedFocusRanges();
sl@0	608
sl@0	609	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	610	application is not prepared to receive extra added enum values. So, any extra enum value passed
sl@0	611	from the implementation will be filtered at this point.
sl@0	612	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	613	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	614	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	615	{
sl@0	616	supportedFocusRanges &= KBaselinedFocusRanges;
sl@0	617	}
sl@0	618
sl@0	619	return supportedFocusRanges;
sl@0	620	}
sl@0	621
sl@0	622	/**
sl@0	623	Gets current focus range on the camera.
sl@0	624
sl@0	625	@return the current TFocusRange value.
sl@0	626
sl@0	627	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	628	application is not prepared to receive extra added enum values. So, any extra enum value received
sl@0	629	from the implementation will be dropped and EFocusRangeAuto would be passed instead.
sl@0	630	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	631	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
sl@0	632	*/
sl@0	633	EXPORT_C CCamera::CCameraAdvancedSettings::TFocusRange CCamera::CCameraAdvancedSettings::FocusRange() const
sl@0	634	{
sl@0	635	CCamera::CCameraAdvancedSettings::TFocusRange focusRange = iImpl->FocusRange();
sl@0	636
sl@0	637	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	638	application is not prepared to receive extra added enum values. So, any extra enum value received
sl@0	639	from the implementation will be dropped and EFocusRangeAuto would be passed instead.
sl@0	640	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	641	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	642	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	643	{
sl@0	644	if(static_cast<TInt>(focusRange) > KBaselinedFocusRanges)
sl@0	645	{
sl@0	646	focusRange = CCamera::CCameraAdvancedSettings::EFocusRangeAuto;
sl@0	647	}
sl@0	648	}
sl@0	649
sl@0	650	return focusRange;
sl@0	651	}
sl@0	652
sl@0	653	/**
sl@0	654	Sets a specific focus range on the camera.
sl@0	655	The focus range change fires both, KUidECamEventCameraSettingFocusRange and
sl@0	656	KUidECamEventCameraSettingFocusRange2 event to all MCameraObserver2 clients of the camera.
sl@0	657	@see KUidECamEventCameraSettingFocusRange
sl@0	658
sl@0	659	@param aFocusRange
sl@0	660	newly selected focus range.
sl@0	661	*/
sl@0	662	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFocusRange(CCamera::CCameraAdvancedSettings::TFocusRange aFocusRange)
sl@0	663	{
sl@0	664	iImpl->SetFocusRange(aFocusRange);
sl@0	665	}
sl@0	666
sl@0	667	/**
sl@0	668	Gets all supported auto focus types on the camera.
sl@0	669
sl@0	670	@return an integer - a bitfield of all supported TAutoFocusType values.
sl@0	671	*/
sl@0	672	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedAutoFocusTypes() const
sl@0	673	{
sl@0	674	return iImpl->SupportedAutoFocusTypes();
sl@0	675	}
sl@0	676
sl@0	677	/**
sl@0	678	Gets current auto focus type on the camera.
sl@0	679	@see TAutoFocusType
sl@0	680
sl@0	681	@return a CCamera::TAutoFocusType value.
sl@0	682	*/
sl@0	683	EXPORT_C CCamera::CCameraAdvancedSettings::TAutoFocusType CCamera::CCameraAdvancedSettings::AutoFocusType() const
sl@0	684	{
sl@0	685	return iImpl->AutoFocusType();
sl@0	686	}
sl@0	687
sl@0	688	/**
sl@0	689	Sets a specific auto focus type on the camera.
sl@0	690	The focus type change fires both, KUidECamEventCameraSettingAutoFocusType and
sl@0	691	KUidECamEventCameraSettingAutoFocusType2 event to all MCameraObserver2 clients of the camera.
sl@0	692	@see KUidECamEventCameraSettingAutoFocusType
sl@0	693
sl@0	694	@param aAutoFocusType
sl@0	695	Autofocus selection.
sl@0	696	*/
sl@0	697	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAutoFocusType(CCamera::CCameraAdvancedSettings::TAutoFocusType aAutoFocusType)
sl@0	698	{
sl@0	699	iImpl->SetAutoFocusType(aAutoFocusType);
sl@0	700	}
sl@0	701
sl@0	702	/**
sl@0	703	Gets all supported auto focus areas on the camera.
sl@0	704
sl@0	705	@return an integer - a bitfield of al supported TAutoFocusArea values.
sl@0	706	*/
sl@0	707	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedAutoFocusAreas() const
sl@0	708	{
sl@0	709	return iImpl->SupportedAutoFocusAreas();
sl@0	710	}
sl@0	711
sl@0	712	/**
sl@0	713	Gets current chosen auto focus area on the camera.
sl@0	714
sl@0	715	@return a CCamera::TAutoFocusArea value.
sl@0	716	*/
sl@0	717	EXPORT_C CCamera::CCameraAdvancedSettings::TAutoFocusArea CCamera::CCameraAdvancedSettings::AutoFocusArea() const
sl@0	718	{
sl@0	719	return iImpl->AutoFocusArea();
sl@0	720	}
sl@0	721
sl@0	722	/**
sl@0	723	Sets a specific auto focus area on the camera.
sl@0	724	Focus area change fires a KUidECamEventCameraSettingAutoFocusArea event
sl@0	725	to all MCameraObserver2 clients of the camera.
sl@0	726
sl@0	727	@param aAutoFocusArea
sl@0	728	Autofocus area selection.
sl@0	729	*/
sl@0	730	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAutoFocusArea(CCamera::CCameraAdvancedSettings::TAutoFocusArea aAutoFocusArea)
sl@0	731	{
sl@0	732	iImpl->SetAutoFocusArea(aAutoFocusArea);
sl@0	733	}
sl@0	734
sl@0	735	/**
sl@0	736	Get focus distance in millimetres.
sl@0	737
sl@0	738	@return the current focus distance in millimetres, directly from user setting of lenses.
sl@0	739	*/
sl@0	740	EXPORT_C TInt CCamera::CCameraAdvancedSettings::FocusDistance() const
sl@0	741	{
sl@0	742	return iImpl->FocusDistance();
sl@0	743	}
sl@0	744
sl@0	745	/**
sl@0	746	Set focus distance in millimetres. Focus distance change fires a KUidECamEventCameraSettingFocusDistance event
sl@0	747	to all MCameraObserver2 clients of the camera.
sl@0	748
sl@0	749	@param aDistance
sl@0	750	the new distance value in millimetres.
sl@0	751
sl@0	752	@note KUidECamEvent2CameraSettingFocusDistance may be used to provide the focussing feedback as well. This means that
sl@0	753	the feedback will state whether the proper focussing has been achieved after setting the given focus distance.
sl@0	754	*/
sl@0	755	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFocusDistance(TInt aDistance)
sl@0	756	{
sl@0	757	iImpl->SetFocusDistance(aDistance);
sl@0	758	}
sl@0	759
sl@0	760	/**
sl@0	761	Get minimum focus distance in millimetres
sl@0	762
sl@0	763	@return the minimum (35 camera equivalent) focal length of a camera.
sl@0	764	@note Current Focal length is calculated as focalLength = opticalZoom * minFocalLength;
sl@0	765	*/
sl@0	766	EXPORT_C TInt CCamera::CCameraAdvancedSettings::GetMinFocalLength() const
sl@0	767	{
sl@0	768	return iImpl->GetMinFocalLength();
sl@0	769	}
sl@0	770
sl@0	771	/**
sl@0	772	Gets the set of camera supported ISO rates.
sl@0	773
sl@0	774	@param aSupportedIsoRates
sl@0	775	an array of integers which gets filled with the supported ISO rates.
sl@0	776
sl@0	777	@note When camera device is incapable of revealing the ISO rates supported, it has to be assumed that
sl@0	778	camera will work only on the permanently set value. If this value is not known, empty array may be
sl@0	779	returned; corresponding getter/setters for this feature should not be used in such a case.
sl@0	780	*/
sl@0	781	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedIsoRatesL(RArray<TInt>& aSupportedIsoRates) const
sl@0	782	{
sl@0	783	iImpl->GetSupportedIsoRatesL(aSupportedIsoRates);
sl@0	784	}
sl@0	785
sl@0	786	/**
sl@0	787	Gets current ISO rate.
sl@0	788
sl@0	789	@return current ISO rate as a TInt value.
sl@0	790	Negative value returned means error case (system wide error code) and positive value means current ISO rate.
sl@0	791
sl@0	792	@note The returned value may be checked with the list of supported ISO rates. If value returned does not belong to
sl@0	793	this list, then it may be treated as an error case.
sl@0	794	*/
sl@0	795	EXPORT_C TInt CCamera::CCameraAdvancedSettings::IsoRate() const
sl@0	796	{
sl@0	797	return iImpl->IsoRate();
sl@0	798	}
sl@0	799
sl@0	800	/**
sl@0	801	Set current ISO rate for the camera.
sl@0	802	Triggers KUidECamEventCameraSettingIsoRate to all MCameraObserver2 clients of the camera.
sl@0	803
sl@0	804	@param aRate
sl@0	805	required new ISO rate.
sl@0	806	*/
sl@0	807	EXPORT_C void CCamera::CCameraAdvancedSettings::SetIsoRate(TInt aRate)
sl@0	808	{
sl@0	809	iImpl->SetIsoRate(aRate);
sl@0	810	}
sl@0	811
sl@0	812	/**
sl@0	813	Gets the current discrete aperture steps (F-stops) supported by the camera.
sl@0	814
sl@0	815	@param aFStops
sl@0	816	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	817	the specific supported values. If the array is empty on return,
sl@0	818	the camera supports all integer values in the aperture range. Each value is multiplied by
sl@0	819	a factor of KECamFineResolutionFactor.
sl@0	820
sl@0	821	@param aInfo
sl@0	822	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	823
sl@0	824	@leave KErrNoMemory Out of memory.
sl@0	825
sl@0	826	@note When camera device is incapable of revealing the aperture openings supported, it has to be assumed that
sl@0	827	camera will work only on the parmanently set value. If this value is not known, empty array may be
sl@0	828	returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	829	*/
sl@0	830	EXPORT_C void CCamera::CCameraAdvancedSettings::GetAperturesL(RArray<TInt>& aFStops, TValueInfo& aInfo) const
sl@0	831	{
sl@0	832	iImpl->GetAperturesL(aFStops, aInfo);
sl@0	833	}
sl@0	834
sl@0	835	/**
sl@0	836	Get current aperture value.
sl@0	837	The default aperture value is ECAM implementation specific and could be either auto aperture or any other supported value.
sl@0	838
sl@0	839	@return Current aperture value as an integer, multiplied by KECamFineResolutionFactor.
sl@0	840	For example the function will return 280 for the actual aperture of F2.8.
sl@0	841	Negative value returned means error case (system wide error code) and positive value means current aperture.
sl@0	842	*/
sl@0	843	EXPORT_C TInt CCamera::CCameraAdvancedSettings::Aperture() const
sl@0	844	{
sl@0	845	return iImpl->Aperture();
sl@0	846	}
sl@0	847
sl@0	848	/**
sl@0	849	Set a new aperture value.
sl@0	850	All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingAperture
sl@0	851	event notification when aperture value is changed.
sl@0	852
sl@0	853	@param aFStop
sl@0	854	a new aperture value in the supported by the camera range.
sl@0	855
sl@0	856	@note The aperture parameter value is an integer, multiplied by KECamFineResolutionFactor.
sl@0	857	For example to set an aperture of F2.8, call SetAperture(280).
sl@0	858
sl@0	859	*/
sl@0	860	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAperture(TInt aFStop)
sl@0	861	{
sl@0	862	iImpl->SetAperture(aFStop);
sl@0	863	}
sl@0	864
sl@0	865	/**
sl@0	866	Gets the set of supported shutter speeds.
sl@0	867
sl@0	868	@param aShutterSpeeds
sl@0	869	a reference to an RArray of TInt representing the discrete shutter speeds supported
sl@0	870	currently by the camera.
sl@0	871
sl@0	872	@param aInfo
sl@0	873	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	874
sl@0	875	@return the populated array with all shutter speeds in microseconds.
sl@0	876
sl@0	877	@leave KErrNoMemory Out of memory.
sl@0	878
sl@0	879	@note When camera device is incapable of revealing the shutter speeds supported, it has to be assumed that
sl@0	880	camera will work only on the parmanently set value. If this value is not known, empty array may be
sl@0	881	returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	882	*/
sl@0	883	EXPORT_C void CCamera::CCameraAdvancedSettings::GetShutterSpeedsL(RArray<TInt>& aShutterSpeeds, TValueInfo& aInfo) const
sl@0	884	{
sl@0	885	iImpl->GetShutterSpeedsL(aShutterSpeeds, aInfo);
sl@0	886	}
sl@0	887
sl@0	888	/**
sl@0	889	Gets the current shutter speed
sl@0	890
sl@0	891	@return the current shutter speed in microseconds.
sl@0	892	Negative value returned means error case (system wide error code) and positive value means current shutter speed.
sl@0	893	*/
sl@0	894	EXPORT_C TInt CCamera::CCameraAdvancedSettings::ShutterSpeed() const
sl@0	895	{
sl@0	896	return iImpl->ShutterSpeed();
sl@0	897	}
sl@0	898
sl@0	899	/**
sl@0	900	Sets the current shutter speed. When set, all MCameraObserver2 clients of the camera
sl@0	901	receive a KUidECamEventCameraSettingShutterSpeed event
sl@0	902
sl@0	903	@param aShutterSpeed
sl@0	904	the required shutter speed in microseconds.
sl@0	905	*/
sl@0	906	EXPORT_C void CCamera::CCameraAdvancedSettings::SetShutterSpeed(TInt aShutterSpeed)
sl@0	907	{
sl@0	908	iImpl->SetShutterSpeed(aShutterSpeed);
sl@0	909	}
sl@0	910
sl@0	911	/**
sl@0	912	Get all supported metering modes on this camera represented as bitfield of type TMeteringMode.
sl@0	913
sl@0	914	@return the set of supported metering modes.
sl@0	915	*/
sl@0	916	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedMeteringModes() const
sl@0	917	{
sl@0	918	return iImpl->SupportedMeteringModes();
sl@0	919	}
sl@0	920
sl@0	921	/**
sl@0	922	Get current metering mode.
sl@0	923
sl@0	924	@return a value of type TMeteringMode.
sl@0	925	*/
sl@0	926	EXPORT_C CCamera::CCameraAdvancedSettings::TMeteringMode CCamera::CCameraAdvancedSettings::MeteringMode() const
sl@0	927	{
sl@0	928	return iImpl->MeteringMode();
sl@0	929	}
sl@0	930
sl@0	931	/**
sl@0	932	Set the current metering mode. When set, all MCameraObserver2 clients are notified
sl@0	933	with a KUidECamEventCameraSettingMeteringMode event.
sl@0	934
sl@0	935	@param aMeteringMode
sl@0	936	new selection for metering mode of type TMeteringMode.
sl@0	937	*/
sl@0	938	EXPORT_C void CCamera::CCameraAdvancedSettings::SetMeteringMode(CCamera::CCameraAdvancedSettings::TMeteringMode aMeteringMode)
sl@0	939	{
sl@0	940	iImpl->SetMeteringMode(aMeteringMode);
sl@0	941	}
sl@0	942
sl@0	943	/**
sl@0	944	Get all supported drive modes as bitfields of TDriveMode type.
sl@0	945
sl@0	946	@return the set of supported drive modes.
sl@0	947	*/
sl@0	948	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedDriveModes() const
sl@0	949	{
sl@0	950	TInt supportedDriveModes = iImpl->SupportedDriveModes();
sl@0	951
sl@0	952	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	953	application is not prepared to receive extra added enum values. So, any extra enum value passed
sl@0	954	from the implementation will be filtered at this point.
sl@0	955	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	956	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	957	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	958	{
sl@0	959	supportedDriveModes &= KBaselinedDriveMode;
sl@0	960	}
sl@0	961
sl@0	962	return supportedDriveModes;
sl@0	963	}
sl@0	964
sl@0	965	/**
sl@0	966	Gets currently active drive mode.
sl@0	967
sl@0	968	@return current drive mode.
sl@0	969	*/
sl@0	970	EXPORT_C CCamera::CCameraAdvancedSettings::TDriveMode CCamera::CCameraAdvancedSettings::DriveMode() const
sl@0	971	{
sl@0	972	CCamera::CCameraAdvancedSettings::TDriveMode driveMode = iImpl->DriveMode();
sl@0	973
sl@0	974	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	975	application is not prepared to receive extra added enum values. So, any extra enum value received
sl@0	976	from the implementation will be dropped and EDriveModeAuto would be passed instead.
sl@0	977	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	978	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	979	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	980	{
sl@0	981	if(static_cast<TUint>(driveMode) > KBaselinedDriveMode)
sl@0	982	{
sl@0	983	driveMode = CCamera::CCameraAdvancedSettings::EDriveModeAuto;
sl@0	984	}
sl@0	985	}
sl@0	986
sl@0	987	return driveMode;
sl@0	988	}
sl@0	989
sl@0	990	/**
sl@0	991	Set the current metering mode. When set all MCameraObserver2 clients are notified with
sl@0	992	KUidECamEventCameraSettingDriveMode.
sl@0	993
sl@0	994	@param aDriveMode
sl@0	995	new selection for drive mode value of type TDriveMode.
sl@0	996
sl@0	997	@note Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or StartPerformantVideoCaptureL())
sl@0	998	if an image/video capture is still outstanding, this method may report error KErrInUse.
sl@0	999	*/
sl@0	1000	EXPORT_C void CCamera::CCameraAdvancedSettings::SetDriveMode(CCamera::CCameraAdvancedSettings::TDriveMode aDriveMode)
sl@0	1001	{
sl@0	1002	iImpl->SetDriveMode(aDriveMode);
sl@0	1003	}
sl@0	1004
sl@0	1005	/**
sl@0	1006	Get all supported bracket modes as bitfields.
sl@0	1007
sl@0	1008	@return the set of all supported bracket modes as an integer.
sl@0	1009	*/
sl@0	1010	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedBracketModes() const
sl@0	1011	{
sl@0	1012	return iImpl->SupportedBracketModes();
sl@0	1013	}
sl@0	1014
sl@0	1015	/**
sl@0	1016	Get current bracket mode.
sl@0	1017
sl@0	1018	@return the current bracket mode TBracketMode.
sl@0	1019	*/
sl@0	1020	EXPORT_C CCamera::CCameraAdvancedSettings::TBracketMode CCamera::CCameraAdvancedSettings::BracketMode() const
sl@0	1021	{
sl@0	1022	return iImpl->BracketMode();
sl@0	1023	}
sl@0	1024
sl@0	1025	/**
sl@0	1026	Set new bracket mode. All MCameraObserver2 clients are notified with
sl@0	1027	KUidECamEventCameraSettingBracketMode.
sl@0	1028
sl@0	1029	@param aBracketMode
sl@0	1030	new selection for bracket mode of type TBracketMode.
sl@0	1031	*/
sl@0	1032	EXPORT_C void CCamera::CCameraAdvancedSettings::SetBracketMode(CCamera::CCameraAdvancedSettings::TBracketMode aBracketMode)
sl@0	1033	{
sl@0	1034	iImpl->SetBracketMode(aBracketMode);
sl@0	1035	}
sl@0	1036
sl@0	1037	/**
sl@0	1038	Get all supported bracket parameters as bitfields.
sl@0	1039
sl@0	1040	@return the set of all currently supported bracket modes.
sl@0	1041	*/
sl@0	1042	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedBracketParameters() const
sl@0	1043	{
sl@0	1044	return iImpl->SupportedBracketParameters();
sl@0	1045	}
sl@0	1046
sl@0	1047	/**
sl@0	1048	Get current bracket parameter.
sl@0	1049
sl@0	1050	@return the current bracket mode TBracketParameter.
sl@0	1051	*/
sl@0	1052	EXPORT_C CCamera::CCameraAdvancedSettings::TBracketParameter CCamera::CCameraAdvancedSettings::BracketParameter() const
sl@0	1053	{
sl@0	1054	return iImpl->BracketParameter();
sl@0	1055	}
sl@0	1056
sl@0	1057	/**
sl@0	1058	Set new bracket parameter
sl@0	1059	When set all clients are notified with
sl@0	1060	KUidECamEventCameraSettingBracketParameter.
sl@0	1061
sl@0	1062	@param aBracketParameter
sl@0	1063	new selection for parameter type of type TBracketParameter.
sl@0	1064	*/
sl@0	1065	EXPORT_C void CCamera::CCameraAdvancedSettings::SetBracketParameter(CCamera::CCameraAdvancedSettings::TBracketParameter aBracketParameter)
sl@0	1066	{
sl@0	1067	iImpl->SetBracketParameter(aBracketParameter);
sl@0	1068	}
sl@0	1069
sl@0	1070	/**
sl@0	1071	Get all supported bracket steps as bitfields.
sl@0	1072
sl@0	1073	@return the set of all supported bracket modes.
sl@0	1074	*/
sl@0	1075	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedBracketSteps() const
sl@0	1076	{
sl@0	1077	return iImpl->SupportedBracketSteps();
sl@0	1078	}
sl@0	1079
sl@0	1080	/**
sl@0	1081	Get current bracket step.
sl@0	1082
sl@0	1083	@return the current bracket mode TBracketStep.
sl@0	1084	*/
sl@0	1085	EXPORT_C CCamera::CCameraAdvancedSettings::TBracketStep CCamera::CCameraAdvancedSettings::BracketStep() const
sl@0	1086	{
sl@0	1087	return iImpl->BracketStep();
sl@0	1088	}
sl@0	1089
sl@0	1090	/**
sl@0	1091	Set new bracket step. All MCameraObserver2 clients are notified with
sl@0	1092	KUidECamEventCameraSettingBracketStep.
sl@0	1093
sl@0	1094	@param aBracketStep
sl@0	1095	new selection for step of type TBracketStep.
sl@0	1096	*/
sl@0	1097	EXPORT_C void CCamera::CCameraAdvancedSettings::SetBracketStep(CCamera::CCameraAdvancedSettings::TBracketStep aBracketStep)
sl@0	1098	{
sl@0	1099	iImpl->SetBracketStep(aBracketStep);
sl@0	1100	}
sl@0	1101
sl@0	1102	/**
sl@0	1103	Gets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
sl@0	1104	@note there must be at least two images to merge. All are assumed to form a sequence and
sl@0	1105	are identified using the first frame index and number of frames e.g. to merge two frames - one
sl@0	1106	on and one +1, when in EBracketMode3Image, one sets the start index to 1 and frames to two.
sl@0	1107	@note It is very much TBracketMode setting dependent operation.
sl@0	1108
sl@0	1109	@param aStartIndex
sl@0	1110	the index of the start frame, starts from 0.
sl@0	1111
sl@0	1112	@param aFrames
sl@0	1113	the number of frames to be merged.
sl@0	1114	*/
sl@0	1115	EXPORT_C void CCamera::CCameraAdvancedSettings::GetBracketMerge(TInt& aStartIndex, TInt& aFrames) const
sl@0	1116	{
sl@0	1117	iImpl->GetBracketMerge(aStartIndex, aFrames);
sl@0	1118	}
sl@0	1119
sl@0	1120	/**
sl@0	1121	Sets the settings for which frames to merge. Valid only in EDriveModeBracketMerge mode.
sl@0	1122	@note there must be at least two images to merge. All are assumed to form a sequence and
sl@0	1123	are identified using the first frame index and number of frames e.g. to merge two frames - one
sl@0	1124	on and one +1, when in EBracketMode3Image, one sets the start index to 1 and frames to 2.
sl@0	1125	MCameraObserver2 clients are notified with a KUidECamEventBracketMerge event.
sl@0	1126
sl@0	1127	@note It is very TBracketMode setting dependent.
sl@0	1128
sl@0	1129	@param aStartIndex
sl@0	1130	the index of the start frame, starts from 0.
sl@0	1131
sl@0	1132	@param aFrames
sl@0	1133	the number of frames to be merged.
sl@0	1134	*/
sl@0	1135	EXPORT_C void CCamera::CCameraAdvancedSettings::SetBracketMerge(TInt aStartIndex, TInt aFrames)
sl@0	1136	{
sl@0	1137	iImpl->SetBracketMerge(aStartIndex, aFrames);
sl@0	1138	}
sl@0	1139
sl@0	1140	/**
sl@0	1141	Get camera all supported flash modes CCamera::TFlash
sl@0	1142
sl@0	1143	@return the set of all supported flash modes as bitfields in an integer.
sl@0	1144	@note Some of the flash modes are available only for clients using either CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1145	@see CCamera::TFlash
sl@0	1146	*/
sl@0	1147	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedFlashModes() const
sl@0	1148	{
sl@0	1149	TInt modes = iImpl->SupportedFlashModes();
sl@0	1150	if (iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	1151	{
sl@0	1152	modes &= KBaselinedFlashModeMask;
sl@0	1153	}
sl@0	1154	return modes;
sl@0	1155	}
sl@0	1156
sl@0	1157	/**
sl@0	1158	Gets the currently set flash mode.
sl@0	1159
sl@0	1160	@return The currently set flash mode.
sl@0	1161	@note Clients not using the CCamera::New2L() or CCamera::NewDuplicate2L() would be given CCamera::EFlashAuto
sl@0	1162	if current flash mode exceeds CCamera::EFlashManual
sl@0	1163	@see CCamera::TFlash
sl@0	1164	*/
sl@0	1165	EXPORT_C CCamera::TFlash CCamera::CCameraAdvancedSettings::FlashMode() const
sl@0	1166	{
sl@0	1167	TInt mode = iImpl->FlashMode();
sl@0	1168	if (iOwner.CameraVersion() == KCameraDefaultVersion && mode > KBaselinedFlashModeMask)
sl@0	1169	{
sl@0	1170	mode = EFlashAuto;
sl@0	1171	}
sl@0	1172	return static_cast<CCamera::TFlash>(mode);
sl@0	1173	}
sl@0	1174
sl@0	1175	/**
sl@0	1176	Sets the flash mode.
sl@0	1177
sl@0	1178	Triggers a KUidECamEventCameraSettingFlashMode event to all camera
sl@0	1179	MCameraObserver2 clients.
sl@0	1180
sl@0	1181	@param aMode
sl@0	1182	The required flash mode.
sl@0	1183	*/
sl@0	1184	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFlashMode(CCamera::TFlash aMode)
sl@0	1185	{
sl@0	1186	iImpl->SetFlashMode(aMode);
sl@0	1187	}
sl@0	1188
sl@0	1189	/**
sl@0	1190	Gets whether the flash red eye reduction is switched on.
sl@0	1191
sl@0	1192	@return The present state - ETrue for switched on and EFalse for switched off.
sl@0	1193	*/
sl@0	1194	EXPORT_C TBool CCamera::CCameraAdvancedSettings::RedEyeReduceOn() const
sl@0	1195	{
sl@0	1196	return iImpl->RedEyeReduceOn();
sl@0	1197	}
sl@0	1198
sl@0	1199	/**
sl@0	1200	Sets the flash red eye reduction on or off.
sl@0	1201
sl@0	1202	Triggers a KUidECamEventCameraSettingFlashRedEyeReduce event to all camera
sl@0	1203	MCameraObserver2 clients.
sl@0	1204
sl@0	1205	@param aState
sl@0	1206	The required state ETrue for switching it on and EFalse for switching it off.
sl@0	1207	*/
sl@0	1208	EXPORT_C void CCamera::CCameraAdvancedSettings::SetRedEyeReduceOn(TBool aState)
sl@0	1209	{
sl@0	1210	iImpl->SetRedEyeReduceOn(aState);
sl@0	1211	}
sl@0	1212
sl@0	1213	/**
sl@0	1214	Get flash compensation steps as integers multiplied by KECamFineResolutionFactor.
sl@0	1215	For example 0.5 EV is 50.
sl@0	1216
sl@0	1217	@param aFlashCompensationSteps
sl@0	1218	an RArray of integers which is populated on return to reflect the supported
sl@0	1219	flash compensation steps,
sl@0	1220
sl@0	1221	@param aInfo
sl@0	1222	an TValueInfo reference, which establishes the organization of
sl@0	1223	the returned data.
sl@0	1224
sl@0	1225	@see TValueInfo
sl@0	1226
sl@0	1227	@leave KErrNoMemory Out of memory.
sl@0	1228
sl@0	1229	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1230	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1231
sl@0	1232	@note When camera device is incapable of revealing the flash compensation steps supported,
sl@0	1233	it has to be assumed that camera will work only on the parmanently set value. If this value is not known, empty
sl@0	1234	array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	1235	*/
sl@0	1236	EXPORT_C void CCamera::CCameraAdvancedSettings::GetFlashCompensationStepsL(RArray<TInt>& aFlashCompensationSteps, TValueInfo& aInfo) const
sl@0	1237	{
sl@0	1238	iImpl->GetFlashCompensationStepsL(aFlashCompensationSteps, aInfo);
sl@0	1239	}
sl@0	1240
sl@0	1241	/**
sl@0	1242	@deprecated Use TInt GetFlashCompensationStep(TInt& aFlashCompensationStep);
sl@0	1243
sl@0	1244	Get current flash power compensation step.
sl@0	1245
sl@0	1246	@return current flash compensation step.
sl@0	1247	*/
sl@0	1248	EXPORT_C TInt CCamera::CCameraAdvancedSettings::FlashCompensationStep() const
sl@0	1249	{
sl@0	1250	return iImpl->FlashCompensationStep();
sl@0	1251	}
sl@0	1252
sl@0	1253	/**
sl@0	1254	Get current flash power compensation step.
sl@0	1255
sl@0	1256	@param aFlashCompensationStep
sl@0	1257	Reference to the current flash compensation step.
sl@0	1258
sl@0	1259	@return system wide error code.
sl@0	1260
sl@0	1261	@note Use this method in place of deprecated TInt FlashCompensationStep()
sl@0	1262
sl@0	1263	*/
sl@0	1264	EXPORT_C TInt CCamera::CCameraAdvancedSettings::GetFlashCompensationStep(TInt& aFlashCompensationStep) const
sl@0	1265	{
sl@0	1266	return iImpl->GetFlashCompensationStep(aFlashCompensationStep);
sl@0	1267	}
sl@0	1268
sl@0	1269	/**
sl@0	1270	Set current flash compensation step as an integer multiplied by KECamFineResolutionFactor.
sl@0	1271	For example to set a compensation of -0.3 EV, one should use a parameter with value -30.
sl@0	1272	All clients receive a KUidECamEventCameraSettingFlashCompensationStep event, when the value has changed.
sl@0	1273
sl@0	1274	@param aFlashCompensationStep
sl@0	1275	a new value for the flash compensation step.
sl@0	1276	*/
sl@0	1277	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFlashCompensationStep(TInt aFlashCompensationStep)
sl@0	1278	{
sl@0	1279	iImpl->SetFlashCompensationStep(aFlashCompensationStep);
sl@0	1280	}
sl@0	1281
sl@0	1282	/**
sl@0	1283	Get current flash power compensation range measured in a already selected compensation step magnitude.
sl@0	1284	@note This range may change if a different compensation step is selected.
sl@0	1285	For example if flash compensation range is in the range -1EV 1.5EV and the selected flash compensation
sl@0	1286	step is selected to be 0.3 EV, the result of this call will be aNegativeCompensation = -3 and aPositiveCompensation = 5.
sl@0	1287	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	1288	In this way developers, having pre-selected a step value from the supported set, would need to provide
sl@0	1289	just the multiplier (in steps) and the direction (the sign). Steps are always assumed integers.
sl@0	1290
sl@0	1291	@param aNegativeCompensation
sl@0	1292	a reference to an integer returning the maximum number of steps available for negative compensation.
sl@0	1293
sl@0	1294	@param aPositiveCompensation
sl@0	1295	a reference to an integer returning the maximum number of steps available for positive compensation.
sl@0	1296	*/
sl@0	1297	EXPORT_C void CCamera::CCameraAdvancedSettings::GetFlashCompensationRangeInSteps(TInt& aNegativeCompensation, TInt& aPositiveCompensation) const
sl@0	1298	{
sl@0	1299	iImpl->GetFlashCompensationRangeInSteps(aNegativeCompensation, aPositiveCompensation);
sl@0	1300	}
sl@0	1301
sl@0	1302	/**
sl@0	1303	@deprecated Use TInt GetFlashCompensation(TInt& aFlashCompensation);
sl@0	1304
sl@0	1305	Get the current flash compensation value as integer steps. Positive values boost flash power,
sl@0	1306	negative reduce flash power. The change is not cumulative i.e. the change is stateless.
sl@0	1307	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	1308
sl@0	1309	@note if returned value is 2 (compensation steps) and the current flash compensation step is 0.3 EV,
sl@0	1310	then the actual compensation effect will be 0.6 EV.
sl@0	1311
sl@0	1312	@return the current number of compensation steps as an integer.
sl@0	1313	*/
sl@0	1314	EXPORT_C TInt CCamera::CCameraAdvancedSettings::FlashCompensation() const
sl@0	1315	{
sl@0	1316	return iImpl->FlashCompensation();
sl@0	1317	}
sl@0	1318
sl@0	1319	/**
sl@0	1320	Get the current flash compensation value as integer steps. Positive values boost flash power,
sl@0	1321	negative reduce flash power. The change is not cumulative i.e. the change is stateless.
sl@0	1322	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	1323
sl@0	1324	@note if retrieved value is 2 (compensation steps) and the current flash compensation step is 0.3 EV,
sl@0	1325	then the actual compensation effect will be 0.6 EV.
sl@0	1326
sl@0	1327	@param aFlashCompensation
sl@0	1328	Reference to the current number of compensation steps as an integer.
sl@0	1329
sl@0	1330	@return system wide error code.
sl@0	1331
sl@0	1332	@note Use this method in place of deprecated TInt FlashCompensation()
sl@0	1333
sl@0	1334	*/
sl@0	1335	EXPORT_C TInt CCamera::CCameraAdvancedSettings::GetFlashCompensation(TInt& aFlashCompensation) const
sl@0	1336	{
sl@0	1337	return iImpl->GetFlashCompensation(aFlashCompensation);
sl@0	1338	}
sl@0	1339
sl@0	1340	/**
sl@0	1341	Set the current flash compensation value as integer steps.
sl@0	1342	Positive values increase power, negative reduce power. The change is not acumulative e.g. the change is stateless.
sl@0	1343	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	1344	Triggers a KUidECamEventCameraSettingFlashCompensation event.
sl@0	1345
sl@0	1346	@param aFlashCompensationSteps
sl@0	1347	a required compensation steps - negative value reduce the flash power
sl@0	1348	positive boosts up the flash power.
sl@0	1349	*/
sl@0	1350	EXPORT_C void CCamera::CCameraAdvancedSettings::SetFlashCompensation(TInt aFlashCompensationSteps)
sl@0	1351	{
sl@0	1352	iImpl->SetFlashCompensation(aFlashCompensationSteps);
sl@0	1353	}
sl@0	1354
sl@0	1355	/**
sl@0	1356	Check whether there is an external flash source.
sl@0	1357
sl@0	1358	@return ETrue if an external flash source is present, EFalse otherwise
sl@0	1359	*/
sl@0	1360	EXPORT_C TBool CCamera::CCameraAdvancedSettings::IsExternalFlashPresent() const
sl@0	1361	{
sl@0	1362	return iImpl->IsExternalFlashPresent();
sl@0	1363	}
sl@0	1364
sl@0	1365	/**
sl@0	1366	Gets the current discrete manual flash power levels supported by the camera in range 0-100
sl@0	1367	as a percentage of maximum power level.
sl@0	1368
sl@0	1369	@param aManualFlashPowerLevels
sl@0	1370	An empty array of TInt which would be populated by the implementation with
sl@0	1371	the specific supported values. If the array is empty on return,
sl@0	1372	the camera does not support this functionality.
sl@0	1373
sl@0	1374	@param aInfo
sl@0	1375	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1376
sl@0	1377	@leave KErrNoMemory Out of memory.
sl@0	1378
sl@0	1379	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1380	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1381	When camera device is incapable of revealing the manual flash power levels supported,
sl@0	1382	it has to be assumed that camera will work only on the permanently set value. If this value is not known, empty
sl@0	1383	array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	1384	*/
sl@0	1385	EXPORT_C void CCamera::CCameraAdvancedSettings::GetManualFlashPowerLevelsL(RArray<TInt>& aManualFlashPowerLevels, TValueInfo& aInfo) const
sl@0	1386	{
sl@0	1387	return iImpl->GetManualFlashPowerLevelsL(aManualFlashPowerLevels, aInfo);
sl@0	1388	}
sl@0	1389
sl@0	1390	/**
sl@0	1391	Gets the current manual flash power level on the camera.
sl@0	1392
sl@0	1393	@return the current manual flash power level as a value in the range [0:100].
sl@0	1394	Negative value returned means error case (system wide error code) and positive value means current manual flash power level.
sl@0	1395	*/
sl@0	1396	EXPORT_C TInt CCamera::CCameraAdvancedSettings::ManualFlashPowerLevel() const
sl@0	1397	{
sl@0	1398	return iImpl->ManualFlashPowerLevel();
sl@0	1399	}
sl@0	1400
sl@0	1401	/**
sl@0	1402	Sets the current manual flash power level on the camera.
sl@0	1403	Triggers a KUidECamEventCameraSettingFlashManualPower event to all MCameraObserver2 clients.
sl@0	1404
sl@0	1405	@param aManualFlashPowerLevel
sl@0	1406	one of the values returned in GetManualFlashPowerLevelsL().
sl@0	1407	*/
sl@0	1408	EXPORT_C void CCamera::CCameraAdvancedSettings::SetManualFlashPowerLevel(TInt aManualFlashPowerLevel)
sl@0	1409	{
sl@0	1410	iImpl->SetManualFlashPowerLevel(aManualFlashPowerLevel);
sl@0	1411	}
sl@0	1412
sl@0	1413	/**
sl@0	1414	Get Supported exposure modes - bitfields of CCamera::TExposure
sl@0	1415
sl@0	1416	@return the set of supported exposure modes.
sl@0	1417	*/
sl@0	1418	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedExposureModes() const
sl@0	1419	{
sl@0	1420	return iImpl->SupportedExposureModes();
sl@0	1421	}
sl@0	1422
sl@0	1423	/**
sl@0	1424	Gets the currently set exposure setting value.
sl@0	1425
sl@0	1426	@return The currently set exposure setting value.
sl@0	1427	*/
sl@0	1428	EXPORT_C CCamera::TExposure CCamera::CCameraAdvancedSettings::ExposureMode() const
sl@0	1429	{
sl@0	1430	return iImpl->ExposureMode();
sl@0	1431	}
sl@0	1432
sl@0	1433	/**
sl@0	1434	Sets the exposure mode of the camera.
sl@0	1435	Triggers a KUidECamEventCameraSettingExposureMode event to all MCameraObserver2 clients.
sl@0	1436
sl@0	1437	@param aExposureMode
sl@0	1438	The required exposure adjustment.
sl@0	1439	*/
sl@0	1440	EXPORT_C void CCamera::CCameraAdvancedSettings::SetExposureMode(CCamera::TExposure aExposureMode)
sl@0	1441	{
sl@0	1442	iImpl->SetExposureMode(aExposureMode);
sl@0	1443	}
sl@0	1444
sl@0	1445	/**
sl@0	1446	Get exposure compensation steps as integers multiplied by KECamFineResolutionFactor.
sl@0	1447	For example 0.3 EV is 30.
sl@0	1448
sl@0	1449	@param aExposureCompensationSteps
sl@0	1450	an RArray of integers which is populated to reflect the supported
sl@0	1451	exposure compensation steps, all values have been multiplied by KECamFineResolutionFactor before
sl@0	1452	truncated to integers.
sl@0	1453
sl@0	1454	@param aInfo
sl@0	1455	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1456
sl@0	1457	@leave KErrNoMemory Out of memory.
sl@0	1458
sl@0	1459	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1460	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1461	When camera device is incapable of revealing the exposure compensation steps supported,
sl@0	1462	it has to be assumed that camera will work only on the permanently set value. If this value is not known, empty
sl@0	1463	array may be returned and TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	1464	*/
sl@0	1465	EXPORT_C void CCamera::CCameraAdvancedSettings::GetExposureCompensationStepsL(RArray<TInt>& aExposureCompensationSteps, TValueInfo& aInfo) const
sl@0	1466	{
sl@0	1467	iImpl->GetExposureCompensationStepsL(aExposureCompensationSteps, aInfo);
sl@0	1468	}
sl@0	1469
sl@0	1470	/**
sl@0	1471	@deprecated Use TInt GetExposureCompensationStep(TInt& aExposureCompensationStep);
sl@0	1472
sl@0	1473	Get current exposure compensation step.
sl@0	1474
sl@0	1475	@return the current exposure compensation step.
sl@0	1476	*/
sl@0	1477	EXPORT_C TInt CCamera::CCameraAdvancedSettings::ExposureCompensationStep() const
sl@0	1478	{
sl@0	1479	return iImpl->ExposureCompensationStep();
sl@0	1480	}
sl@0	1481
sl@0	1482	/**
sl@0	1483	Get current exposure compensation step.
sl@0	1484
sl@0	1485	@param aExposureCompensationStep
sl@0	1486	Reference to the current exposure compensation step.
sl@0	1487
sl@0	1488	@return system wide error code.
sl@0	1489
sl@0	1490	@note Use this method in place of deprecated TInt ExposureCompensationStep()
sl@0	1491
sl@0	1492	*/
sl@0	1493	EXPORT_C TInt CCamera::CCameraAdvancedSettings::GetExposureCompensationStep(TInt& aExposureCompensationStep) const
sl@0	1494	{
sl@0	1495	return iImpl->GetExposureCompensationStep(aExposureCompensationStep);
sl@0	1496	}
sl@0	1497
sl@0	1498	/**
sl@0	1499	Set current exposure compensation step as an integer multiplied by KECamFineResolutionFactor.
sl@0	1500	All MCameraObserver2 clients receive a KUidECamEventCameraSettingExposureCompensationStep event,
sl@0	1501	when the value has changed.
sl@0	1502
sl@0	1503	@param aExposureCompensationStep
sl@0	1504	a new value for the exposure compensation step.
sl@0	1505	*/
sl@0	1506	EXPORT_C void CCamera::CCameraAdvancedSettings::SetExposureCompensationStep(TInt aExposureCompensationStep)
sl@0	1507	{
sl@0	1508	iImpl->SetExposureCompensationStep(aExposureCompensationStep);
sl@0	1509	}
sl@0	1510
sl@0	1511	/**
sl@0	1512	Get current exposure compensation range in steps. It depends on the previously
sl@0	1513	selected exposure compensation step.
sl@0	1514
sl@0	1515	@see GetFlashCompensationRangeInSteps()
sl@0	1516
sl@0	1517	@param aNegativeCompensation
sl@0	1518	reference to an integer returning the maximum number of steps
sl@0	1519	available for negative compensation,
sl@0	1520
sl@0	1521	@param aPositiveCompensation
sl@0	1522	reference to an integer returning the maximum number of steps
sl@0	1523	available for positive compensation,
sl@0	1524	*/
sl@0	1525	EXPORT_C void CCamera::CCameraAdvancedSettings::GetExposureCompensationRangeInSteps(TInt& aNegativeCompensation, TInt& aPositiveCompensation) const
sl@0	1526	{
sl@0	1527	iImpl->GetExposureCompensationRangeInSteps(aNegativeCompensation, aPositiveCompensation);
sl@0	1528	}
sl@0	1529
sl@0	1530	/**
sl@0	1531	@deprecated Use TInt GetExposureCompensation(TInt& aExposureCompensation);
sl@0	1532
sl@0	1533	Get the current exposure compensation steps. Positive values increase exposure times,
sl@0	1534	negative reduce exposure times. The change is not cumulative i.e. the change is stateless.
sl@0	1535	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	1536
sl@0	1537	@note if returned value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV,
sl@0	1538	then the actual compensation effect will be 0.6 EV.
sl@0	1539
sl@0	1540	@return current number of compensation steps as an integer.
sl@0	1541	*/
sl@0	1542	EXPORT_C TInt CCamera::CCameraAdvancedSettings::ExposureCompensation() const
sl@0	1543	{
sl@0	1544	return iImpl->ExposureCompensation();
sl@0	1545	}
sl@0	1546
sl@0	1547	/**
sl@0	1548	Get the current exposure compensation steps. Positive values increase exposure times,
sl@0	1549	negative reduce exposure times. The change is not cumulative i.e. the change is stateless.
sl@0	1550	Each call assumes no previous compensation has been performed i.e. that there is a zero compensation.
sl@0	1551
sl@0	1552	@note if retrieved value is 2 (compensation steps) and the current exposure compensation step is 0.3 EV,
sl@0	1553	then the actual compensation effect will be 0.6 EV.
sl@0	1554
sl@0	1555	@param aExposureCompensation
sl@0	1556	Reference to the current number of compensation steps as an integer.
sl@0	1557
sl@0	1558	@return system wide error code.
sl@0	1559
sl@0	1560	@note Use this method in place of deprecated TInt ExposureCompensation()
sl@0	1561
sl@0	1562	*/
sl@0	1563	EXPORT_C TInt CCamera::CCameraAdvancedSettings::GetExposureCompensation(TInt& aExposureCompensation) const
sl@0	1564	{
sl@0	1565	return iImpl->GetExposureCompensation(aExposureCompensation);
sl@0	1566	}
sl@0	1567
sl@0	1568	/**
sl@0	1569	Set the current exposure compensation value as integer steps.
sl@0	1570	Triggers a KUidECamEventCameraSettingExposureCompensation event to all MCameraObserver2 clients.
sl@0	1571
sl@0	1572	@param aExposureCompensationSteps
sl@0	1573	a required number of compensation steps - negative value reduce the exposure time
sl@0	1574	positive increases the exposure time.
sl@0	1575	*/
sl@0	1576	EXPORT_C void CCamera::CCameraAdvancedSettings::SetExposureCompensation(TInt aExposureCompensationSteps)
sl@0	1577	{
sl@0	1578	iImpl->SetExposureCompensation(aExposureCompensationSteps);
sl@0	1579	}
sl@0	1580
sl@0	1581	/**
sl@0	1582	Gets camera supported set of white balance adjustments.
sl@0	1583
sl@0	1584	@return bitfield of all supported CCamera::TWhiteBalance values.
sl@0	1585
sl@0	1586	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	1587	application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised) passed
sl@0	1588	from the implementation will be filtered at this point.
sl@0	1589	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1590	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
sl@0	1591	*/
sl@0	1592	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedWhiteBalanceModes() const
sl@0	1593	{
sl@0	1594	TInt supportedWhiteBalanceModes = iImpl->SupportedWhiteBalanceModes();
sl@0	1595
sl@0	1596	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	1597	application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised) passed
sl@0	1598	from the implementation will be filtered at this point.
sl@0	1599	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1600	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	1601	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	1602	{
sl@0	1603	supportedWhiteBalanceModes &= KBaselinedWhiteBalanceModes;
sl@0	1604	}
sl@0	1605
sl@0	1606	return supportedWhiteBalanceModes;
sl@0	1607	}
sl@0	1608
sl@0	1609	/**
sl@0	1610	Gets the current white balance value.
sl@0	1611
sl@0	1612	@return The current white balance value.
sl@0	1613
sl@0	1614	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	1615	application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised) received
sl@0	1616	from the implementation will be dropped and EWBAuto would be passed instead.
sl@0	1617	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1618	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
sl@0	1619	*/
sl@0	1620	EXPORT_C CCamera::TWhiteBalance CCamera::CCameraAdvancedSettings::WhiteBalanceMode() const
sl@0	1621	{
sl@0	1622	CCamera::TWhiteBalance whiteBalance = iImpl->WhiteBalanceMode();
sl@0	1623
sl@0	1624	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	1625	application is not prepared to receive extra added enum values. So, any extra enum value(unrecognised) received
sl@0	1626	from the implementation will be dropped and EWBAuto would be passed instead.
sl@0	1627	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1628	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	1629	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	1630	{
sl@0	1631	if(static_cast<TInt>(whiteBalance) > KBaselinedWhiteBalanceModes)
sl@0	1632	{
sl@0	1633	whiteBalance = CCamera::EWBAuto;
sl@0	1634	}
sl@0	1635	}
sl@0	1636
sl@0	1637	return whiteBalance;
sl@0	1638	}
sl@0	1639
sl@0	1640	/**
sl@0	1641	Sets the white balance adjustment of the camera.
sl@0	1642
sl@0	1643	No effect if this is not supported, see TCameraInfo::iWhiteBalanceModesSupported.
sl@0	1644	Triggers KUidECamEventCameraSettingWhiteBalanceMode event to all MCameraObserver2 clients.
sl@0	1645
sl@0	1646	@param aWhiteBalanceMode
sl@0	1647	The required white balance mode.
sl@0	1648	*/
sl@0	1649	EXPORT_C void CCamera::CCameraAdvancedSettings::SetWhiteBalanceMode(CCamera::TWhiteBalance aWhiteBalanceMode)
sl@0	1650	{
sl@0	1651	iImpl->SetWhiteBalanceMode(aWhiteBalanceMode);
sl@0	1652	}
sl@0	1653
sl@0	1654	/**
sl@0	1655	Gets the current state for aperture and exposure lock.
sl@0	1656
sl@0	1657	@return ETrue if aperture and exposure values are locked together,
sl@0	1658	EFalse if these are not locked.
sl@0	1659	*/
sl@0	1660	EXPORT_C TBool CCamera::CCameraAdvancedSettings::ApertureExposureLockOn() const
sl@0	1661	{
sl@0	1662	return iImpl->ApertureExposureLockOn();
sl@0	1663	}
sl@0	1664
sl@0	1665	/**
sl@0	1666	Sets the current state for aperture and exposure lock.
sl@0	1667	Triggers a KUidECamEventAELock event to all MCameraObserver2 clients.
sl@0	1668
sl@0	1669	@param aAELock
sl@0	1670	a value whether to lock exposure and aperture together.
sl@0	1671	*/
sl@0	1672	EXPORT_C void CCamera::CCameraAdvancedSettings::SetApertureExposureLockOn(TBool aAELock)
sl@0	1673	{
sl@0	1674	iImpl->SetApertureExposureLockOn(aAELock);
sl@0	1675	}
sl@0	1676
sl@0	1677	/**
sl@0	1678	Gets the current state for button clicking sound effect.
sl@0	1679
sl@0	1680	@return ETrue to switch clicking sound on, EFalse sound off
sl@0	1681	*/
sl@0	1682	EXPORT_C TBool CCamera::CCameraAdvancedSettings::ShootClickOn() const
sl@0	1683	{
sl@0	1684	return iImpl->ShootClickOn();
sl@0	1685	}
sl@0	1686
sl@0	1687	/**
sl@0	1688	Sets the button clicking sound on /off. Triggers a KUidECamEventSoundClick event
sl@0	1689	to all MCameraObserver2 clients.
sl@0	1690
sl@0	1691	@param aShootClickOn
sl@0	1692	ETrue to switch clicking sound on, EFalse sound is switched off.
sl@0	1693	*/
sl@0	1694	EXPORT_C void CCamera::CCameraAdvancedSettings::SetShootClickOn(TBool aShootClickOn)
sl@0	1695	{
sl@0	1696	iImpl->SetShootClickOn(aShootClickOn);
sl@0	1697	}
sl@0	1698
sl@0	1699	/**
sl@0	1700	Get camera supported timer values. Active only when drive mode EDriveModeTimed.
sl@0	1701	Time is in microseconds. As time interval is expected to be relatively short,
sl@0	1702	integer value is considered sufficient.
sl@0	1703
sl@0	1704	@param aTimerIntervals
sl@0	1705	an RArray of integers which is populated to reflect the supported
sl@0	1706	timer interval steps.
sl@0	1707
sl@0	1708	@param aInfo
sl@0	1709	an TValueInfo reference, which establishes the organization of
sl@0	1710	the returned data.
sl@0	1711
sl@0	1712	@see TValueInfo
sl@0	1713
sl@0	1714	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1715	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1716	*/
sl@0	1717	EXPORT_C void CCamera::CCameraAdvancedSettings::GetTimerIntervalsL(RArray<TInt>& aTimerIntervals, TValueInfo& aInfo) const
sl@0	1718	{
sl@0	1719	iImpl->GetTimerIntervalsL(aTimerIntervals, aInfo);
sl@0	1720	}
sl@0	1721
sl@0	1722	/**
sl@0	1723	Get current timer value. Active only when drive mode is EDriveModeTimed.
sl@0	1724	Timer resolution is in microseconds.
sl@0	1725
sl@0	1726	@return current time interval value.
sl@0	1727	Negative value returned means error case (system wide error code) and positive value means current timer interval.
sl@0	1728	*/
sl@0	1729	EXPORT_C TInt CCamera::CCameraAdvancedSettings::TimerInterval() const
sl@0	1730	{
sl@0	1731	return iImpl->TimerInterval();
sl@0	1732	}
sl@0	1733
sl@0	1734	/**
sl@0	1735	Set current timer value. Active only when drive mode EDriveModeTimed.
sl@0	1736	This is the time interval (delay) in microseconds between user pressing the button and image is taken.
sl@0	1737	The setting of the value triggers a KUidECamEventCameraSettingTimerInterval event
sl@0	1738	to all MCameraObserver2 clients.
sl@0	1739
sl@0	1740	@param aTimerInterval
sl@0	1741	The selected timer interval in microseconds.
sl@0	1742	*/
sl@0	1743	EXPORT_C void CCamera::CCameraAdvancedSettings::SetTimerInterval(TInt aTimerInterval)
sl@0	1744	{
sl@0	1745	iImpl->SetTimerInterval(aTimerInterval);
sl@0	1746	}
sl@0	1747
sl@0	1748	/**
sl@0	1749	Get camera supported time lapse period range. Active only when drive mode EDriveModeTimeLapse.
sl@0	1750	The time lapse is denoted as the uniform time period between consecutive frames.
sl@0	1751
sl@0	1752	@param aTimeLapseMin
sl@0	1753	The minimum time value.
sl@0	1754
sl@0	1755	@param aTimeLapseMax
sl@0	1756	The maximum time value.
sl@0	1757	*/
sl@0	1758	EXPORT_C void CCamera::CCameraAdvancedSettings::GetTimeLapsePeriodRange(TTime& aTimeLapseMin, TTime& aTimeLapseMax) const
sl@0	1759	{
sl@0	1760	iImpl->GetTimeLapsePeriodRange(aTimeLapseMin, aTimeLapseMax);
sl@0	1761	}
sl@0	1762
sl@0	1763	/**
sl@0	1764	Get current time lapse value. Active only when drive mode EDriveModeTimeLapse.
sl@0	1765	The time lapse is denoted as the uniform time period
sl@0	1766	between consecutive frames and operation is configurable by its start, end and a fixed interval.
sl@0	1767
sl@0	1768	@param aStart
sl@0	1769	the start of the timelapse period.
sl@0	1770
sl@0	1771	@param aEnd
sl@0	1772	the end of the timelapse period; start < end.
sl@0	1773
sl@0	1774	@param aInterval
sl@0	1775	the set parameter between two successive snapshots.
sl@0	1776	*/
sl@0	1777	EXPORT_C void CCamera::CCameraAdvancedSettings::GetTimeLapse(TTime& aStart, TTime& aEnd, TTime& aInterval) const
sl@0	1778	{
sl@0	1779	iImpl->GetTimeLapse(aStart, aEnd, aInterval);
sl@0	1780	}
sl@0	1781
sl@0	1782	/**
sl@0	1783	Set current time lapse value. Active only when drive mode EDriveModeTimeLapse.
sl@0	1784	The time lapse is denoted as the uniform time period between consecutive frames.
sl@0	1785	Setting triggers a KUidECamEventCameraSettingTimeLapse event to all MCameraObserver2 camera clients.
sl@0	1786
sl@0	1787	@param aStart
sl@0	1788	the start of the timelapse period.
sl@0	1789
sl@0	1790	@param aEnd
sl@0	1791	the end of the timelapse period; start < end.
sl@0	1792
sl@0	1793	@param aInterval
sl@0	1794	the set parameter between two successive snapshots.
sl@0	1795	*/
sl@0	1796	EXPORT_C void CCamera::CCameraAdvancedSettings::SetTimeLapse(const TTime& aStart, const TTime& aEnd, const TTime& aInterval)
sl@0	1797	{
sl@0	1798	iImpl->SetTimeLapse(aStart, aEnd, aInterval);
sl@0	1799	}
sl@0	1800
sl@0	1801	/**
sl@0	1802	Get current picture orientation
sl@0	1803
sl@0	1804	@return a TPictureOrientation value.
sl@0	1805	*/
sl@0	1806	EXPORT_C CCamera::CCameraAdvancedSettings::TPictureOrientation CCamera::CCameraAdvancedSettings::PictureOrientation() const
sl@0	1807	{
sl@0	1808	return iImpl->PictureOrientation();
sl@0	1809	}
sl@0	1810
sl@0	1811	/**
sl@0	1812	Set a new picture orientation
sl@0	1813	This triggers a KUidECamEventCameraSettingPictureOrientation event to all MCameraObserver2 clients.
sl@0	1814
sl@0	1815	@param aOrientation
sl@0	1816	a value of TPictureOrientation denoting the new orientation.
sl@0	1817	*/
sl@0	1818	EXPORT_C void CCamera::CCameraAdvancedSettings::SetPictureOrientation(CCamera::CCameraAdvancedSettings::TPictureOrientation aOrientation)
sl@0	1819	{
sl@0	1820	iImpl->SetPictureOrientation(aOrientation);
sl@0	1821	}
sl@0	1822
sl@0	1823	/**
sl@0	1824	Get supported pixel aspect ratio.
sl@0	1825
sl@0	1826	@return a bitfield of all supported TPixelAspectRatio values.
sl@0	1827	@note Some of the pixel aspect ratios are available only for clients using either CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1828	*/
sl@0	1829	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedPixelAspectRatios() const
sl@0	1830	{
sl@0	1831	TInt supportedRatios = iImpl->SupportedPixelAspectRatios();
sl@0	1832	/**
sl@0	1833	Mask out new features for old clients
sl@0	1834	*/
sl@0	1835	if (iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	1836	{
sl@0	1837	supportedRatios &= KBaselinedPixelAspectsMask;
sl@0	1838	}
sl@0	1839	return supportedRatios;
sl@0	1840	}
sl@0	1841
sl@0	1842	/**
sl@0	1843	Get current pixel aspect ratio.
sl@0	1844
sl@0	1845	@return a TPixelAspectRatio value.
sl@0	1846	@note Some of the pixel aspect ratios are available only for clients using either CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	1847	*/
sl@0	1848	EXPORT_C CCamera::CCameraAdvancedSettings::TPixelAspectRatio CCamera::CCameraAdvancedSettings::PixelAspectRatio() const
sl@0	1849	{
sl@0	1850	TInt ratio = iImpl->PixelAspectRatio();
sl@0	1851	/**
sl@0	1852	Mask out new features for old clients
sl@0	1853	*/
sl@0	1854	if (iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	1855	{
sl@0	1856	ratio &= KBaselinedPixelAspectsMask;
sl@0	1857	}
sl@0	1858	return static_cast<CCamera::CCameraAdvancedSettings::TPixelAspectRatio>( ratio );
sl@0	1859	}
sl@0	1860
sl@0	1861	/**
sl@0	1862	Set a new pixel aspect ratio.
sl@0	1863	This triggers a KUidECamEventPixelAspectRatio event to all MCameraObserver2 clients.
sl@0	1864
sl@0	1865	@param aPixelAspectRatio
sl@0	1866	a value of TPixelAspectRatio denoting the new pixel aspect ratio.
sl@0	1867	*/
sl@0	1868	EXPORT_C void CCamera::CCameraAdvancedSettings::SetPixelAspectRatio(CCamera::CCameraAdvancedSettings::TPixelAspectRatio aPixelAspectRatio)
sl@0	1869	{
sl@0	1870	iImpl->SetPixelAspectRatio(aPixelAspectRatio);
sl@0	1871	}
sl@0	1872
sl@0	1873	/**
sl@0	1874	Get supported YUV ranges.
sl@0	1875
sl@0	1876	@return a bitfileld of all supported TYuvRange values.
sl@0	1877	*/
sl@0	1878	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedYuvRanges() const
sl@0	1879	{
sl@0	1880	return iImpl->SupportedYuvRanges();
sl@0	1881	}
sl@0	1882
sl@0	1883	/**
sl@0	1884	Get current YUV range.
sl@0	1885
sl@0	1886	@return a TYuvRange value.
sl@0	1887	*/
sl@0	1888	EXPORT_C CCamera::CCameraAdvancedSettings::TYuvRange CCamera::CCameraAdvancedSettings::YuvRange() const
sl@0	1889	{
sl@0	1890	return iImpl->YuvRange();
sl@0	1891	}
sl@0	1892
sl@0	1893	/**
sl@0	1894	Set a new YUV range.
sl@0	1895	This triggers a KUidECamEventYuvRange event to all MCameraObserver2 clients.
sl@0	1896
sl@0	1897	@param aYuvRange
sl@0	1898	a value of TYuvRange denoting the new YUV range.
sl@0	1899	*/
sl@0	1900	EXPORT_C void CCamera::CCameraAdvancedSettings::SetYuvRange(CCamera::CCameraAdvancedSettings::TYuvRange aYuvRange)
sl@0	1901	{
sl@0	1902	iImpl->SetYuvRange(aYuvRange);
sl@0	1903	}
sl@0	1904
sl@0	1905	/**
sl@0	1906	Get the number of images captured normally under EDriveModeBurst condition.
sl@0	1907	@note: due to memory or image size limitations the actual number may be less.
sl@0	1908
sl@0	1909	@return the number of images set to capture in burst mode.
sl@0	1910	*/
sl@0	1911	EXPORT_C TInt CCamera::CCameraAdvancedSettings::BurstImages() const
sl@0	1912	{
sl@0	1913	return iImpl->BurstImages();
sl@0	1914	}
sl@0	1915
sl@0	1916	/**
sl@0	1917	Set the number of images captured normally under EDriveModeBurst condition.
sl@0	1918	Triggers a KUidECamEventBurstImages event to all MCameraObserver2 clients.
sl@0	1919	@note: due to memory or image size limitations the actual number may be less.
sl@0	1920
sl@0	1921	@param aImages
sl@0	1922	the number of images set to capture in burst mode
sl@0	1923
sl@0	1924	@note Unless reduced Latency scheme is not used (ie CaptureImageL(TInt aSequenceNumber) or StartPerformantVideoCaptureL())
sl@0	1925	if an image/video capture is still outstanding, this method may report error KErrInUse.
sl@0	1926	*/
sl@0	1927	EXPORT_C void CCamera::CCameraAdvancedSettings::SetBurstImages(TInt aImages)
sl@0	1928	{
sl@0	1929	iImpl->SetBurstImages(aImages);
sl@0	1930	}
sl@0	1931
sl@0	1932	/**
sl@0	1933	Gets the optical zoom levels.
sl@0	1934
sl@0	1935	@param aOpticalZoomSteps
sl@0	1936	Array to hold optical zoom values multiplied by KECamFineResolutionFactor to retain precision.
sl@0	1937	So that if zoom is not supported the array will return a single element of value
sl@0	1938	KECamFineResolutionFactor.
sl@0	1939
sl@0	1940	@param aInfo
sl@0	1941	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1942
sl@0	1943	@note Such approach allows for support for both linear and non-linear zoom steps.
sl@0	1944	When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1945	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1946
sl@0	1947	@leave KErrNoMemory Out of memory.
sl@0	1948	*/
sl@0	1949	EXPORT_C void CCamera::CCameraAdvancedSettings::GetOpticalZoomStepsL(RArray<TInt>& aOpticalZoomSteps, TValueInfo& aInfo) const
sl@0	1950	{
sl@0	1951	iImpl->GetOpticalZoomStepsL(aOpticalZoomSteps, aInfo);
sl@0	1952	}
sl@0	1953
sl@0	1954	/**
sl@0	1955	Gets the currently set zoom value.
sl@0	1956
sl@0	1957	@return The currently set optical zoom value. The value is multiplied by
sl@0	1958	KECamFineResolutionFactor to retain precision.
sl@0	1959	Negative value returned means error case (system wide error code) and positive value means current optical zoom.
sl@0	1960	*/
sl@0	1961	EXPORT_C TInt CCamera::CCameraAdvancedSettings::OpticalZoom() const
sl@0	1962	{
sl@0	1963	return iImpl->OpticalZoom();
sl@0	1964	}
sl@0	1965
sl@0	1966	/**
sl@0	1967	Sets the zoom using a specific value. Triggers a KUidECamEventCameraSettingOpticalZoom
sl@0	1968	event to all MCameraObserver2 clients.
sl@0	1969
sl@0	1970	@param aOpticalZoom
sl@0	1971	Required zoom value.
sl@0	1972	*/
sl@0	1973	EXPORT_C void CCamera::CCameraAdvancedSettings::SetOpticalZoom(TInt aOpticalZoom)
sl@0	1974	{
sl@0	1975	iImpl->SetOpticalZoom(aOpticalZoom);
sl@0	1976	}
sl@0	1977
sl@0	1978	/**
sl@0	1979	Gets the digital zoom levels.
sl@0	1980
sl@0	1981	@param aDigitalZoomSteps
sl@0	1982	Array to hold digital zoom values multiplied by KECamFineResolutionFactor to retain precision.
sl@0	1983	So that if zoom is not supported the array will return a single element of value
sl@0	1984	KECamFineResolutionFactor.
sl@0	1985
sl@0	1986	@param aInfo
sl@0	1987	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	1988
sl@0	1989	@note Such approach allows for support for both linear and non-linear zoom steps.
sl@0	1990	When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	1991	corresponding getter/setters for this feature should not be used in such a case.
sl@0	1992
sl@0	1993	@leave KErrNoMemory Out of memory.
sl@0	1994	*/
sl@0	1995	EXPORT_C void CCamera::CCameraAdvancedSettings::GetDigitalZoomStepsL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo) const
sl@0	1996	{
sl@0	1997	iImpl->GetDigitalZoomStepsL(aDigitalZoomSteps, aInfo);
sl@0	1998	}
sl@0	1999
sl@0	2000	/**
sl@0	2001	Gets the currently set digital zoom value.
sl@0	2002
sl@0	2003	@return The currently set digital zoom value. The value is multiplied by
sl@0	2004	KECamFineResolutionFactor to retain precision.
sl@0	2005	Negative value returned means error case (system wide error code) and positive value means current digital zoom.
sl@0	2006	*/
sl@0	2007	EXPORT_C TInt CCamera::CCameraAdvancedSettings::DigitalZoom() const
sl@0	2008	{
sl@0	2009	return iImpl->DigitalZoom();
sl@0	2010	}
sl@0	2011
sl@0	2012	/**
sl@0	2013	Sets the digital zoom value. Triggers a KUidECamEventCameraSettingDigitalZoom event
sl@0	2014	to all MCameraObserver2 clients.
sl@0	2015
sl@0	2016	@param aDigitalZoom
sl@0	2017	Required zoom value.
sl@0	2018	*/
sl@0	2019	EXPORT_C void CCamera::CCameraAdvancedSettings::SetDigitalZoom(TInt aDigitalZoom)
sl@0	2020	{
sl@0	2021	iImpl->SetDigitalZoom(aDigitalZoom);
sl@0	2022	}
sl@0	2023
sl@0	2024	/**
sl@0	2025	Checks whether exposure value is locked or not.
sl@0	2026
sl@0	2027	@return whether exposure value is locked or not.
sl@0	2028	ETrue if locked, EFalse otherwise.
sl@0	2029	*/
sl@0	2030	EXPORT_C TBool CCamera::CCameraAdvancedSettings::ExposureLockOn() const
sl@0	2031	{
sl@0	2032	return iImpl->ExposureLockOn();
sl@0	2033	}
sl@0	2034
sl@0	2035	/**
sl@0	2036	Sets exposure lock state. Triggers a KUidECamEventCameraSettingExposureLock event
sl@0	2037	to all MCameraObserver2 clients.
sl@0	2038
sl@0	2039	@param aState
sl@0	2040	Required new state.
sl@0	2041	*/
sl@0	2042	EXPORT_C void CCamera::CCameraAdvancedSettings::SetExposureLockOn(TBool aState)
sl@0	2043	{
sl@0	2044	iImpl->SetExposureLockOn(aState);
sl@0	2045	}
sl@0	2046
sl@0	2047	/**
sl@0	2048	Checks whether AutoFocus value is locked or not.
sl@0	2049
sl@0	2050	@return whether AutoFocus value is locked or not.
sl@0	2051	ETrue if locked, EFalse otherwise.
sl@0	2052	*/
sl@0	2053	EXPORT_C TBool CCamera::CCameraAdvancedSettings::AutoFocusLockOn() const
sl@0	2054	{
sl@0	2055	return iImpl->AutoFocusLockOn();
sl@0	2056	}
sl@0	2057
sl@0	2058	/**
sl@0	2059	Sets autofocus lock state. Triggers a KUidECamEventCameraSettingAutoFocusLock event
sl@0	2060	to all MCameraObserver2 clients.
sl@0	2061
sl@0	2062	@param aState
sl@0	2063	Required new state.
sl@0	2064	*/
sl@0	2065	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAutoFocusLockOn(TBool aState)
sl@0	2066	{
sl@0	2067	iImpl->SetAutoFocusLockOn(aState);
sl@0	2068	}
sl@0	2069
sl@0	2070	/**
sl@0	2071	Gets an array of all the advanced settings parameters supported by the camera.
sl@0	2072	These are identified by UIDs and relate to the set or subset of it of all defined settings UIDs.
sl@0	2073
sl@0	2074	@param aSettings
sl@0	2075	An empty array of TUids which would be populated by the implementation with
sl@0	2076	the UIDs of the supported parameters. If the array is empty on return,
sl@0	2077	the camera does not support any settings.
sl@0	2078
sl@0	2079	@leave KErrNoMemory Out of memory.
sl@0	2080
sl@0	2081	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2082	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2083	from the implementation will be filtered at this point.
sl@0	2084	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2085	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	2086	*/
sl@0	2087	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray<TUid>& aSettings) const
sl@0	2088	{
sl@0	2089	iImpl->GetSupportedSettingsL(aSettings);
sl@0	2090
sl@0	2091	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2092	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2093	from the implementation will be filtered at this point.
sl@0	2094	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2095	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	2096	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	2097	{
sl@0	2098	for(TInt index =0; index < aSettings.Count(); index++)
sl@0	2099	{
sl@0	2100	/** KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has
sl@0	2101	been added in later versions */
sl@0	2102	if(aSettings[index].iUid > KUidECamEventCameraSettingAutoFocusType2UidValue)
sl@0	2103	{
sl@0	2104	aSettings.Remove(index);
sl@0	2105	index--;
sl@0	2106	}
sl@0	2107	}
sl@0	2108	}
sl@0	2109	}
sl@0	2110
sl@0	2111	/**
sl@0	2112	Gets an array of all the advanced settings parameters currently active on the camera.
sl@0	2113	These are identified by UIDs and relate to the set or subset of it of all supported
sl@0	2114	settings UIDs.
sl@0	2115
sl@0	2116	@param aActiveSettings
sl@0	2117	An empty array of TUids which would be populated by the implementation with
sl@0	2118	the active setting UIDs. If the array is empty on return,
sl@0	2119	the camera does not support any settings.
sl@0	2120
sl@0	2121	@leave KErrNoMemory Out of memory.
sl@0	2122
sl@0	2123	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2124	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2125	from the implementation will be filtered at this point.
sl@0	2126	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2127	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	2128	*/
sl@0	2129	EXPORT_C void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray<TUid>& aActiveSettings) const
sl@0	2130	{
sl@0	2131	iImpl->GetActiveSettingsL(aActiveSettings);
sl@0	2132
sl@0	2133	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2134	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2135	from the implementation will be filtered at this point.
sl@0	2136	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2137	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	2138	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	2139	{
sl@0	2140	for(TInt index =0; index < aActiveSettings.Count(); index++)
sl@0	2141	{
sl@0	2142	/** KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has
sl@0	2143	been added in later versions */
sl@0	2144	if(aActiveSettings[index].iUid > KUidECamEventCameraSettingAutoFocusType2UidValue)
sl@0	2145	{
sl@0	2146	aActiveSettings.Remove(index);
sl@0	2147	index--;
sl@0	2148	}
sl@0	2149	}
sl@0	2150	}
sl@0	2151	}
sl@0	2152
sl@0	2153	/**
sl@0	2154	Gets an array of all the advanced settings parameters currently disabled on the camera.
sl@0	2155	These are identified by UIDs and relate to the set or subset of it of all supported
sl@0	2156	settings UIDs.
sl@0	2157
sl@0	2158	@param aDisabledSettings
sl@0	2159	An empty array of TUids which would be populated by the implementation with
sl@0	2160	the disabled setting UIDs. If the array is empty on return,
sl@0	2161	the camera does not support any settings.
sl@0	2162
sl@0	2163	@leave KErrNoMemory Out of memory.
sl@0	2164
sl@0	2165	@note if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2166	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2167	from the implementation will be filtered at this point.
sl@0	2168	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2169	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values
sl@0	2170	*/
sl@0	2171	EXPORT_C void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray<TUid>& aDisabledSettings) const
sl@0	2172	{
sl@0	2173	iImpl->GetDisabledSettingsL(aDisabledSettings);
sl@0	2174
sl@0	2175	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2176	application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed
sl@0	2177	from the implementation will be filtered at this point.
sl@0	2178	To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2179	to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0	2180	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	2181	{
sl@0	2182	for(TInt index =0; index < aDisabledSettings.Count(); index++)
sl@0	2183	{
sl@0	2184	/** KUidECamEventCameraSettingAutoFocusType2UidValue is the baseline. Any settings with greater uid value means that it has
sl@0	2185	been added in later versions */
sl@0	2186	if(aDisabledSettings[index].iUid > KUidECamEventCameraSettingAutoFocusType2UidValue)
sl@0	2187	{
sl@0	2188	aDisabledSettings.Remove(index);
sl@0	2189	index--;
sl@0	2190	}
sl@0	2191	}
sl@0	2192	}
sl@0	2193	}
sl@0	2194
sl@0	2195	/**
sl@0	2196	Retrieves the state for automatic size selection option. Default value is EFalse.
sl@0	2197
sl@0	2198	@return ETrue if the automatic selection is switched on. Default value is EFalse.
sl@0	2199	*/
sl@0	2200	EXPORT_C TBool CCamera::CCameraAdvancedSettings::AutomaticSizeSelectionChangeOn() const
sl@0	2201	{
sl@0	2202	return iImpl->AutomaticSizeSelectionChangeOn();
sl@0	2203	}
sl@0	2204
sl@0	2205	/**
sl@0	2206	Allow camera to proactively change image size due external factors.
sl@0	2207	Default value is EFalse. Triggers a KUidECamEventCameraSettingAutomaticSizeSelection event notification.
sl@0	2208
sl@0	2209	@param aSetOn
sl@0	2210	whether the option should be switched on
sl@0	2211	*/
sl@0	2212	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAutomaticSizeSelectionChangeOn(TBool aSetOn)
sl@0	2213	{
sl@0	2214	iImpl->SetAutomaticSizeSelectionChangeOn(aSetOn);
sl@0	2215	}
sl@0	2216
sl@0	2217	/**
sl@0	2218	Retrieves the timeout values camera supported by the camera when in continuous auto focus mode.
sl@0	2219	Timeouts are in microseconds.
sl@0	2220
sl@0	2221	@param aTimeouts
sl@0	2222	An empty array to hold timeout values.
sl@0	2223
sl@0	2224	@param aInfo
sl@0	2225	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	2226
sl@0	2227	@leave KErrNoMemory Out of memory.
sl@0	2228
sl@0	2229	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	2230	corresponding getter/setters for this feature should not be used in such a case.
sl@0	2231	*/
sl@0	2232	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedContinuousAutoFocusTimeoutsL(RArray<TInt>& aTimeouts, TValueInfo& aInfo) const
sl@0	2233	{
sl@0	2234	iImpl->GetSupportedContinuousAutoFocusTimeoutsL(aTimeouts, aInfo);
sl@0	2235	}
sl@0	2236
sl@0	2237	/**
sl@0	2238	Gets the current value for continuous autofocus timeout. Timeouts are in microseconds.
sl@0	2239
sl@0	2240	@return the timeout value in microseconds.
sl@0	2241	Negative value returned means error case (system wide error code) and positive value means current value for
sl@0	2242	continuous autofocus timeout.
sl@0	2243	*/
sl@0	2244	EXPORT_C TInt CCamera::CCameraAdvancedSettings::ContinuousAutoFocusTimeout() const
sl@0	2245	{
sl@0	2246	return iImpl->ContinuousAutoFocusTimeout();
sl@0	2247	}
sl@0	2248
sl@0	2249	/**
sl@0	2250	Sets the current value for continuous autofocus timeout. Timeouts are in microseconds.
sl@0	2251	All MCameraObserver2 clients of the camera receive a KUidECamEventCameraSettingsContinuousAutoFocusTimeout
sl@0	2252	event notification when timeout value is changed.
sl@0	2253
sl@0	2254	@param aTimeout
sl@0	2255	the timeout value in microseconds.
sl@0	2256	*/
sl@0	2257	EXPORT_C void CCamera::CCameraAdvancedSettings::SetContinuousAutoFocusTimeout(TInt aTimeout)
sl@0	2258	{
sl@0	2259	iImpl->SetContinuousAutoFocusTimeout(aTimeout);
sl@0	2260	}
sl@0	2261
sl@0	2262	/**
sl@0	2263	Gets all supported stabilization effects on the camera.
sl@0	2264
sl@0	2265	@return an integer - a bitfield of all supported TStabilizationEffect values.
sl@0	2266	*/
sl@0	2267	EXPORT_C CCamera::CCameraAdvancedSettings::TStabilizationEffect CCamera::CCameraAdvancedSettings::StabilizationEffect() const
sl@0	2268	{
sl@0	2269	return iImpl->StabilizationEffect();
sl@0	2270	}
sl@0	2271
sl@0	2272	/**
sl@0	2273	Gets the current stabilization effect on the camera.
sl@0	2274
sl@0	2275	@return a TStabilizationEffect value.
sl@0	2276	*/
sl@0	2277	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedStabilizationEffects() const
sl@0	2278	{
sl@0	2279	return iImpl->SupportedStabilizationEffects();
sl@0	2280	}
sl@0	2281
sl@0	2282	/**
sl@0	2283	Sets a specific stabilization effect on the camera.
sl@0	2284	When a value is set, MCameraObserver2 clients for that camera will receive a
sl@0	2285	KUidECamEventCameraSettingsStabilizationEffect event notification.
sl@0	2286
sl@0	2287	@param aEffect
sl@0	2288	stabilization effect selection of type TStabilizationEffect.
sl@0	2289	*/
sl@0	2290	EXPORT_C void CCamera::CCameraAdvancedSettings::SetStabilizationEffect(CCamera::CCameraAdvancedSettings::TStabilizationEffect aEffect)
sl@0	2291	{
sl@0	2292	iImpl->SetStabilizationEffect(aEffect);
sl@0	2293	}
sl@0	2294
sl@0	2295	/**
sl@0	2296	Gets all supported stabilization algorithm values on the camera.
sl@0	2297
sl@0	2298	@return an integer - a bitfield of all supported TStabilizationAlgorithmComplexity values.
sl@0	2299	*/
sl@0	2300
sl@0	2301	EXPORT_C TInt CCamera::CCameraAdvancedSettings::SupportedStabilizationComplexityValues() const
sl@0	2302	{
sl@0	2303	return iImpl->SupportedStabilizationComplexityValues();
sl@0	2304	}
sl@0	2305
sl@0	2306	/**
sl@0	2307	Gets current active stabilization algorithm selection on the camera.
sl@0	2308
sl@0	2309	@return a TStabilizationAlgorithmComplexity value.
sl@0	2310	*/
sl@0	2311	EXPORT_C CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity CCamera::CCameraAdvancedSettings::StabilizationComplexity() const
sl@0	2312	{
sl@0	2313	return iImpl->StabilizationComplexity();
sl@0	2314	}
sl@0	2315
sl@0	2316	/**
sl@0	2317	Sets a specific stabilization algorithm on the camera.
sl@0	2318	When a value is set, MCameraObserver2 clients for that camera will receive a
sl@0	2319	KUidECamEventSettingsStabilizationAlgorithmComplexity event notification.
sl@0	2320
sl@0	2321	@param aComplexity
sl@0	2322	stabilization effect selection of type TStabilizationAlgorithmComplexity.
sl@0	2323	*/
sl@0	2324	EXPORT_C void CCamera::CCameraAdvancedSettings::SetStabilizationComplexity(CCamera::CCameraAdvancedSettings::TStabilizationAlgorithmComplexity aComplexity)
sl@0	2325	{
sl@0	2326	iImpl->SetStabilizationComplexity(aComplexity);
sl@0	2327	}
sl@0	2328
sl@0	2329	/**
sl@0	2330	Gets the units in which the white balance is measured on the camera.
sl@0	2331	@note The methods used to get or set these differ depending on the supported unit type.
sl@0	2332	It is expected that a camera will support only a single type or none.
sl@0	2333
sl@0	2334	@return a value of TWBUnits type.
sl@0	2335	*/
sl@0	2336	EXPORT_C CCamera::CCameraAdvancedSettings::TWBUnits CCamera::CCameraAdvancedSettings::SupportedWBUnits() const
sl@0	2337	{
sl@0	2338	return iImpl->SupportedWBUnits();
sl@0	2339	}
sl@0	2340
sl@0	2341	/**
sl@0	2342	Get white balance value represented as a RGB triplet.
sl@0	2343
sl@0	2344	@see TRgb
sl@0	2345
sl@0	2346	@param aValue
sl@0	2347	a reference to TRgb object which will contain the current white balance.
sl@0	2348	*/
sl@0	2349	EXPORT_C void CCamera::CCameraAdvancedSettings::GetWBRgbValue(TRgb& aValue) const
sl@0	2350	{
sl@0	2351	iImpl->GetWBRgbValue(aValue);
sl@0	2352	}
sl@0	2353
sl@0	2354	/**
sl@0	2355	Set white balance value using a RGB triplet.
sl@0	2356	Change in value causes an event notification KUidECamEventCameraSettingsWBValue
sl@0	2357	to be sent to all MCameraObserver2 clients of this camera.
sl@0	2358
sl@0	2359	@param aValue
sl@0	2360	a const reference to TRgb object, which contains the new white balance.
sl@0	2361
sl@0	2362	@see TRgb
sl@0	2363	*/
sl@0	2364	EXPORT_C void CCamera::CCameraAdvancedSettings::SetWBRgbValue(const TRgb& aValue)
sl@0	2365	{
sl@0	2366	iImpl->SetWBRgbValue(aValue);
sl@0	2367	}
sl@0	2368
sl@0	2369	/**
sl@0	2370	Get the white balance values, as temperature measured in Kelvin, supported on the camera.
sl@0	2371
sl@0	2372	@param aWBColorTemperatures
sl@0	2373	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	2374	the specific supported values.
sl@0	2375
sl@0	2376	@param aInfo
sl@0	2377	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	2378
sl@0	2379	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	2380	corresponding getter/setters for this feature should not be used in such a case.
sl@0	2381	*/
sl@0	2382	EXPORT_C void CCamera::CCameraAdvancedSettings::GetWBSupportedColorTemperaturesL(RArray<TInt>& aWBColorTemperatures, TValueInfo& aInfo) const
sl@0	2383	{
sl@0	2384	iImpl->GetWBSupportedColorTemperaturesL(aWBColorTemperatures, aInfo);
sl@0	2385	}
sl@0	2386
sl@0	2387	/**
sl@0	2388	Get the white balance as a temperature in Kelvin
sl@0	2389
sl@0	2390	@return current white balance value as a temperature in Kelvins.
sl@0	2391	Negative value returned means error case (system wide error code) and positive value means current value for
sl@0	2392	white balance as a temperature in Kelvin.
sl@0	2393	*/
sl@0	2394	EXPORT_C TInt CCamera::CCameraAdvancedSettings::WBColorTemperature() const
sl@0	2395	{
sl@0	2396	return iImpl->WBColorTemperature();
sl@0	2397	}
sl@0	2398
sl@0	2399	/**
sl@0	2400	Set the white balance as a temperature in Kelvin
sl@0	2401
sl@0	2402	@param aColorTemperature
sl@0	2403	white balance value as a temperature in Kelvins.
sl@0	2404	*/
sl@0	2405	EXPORT_C void CCamera::CCameraAdvancedSettings::SetWBColorTemperature(TInt aColorTemperature)
sl@0	2406	{
sl@0	2407	iImpl->SetWBColorTemperature(aColorTemperature);
sl@0	2408	}
sl@0	2409
sl@0	2410	/**
sl@0	2411	Checks whether the flash is ready.
sl@0	2412
sl@0	2413	@param aReady
sl@0	2414	A reference to a boolean set by the implementation to ETrue if the flash is ready,
sl@0	2415	EFalse otherwise.
sl@0	2416
sl@0	2417	@return KErrNotSupported if the implementation of this method is not supported.
sl@0	2418	*/
sl@0	2419	EXPORT_C TInt CCamera::CCameraAdvancedSettings::IsFlashReady(TBool& aReady) const
sl@0	2420	{
sl@0	2421	aReady = EFalse;
sl@0	2422	if(iImpl2 != NULL)
sl@0	2423	{
sl@0	2424	return iImpl2->IsFlashReady(aReady);
sl@0	2425	}
sl@0	2426	return KErrNotSupported;
sl@0	2427	}
sl@0	2428
sl@0	2429	/**
sl@0	2430	Get the number of focus steps for current focus mode.
sl@0	2431
sl@0	2432	@param aFocusModeSteps
sl@0	2433	A reference to an empty array of TInt which would be populated by the implementation with
sl@0	2434	the specific supported values.
sl@0	2435
sl@0	2436	@param aInfo
sl@0	2437	a reference to TValueInfo, which establishes the type of the returned data.
sl@0	2438
sl@0	2439	@leave KErrNotSupported if the implementation of this method is not supported. May also leave as a result of other system errors.
sl@0	2440
sl@0	2441	@note When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive;
sl@0	2442	corresponding getter/setters for this feature should not be used in such a case.
sl@0	2443	*/
sl@0	2444	EXPORT_C void CCamera::CCameraAdvancedSettings::GetCurrentFocusModeStepsL(RArray<TInt>& aFocusModeSteps, TValueInfo& aInfo) const
sl@0	2445	{
sl@0	2446	if(iImpl2 != NULL)
sl@0	2447	{
sl@0	2448	iImpl2->GetCurrentFocusModeStepsL(aFocusModeSteps, aInfo);
sl@0	2449	}
sl@0	2450	else
sl@0	2451	{
sl@0	2452	User::Leave(KErrNotSupported);
sl@0	2453	}
sl@0	2454	}
sl@0	2455
sl@0	2456	/**
sl@0	2457	Gets all supported ISO types on the device.
sl@0	2458
sl@0	2459	@param aSupportedISORateTypes
sl@0	2460	A reference to an integer which is a bitfield of all supported TISORateType values. EISONone means feature is not supported.
sl@0	2461
sl@0	2462	@leave KErrNotSupported if the implementation of this method is not present. May leave as a result of some other error.
sl@0	2463
sl@0	2464	@note When concrete implementation is provided, but camera device does not support this feature, then aSupportedISORateTypes retrieves EISONone.
sl@0	2465
sl@0	2466	*/
sl@0	2467	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedISORateTypeL(TInt& aSupportedISORateTypes) const
sl@0	2468	{
sl@0	2469	if(iImpl3 != NULL)
sl@0	2470	{
sl@0	2471	iImpl3->GetSupportedISORateTypeL(aSupportedISORateTypes);
sl@0	2472	}
sl@0	2473	else
sl@0	2474	{
sl@0	2475	User::Leave(KErrNotSupported);
sl@0	2476	}
sl@0	2477	}
sl@0	2478
sl@0	2479	/**
sl@0	2480	Set the type of ISO rate and the exposure parameter or value specified.
sl@0	2481
sl@0	2482	@param aISORateType
sl@0	2483	The type of ISO rate to be set.
sl@0	2484
sl@0	2485	@param aParam
sl@0	2486	Depending on the value of aISORateType, possible values of aParam are one of the following:-
sl@0	2487	The value of ISO rate to be used in case of manual type of ISO rate (EISOManual).
sl@0	2488	OR
sl@0	2489	Redundant parameter in case of unprioritised type of auto ISO (EISOAutoUnPrioritised). It is left to the camera hardware/firmware
sl@0	2490	to decide how the ISO rate is selected. No priority regarding exposure is specified.
sl@0	2491	OR
sl@0	2492	Highest ISO rate to be picked by the camera while deciding for the best exposure in case of ISO prioritised
sl@0	2493	type of auto ISO (EISOAutoISOPrioritised). ISO rate closest to this (and lower) may be used so that best possible exposure is achieved.
sl@0	2494	OR
sl@0	2495	Slowest shutter speed to be picked by the camera while deciding for the best exposure in case of shutter speed
sl@0	2496	prioritised type of auto ISO (EISOAutoShutterSpeedPrioritised). After using this shutter speed, ISO rate is chosen by the camera to achieve
sl@0	2497	proper exposure. Shutter speed closest to this (and faster) may be used so that best possible exposure is achieved.
sl@0	2498	OR
sl@0	2499	Minimum aperture opening (deepest depth of field) to be picked by the camera while deciding
sl@0	2500	for the best exposure in case of aperture prioritised type of auto ISO (EISOAutoAperturePrioritised). After using this aperture opening, ISO
sl@0	2501	rate is chosen by the camera to achieve proper exposure. Aperture opening closest to this (and wider) may be
sl@0	2502	used to achieve best possible exposure.
sl@0	2503
sl@0	2504	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2505
sl@0	2506	@note Triggers KUidECamEventCameraSettingIsoRateType to all MCameraObserver2 clients of the camera.
sl@0	2507	HandleEvent is used to report the result or any possible error. New setter functions leave only when
sl@0	2508	implementation is not there.
sl@0	2509
sl@0	2510	*/
sl@0	2511	EXPORT_C void CCamera::CCameraAdvancedSettings::SetISORateL(CCamera::CCameraAdvancedSettings::TISORateType aISORateType, TInt aParam)
sl@0	2512	{
sl@0	2513	if(iImpl3 != NULL)
sl@0	2514	{
sl@0	2515	iImpl3->SetISORate(aISORateType, aParam);
sl@0	2516	}
sl@0	2517	else
sl@0	2518	{
sl@0	2519	User::Leave(KErrNotSupported);
sl@0	2520	}
sl@0	2521	}
sl@0	2522
sl@0	2523	/**
sl@0	2524	Get the type of ISO rate, exposure parameter and value set.
sl@0	2525
sl@0	2526	@param aISORateType
sl@0	2527	A reference to the type of ISO rate set. EISONone means feature is not supported.
sl@0	2528
sl@0	2529	@param aParam
sl@0	2530	Depending on the value of aISORateType, possible values of aParam are one of the following:-
sl@0	2531	A reference to the redundant parameter in case of manual type of ISO rate(EISOManual)
sl@0	2532	OR
sl@0	2533	A reference to the redundant parameter in case of unprioritised type of auto ISO(EISOAutoUnPrioritised)
sl@0	2534	OR
sl@0	2535	A reference to the highest ISO rate that may be picked up in case of ISO prioritised type of auto ISO(EISOAutoISOPrioritised)
sl@0	2536	OR
sl@0	2537	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	2538	OR
sl@0	2539	A reference to the minimum aperture opening that may be picked up in case of aperture prioritised type of auto ISO(EISOAutoAperturePrioritised)
sl@0	2540
sl@0	2541	@param aISORate
sl@0	2542	A reference to the value of ISO rate currently being used, if camera device is capable of doing that.
sl@0	2543	Otherwise KErrNotFound is retrieved indicating the incapability of camera.
sl@0	2544
sl@0	2545	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2546	May leave as a result of some other error.
sl@0	2547
sl@0	2548	@note When concrete implementation is provided, but camera device does not support this feature, then aISORateType retrieves EISONone.
sl@0	2549
sl@0	2550	@note Since camera hardware may be incapable of providing the actual ISO value when one of the auto ISO type has
sl@0	2551	been set, then, in these cases, the 3rd argument is retrieved as KErrNotFound.
sl@0	2552
sl@0	2553	*/
sl@0	2554	EXPORT_C void CCamera::CCameraAdvancedSettings::GetISORateL(CCamera::CCameraAdvancedSettings::TISORateType& aISORateType, TInt& aParam, TInt& aISORate) const
sl@0	2555	{
sl@0	2556	if(iImpl3 != NULL)
sl@0	2557	{
sl@0	2558	iImpl3->GetISORateL(aISORateType, aParam, aISORate);
sl@0	2559	}
sl@0	2560	else
sl@0	2561	{
sl@0	2562	User::Leave(KErrNotSupported);
sl@0	2563	}
sl@0	2564	}
sl@0	2565
sl@0	2566	/**
sl@0	2567	Provide reference screen for orientation information.
sl@0	2568
sl@0	2569	@param aScreenDevice
sl@0	2570	A reference to the screen device.
sl@0	2571
sl@0	2572	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2573
sl@0	2574	@note Triggers KUidECamEventCameraSettingReferenceScreen to all MCameraObserver2 clients of the camera.
sl@0	2575	HandleEvent is used to report the result or any possible error. New setter functions leave only when
sl@0	2576	implementation is not there.
sl@0	2577
sl@0	2578	*/
sl@0	2579	EXPORT_C void CCamera::CCameraAdvancedSettings::SetReferenceScreenL(CWsScreenDevice& aScreenDevice)
sl@0	2580	{
sl@0	2581	if(iImpl3 != NULL)
sl@0	2582	{
sl@0	2583	iImpl3->SetReferenceScreen(aScreenDevice);
sl@0	2584	}
sl@0	2585	else
sl@0	2586	{
sl@0	2587	User::Leave(KErrNotSupported);
sl@0	2588	}
sl@0	2589	}
sl@0	2590
sl@0	2591	/**
sl@0	2592	Get the digital zoom steps for the still image when a particular image format and size are specified.
sl@0	2593
sl@0	2594	@param aDigitalZoomSteps
sl@0	2595	A reference to an empty array of TInt to hold digital zoom step values for still image and multiplied by
sl@0	2596	KECamFineResolutionFactor to retain precision. If list returned is empty, this means feature is not supported.
sl@0	2597
sl@0	2598	@param aInfo
sl@0	2599	A reference to TValueInfo, which establishes the type of the returned data.
sl@0	2600
sl@0	2601	@param aSizeIndex
sl@0	2602	A value providing the size index which must be in the range 0 to TCameraInfo::iNumImageSizesSupported-1
sl@0	2603	inclusive.
sl@0	2604
sl@0	2605	@param aFormat
sl@0	2606	A value providing the image format which must be one of the formats supported. (see
sl@0	2607	TCameraInfo::iImageFormatsSupported)
sl@0	2608
sl@0	2609	@param aIsInfluencePossible
sl@0	2610	If True, signals that digital zoom step values may be influenced by some hardware factor like stabilization etc.
sl@0	2611	If False, no influence possible.
sl@0	2612
sl@0	2613	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2614	KErrNoMemory if out of memory. May leave as a result of some other error.
sl@0	2615
sl@0	2616	@note This method retrieves the supported digital zoom steps irrespective of any stabilization influence.
sl@0	2617	In case of stabilization etc. influence, the setting function should set the best possible digital zoom value
sl@0	2618	and return error KErrECamDigitalZoomLimited along with dedicated event.
sl@0	2619
sl@0	2620	@note When concrete implementation is provided, but camera device does not support this feature, empty array may be returned and
sl@0	2621	TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	2622
sl@0	2623	*/
sl@0	2624	EXPORT_C void CCamera::CCameraAdvancedSettings::GetDigitalZoomStepsForStillL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo,
sl@0	2625	TInt aSizeIndex, CCamera::TFormat aFormat, TBool& aIsInfluencePossible) const
sl@0	2626	{
sl@0	2627	if(iImpl3 != NULL)
sl@0	2628	{
sl@0	2629	iImpl3->GetDigitalZoomStepsForStillL(aDigitalZoomSteps, aInfo, aSizeIndex, aFormat, aIsInfluencePossible);
sl@0	2630	}
sl@0	2631	else
sl@0	2632	{
sl@0	2633	User::Leave(KErrNotSupported);
sl@0	2634	}
sl@0	2635	}
sl@0	2636
sl@0	2637	/**
sl@0	2638	Get the digital zoom steps for the video when a particular video frame format, size and rate are specified.
sl@0	2639
sl@0	2640	@param aDigitalZoomSteps
sl@0	2641	A reference to an empty array of TInt to hold digital zoom step values for video and multiplied by
sl@0	2642	KECamFineResolutionFactor to retain precision. If list returned is empty, this means feature is not supported.
sl@0	2643
sl@0	2644	@param aInfo
sl@0	2645	A reference to TValueInfo, which establishes the type of the returned data.
sl@0	2646
sl@0	2647	@param aFrameRateIndex
sl@0	2648	A value providing the rate index must be in the range 0 to TCameraInfo::iNumVideoFrameRatesSupported-1
sl@0	2649	inclusive.
sl@0	2650
sl@0	2651	@param aSizeIndex
sl@0	2652	A value providing the size index which must be in the range 0 to TCameraInfo::iNumVideoFrameSizesSupported-1
sl@0	2653	inclusive.
sl@0	2654
sl@0	2655	@param aFormat
sl@0	2656	A value providing the format which must be one of the video frame formats supported. (see
sl@0	2657	TCameraInfo::iVideoFrameFormatsSupported)
sl@0	2658
sl@0	2659	@param aIsInfluencePossible
sl@0	2660	If True, signals that digital zoom step values may be influenced by some hardware factor like stabilization etc.
sl@0	2661	If False, no influence possible.
sl@0	2662
sl@0	2663	@param aExposure
sl@0	2664	The exposure mode.
sl@0	2665
sl@0	2666	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2667	KErrNoMemory if out of memory. May leave as a result of some other error.
sl@0	2668
sl@0	2669	@note This method retrieves the supported digital zoom steps irrespective of any stabilization influence.
sl@0	2670	In case of stabilization etc. influence, the setting function should set the best possible digital zoom value
sl@0	2671	and return error KErrECamDigitalZoomLimited along with dedicated event.
sl@0	2672
sl@0	2673	@note When concrete implementation is provided, but camera device does not support this feature, empty array may be returned and
sl@0	2674	TValueInfo may be ENotActive; corresponding getter/setters for this feature should not be used in such a case.
sl@0	2675
sl@0	2676	*/
sl@0	2677	EXPORT_C void CCamera::CCameraAdvancedSettings::GetDigitalZoomStepsForVideoL(RArray<TInt>& aDigitalZoomSteps, TValueInfo& aInfo,
sl@0	2678	TInt aFrameRateIndex, TInt aSizeIndex, CCamera::TFormat aFormat, TBool& aIsInfluencePossible,
sl@0	2679	CCamera::TExposure aExposure) const
sl@0	2680	{
sl@0	2681	if(iImpl3 != NULL)
sl@0	2682	{
sl@0	2683	iImpl3->GetDigitalZoomStepsForVideoL(aDigitalZoomSteps, aInfo, aFrameRateIndex, aSizeIndex, aFormat, aIsInfluencePossible, aExposure);
sl@0	2684	}
sl@0	2685	else
sl@0	2686	{
sl@0	2687	User::Leave(KErrNotSupported);
sl@0	2688	}
sl@0	2689	}
sl@0	2690
sl@0	2691	/**
sl@0	2692	Retrieves the pre capture warnings supported for a given camera mode
sl@0	2693
sl@0	2694	@param aCameraMode
sl@0	2695	Desired camera mode for which the supported pre capture warnings may be retrieved.
sl@0	2696
sl@0	2697	@param aPreCaptureWarningSupported
sl@0	2698	A bitfield of all supported TPreCaptureWarning to be issued in the given camera mode.
sl@0	2699	If no pre capture warning supported for the given camera mode, EPCWNone is retrieved.
sl@0	2700
sl@0	2701	@leave May leave with any error.
sl@0	2702
sl@0	2703	*/
sl@0	2704	EXPORT_C void CCamera::CCameraAdvancedSettings::GetPreCaptureWarningSupportedL(CCamera::CCameraAdvancedSettings::TCameraMode aCameraMode, TInt& aPreCaptureWarningSupported) const
sl@0	2705	{
sl@0	2706	if(iImpl3 != NULL)
sl@0	2707	{
sl@0	2708	iImpl3->GetPreCaptureWarningSupportedL(aCameraMode, aPreCaptureWarningSupported);
sl@0	2709
sl@0	2710	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2711	application is not prepared to receive extra added enum values. So, any extra enum value passed
sl@0	2712	from the implementation will be filtered at this point.
sl@0	2713	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2714	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	2715	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	2716	{
sl@0	2717	aPreCaptureWarningSupported &= KBaselinedPreCaptureWarning;
sl@0	2718	}
sl@0	2719	}
sl@0	2720	else
sl@0	2721	{
sl@0	2722	User::Leave(KErrNotSupported);
sl@0	2723	}
sl@0	2724	}
sl@0	2725
sl@0	2726	/**
sl@0	2727	Subscribe in order to receive event which indicates warnings on occurrence of some specific unfavourable
sl@0	2728	conditions before image/video capture.
sl@0	2729
sl@0	2730	@param aPreCaptureWarning
sl@0	2731	A bitfield specifying all the TPreCaptureWarning types to be subscribed for.
sl@0	2732
sl@0	2733	@leave KErrNotSupported if the implementation of this method or the feature is not supported.
sl@0	2734	May also leave as a result of other errors.
sl@0	2735
sl@0	2736	@note When any of the subscribed warnings (represented by aPreCaptureWarning) get generated by the camera device,
sl@0	2737	event KUidECamEventCameraSettingPreCaptureWarning is issued. TECAMEvent2 class should be used in order to
sl@0	2738	provide the status of every PreCaptureWarning.
sl@0	2739
sl@0	2740	*/
sl@0	2741	EXPORT_C void CCamera::CCameraAdvancedSettings::SubscribeToPreCaptureWarningL(TInt aPreCaptureWarning)
sl@0	2742	{
sl@0	2743	if(iImpl3 != NULL)
sl@0	2744	{
sl@0	2745	iImpl3->SubscribeToPreCaptureWarningL(aPreCaptureWarning);
sl@0	2746	}
sl@0	2747	else
sl@0	2748	{
sl@0	2749	User::Leave(KErrNotSupported);
sl@0	2750	}
sl@0	2751	}
sl@0	2752
sl@0	2753	/**
sl@0	2754	Unsubscribe so that further events are not received when warnings get issued.
sl@0	2755
sl@0	2756	@leave KErrNotSupported if the implementation of this method or the feature is not supported.
sl@0	2757	May also leave as a result of other errors.
sl@0	2758
sl@0	2759	*/
sl@0	2760	EXPORT_C void CCamera::CCameraAdvancedSettings::UnSubscribePreCaptureWarningL()
sl@0	2761	{
sl@0	2762	if(iImpl3 != NULL)
sl@0	2763	{
sl@0	2764	iImpl3->UnSubscribePreCaptureWarningL();
sl@0	2765	}
sl@0	2766	else
sl@0	2767	{
sl@0	2768	User::Leave(KErrNotSupported);
sl@0	2769	}
sl@0	2770	}
sl@0	2771
sl@0	2772	/**
sl@0	2773	Get the status of every warnings defined.
sl@0	2774
sl@0	2775	@param aPreCaptureWarning
sl@0	2776	A reference to the integer - bitfield representing all the TPreCaptureWarning types issued.
sl@0	2777
sl@0	2778	@leave KErrNotSupported if the implementation of this method or the feature is not supported.
sl@0	2779	May also leave as a result of other errors.
sl@0	2780
sl@0	2781	@note This method may be called after receiving the event KUidECamEventCameraSettingPreCaptureWarning OR
sl@0	2782	user may also opt for polling on this.
sl@0	2783
sl@0	2784	*/
sl@0	2785	EXPORT_C void CCamera::CCameraAdvancedSettings::GetPreCaptureWarningL(TInt& aPreCaptureWarning) const
sl@0	2786	{
sl@0	2787	if(iImpl3 != NULL)
sl@0	2788	{
sl@0	2789	iImpl3->GetPreCaptureWarningL(aPreCaptureWarning);
sl@0	2790
sl@0	2791	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that
sl@0	2792	application is not prepared to receive extra added enum values. So, any extra enum value passed
sl@0	2793	from the implementation will be filtered at this point.
sl@0	2794	To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L()
sl@0	2795	to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0	2796	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0	2797	{
sl@0	2798	aPreCaptureWarning &= KBaselinedPreCaptureWarning;
sl@0	2799	}
sl@0	2800	}
sl@0	2801	else
sl@0	2802	{
sl@0	2803	User::Leave(KErrNotSupported);
sl@0	2804	}
sl@0	2805	}
sl@0	2806
sl@0	2807	/**
sl@0	2808	Retrieve the different supported AF assistant light.
sl@0	2809
sl@0	2810	@param aSupportedAFAssistantLight
sl@0	2811	A reference to integer - bitfield indicating the supported AF assistant light.
sl@0	2812	If EAFAssistantLightOff, this means AF assistant light is not supported.
sl@0	2813	If EAFAssistantLightManualOn, then manual AF assistant light is supported.
sl@0	2814	If EAFAssistantLightAuto, auto assistant light is supported.
sl@0	2815	If combination of EAFAssistantLightManualOn\|\|EAFAssistantLightAuto , then both manual and Auto assistant light are supported.
sl@0	2816
sl@0	2817	@leave KErrNotSupported if the implementation of this method is not supported.
sl@0	2818	May also leave as a result of other errors.
sl@0	2819
sl@0	2820	@note When concrete implementation is provided, but camera device does not support this feature,
sl@0	2821	then aSupportedAFAssistantLight retrieves EAFAssistantLightOff. Corresponding getter/setters for this feature should not be called then.
sl@0	2822
sl@0	2823	*/
sl@0	2824	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedAFAssistantLightL(TInt& aSupportedAFAssistantLight) const
sl@0	2825	{
sl@0	2826	if(iImpl3 != NULL)
sl@0	2827	{
sl@0	2828	iImpl3->GetSupportedAFAssistantLightL(aSupportedAFAssistantLight);
sl@0	2829	}
sl@0	2830	else
sl@0	2831	{
sl@0	2832	User::Leave(KErrNotSupported);
sl@0	2833	}
sl@0	2834	}
sl@0	2835
sl@0	2836	/**
sl@0	2837	Get the type ( and state) of AF assistant light currently set.
sl@0	2838
sl@0	2839	@param aAFAssistantLight
sl@0	2840	A reference to AF assistant light.
sl@0	2841	If EAFAssistantLightOff, then manual and auto assistant light are switched off.
sl@0	2842	If EAFAssistantLightManualOn, manual assistant light is switched on.
sl@0	2843	If EAFAssistantLightAuto, AF assistant light is set to auto.
sl@0	2844
sl@0	2845	@leave KErrNotSupported if the implementation of this method or the feature is not supported.
sl@0	2846	May also leave as a result of other errors.
sl@0	2847
sl@0	2848	*/
sl@0	2849	EXPORT_C void CCamera::CCameraAdvancedSettings::GetAFAssistantLightL(CCamera::CCameraAdvancedSettings::TAFAssistantLight& aAFAssistantLight) const
sl@0	2850	{
sl@0	2851	if(iImpl3 != NULL)
sl@0	2852	{
sl@0	2853	iImpl3->GetAFAssistantLightL(aAFAssistantLight);
sl@0	2854	}
sl@0	2855	else
sl@0	2856	{
sl@0	2857	User::Leave(KErrNotSupported);
sl@0	2858	}
sl@0	2859	}
sl@0	2860
sl@0	2861	/**
sl@0	2862	Set a particular type ( and state) of AF assistant light.
sl@0	2863
sl@0	2864	@param aAFAssistantLight
sl@0	2865	Type of AF assistant light to be set.
sl@0	2866	If EAFAssistantLightOff, switch off the manual or auto assistant light.
sl@0	2867	If EAFAssistantLightManualOn, manually switch on the assistant light.
sl@0	2868	If EAFAssistantLightAuto, camera will automatically switch it on/off as per the conditions.
sl@0	2869
sl@0	2870	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	2871
sl@0	2872	@note Triggers KUidECamEventCameraSettingAFAssistantLight to all MCameraObserver2 clients of the camera.
sl@0	2873	HandleEvent is used to report the result or any possible error. New setter functions leave only when
sl@0	2874	implementation is not there.
sl@0	2875
sl@0	2876	*/
sl@0	2877	EXPORT_C void CCamera::CCameraAdvancedSettings::SetAFAssistantLightL(CCamera::CCameraAdvancedSettings::TAFAssistantLight aAFAssistantLight)
sl@0	2878	{
sl@0	2879	if(iImpl3 != NULL)
sl@0	2880	{
sl@0	2881	iImpl3->SetAFAssistantLight(aAFAssistantLight);
sl@0	2882	}
sl@0	2883	else
sl@0	2884	{
sl@0	2885	User::Leave(KErrNotSupported);
sl@0	2886	}
sl@0	2887	}
sl@0	2888
sl@0	2889	/**
sl@0	2890	Retrieves the supported continuous zoom types.
sl@0	2891
sl@0	2892	@param aSupportedContinuousZoomType
sl@0	2893	Retrieves a bitfield of TUint which indicates the supported continuous zoom type as given by
sl@0	2894	CCamera::CCameraAdvancedSettings::TContinuousZoomType
sl@0	2895
sl@0	2896	@leave May leave with any error code.
sl@0	2897
sl@0	2898	@publishedPartner
sl@0	2899	@prototype
sl@0	2900	*/
sl@0	2901	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedContinuousZoomTypeL(TUint& aSupportedContinuousZoomType) const
sl@0	2902	{
sl@0	2903	if(iImpl4 != NULL)
sl@0	2904	{
sl@0	2905	iImpl4->GetSupportedContinuousZoomTypeL(aSupportedContinuousZoomType);
sl@0	2906	}
sl@0	2907	else
sl@0	2908	{
sl@0	2909	User::Leave(KErrNotSupported);
sl@0	2910	}
sl@0	2911	}
sl@0	2912
sl@0	2913	/**
sl@0	2914	Retrieves the minimum, current and maximum focal length in millimeters. This information is useful to find out
sl@0	2915	which zoom directions can be used on the fly.
sl@0	2916
sl@0	2917	@param aMinFocalLength
sl@0	2918	Minimum focal length if positive.
sl@0	2919	Error value if negative (for example, KErrNotFound if information not available).
sl@0	2920
sl@0	2921	@param aCurrentFocalLength
sl@0	2922	Current focal length if positive.
sl@0	2923	Error value if negative (for example, KErrNotFound if information not available).
sl@0	2924
sl@0	2925	@param aMaxFocalLength
sl@0	2926	Maximum focal length if positive.
sl@0	2927	Error value if negative (for example, KErrNotFound if information not available).
sl@0	2928
sl@0	2929	@leave May leave with any error code.
sl@0	2930
sl@0	2931	@publishedPartner
sl@0	2932	@prototype
sl@0	2933	*/
sl@0	2934	EXPORT_C void CCamera::CCameraAdvancedSettings::GetFocalLengthInfoL(TInt& aMinFocalLength, TInt& aCurrentFocalLength, TInt& aMaxFocalLength) const
sl@0	2935	{
sl@0	2936	if(iImpl4 != NULL)
sl@0	2937	{
sl@0	2938	iImpl4->GetFocalLengthInfoL(aMinFocalLength, aCurrentFocalLength, aMaxFocalLength);
sl@0	2939	}
sl@0	2940	else
sl@0	2941	{
sl@0	2942	User::Leave(KErrNotSupported);
sl@0	2943	}
sl@0	2944	}
sl@0	2945
sl@0	2946	/**
sl@0	2947	Retrieves the total number of operation preferences supported by the implementation. Operation preferences are
sl@0	2948	specified in terms of performance vectors, that is, speed, quality, low memory consumption and low power consumption.
sl@0	2949
sl@0	2950	@param aNumOperationPreferenceSupported
sl@0	2951	Retrieves the number of operation preferences supported.
sl@0	2952
sl@0	2953	@leave May leave with any error code.
sl@0	2954
sl@0	2955	@publishedPartner
sl@0	2956	@prototype
sl@0	2957	*/
sl@0	2958	EXPORT_C void CCamera::CCameraAdvancedSettings::GetNumOperationPreferenceL(TUint& aNumOperationPreferenceSupported) const
sl@0	2959	{
sl@0	2960	if(iImpl4 != NULL)
sl@0	2961	{
sl@0	2962	iImpl4->GetNumOperationPreferenceL(aNumOperationPreferenceSupported);
sl@0	2963	}
sl@0	2964	else
sl@0	2965	{
sl@0	2966	User::Leave(KErrNotSupported);
sl@0	2967	}
sl@0	2968	}
sl@0	2969
sl@0	2970	/**
sl@0	2971	Enumerate the available operation preferences.
sl@0	2972
sl@0	2973	@param aOperationPreferenceIndex
sl@0	2974	A particular index which represents an operation preference. The level of different performance vectors may be known
sl@0	2975	through other arguments. This varies from 0 to n-1, where n is given by GetNumOperationPreferenceL(n).
sl@0	2976
sl@0	2977	@param aSpeedLevel
sl@0	2978	A TPerformanceLevel which specifies the speed level related to the index aOperationPreferenceIndex.
sl@0	2979
sl@0	2980	@param aQualityLevel
sl@0	2981	A TPerformanceLevel which specifies the quality level related to the index aOperationPreferenceIndex.
sl@0	2982
sl@0	2983	@param aLowMemoryConsumptionLevel
sl@0	2984	A TPerformanceLevel which specifies the low memory consumption level related to the index aOperationPreferenceIndex.
sl@0	2985	The lower the memory consumption, the higher the level.
sl@0	2986
sl@0	2987	@param aLowPowerConsumptionLevel
sl@0	2988	A TPerformanceLevel which specifies the low power consumption level related to the index aOperationPreferenceIndex.
sl@0	2989	The lower the power consumption, the higher the level.
sl@0	2990
sl@0	2991	@note It is up to the implementation how the performance levels are achieved. For example, shutter opening, JPEQ quality
sl@0	2992	and parallel buffering in case of streamed image output can be controlled in order to provide the desired
sl@0	2993	performance.
sl@0	2994
sl@0	2995	@leave May leave with any error code.
sl@0	2996
sl@0	2997	@publishedPartner
sl@0	2998	@prototype
sl@0	2999	*/
sl@0	3000	EXPORT_C void CCamera::CCameraAdvancedSettings::EnumerateOperationPreferenceL(TUint aOperationPreferenceIndex, CCamera::
sl@0	3001	CCameraAdvancedSettings::TPerformanceLevel& aSpeedLevel, CCamera::CCameraAdvancedSettings::
sl@0	3002	TPerformanceLevel& aQualityLevel, CCamera::CCameraAdvancedSettings::TPerformanceLevel&
sl@0	3003	aLowMemoryConsumptionLevel, CCamera::CCameraAdvancedSettings::TPerformanceLevel& aLowPowerConsumptionLevel) const
sl@0	3004
sl@0	3005	{
sl@0	3006	if(iImpl4 != NULL)
sl@0	3007	{
sl@0	3008	iImpl4->EnumerateOperationPreferenceL(aOperationPreferenceIndex, aSpeedLevel, aQualityLevel,
sl@0	3009	aLowMemoryConsumptionLevel, aLowPowerConsumptionLevel);
sl@0	3010	}
sl@0	3011	else
sl@0	3012	{
sl@0	3013	User::Leave(KErrNotSupported);
sl@0	3014	}
sl@0	3015	}
sl@0	3016
sl@0	3017	/**
sl@0	3018	Set a particular operation preference.
sl@0	3019
sl@0	3020	@param aOperationPreferenceIndex
sl@0	3021	An index which reveals a set of levels to be used for performance vectors, that is, speed, quality, low memory
sl@0	3022	consumption and low power consumption.
sl@0	3023
sl@0	3024	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3025
sl@0	3026	@note Event KUidECamEventCameraSettingOperationPreference is used to notify clients about setting an operation preference.
sl@0	3027
sl@0	3028	@publishedPartner
sl@0	3029	@prototype
sl@0	3030	*/
sl@0	3031	EXPORT_C void CCamera::CCameraAdvancedSettings::SetOperationPreferenceL(TUint aOperationPreferenceIndex)
sl@0	3032	{
sl@0	3033	if(iImpl4 != NULL)
sl@0	3034	{
sl@0	3035	iImpl4->SetOperationPreference(aOperationPreferenceIndex);
sl@0	3036	}
sl@0	3037	else
sl@0	3038	{
sl@0	3039	User::Leave(KErrNotSupported);
sl@0	3040	}
sl@0	3041	}
sl@0	3042
sl@0	3043	/**
sl@0	3044	Get the current operation preference being used.
sl@0	3045
sl@0	3046	@param aOperationPreferenceIndex
sl@0	3047	Currently used operation preference index.
sl@0	3048
sl@0	3049	@leave May leave with any error code.
sl@0	3050
sl@0	3051	@publishedPartner
sl@0	3052	@prototype
sl@0	3053	*/
sl@0	3054	EXPORT_C void CCamera::CCameraAdvancedSettings::GetOperationPreferenceL(TInt& aOperationPreferenceIndex) const
sl@0	3055	{
sl@0	3056	if(iImpl4 != NULL)
sl@0	3057	{
sl@0	3058	iImpl4->GetOperationPreferenceL(aOperationPreferenceIndex);
sl@0	3059	}
sl@0	3060	else
sl@0	3061	{
sl@0	3062	User::Leave(KErrNotSupported);
sl@0	3063	}
sl@0	3064	}
sl@0	3065
sl@0	3066	/**
sl@0	3067	Retrieves the event uids which the underlying implementation supports. Client may use these event notifications as
sl@0	3068	milestones in their application.
sl@0	3069
sl@0	3070	@param aSupportedEvents
sl@0	3071	Retrieves as array of TUid. Every member of the array represents a supported event uid. These events are ECAM
sl@0	3072	component wide.
sl@0	3073
sl@0	3074	@leave May leave with any error code.
sl@0	3075
sl@0	3076	@note This method may retrieve unrecognized events which may be introduced later on.
sl@0	3077
sl@0	3078	@publishedPartner
sl@0	3079	@prototype
sl@0	3080	*/
sl@0	3081	EXPORT_C void CCamera::CCameraAdvancedSettings::GetSupportedEventsL(RArray<TUid>& aSupportedEvents) const
sl@0	3082	{
sl@0	3083	if(iImpl4 != NULL)
sl@0	3084	{
sl@0	3085	iImpl4->GetSupportedEventsL(aSupportedEvents);
sl@0	3086	}
sl@0	3087	else
sl@0	3088	{
sl@0	3089	User::Leave(KErrNotSupported);
sl@0	3090	}
sl@0	3091	}
sl@0	3092
sl@0	3093	/**
sl@0	3094	Retrieves the indirect feature changes which occur because of a particular requested feature change.
sl@0	3095	Since the camera setting operation is asynchronous in nature, changing a particular camera feature, in certain cases,
sl@0	3096	involves indirectly changing another feature. In order to notify the ECam client about this indirect feature change,
sl@0	3097	event KUidECamEvent2IndirectFeatureChange is issued. After this notification, the client may use this method to retrieve
sl@0	3098	the full list of indirect feature changes.
sl@0	3099
sl@0	3100	@param aRequestedSetting
sl@0	3101	The actual requested feature change. This uid is supposed to be ECAM component wide and not restricted to
sl@0	3102	advanced camera settings.
sl@0	3103
sl@0	3104	@param aIndirectFeatureChanges
sl@0	3105	An array of uids which retrieves the indirect feature changes. These uids are supposed to be ECAM component wide
sl@0	3106	and not restricted to advanced camera settings.
sl@0	3107
sl@0	3108	@leave May leave with any error code.
sl@0	3109
sl@0	3110	@publishedPartner
sl@0	3111	@prototype
sl@0	3112	*/
sl@0	3113	EXPORT_C void CCamera::CCameraAdvancedSettings::GetIndirectFeatureChangesL(TUid aRequestedSetting, RArray<TUid>& aIndirectFeatureChanges) const
sl@0	3114	{
sl@0	3115	if(iImpl4 != NULL)
sl@0	3116	{
sl@0	3117	iImpl4->GetIndirectFeatureChangesL(aRequestedSetting, aIndirectFeatureChanges);
sl@0	3118	}
sl@0	3119	else
sl@0	3120	{
sl@0	3121	User::Leave(KErrNotSupported);
sl@0	3122	}
sl@0	3123	}
sl@0	3124
sl@0	3125	/**
sl@0	3126	Creates an instance of a CCameraContinuousZoom object and returns it to the client. Ownership of the object is passed to the client.
sl@0	3127
sl@0	3128	@param aObserver
sl@0	3129	Reference to a continuous zoom observer which will be used to issue callbacks to the client.
sl@0	3130
sl@0	3131	@param aContinuousZoomType
sl@0	3132	The continuous zoom type with which the continuous zoom object will be initialised.
sl@0	3133
sl@0	3134	@param aContinuousZoom
sl@0	3135	Retrieves pointer to the continuous zoom object. Client assumes ownership of the object.
sl@0	3136
sl@0	3137	@note Client must not delete the continuous zoom object if CCameraContinuousZoom::StartContinuousZoomL() has been called as MContinuousZoomObserver callbacks
sl@0	3138	are still expected by the implementation. Clients should therefore only delete the object once the MContinuousZoomObserver::ContinuousZoomCompleted()
sl@0	3139	callback has been received or has explicitly stopped the continuous zoom via StopContinuousZoom().
sl@0	3140
sl@0	3141	@internalTechnology
sl@0	3142	@prototype
sl@0	3143	*/
sl@0	3144	EXPORT_C void CCamera::CCameraAdvancedSettings::CreateContinuousZoomL(MContinuousZoomObserver& aObserver, TContinuousZoomType aContinuousZoomType, CCameraContinuousZoom*& aContinuousZoom)
sl@0	3145	{
sl@0	3146	if(iImpl4 != NULL)
sl@0	3147	{
sl@0	3148	MImplementationFactory* implFactory = NULL;
sl@0	3149
sl@0	3150	iImpl4->CreateContinuousZoomImplFactoryL(implFactory);
sl@0	3151
sl@0	3152	CleanupReleasePushL(*implFactory);
sl@0	3153	CCameraContinuousZoom* zoom = CCameraContinuousZoom::CreateL(aObserver, aContinuousZoomType, *implFactory);
sl@0	3154	CleanupStack::Pop(implFactory);
sl@0	3155
sl@0	3156	implFactory->Release();
sl@0	3157	aContinuousZoom = zoom;
sl@0	3158	}
sl@0	3159	else
sl@0	3160	{
sl@0	3161	User::Leave(KErrNotSupported);
sl@0	3162	}
sl@0	3163	}
sl@0	3164
sl@0	3165	/**
sl@0	3166	Register the ECAM component wide events in order to decide which events the client needs to be notified about.
sl@0	3167	Previously registered events will be overridden and not augmented.
sl@0	3168
sl@0	3169	@param aEventFilter
sl@0	3170	This is of type TECAMEventFilterScheme.
sl@0	3171	If EECAMEventFilterSchemeBlackList, the client will not be notified only for the events packed in the array 'aEvents'.
sl@0	3172	If EECAMEventFilterSchemeWhiteList, the client will be notified only for the events packed in the array 'aEvents'.
sl@0	3173
sl@0	3174	@param aEvents
sl@0	3175	An array of events provided by the client. Helps in filtering the events for notification purposes. An empty array
sl@0	3176	indicates that there are no events to register for a particular filtering scheme as given by aEventFilter.
sl@0	3177
sl@0	3178	@leave May leave with any error code.
sl@0	3179
sl@0	3180	@note Method RegisterEvents if called with EECAMEventFilterSchemeBlackList will wipe away any white listed events set
sl@0	3181	previously and make them inactive.
sl@0	3182
sl@0	3183	@publishedPartner
sl@0	3184	@prototype
sl@0	3185	*/
sl@0	3186	void CCamera::CCameraAdvancedSettings::RegisterEventsL(TECAMEventFilterScheme /aEventFilter/, const RArray<TUid>& /aEvents/)
sl@0	3187	{
sl@0	3188	User::Leave(KErrNotSupported);
sl@0	3189	}
sl@0	3190
sl@0	3191	/**
sl@0	3192	Retrieve the list of ECAM component wide events for a particular event filtering scheme.
sl@0	3193
sl@0	3194	@param aEventFilter
sl@0	3195	This is of type TECAMEventFilterScheme.
sl@0	3196	If EECAMEventFilterSchemeBlackList, retrieve the events which are not supposed to be used for notification.
sl@0	3197	If EECAMEventFilterSchemeWhiteList, retrieve the events which are supposed to be used for notification.
sl@0	3198
sl@0	3199	@param aEvents
sl@0	3200	An array of events given to the clients. Helps in filtering the events for notification purposes. An empty array
sl@0	3201	indicates that no events have been registered so far.
sl@0	3202
sl@0	3203	@param aInfo
sl@0	3204	Retrieved TValueInfo.
sl@0	3205	This will be ENotActive if no event has been yet registered under the 'aEventFilter' filter scheme.
sl@0	3206	This will be EDiscreteSteps if some events have been registered under the 'aEventFilter' filter scheme.
sl@0	3207
sl@0	3208	@leave May leave with any error code.
sl@0	3209
sl@0	3210	@note There should be consistency in the information retrieved when GetRegisteredEvents is consecutively called,
sl@0	3211	first for blacklisted events and secondly, for white listed events. Only one of them should be used at a time and
sl@0	3212	hence, for the other one, aInfo will be ENotActive.
sl@0	3213
sl@0	3214	@publishedPartner
sl@0	3215	@prototype
sl@0	3216	*/
sl@0	3217	void CCamera::CCameraAdvancedSettings::GetRegisterEventsL(TECAMEventFilterScheme /aEventFilter/, RArray<TUid>& /aEvents/, TValueInfo& /aInfo/) const
sl@0	3218	{
sl@0	3219	User::Leave(KErrNotSupported);
sl@0	3220	}
sl@0	3221
sl@0	3222	/**
sl@0	3223	Retrieves the supported flicker removal values.
sl@0	3224
sl@0	3225	@param aSupportedFlickerRemovalValue
sl@0	3226	A bitfield of all supported TFlickerRemoval to be provided to the client.
sl@0	3227
sl@0	3228	@leave May leave with any error code.
sl@0	3229
sl@0	3230	@publishedPartner
sl@0	3231	@prototype
sl@0	3232	*/
sl@0	3233	void CCamera::CCameraAdvancedSettings::GetSupportedFlickerRemovalValueL(TUint& /aSupportedFlickerRemovalValue/) const
sl@0	3234	{
sl@0	3235	User::Leave(KErrNotSupported);
sl@0	3236	}
sl@0	3237
sl@0	3238	/**
sl@0	3239	Get the current flicker removal value being used.
sl@0	3240
sl@0	3241	@param aFlickerRemovalValue
sl@0	3242	Currently used TFlickerRemoval value.
sl@0	3243
sl@0	3244	@leave May leave with any error code.
sl@0	3245
sl@0	3246	@publishedPartner
sl@0	3247	@prototype
sl@0	3248	*/
sl@0	3249	void CCamera::CCameraAdvancedSettings::GetFlickerRemovalValueL(CCamera::CCameraAdvancedSettings::TFlickerRemoval& /aFlickerRemovalValue/) const
sl@0	3250	{
sl@0	3251	User::Leave(KErrNotSupported);
sl@0	3252	}
sl@0	3253
sl@0	3254	/**
sl@0	3255	Set the flicker removal value.
sl@0	3256
sl@0	3257	@param aFlickerRemovalValue
sl@0	3258	The TFlickerRemoval value to be set.
sl@0	3259
sl@0	3260	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3261
sl@0	3262	@note Event KUidECamEventCameraSettingFlickerRemovalValue is used to notify clients about the flicker removal value
sl@0	3263	setting operation.
sl@0	3264
sl@0	3265	@publishedPartner
sl@0	3266	@prototype
sl@0	3267	*/
sl@0	3268	void CCamera::CCameraAdvancedSettings::SetFlickerRemovalValueL(CCamera::CCameraAdvancedSettings::TFlickerRemoval /aFlickerRemovalValue/)
sl@0	3269	{
sl@0	3270	User::Leave(KErrNotSupported);
sl@0	3271	}
sl@0	3272
sl@0	3273	/**
sl@0	3274	Retrieves the supported neutral density filter.
sl@0	3275
sl@0	3276	@param aSupportedNDFilter
sl@0	3277	A bitfield of all supported TNDFilter to be provided to the client.
sl@0	3278
sl@0	3279	@leave May leave with any error code.
sl@0	3280
sl@0	3281	@publishedPartner
sl@0	3282	@prototype
sl@0	3283	*/
sl@0	3284	void CCamera::CCameraAdvancedSettings::GetSupportedNDFilterL(TUint& /aSupportedNDFilter/) const
sl@0	3285	{
sl@0	3286	User::Leave(KErrNotSupported);
sl@0	3287	}
sl@0	3288
sl@0	3289	/**
sl@0	3290	Get the current neutral density filter being used.
sl@0	3291
sl@0	3292	@param aNDFilter
sl@0	3293	Currently used TNDFilter.
sl@0	3294
sl@0	3295	@leave May leave with any error code.
sl@0	3296
sl@0	3297	@publishedPartner
sl@0	3298	@prototype
sl@0	3299	*/
sl@0	3300	void CCamera::CCameraAdvancedSettings::GetNDFilterL(CCamera::CCameraAdvancedSettings::TNDFilter& /aNDFilter/) const
sl@0	3301	{
sl@0	3302	User::Leave(KErrNotSupported);
sl@0	3303	}
sl@0	3304
sl@0	3305	/**
sl@0	3306	Set the neutral density filter.
sl@0	3307
sl@0	3308	@param aNDFilter
sl@0	3309	The TNDFilter value to be set.
sl@0	3310
sl@0	3311	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3312
sl@0	3313	@note Event KUidECamEventCameraSettingNDFilter is used to notify clients about the neutral density setting operation.
sl@0	3314
sl@0	3315	@publishedPartner
sl@0	3316	@prototype
sl@0	3317	*/
sl@0	3318	void CCamera::CCameraAdvancedSettings::SetNDFilterL(CCamera::CCameraAdvancedSettings::TNDFilter /aNDFilter/)
sl@0	3319	{
sl@0	3320	User::Leave(KErrNotSupported);
sl@0	3321	}
sl@0	3322
sl@0	3323	/**
sl@0	3324	Get the type of LED effect being used for a particular LED event.
sl@0	3325
sl@0	3326	@param aLEDEvent
sl@0	3327	The TLEDEvent for which the current LED effect has to be retrieved.
sl@0	3328
sl@0	3329	@param aLEDEffect
sl@0	3330	The TLEDEffect which is being used for the given LED event.
sl@0	3331	If this is TLEDEffectCustom, then a custom LED effect would have been separately specified by the client.
sl@0	3332
sl@0	3333	@leave May leave with any error code.
sl@0	3334
sl@0	3335	@publishedPartner
sl@0	3336	@prototype
sl@0	3337	*/
sl@0	3338	void CCamera::CCameraAdvancedSettings::GetLEDEffectL(CCamera::CCameraAdvancedSettings::TLEDEvent /aLEDEvent/,
sl@0	3339	CCamera::CCameraAdvancedSettings::TLEDEffect& /aLEDEffect/) const
sl@0	3340	{
sl@0	3341	User::Leave(KErrNotSupported);
sl@0	3342	}
sl@0	3343
sl@0	3344	/**
sl@0	3345	Set the LED effect for a particular LED event.
sl@0	3346
sl@0	3347	@param aLEDEvent
sl@0	3348	The TLEDEvent for which the LED effect has to be set.
sl@0	3349
sl@0	3350	@param aLEDEffect
sl@0	3351	The TLEDEffect which has to be set for the given LED event. It should not be TLEDEffectCustom.
sl@0	3352	Use the method SetLEDCustomEffectL() to provide the custom LED effect.
sl@0	3353
sl@0	3354	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3355
sl@0	3356	@note Event KUidECamEventCameraSettingLEDEffect is used to notify clients about the LED effect setting operation.
sl@0	3357
sl@0	3358	@note The event will provide error code KErrArgument if TLEDEffectCustom is used as the TLEDEffect. Use the method
sl@0	3359	SetLEDCustomEffectL() to provide the custom LED effect.
sl@0	3360
sl@0	3361	@publishedPartner
sl@0	3362	@prototype
sl@0	3363	*/
sl@0	3364	void CCamera::CCameraAdvancedSettings::SetLEDEffectL(CCamera::CCameraAdvancedSettings::TLEDEvent /aLEDEvent/,
sl@0	3365	CCamera::CCameraAdvancedSettings::TLEDEffect /aLEDEffect/)
sl@0	3366	{
sl@0	3367	User::Leave(KErrNotSupported);
sl@0	3368	}
sl@0	3369
sl@0	3370	/**
sl@0	3371	Set the custom LED effect for a particular LED event.
sl@0	3372
sl@0	3373	@param aLEDEvent
sl@0	3374	The TLEDEvent for which the custom LED effect has to be set.
sl@0	3375
sl@0	3376	@param aLEDSpecialEffectSteps
sl@0	3377	An array of custom LED special effect steps. Every member of this array is of type TECamLEDSpecialEffectStep.
sl@0	3378	The array as a whole constitues a custom LED effect.
sl@0	3379
sl@0	3380	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3381
sl@0	3382	@note Event KUidECamEventCameraSettingLEDCustomEffect is used to notify clients about the LED effect setting operation.
sl@0	3383
sl@0	3384	@note Successful setting of a custom LED effect means that the GetLEDEffectL will retrieve TLEDEffectCustom for the
sl@0	3385	LEDEvent aLEDEvent.
sl@0	3386
sl@0	3387	@publishedPartner
sl@0	3388	@prototype
sl@0	3389	*/
sl@0	3390	void CCamera::CCameraAdvancedSettings::SetLEDCustomEffectL(CCamera::CCameraAdvancedSettings::TLEDEvent /aLEDEvent/,
sl@0	3391	const RArray<CCamera::CCameraAdvancedSettings::TECamLEDSpecialEffectStep>& /aLEDSpecialEffectSteps/)
sl@0	3392	{
sl@0	3393	User::Leave(KErrNotSupported);
sl@0	3394	}
sl@0	3395
sl@0	3396	/**
sl@0	3397	Reserve method which are less strict than existing Reserve methods and hence, expects implementation to be considerate towards camera access/control.
sl@0	3398
sl@0	3399	@param aMaxTimeToWait
sl@0	3400	Maximum specified time for the client to hold the camera control before releasing (KUidECamEvent2CameraRequestTimedTakeOver)
sl@0	3401	or being forcefully overtaken (KUidECamEvent2CameraRequestForcedTimedTakeOver).
sl@0	3402
sl@0	3403	@param aKickOut
sl@0	3404	ETrue indicates that if the requester's priority is greater than the current reserver's, then
sl@0	3405	KUidECamEvent2CameraRequestForcedTimedTakeOver will be issued to the current reserver. Otherwise,
sl@0	3406	KUidECamEvent2CameraRequestTimedTakeOver will be issued.
sl@0	3407
sl@0	3408	EFalse indicates that KUidECamEvent2CameraRequestTimedTakeOver will be issued to the current reserver.
sl@0	3409
sl@0	3410	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3411
sl@0	3412	@note Event KUidECamEventNewReserveComplete notifies the client who made the new Reserve request.
sl@0	3413	Error value KErrECamHighPriorityReserveRequesterExists indicates another such reserve request is outstanding
sl@0	3414	and has higher priority than this one.
sl@0	3415	Error value KErrCancel indicates a new reserve requester with a higher priority than the current requester has
sl@0	3416	been made and that the current requester has been cancelled.
sl@0	3417
sl@0	3418	@note Event KUidECamEvent2CameraRequestForcedTimedTakeOver notifies the current reserver client about its camera control
sl@0	3419	being forcefully overtaken after a specified time period.
sl@0	3420
sl@0	3421	@note Event KUidECamEvent2CameraRequestTimedTakeOver notifies the current reserver client about a request to release its
sl@0	3422	camera control within a specified time period.
sl@0	3423
sl@0	3424	@publishedPartner
sl@0	3425	@prototype
sl@0	3426	*/
sl@0	3427	void CCamera::CCameraAdvancedSettings::ReserveL(const TTimeIntervalMicroSeconds32& /aMaxTimeToWait/, TBool /aKickOut/)
sl@0	3428	{
sl@0	3429	User::Leave(KErrNotSupported);
sl@0	3430	}
sl@0	3431
sl@0	3432	/**
sl@0	3433	Sets the priority of the client. The client issues this call when it receives the notification
sl@0	3434	KUidECamEvent2CameraSettingChangeClientPriority. The target priority is also supplied with this notification as iParam.
sl@0	3435
sl@0	3436	@param aPriority
sl@0	3437	The target priority.
sl@0	3438
sl@0	3439	@note For example, a higher priority client is currently holding the camera and a lower priority legacy
sl@0	3440	application is continuously requesting to get hold of it. After receiving a number of repeated requests by the
sl@0	3441	same legacy client, the supportive ECam implementation issues the notification
sl@0	3442	KUidECamEvent2CameraSettingChangeClientPriority. After receiving this notification, the client issues this method
sl@0	3443	SetClientPriorityL(TInt aPriority).
sl@0	3444
sl@0	3445	@leave May leave with any error code.
sl@0	3446
sl@0	3447	@publishedPartner
sl@0	3448	@prototype
sl@0	3449	*/
sl@0	3450	void CCamera::CCameraAdvancedSettings::SetClientPriorityL(TInt /aPriority/)
sl@0	3451	{
sl@0	3452	User::Leave(KErrNotSupported);
sl@0	3453	}
sl@0	3454
sl@0	3455	/**
sl@0	3456	Restores the priority of the client. The client issues this call when it receives the notification
sl@0	3457	KUidECamEventCameraSettingRestoreClientPriority. ECam's responsibility is to save the original priority of the client.
sl@0	3458
sl@0	3459	@note Once the legacy client has released the camera (after changing its priority), implementation will notify the
sl@0	3460	client to restore its priority by event KUidECamEventCameraSettingRestoreClientPriority. After receiving this
sl@0	3461	notification, the client issues this method RestoreClientPriorityL().
sl@0	3462
sl@0	3463	@leave May leave with any error code.
sl@0	3464
sl@0	3465	@publishedPartner
sl@0	3466	@prototype
sl@0	3467	*/
sl@0	3468	void CCamera::CCameraAdvancedSettings::RestoreClientPriorityL()
sl@0	3469	{
sl@0	3470	User::Leave(KErrNotSupported);
sl@0	3471	}
sl@0	3472
sl@0	3473	/**
sl@0	3474	Retrieves the supported manual gain for a particular color channel.
sl@0	3475
sl@0	3476	@param aSupportedManualGain
sl@0	3477	An array of manual gain. The TInt represent the unit in 'db' and multiplied by KECamFineResolutionFactor. Empty
sl@0	3478	array indicates that feature is not supported.
sl@0	3479
sl@0	3480	@param aColorChannel
sl@0	3481	The TColorChannel for which the supported manual gain values have to be retrieved.
sl@0	3482
sl@0	3483	@leave May leave with any error code.
sl@0	3484
sl@0	3485	@publishedPartner
sl@0	3486	@prototype
sl@0	3487	*/
sl@0	3488	void CCamera::CCameraAdvancedSettings::GetSupportedManualGainL(RArray<TInt>& /aSupportedManualGain/,
sl@0	3489	CCamera::CCameraAdvancedSettings::TColorChannel /aColorChannel/) const
sl@0	3490	{
sl@0	3491	User::Leave(KErrNotSupported);
sl@0	3492	}
sl@0	3493
sl@0	3494	/**
sl@0	3495	Get the current manual gain value to be used for a particular color channel.
sl@0	3496
sl@0	3497	@param aManualGain
sl@0	3498	Currently used manual gain value. The TInt represents the unit in 'db' and multiplied by KECamFineResolutionFactor.
sl@0	3499
sl@0	3500	@param aColorChannel
sl@0	3501	The color channel for which the manual gain value has to be used.
sl@0	3502
sl@0	3503	@leave May leave with any error code.
sl@0	3504
sl@0	3505	@publishedPartner
sl@0	3506	@prototype
sl@0	3507	*/
sl@0	3508	void CCamera::CCameraAdvancedSettings::GetManualGainL(TInt& /aManualGain/,
sl@0	3509	CCamera::CCameraAdvancedSettings::TColorChannel /aColorChannel/) const
sl@0	3510	{
sl@0	3511	User::Leave(KErrNotSupported);
sl@0	3512	}
sl@0	3513
sl@0	3514	/**
sl@0	3515	Set the manual gain value for a particular color channel.
sl@0	3516
sl@0	3517	@param aManualGain
sl@0	3518	The manual gain value to be set. The TInt represents the unit in 'db' and multiplied by KECamFineResolutionFactor.
sl@0	3519
sl@0	3520	@param aColorChannel
sl@0	3521	Represents the color channel for which the manual gain value has to be set.
sl@0	3522
sl@0	3523	@leave KErrNotSupported if the implementation of this method is not present.
sl@0	3524
sl@0	3525	@note Event KUidECamEvent2CameraSettingManualGain is used to notify clients about the manual gain setting operation.
sl@0	3526
sl@0	3527	@note The client will be expected to use either RBG color channel or YUV color channel in order to apply manual gain.
sl@0	3528	If the client sets manual gain values for both the color space, it is up to the implementation to decide which
sl@0	3529	values to use.
sl@0	3530
sl@0	3531	@publishedPartner
sl@0	3532	@prototype
sl@0	3533	*/
sl@0	3534	void CCamera::CCameraAdvancedSettings::SetManualGainL(TInt /aManualGain/,
sl@0	3535	CCamera::CCameraAdvancedSettings::TColorChannel /aColorChannel/)
sl@0	3536	{
sl@0	3537	User::Leave(KErrNotSupported);
sl@0	3538	}
sl@0	3539
sl@0	3540	/**
sl@0	3541	Control the white balance lock. It can be either locked or unlocked.
sl@0	3542	The white balance can be locked after aiming at a white or grey card. This helps in using the same white balance
sl@0	3543	setting for the next image shots.
sl@0	3544
sl@0	3545	@param aEnableLock
sl@0	3546	ETrue instructs to lock the white balance.
sl@0	3547	EFalse instructs to unlock the white balance.
sl@0	3548
sl@0	3549	@leave KErrNotSupported If the implementation of this method is not present.
sl@0	3550
sl@0	3551	@note Event KUidECamEventCameraSettingLockWhiteBalance is used to notify clients about setting the state
sl@0	3552	of white balance lock.
sl@0	3553
sl@0	3554	@publishedPartner
sl@0	3555	@prototype
sl@0	3556	*/
sl@0	3557	void CCamera::CCameraAdvancedSettings::SetWhiteBalanceLockL(TBool /aEnableLock/)
sl@0	3558	{
sl@0	3559	User::Leave(KErrNotSupported);
sl@0	3560	}
sl@0	3561
sl@0	3562	/**
sl@0	3563	Get the current state for the white balance lock.
sl@0	3564
sl@0	3565	@param aIsLocked
sl@0	3566	A TBool specifies whether the white balance has been locked or unlocked.
sl@0	3567	ETrue indicates that the white balance has been locked.
sl@0	3568	EFalse indicates that the white balance has been unlocked.
sl@0	3569
sl@0	3570	@leave May leave with any error code.
sl@0	3571
sl@0	3572	@publishedPartner
sl@0	3573	@prototype
sl@0	3574	*/
sl@0	3575	void CCamera::CCameraAdvancedSettings::GetWhiteBalanceLockStateL(TBool& /aIsLocked/) const
sl@0	3576	{
sl@0	3577	User::Leave(KErrNotSupported);
sl@0	3578	}
sl@0	3579
sl@0	3580	/**
sl@0	3581	Instructs the implementation to continuously save the current state before releasing the camera or being overtaken.
sl@0	3582
sl@0	3583	@param aLatestCameraState
sl@0	3584	A RWriteStream reference which will be used by the implementation to continuously save the latest camera state.
sl@0	3585
sl@0	3586	@note The RWriteStream gives the implementation the facility to seek and overwrite any incorrectly updated state (in
sl@0	3587	the event of power failure, for example). Given stream sink shall support repositioning.
sl@0	3588
sl@0	3589	@note The ECam client should be careful not to use the saved state for a particular camera in order to restore a
sl@0	3590	different camera later on. Though the implementation will be expected to take care of such things since the
sl@0	3591	content of the files are only meaningful for the implementation.
sl@0	3592
sl@0	3593	@note The RWriteStream reference is not valid across the process.
sl@0	3594
sl@0	3595	@leave May leave with any error code.
sl@0	3596
sl@0	3597	@publishedPartner
sl@0	3598	@prototype
sl@0	3599	*/
sl@0	3600	void CCamera::CCameraAdvancedSettings::EnableStateSavingL(RWriteStream& /aLatestCameraState/)
sl@0	3601	{
sl@0	3602	User::Leave(KErrNotSupported);
sl@0	3603	}
sl@0	3604
sl@0	3605	/**
sl@0	3606	Instructs the implementation to stop saving the current state in the RWriteStream& as given by
sl@0	3607	EnableStateSavingL(RWriteStream& aLatestCameraState).
sl@0	3608
sl@0	3609	@leave May leave with any error code.
sl@0	3610
sl@0	3611	@publishedPartner
sl@0	3612	@prototype
sl@0	3613	*/
sl@0	3614	void CCamera::CCameraAdvancedSettings::DisableStateSavingL()
sl@0	3615	{
sl@0	3616	User::Leave(KErrNotSupported);
sl@0	3617	}
sl@0	3618
sl@0	3619	/**
sl@0	3620	Instructs the implementation to resume from the last saved state. This may be used after reserving the camera.
sl@0	3621
sl@0	3622	@param aLatestCameraState
sl@0	3623	A RReadStream reference which will be used by the implementation to restore the latest saved camera state information.
sl@0	3624
sl@0	3625	@note The RReadStream gives the implementation the facility to seek and overwrite any incorrectly updated state (in
sl@0	3626	the event of power failure, for example).
sl@0	3627
sl@0	3628	@note The ECam client should be careful not to use the saved state for a particular camera in order to restore a
sl@0	3629	different camera later on. Though the implementation will be expected to take care of such things since the
sl@0	3630	content of the files are only meaningful for the implementation.
sl@0	3631
sl@0	3632	@note The RReadStream reference is not valid across the process.
sl@0	3633
sl@0	3634	@leave May leave with any error code.
sl@0	3635
sl@0	3636	@publishedPartner
sl@0	3637	@prototype
sl@0	3638	*/
sl@0	3639	void CCamera::CCameraAdvancedSettings::RestoreLatestStateL(RReadStream& /aLatestCameraState/)
sl@0	3640	{
sl@0	3641	User::Leave(KErrNotSupported);
sl@0	3642	}
sl@0	3643
sl@0	3644	/**
sl@0	3645	Instructs the implementation to save the current state which will be used by the client as a custom user state.
sl@0	3646	The state saving will be done only once when this call is issued. Many such custom state could be created by the
sl@0	3647	clients.
sl@0	3648
sl@0	3649	@param aCustomCameraState
sl@0	3650	A RWriteStream reference which will be used by the implementation to save the current camera state as a milestone.
sl@0	3651
sl@0	3652	@note The ECam client should be careful not to use the saved state for a particular camera in order to restore a
sl@0	3653	different camera later on. Though the implementation will be expected to take care of such things since the
sl@0	3654	content of the files are only meaningful for the implementation.
sl@0	3655
sl@0	3656	@note The RWriteStream reference is not valid across the process.
sl@0	3657
sl@0	3658	@leave May leave with any error code.
sl@0	3659
sl@0	3660	@publishedPartner
sl@0	3661	@prototype
sl@0	3662	*/
sl@0	3663	void CCamera::CCameraAdvancedSettings::SaveCameraStateL(RWriteStream& /aCustomCameraState/)
sl@0	3664	{
sl@0	3665	User::Leave(KErrNotSupported);
sl@0	3666	}
sl@0	3667
sl@0	3668	/**
sl@0	3669	Instructs the implementation to stop saving the custom state in the RWriteStream& as given by
sl@0	3670	SaveCameraStateL(RWriteStream& aCustomCameraState).
sl@0	3671
sl@0	3672	@leave May leave with any error code.
sl@0	3673
sl@0	3674	@publishedPartner
sl@0	3675	@prototype
sl@0	3676	*/
sl@0	3677	void CCamera::CCameraAdvancedSettings::DisableCameraStateSavingL(RWriteStream& /aCustomCameraState/)
sl@0	3678	{
sl@0	3679	User::Leave(KErrNotSupported);
sl@0	3680	}
sl@0	3681
sl@0	3682	/**
sl@0	3683	Instructs the implementation to restore a custom saved state.
sl@0	3684	The camera can be restored in any of the custom camera states saved earlier.
sl@0	3685
sl@0	3686	@param aCustomCameraState
sl@0	3687	A RReadStream reference which will be used by the implementation to restore a custom camera state
sl@0	3688	which was saved earlier.
sl@0	3689
sl@0	3690	@note The ECam client should be careful not to use the saved state for a particular camera in order to restore a
sl@0	3691	different camera later on. Though the implementation will be expected to take care of such things since the
sl@0	3692	content of the files are only meaningful for the implementation.
sl@0	3693
sl@0	3694	@note The RReadStream reference is not valid across the process.
sl@0	3695
sl@0	3696	@leave May leave with any error code.
sl@0	3697
sl@0	3698	@publishedPartner
sl@0	3699	@prototype
sl@0	3700	*/
sl@0	3701	void CCamera::CCameraAdvancedSettings::RestoreCameraStateL(RReadStream& /aCustomCameraState/)
sl@0	3702	{
sl@0	3703	User::Leave(KErrNotSupported);
sl@0	3704	}
sl@0	3705
sl@0	3706	/**
sl@0	3707	Constructor for the TECamLEDSpecialEffectStep class.
sl@0	3708	Sets the size and version of this class.
sl@0	3709	*/
sl@0	3710	CCamera::CCameraAdvancedSettings::TECamLEDSpecialEffectStep::TECamLEDSpecialEffectStep()
sl@0	3711	{
sl@0	3712	iSize = sizeof(CCamera::CCameraAdvancedSettings::TECamLEDSpecialEffectStep);
sl@0	3713	iVersion = KECamLEDSpecialEffectStepCurrentVersion;
sl@0	3714	iBlinkingFrequency = 0;
sl@0	3715	iIntensity = 0;
sl@0	3716	iFrequencyStep = 0;
sl@0	3717	iDuration = 0;
sl@0	3718	}
sl@0	3719
sl@0	3720	/**
sl@0	3721	Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0	3722	Intended to be used for implementation of methods where this class reference is passed as function arguments.
sl@0	3723	Implementation of such methods can find out whether the actual class passed is the base or the derived one. For example, if a new application
sl@0	3724	is made to run on an old implementation, an error may occur once the old implementation detects this by getting
sl@0	3725	the size information of the T class passed. Also, if an old application is made to run on a new implementation, this can be
sl@0	3726	correctly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0	3727
sl@0	3728	@return The size of the class.
sl@0	3729
sl@0	3730	@note The size will be modified when the T-class gets updated.
sl@0	3731	*/
sl@0	3732	TUint CCamera::CCameraAdvancedSettings::TECamLEDSpecialEffectStep::Size() const
sl@0	3733	{
sl@0	3734	return iSize;
sl@0	3735	}
sl@0	3736
sl@0	3737	/**
sl@0	3738	Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved
sl@0	3739	members get used at a later stage.
sl@0	3740
sl@0	3741	@return The version of the class.
sl@0	3742
sl@0	3743	@note The version will be modified when the T-class gets updated.
sl@0	3744	*/
sl@0	3745	TUint CCamera::CCameraAdvancedSettings::TECamLEDSpecialEffectStep::Version() const
sl@0	3746	{
sl@0	3747	return iVersion;
sl@0	3748	}
sl@0	3749
sl@0	3750	/**
sl@0	3751	Constructor for the TContinuousZoomSupportInfo class.
sl@0	3752	Sets the size and version of this class.
sl@0	3753	*/
sl@0	3754	EXPORT_C CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo::TContinuousZoomSupportInfo()
sl@0	3755	{
sl@0	3756	iSize = sizeof(CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo);
sl@0	3757	iVersion = KContinuousZoomSupportInfoCurrentVersion;
sl@0	3758	}
sl@0	3759
sl@0	3760	/**
sl@0	3761	Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0	3762	Intended to be used for implementation of methods where this class reference is passed as function arguments.
sl@0	3763	Implementation of such methods can find out whether the actual class passed is the base or the derived one. For example, if a new application
sl@0	3764	is made to run on an old implementation, an error may occur once the old implementation detects this by getting
sl@0	3765	the size information of the T class passed. Also, if an old application is made to run on a new implementation, this can be
sl@0	3766	correctly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0	3767
sl@0	3768	@return The size of the class.
sl@0	3769
sl@0	3770	@note The size will be modified when the T-class gets updated.
sl@0	3771	*/
sl@0	3772	EXPORT_C TUint CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo::Size() const
sl@0	3773	{
sl@0	3774	return iSize;
sl@0	3775	}
sl@0	3776
sl@0	3777	/**
sl@0	3778	Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved
sl@0	3779	members get used at a later stage.
sl@0	3780
sl@0	3781	@return The version of the class.
sl@0	3782
sl@0	3783	@note The version will be modified when the T-class gets updated.
sl@0	3784	*/
sl@0	3785	EXPORT_C TUint CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo::Version() const
sl@0	3786	{
sl@0	3787	return iVersion;
sl@0	3788	}
sl@0	3789
sl@0	3790	/**
sl@0	3791	Constructor for the TContinuousZoomParameters class.
sl@0	3792	Sets the size and version of this class.
sl@0	3793	*/
sl@0	3794	EXPORT_C CCamera::CCameraAdvancedSettings::TContinuousZoomParameters::TContinuousZoomParameters()
sl@0	3795	{
sl@0	3796	iSize = sizeof(CCamera::CCameraAdvancedSettings::TContinuousZoomParameters);
sl@0	3797	iVersion = KContinuousZoomParametersCurrentVersion;
sl@0	3798	}
sl@0	3799
sl@0	3800	/**
sl@0	3801	Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0	3802	Intended to be used for implementation of methods where this class reference is passed as function arguments.
sl@0	3803	Implementation of such methods can find out whether the actual class passed is the base or the derived one. For example, if a new application
sl@0	3804	is made to run on an old implementation, an error may occur once the old implementation detects this by getting
sl@0	3805	the size information of the T class passed. Also, if an old application is made to run on a new implementation, this can be
sl@0	3806	correctly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0	3807
sl@0	3808	@return The size of the class.
sl@0	3809
sl@0	3810	@note The size will be modified when the T-class gets updated.
sl@0	3811	*/
sl@0	3812	EXPORT_C TUint CCamera::CCameraAdvancedSettings::TContinuousZoomParameters::Size() const
sl@0	3813	{
sl@0	3814	return iSize;
sl@0	3815	}
sl@0	3816
sl@0	3817	/**
sl@0	3818	Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved
sl@0	3819	members get used at a later stage.
sl@0	3820
sl@0	3821	@return The version of the class.
sl@0	3822
sl@0	3823	@note The version will be modified when the T-class gets updated.
sl@0	3824	*/
sl@0	3825	EXPORT_C TUint CCamera::CCameraAdvancedSettings::TContinuousZoomParameters::Version() const
sl@0	3826	{
sl@0	3827	return iVersion;
sl@0	3828	}
sl@0	3829
sl@0	3830
sl@0	3831	/**
sl@0	3832	Factory function that creates a new continuous zoom object.
sl@0	3833
sl@0	3834	@param aObserver
sl@0	3835	Continuous zoom observer which is passed to the implementation so it can provide callbacks to the client.
sl@0	3836
sl@0	3837	@param aContinuousZoomType
sl@0	3838	The continuous zoom type that the implementation will be initialised with.
sl@0	3839
sl@0	3840	@param aImplFactory
sl@0	3841	A constant reference to the MImplementationFactory derived object.
sl@0	3842
sl@0	3843	@leave KErrNoMemory if out of memory; also any system wide error.
sl@0	3844
sl@0	3845	@return A pointer to a fully constructed continuous zoom object.
sl@0	3846	*/
sl@0	3847	CCamera::CCameraContinuousZoom* CCamera::CCameraContinuousZoom::CreateL(MContinuousZoomObserver& aObserver, CCamera::CCameraAdvancedSettings::TContinuousZoomType aContinuousZoomType, const MImplementationFactory& aImplFactory)
sl@0	3848	{
sl@0	3849	CCameraContinuousZoom* self = new (ELeave) CCameraContinuousZoom();
sl@0	3850	CleanupStack::PushL(self);
sl@0	3851	self->ConstructL(aObserver, aContinuousZoomType, aImplFactory);
sl@0	3852	CleanupStack::Pop(self);
sl@0	3853	return self;
sl@0	3854	}
sl@0	3855
sl@0	3856	/**
sl@0	3857	CCameraContinuousZoom Constructor.
sl@0	3858	*/
sl@0	3859	CCamera::CCameraContinuousZoom::CCameraContinuousZoom()
sl@0	3860	: iImpl(NULL)
sl@0	3861	{
sl@0	3862	}
sl@0	3863
sl@0	3864	/**
sl@0	3865	CCameraContinuousZoom second phase constructor.
sl@0	3866
sl@0	3867	Function used to initialise internal state of the object.
sl@0	3868
sl@0	3869	@param aObserver
sl@0	3870	Continuous zoom observer which is passed to the implementation so it can provide callbacks to the client.
sl@0	3871
sl@0	3872	@param aContinuousZoomType
sl@0	3873	The continuous zoom type that the implementation will be initialised with.
sl@0	3874
sl@0	3875	@param aImplFactory
sl@0	3876	A constant reference to the MImplementationFactory derived object.
sl@0	3877
sl@0	3878	@leave KErrNoMemory Out of memory.
sl@0	3879	*/
sl@0	3880	void CCamera::CCameraContinuousZoom::ConstructL(MContinuousZoomObserver& aObserver, CCamera::CCameraAdvancedSettings::TContinuousZoomType aContinuousZoomType, const MImplementationFactory& aImplFactory)
sl@0	3881	{
sl@0	3882	TAny* implPtr = NULL;
sl@0	3883	TInt zoomTypeValue = static_cast<TInt>(aContinuousZoomType);
sl@0	3884	TECamImplFactoryParam param(zoomTypeValue);
sl@0	3885
sl@0	3886	User::LeaveIfError(aImplFactory.GetImpl1(implPtr, KECamMCameraContinuousZoomUid, param));
sl@0	3887
sl@0	3888	iImpl = static_cast<MCameraContinuousZoom*>(implPtr);
sl@0	3889
sl@0	3890	iImpl->SetContinuousZoomObserverAndHandle(aObserver, this);
sl@0	3891	}
sl@0	3892
sl@0	3893	/**
sl@0	3894	Destructor
sl@0	3895	*/
sl@0	3896	EXPORT_C CCamera::CCameraContinuousZoom::~CCameraContinuousZoom()
sl@0	3897	{
sl@0	3898	if(iImpl != NULL)
sl@0	3899	{
sl@0	3900	iImpl->Release();
sl@0	3901	}
sl@0	3902	}
sl@0	3903
sl@0	3904	/**
sl@0	3905	Starts the continuous zoom operation. Clients wil receive MContinuousZoomObserver::ContinuousZoomProgress() callback for intermediate
sl@0	3906	zoom factors achieved. Depending on the implementation, the client may or may not receive this callback for every intermediate zoom factor.
sl@0	3907	Upon completion, the client will receive MContinuousZoomObserver::ContinuousZoomComplete() callback.
sl@0	3908
sl@0	3909	@param aContinuousZoomParameters
sl@0	3910	The desired parameters to be used for the continuous zoom operation.
sl@0	3911
sl@0	3912	@note If the implementation does not support re-configuring of zoom parameters whilst an existing continuous zoom operation is active then
sl@0	3913	StartContinuousZoomL() will leave with KErrInUse.
sl@0	3914
sl@0	3915	@note If client has selected EDirectionTele zoom direction and the current zoom factor is greater than the target zoom factor, StartContinuousZoomL()
sl@0	3916	will leave with KErrArgument. Similarly, StartContinuousZoomL() will also leave with KErrArgument if client has selected EDirectionWide zoom
sl@0	3917	direction and current zoom factor is less than target zoom factor.
sl@0	3918
sl@0	3919	@leave May leave with any error code.
sl@0	3920	*/
sl@0	3921	EXPORT_C void CCamera::CCameraContinuousZoom::StartContinuousZoomL(CCamera::CCameraAdvancedSettings::TContinuousZoomParameters aContinuousZoomParameters)
sl@0	3922	{
sl@0	3923	iImpl->StartContinuousZoomL(aContinuousZoomParameters);
sl@0	3924	}
sl@0	3925
sl@0	3926	/**
sl@0	3927	Stop any exisiting continuous zoom operation.
sl@0	3928	Since this method is synchronous, no callback shall be issued for the concerned continuous zoom operation.
sl@0	3929	*/
sl@0	3930	EXPORT_C void CCamera::CCameraContinuousZoom::StopContinuousZoom()
sl@0	3931	{
sl@0	3932	iImpl->StopContinuousZoom();
sl@0	3933	}
sl@0	3934
sl@0	3935	/**
sl@0	3936	Retrieves information about the supported settings related to continuous zoom support.
sl@0	3937
sl@0	3938	@param aContinuousZoomInfo
sl@0	3939	The information of supported continuous zoom functionality.
sl@0	3940
sl@0	3941	@leave May leave with any error code.
sl@0	3942	*/
sl@0	3943	EXPORT_C void CCamera::CCameraContinuousZoom::GetContinuousZoomSupportInfoL(CCamera::CCameraAdvancedSettings::TContinuousZoomSupportInfo& aContinuousZoomInfo) const
sl@0	3944	{
sl@0	3945	iImpl->GetContinuousZoomSupportInfoL(aContinuousZoomInfo);
sl@0	3946	}
sl@0	3947
sl@0	3948	/**
sl@0	3949	Retrieves the unique id of the continuous zoom object.
sl@0	3950	This is used to identify the continuous zoom handle returned to clients via the MContinuousZoomObserver callback.
sl@0	3951
sl@0	3952	@param aZoomId
sl@0	3953	The unique id of this Continuous Zoom object.
sl@0	3954	*/
sl@0	3955	EXPORT_C void CCamera::CCameraContinuousZoom::GetContinuousZoomId(TInt& aZoomId) const
sl@0	3956	{
sl@0	3957	iImpl->GetContinuousZoomId(aZoomId);
sl@0	3958	}

author	sl
	Tue, 10 Jun 2014 14:32:02 +0200
changeset 1	260cb5ec6c19
permissions	-rw-r--r--