sl@0: // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #include <ecam/ecamimageprocessingintf.h>
sl@0: #include <ecam/implementationfactoryintf.h>
sl@0: #include <ecamimageprocessing.h>
sl@0: #include "ecamversion.h"
sl@0: #include <ecam/ecamconstants.h>
sl@0: 
sl@0: const TInt KBaselinedEffects = 0x000001FF;
sl@0: const TUint KBaselinedImageProcessing = KUidECamEventImageProcessingGlareRemovalUidValue;
sl@0: 
sl@0: /**
sl@0: Factory function for creating the CCameraImageProcessing object.
sl@0: The created object is supposed to be meant for image captures only.
sl@0: 
sl@0: @param aCamera 
sl@0: 	a reference to a CCamera object providing the settings.
sl@0: 
sl@0: @return a pointer to a fully constructed CCameraImageProcessing object.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory Or any other system-wide error code.
sl@0: 
sl@0: @note  Clients using MCameraObserver are not recommended to use this extension class since they cannot handle events.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraImageProcessing* CCamera::CCameraImageProcessing::NewL(CCamera& aCamera)
sl@0: 	{
sl@0: 	CCamera::CCameraImageProcessing* self = new (ELeave)CCamera::CCameraImageProcessing(aCamera); 
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL();
sl@0: 	CleanupStack::Pop(self);
sl@0: 	
sl@0: 	return self; 
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @internalComponent
sl@0: 
sl@0: Factory function for creating the CCameraImageProcessing object specifically for any one of the following:-
sl@0: VideoCapture and Viewfinder. This may be used in 
sl@0: other possible cases as well.
sl@0: 
sl@0: The other factory method CCamera::CCameraImageProcessing::NewL is assumed for being operated on image captures only.
sl@0: 
sl@0: @param aCamera 
sl@0: 	   A reference to a CCamera object providing the settings.
sl@0: 	
sl@0: @param aImplFactory 
sl@0: 	   A reference to the MImplementationFactory derived object.
sl@0: 
sl@0: @return a pointer to a fully constructed CCameraImageProcessing object.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory.
sl@0: 
sl@0: @leave KErrExtensionNotSupported When NewL/NewDuplicateL used instead of New2L/NewDuplicate2L.
sl@0: 
sl@0: @note This method is supposed to be used by internal ECAM components only.
sl@0: */	
sl@0: EXPORT_C CCamera::CCameraImageProcessing* CCamera::CCameraImageProcessing::CreateL(CCamera& aCamera, MImplementationFactory& aImplFactory)
sl@0: 	{
sl@0:  	if(aCamera.CameraVersion() == KCameraDefaultVersion)
sl@0:  		{
sl@0:  		User::Leave(KErrExtensionNotSupported);
sl@0:  		}
sl@0:  		
sl@0: 	CCamera::CCameraImageProcessing* self = new (ELeave)CCamera::CCameraImageProcessing(aCamera); 
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL(aImplFactory);
sl@0: 	CleanupStack::Pop(self);
sl@0: 		
sl@0: 	return self; 
sl@0: 	}	
sl@0: 
sl@0: /**	
sl@0: CCameraImageProcessing Constructor.
sl@0: 
sl@0: @param aOwner
sl@0:        a reference to a CCamera object providing the settings. 
sl@0: */	
sl@0: EXPORT_C CCamera::CCameraImageProcessing::CCameraImageProcessing(CCamera& aOwner):iOwner(aOwner), iImpl(NULL), iImpl2(NULL), iImpl3(NULL)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: CCameraImageProcessing second phase constructor 
sl@0: Function used to initialise internal state of the object. Uses reference to the camera to retrieve 
sl@0: Camera image processing interface pointer.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory.
sl@0: */ 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::ConstructL() 
sl@0: 	{
sl@0: 	iImpl = static_cast<MCameraImageProcessing*>(iOwner.CustomInterface(KECamMCameraImageProcessingUid));
sl@0: 	if (iImpl == NULL)
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);
sl@0: 		}
sl@0: 		
sl@0: 	iImpl2 = static_cast<MCameraImageProcessing2*>(iOwner.CustomInterface(KECamMCameraImageProcessing2Uid));
sl@0: 	iImpl3 = static_cast<MCameraImageProcessing3*>(iOwner.CustomInterface(KECamMCameraImageProcessing3Uid));
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @internalComponent
sl@0: 
sl@0: CCameraImageProcessing second phase constructor 
sl@0: 
sl@0: Function used to initialise internal state of the object specifically for any one of the following:-
sl@0: VideoCapture and Viewfinder. This may be used in other possible cases as well.
sl@0: 
sl@0: @param aImplFactory 
sl@0: 	   A constant reference to the MImplementationFactory derived object.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory; or any other error code as well.
sl@0: 
sl@0: @note This method is supposed to be used by this class only.
sl@0: */ 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::ConstructL(const MImplementationFactory& aImplFactory) 
sl@0: 	{
sl@0: 	TInt err = KErrNone;
sl@0: 	TAny* implPtr = NULL;
sl@0: 	
sl@0: 	err = aImplFactory.GetImpl(implPtr, KECamMCameraImageProcessingUid);
sl@0: 	if (err != KErrNone)
sl@0: 		{
sl@0: 		User::Leave(err);
sl@0: 		}
sl@0: 	iImpl = static_cast<MCameraImageProcessing*>(implPtr);
sl@0: 	
sl@0: 	implPtr = NULL;	
sl@0: 	err = aImplFactory.GetImpl(implPtr, KECamMCameraImageProcessing2Uid);
sl@0: 	if (err != KErrNone && err != KErrNotSupported)
sl@0: 		{
sl@0: 		User::Leave(err);
sl@0: 		}
sl@0: 	iImpl2 = static_cast<MCameraImageProcessing2*>(implPtr);
sl@0: 	
sl@0: 	implPtr = NULL;	
sl@0: 	err = aImplFactory.GetImpl(implPtr, KECamMCameraImageProcessing3Uid);
sl@0: 	if (err != KErrNone && err != KErrNotSupported)
sl@0: 		{
sl@0: 		User::Leave(err);
sl@0: 		}
sl@0: 	iImpl3 = static_cast<MCameraImageProcessing3*>(implPtr);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Destructor
sl@0: */	
sl@0: EXPORT_C CCamera::CCameraImageProcessing::~CCameraImageProcessing()
sl@0: 	{
sl@0: 	if (iImpl != NULL)
sl@0: 		{
sl@0: 		iImpl->Release();	
sl@0: 		}
sl@0: 	
sl@0: 	if (iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->Release();	
sl@0: 		}
sl@0: 		
sl@0: 	if (iImpl3 != NULL)
sl@0: 		{
sl@0: 		iImpl3->Release();	
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /** Get all transformations supported on the camera. 
sl@0:     
sl@0: @param  aTransformations
sl@0: 		An empty RArray of TUids to store the UIDs of the supported transformations.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory. 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetSupportedTransformationsL(RArray<TUid>& aTransformations) const
sl@0: 	{
sl@0: 	iImpl->GetSupportedTransformationsL(aTransformations);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0:     application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed 
sl@0:     from the implementation will be filtered at this point.
sl@0:     To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0:     to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0: 	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 		{
sl@0: 		for(TInt index =0; index < aTransformations.Count(); index++)
sl@0: 			{
sl@0: 			/** KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that
sl@0: 			it has been added in later versions */
sl@0: 			if(aTransformations[index].iUid > KBaselinedImageProcessing)
sl@0: 				{
sl@0: 				aTransformations.Remove(index);
sl@0: 				index--;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /** Get currently active transformations on the camera. 
sl@0:     
sl@0: @param  aTransformations
sl@0: 		An empty RArray of TUids to store the UIDs of the supported transformations.
sl@0: 
sl@0: @leave KErrNoMemory Out of memory.  
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetActiveTransformationsL(RArray<TUid>& aTransformations) const
sl@0: 	{
sl@0: 	iImpl->GetActiveTransformationsL(aTransformations);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0:     application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed 
sl@0:     from the implementation will be filtered at this point.
sl@0:     To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0:     to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0: 	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 		{
sl@0: 		for(TInt index =0; index < aTransformations.Count(); index++)
sl@0: 			{
sl@0: 			/** KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that
sl@0: 			it has been added in later versions */
sl@0: 			if(aTransformations[index].iUid > KBaselinedImageProcessing)
sl@0: 				{
sl@0: 				aTransformations.Remove(index);
sl@0: 				index--;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	}
sl@0: 	
sl@0: /** Get all values supported by an active transformation.
sl@0:     
sl@0: @param  aTransformation
sl@0: 		The UID of active transform for which values are requested.
sl@0: 		
sl@0: @param  aValues 
sl@0:         An array of integers to represent the values for the requested transformation.
sl@0:         
sl@0: @param  aInfo
sl@0:         Additional information describing the returned array of values.
sl@0:         
sl@0: @note   Depending on the value of aInfo parameter, same array of values may describe 
sl@0:         different set of values.
sl@0:         When camera device doesn't support this, empty array may be returned and TValueInfo may be ENotActive; 
sl@0:         corresponding getter/setters for this feature should not be used in such a case.
sl@0:         
sl@0: @note   If CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0: 	    application is not prepared to receive extra added enum values for Effects. So, any extra enum value(unrecognised) passed 
sl@0: 	    from the implementation will be filtered at this point.
sl@0: 	    To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0: 	    to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values
sl@0: 	   
sl@0: @leave  KErrNoMemory Out of memory.  
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetTransformationSupportedValuesL(TUid aTransformation, RArray<TInt>& aValues, TValueInfo& aInfo) const
sl@0: 	{
sl@0: 	iImpl->GetTransformationSupportedValuesL(aTransformation, aValues, aInfo);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0: 	   application is not prepared to receive extra added enum values for Effects. So, any extra enum value(unrecognised) passed 
sl@0: 	   from the implementation will be filtered at this point.
sl@0: 	   To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0: 	   to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0: 	if(aTransformation == KUidECamEventImageProcessingEffect)
sl@0: 		{
sl@0: 		if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 			{
sl@0: 			/** it is assumed that implementation will use EBitField to pack all supported effects */
sl@0: 			if(aInfo == EBitField)
sl@0: 				{
sl@0: 				aValues[0] &= KBaselinedEffects;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	}
sl@0: 	
sl@0: /** 
sl@0: @deprecated Use TInt GetTransformationValue(TUid aTransformation, TInt& aTransformationValue); 
sl@0: 
sl@0: Get the current value of a transformation
sl@0: 
sl@0: @param aTransformation
sl@0: 	   The UID of the transformation
sl@0: 
sl@0: @return The integer value of the tranformation. 	 
sl@0: 		
sl@0: @note 	If CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0: 	    application is not prepared to receive extra added enum values for Effects. So, any extra enum value (unrecognised) received 
sl@0: 	    from the implementation will be dropped and EEffectNone would be passed instead.
sl@0: 	    To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0: 	    to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values 
sl@0: */
sl@0: EXPORT_C TInt CCamera::CCameraImageProcessing::TransformationValue(TUid aTransformation) const
sl@0: 	{
sl@0: 	TInt value = iImpl->TransformationValue(aTransformation);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0:     application is not prepared to receive extra added enum values for Effects. So, any extra enum value (unrecognised) received 
sl@0:     from the implementation will be dropped and EEffectNone would be passed instead.
sl@0:     To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0:     to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0: 	if(aTransformation == KUidECamEventImageProcessingEffect)
sl@0: 		{
sl@0: 		if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 			{
sl@0: 			if(value > KBaselinedEffects)
sl@0: 				{
sl@0: 				value = CCamera::CCameraImageProcessing::EEffectNone;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	return value;
sl@0: 	}
sl@0: 	
sl@0: /** Get the current value of a transformation
sl@0: 
sl@0: @param aTransformation
sl@0: 	   The UID of the transformation
sl@0: 	   
sl@0: @param  aTransformationValue
sl@0: 		Reference to the integer value of the tranformation.
sl@0: 
sl@0: @return system wide error code. 	 
sl@0: 		
sl@0: @note 	If CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0: 	    application is not prepared to receive extra added enum values for Effects. So, any extra enum value (unrecognised) received 
sl@0: 	    from the implementation will be dropped and EEffectNone would be passed instead.
sl@0: 	    To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0: 	    to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values 
sl@0: 
sl@0: @note	Use this method instead of deprecated TInt TransformationValue(TUid aTransformation) 
sl@0: 
sl@0: */
sl@0: EXPORT_C TInt CCamera::CCameraImageProcessing::GetTransformationValue(TUid aTransformation, TInt& aTransformationValue) const
sl@0: 	{
sl@0: 	TInt error = iImpl->GetTransformationValue(aTransformation, aTransformationValue);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0:     application is not prepared to receive extra added enum values for Effects. So, any extra enum value (unrecognised) received 
sl@0:     from the implementation will be dropped and EEffectNone would be passed instead.
sl@0:     To receive extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0:     to create camera object. In this case, application is assumed to be prepared to receive unrecognised enum values */
sl@0: 	if(aTransformation == KUidECamEventImageProcessingEffect)
sl@0: 		{
sl@0: 		if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 			{
sl@0: 			if(aTransformationValue > KBaselinedEffects)
sl@0: 				{
sl@0: 				aTransformationValue = CCamera::CCameraImageProcessing::EEffectNone;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 		
sl@0: 	return error;
sl@0: 	}
sl@0: 	
sl@0: /** Set new value for a transformation. 
sl@0:  A notification event with the transformation UID is sent to 
sl@0:  all clients. UIDs are in the form KUidECamEventImageProcessingXXXX.
sl@0: 
sl@0: @param aTransformation
sl@0: 	   The UID of the transformation
sl@0: 
sl@0: @param aValue
sl@0: 	   The integer value of the tranformation. 	   
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetTransformationValue(TUid aTransformation, TInt aValue)
sl@0: 	{
sl@0: 	iImpl->SetTransformationValue(aTransformation, aValue);
sl@0: 	}
sl@0: 	
sl@0: /** Get the sequence of all active transforms, ordered in order of execution.
sl@0:  
sl@0: @param aTransformSequence
sl@0: 	   an empty array to be populated with sequence of transform UIDs, 
sl@0: 	   where transform entries with smaller index are executed earlier. 
sl@0: 	
sl@0: @leave KErrNoMemory Out of memory.  
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetActiveTransformSequenceL(RArray<TUid>& aTransformSequence) const
sl@0: 	{
sl@0: 	iImpl->GetActiveTransformSequenceL(aTransformSequence);
sl@0: 	
sl@0: 	/* if CCamera::New2L() or CCamera::NewDuplicate2L() is not used to create CCamera object, it is assumed that 
sl@0:     application is not prepared to receive extra added uid values (new settings added). So, any extra uid value passed 
sl@0:     from the implementation will be filtered at this point.
sl@0:     To receive extra added uid values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() 
sl@0:     to create camera object. In this case, application is assumed to be prepared to receive unrecognised uid values */
sl@0: 	if(iOwner.CameraVersion() == KCameraDefaultVersion)
sl@0: 		{
sl@0: 		for(TInt index =0; index < aTransformSequence.Count(); index++)
sl@0: 			{
sl@0: 			/** KBaselinedImageProcessing is the baseline. Any image processing attribute with greater uid value means that
sl@0: 			it has been added in later versions */
sl@0: 			if(aTransformSequence[index].iUid > KBaselinedImageProcessing)
sl@0: 				{
sl@0: 				aTransformSequence.Remove(index);
sl@0: 				index--;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 	}
sl@0: 	
sl@0: /** 
sl@0: Set the order of all active transform in terms of execution. The transforms with 
sl@0: smaller index are executed earlier.
sl@0: 
sl@0: @param aTransformSequence
sl@0: 	   The list of ordered transforms, where transforms with smaller 
sl@0: 	   index are executed earlier.
sl@0:   
sl@0: @leave KErrNoMemory Out of memory.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetActiveTransformSequenceL(RArray<TUid>& aTransformSequence)
sl@0: 	{
sl@0: 	iImpl->SetActiveTransformSequenceL(aTransformSequence);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Set the source rectangle for KUidECamEventImageProcessingTransformScale or 
sl@0: KUidECamEventImageProcessingTransformCrop.
sl@0: The coordinates should fall within the current image rectangle. The result 
sl@0: is always a logical AND operation between the two rectangles.
sl@0: 		   
sl@0: @param aRect
sl@0: 	   a reference to TRect object which describes the coordinates of the 
sl@0: 	   area of interest. 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetSourceRect(const TRect& aRect)
sl@0: 	{
sl@0: 	iImpl->SetSourceRect(aRect);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Get the source rectangle for KUidECamEventImageProcessingTransformScale or 
sl@0: KUidECamEventImageProcessingTransformCrop.
sl@0: The coordinates should fall within the current image rectangle. The result 
sl@0: is always a logical AND operation between the two rectangles.
sl@0: 		   
sl@0: @param aRect
sl@0: 		a reference to TRect object to hold the current source rectangle 
sl@0: 		coordinates. If it has not been set, the coordinates match these of 
sl@0: 		the whole image.      
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetSourceRect(TRect& aRect) const
sl@0: 	{
sl@0: 	iImpl->GetSourceRect(aRect);
sl@0: 	}
sl@0: 	
sl@0: 
sl@0: /**
sl@0: Retrieves the maximum number of simultaneous color swapping possible.
sl@0: 	
sl@0: @param aConcurrentColorSwappingSupported
sl@0: 	   Retrieves the number of simultaneous color swapping supported. 
sl@0: 	   Retrieves 0 when swapping feature is not supported.
sl@0: 	
sl@0: @leave May leave as a result of some error.
sl@0: 
sl@0: */       
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetConcurrentColorSwappingsSupportedL(TInt& aConcurrentColorSwappingSupported) const
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetConcurrentColorSwappingsSupportedL(aConcurrentColorSwappingSupported);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Retrieves the color swapping capabilites per entry, if different entries have different capabilities 
sl@0: otherwise the same capabilities retrieved for a particular entry can be assumed to be valid for every entry
sl@0: 
sl@0: @param aIndex 
sl@0: 	   This is a value from 0 to numOfSimultaneousColorSwappings -1. Color swapping capabilities specific to 
sl@0: 	   a particular entry are retrieved. If uniform capability exists for every entry, then this method need not 
sl@0: 	   be called per entry.	
sl@0: 	   
sl@0: @param aColorSwapCapabilities
sl@0: 	   This retrieves the color swap capabilities.
sl@0: 	   
sl@0: @leave May leave as a result of some error.
sl@0: 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetColorSwapCapabilitiesL(TInt aIndex, CCamera::CCameraImageProcessing::TColorOperationCapabilities& aColorSwapCapabilities) const
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetColorSwapCapabilitiesL(aIndex, aColorSwapCapabilities);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Set the color swap entries
sl@0: 
sl@0: @param aIndex
sl@0: 	   This is a value from 0 to numOfSimultaneousColorSwappings -1. This helps in managing the limited no. of 
sl@0: 	   simultaneous color swaps. If parameters are already set for the given entry, then it's up to the implementation
sl@0: 	   to replace the existing one or discard it. 
sl@0: 
sl@0: @param aColorSwapParameters
sl@0: 	   The parameters necessary to define clearly the color swapping operation for the given entry. 
sl@0: 	   iEntryStatus has to be updated by the implementation as per the result of the setting operation. 
sl@0: 	   So, iEntryStatus value is redundant at this point.
sl@0: 	   
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 	   
sl@0: @note  Triggers KUidECamEventCIPSetColorSwapEntry to all MCameraObserver2 clients of the camera. 
sl@0: 	   HandleEvent is used to report the result or any possible error. TECAMEvent2 class should 
sl@0: 	   be used in order to provide the entry no. of the color being set. 
sl@0: 
sl@0: */		 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetColorSwapEntryL(TInt aIndex, const CCamera::CCameraImageProcessing::TColorOperationEntry& aColorSwapParameters)
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->SetColorSwapEntry(aIndex, aColorSwapParameters);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Removes the color swap entry corresponding to the given index
sl@0: 
sl@0: @param aIndex
sl@0: 	   This gives the color swapping entry to be removed. 
sl@0: 	   
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 	   
sl@0: @note  Triggers KUidECamEventCIPRemoveColorSwapEntry to all MCameraObserver2 clients of the camera.
sl@0: 	   HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be
sl@0: 	   used in order to provide the entry no. of the color being removed. 
sl@0: 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::RemoveColorSwapEntryL(TInt aIndex)
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->RemoveColorSwapEntry(aIndex);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Get the details of the color swap entry corresponding to the given index
sl@0: 
sl@0: @param aIndex
sl@0: 	   This gives the color swapping entry whose information has to be retrieved.
sl@0: 
sl@0: @param aColorSwapParameters
sl@0: 	   This contains the parameters currently being used by the color swapping operation for the given entry.
sl@0: 
sl@0: @leave May leave as a result of some error. 
sl@0: 
sl@0: */			   
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetColorSwapEntryL(TInt aIndex, CCamera::CCameraImageProcessing::TColorOperationEntry& aColorSwapParameters) const
sl@0: 	 {
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetColorSwapEntryL(aIndex, aColorSwapParameters);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Starts the color swapping process after taking into account the color swap entries updated up to this point.
sl@0: 
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 
sl@0: @note Triggers KUidECamEventCIPStartColorSwap to all MCameraObserver2 clients of the camera. 
sl@0: 	  HandleEvent is used to report the result or any possible error. 
sl@0: 	  One possible error case is when more than one entry describe the same color source. 
sl@0: 	  New ecam error KErrECamColorOperationConflict used in such a case.
sl@0: 
sl@0: */		 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::StartColorSwappingL()
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->StartColorSwapping();	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Cancel the color swapping process.
sl@0: 
sl@0: @leave May leave as a result of some error.
sl@0: 
sl@0: @note  Used to cancel the color swapping process which might have been just started. 
sl@0: 	   If the issued StartColorSwappingL() gets cancelled, its event should report KErrCancel.
sl@0: 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::CancelColorSwappingL()
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->CancelColorSwappingL();	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Retrieves the maximum number of color entries on which simultaneous color accent process is possible.
sl@0: 
sl@0: @param aConcurrentColorAccentSupported
sl@0: 	   Retrieves the number of color entries on which simultaneous color accent process is possible. 
sl@0: 	   Retrieves 0 when color accent process is not supported.
sl@0: 
sl@0: @leave May leave as a result of some error. 
sl@0: 
sl@0: */    
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetConcurrentColorAccentSupportedL(TInt& aConcurrentColorAccentSupported) const
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetConcurrentColorAccentSupportedL(aConcurrentColorAccentSupported);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Retrieves the color accent capabilites per entry, if different entries have different capabilities 
sl@0: otherwise the same capabilities retrieved for a particular entry can be assumed to be valid for every entry
sl@0: 
sl@0: @param aIndex 
sl@0: 	   This is a value from 0 to numOfSimultaneousColorAccent -1. Color accent capabilities specific to 
sl@0: 	   a particular entry are retrieved. If uniform capability exists for every entry, then this method need not 
sl@0: 	   be called per entry.	
sl@0: 	   
sl@0: @param aColorAccentCapabilities
sl@0: 	   This retrieves the color accent capabilities.
sl@0: 	   
sl@0: @leave May leave as a result of some error.
sl@0: 
sl@0: */       
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetColorAccentCapabilitiesL(TInt aIndex, CCamera::CCameraImageProcessing::TColorOperationCapabilities& aColorAccentCapabilities) const
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetColorAccentCapabilitiesL(aIndex, aColorAccentCapabilities);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Set the color accent entries
sl@0: 
sl@0: @param aIndex
sl@0: 	   This is a value from 0 to numOfSimultaneousColorAccent -1. This helps in managing the limited no. of 
sl@0: 	   simultaneous color accent. If parameters are already set for the given entry, then it's up to the implementation
sl@0: 	   to replace the existing one or discard it. 
sl@0: 
sl@0: @param aColorAccentParameters
sl@0: 	   The parameters necessary to define clearly the color accent operation for the given entry. 
sl@0: 	   iEntryStatus has to be updated by the implementation as per the result of the setting operation. 
sl@0: 	   So, iEntryStatus value is redundant at this point. The parameters defined for target colors in 
sl@0: 	   TColorOperationEntry are redundant for color accent.
sl@0: 	   
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 	   
sl@0: @note  Triggers KUidECamEventCIPSetColorAccentEntry to all MCameraObserver2 clients of the camera. 
sl@0: 	   HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be 
sl@0: 	   used in order to provide the entry no. of the color being set. 
sl@0: 
sl@0: */		 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetColorAccentEntryL(TInt aIndex, const CCamera::CCameraImageProcessing::TColorOperationEntry& aColorAccentParameters)
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->SetColorAccentEntry(aIndex, aColorAccentParameters);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Removes the color accent entry corresponding to the given index
sl@0: 
sl@0: @param aIndex
sl@0: 	   This gives the color accent entry to be removed. 
sl@0: 	   
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 	   
sl@0: @note  Triggers KUidECamEventCIPRemoveColorAccentEntry to all MCameraObserver2 clients of the camera.
sl@0: 	   HandleEvent is used to report the result or any possible error. TECAMEvent2 class should be 
sl@0: 	   used in order to provide the entry no. of the color being removed. 
sl@0: 
sl@0: */		 
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::RemoveColorAccentEntryL(TInt aIndex)
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->RemoveColorAccentEntry(aIndex);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Get the details of the color accent entry corresponding to the given index
sl@0: 
sl@0: @param aIndex
sl@0: 	   This gives the color accent entry whose information has to be retrieved.
sl@0: 
sl@0: @param aColorAccentParameters
sl@0: 	   This contains the parameters currently being used by the color accent operation for the given entry.
sl@0: 	   The parameters defined for target colors in TColorOperationEntry are redundant for color accent.
sl@0: 
sl@0: @leave May leave as a result of some error. 
sl@0: 
sl@0: */		  
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetColorAccentEntryL(TInt aIndex, CCamera::CCameraImageProcessing::TColorOperationEntry& aColorAccentParameters) const
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->GetColorAccentEntryL(aIndex, aColorAccentParameters);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	} 
sl@0: 
sl@0: /**
sl@0: Starts the color accent process after taking into account the color accent entries updated up to this point.
sl@0: 
sl@0: @leave KErrNotSupported if implementation is not present.
sl@0: 
sl@0: @note  Triggers KUidECamEventCIPStartColorAccent to all MCameraObserver2 clients of the camera. 
sl@0: 	   HandleEvent is used to report the result or any possible error. 
sl@0: 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::StartColorAccentL()
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->StartColorAccent();	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Cancel the color accent process.
sl@0: 
sl@0: @leave May leave as a result of some error.
sl@0: 
sl@0: @note  Used to cancel the color accent process which might have been just started. 
sl@0: 	   If the issued StartColorAccentL() gets cancelled, its event should report KErrCancel.
sl@0: 
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::CancelColorAccentL()
sl@0: 	{
sl@0: 	if(iImpl2 != NULL)
sl@0: 		{
sl@0: 		iImpl2->CancelColorAccentL();	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Retrieves the supported options for a particular orientation reference.
sl@0: 
sl@0: @param  aOrientationReference
sl@0: 		A TOrientationReference for which supported relative custom orientation have to retrieved.
sl@0: 		
sl@0: @param  aSupportedRelativeRotation
sl@0: 		A bitfield which retrieves the supported TRelativeRotation for 'aOrientationReference'
sl@0: 		
sl@0: @param  aSupportedRelativeMirroring
sl@0: 		A bitfield which retrieves the supported TRelativeMirror for 'aOrientationReference'
sl@0: 		
sl@0: @param  aSupportedRelativeFlipping
sl@0: 		A bitfield which retrieves the supported TRelativeFlipping for 'aOrientationReference'
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: 
sl@0: @publishedPartner
sl@0: @prototype
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetSupportedRelativeOrientationOptionsL(CCamera::CCameraImageProcessing::TOrientationReference aOrientationReference, 
sl@0: 		TUint& aSupportedRelativeRotation, TUint& aSupportedRelativeMirroring, TUint& aSupportedRelativeFlipping) const
sl@0: 	{
sl@0: 	if(iImpl3 != NULL)
sl@0: 		{
sl@0: 		iImpl3->GetSupportedRelativeOrientationOptionsL(aOrientationReference, aSupportedRelativeRotation, 
sl@0: 									aSupportedRelativeMirroring, aSupportedRelativeFlipping);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}		
sl@0: 	}										
sl@0: 
sl@0: /**
sl@0: Retrieves the options which is being used for the current orientation reference.
sl@0: 
sl@0: @param  aOrientationReference
sl@0: 		A TOrientationReference which is the current orientation reference being used.
sl@0: 		
sl@0: @param  aRelativeRotation
sl@0: 		A TRelativeRotation which is the current relative rotation being used with aOrientationReference.
sl@0: 		
sl@0: @param  aRelativeMirror
sl@0: 		A TRelativeMirror which is the current relative mirroring being used with aOrientationReference.
sl@0: 		
sl@0: @param  aRelativeFlipping
sl@0: 		A TRelativeFlipping which is the current relative flipping being used with aOrientationReference.
sl@0: 		
sl@0: @leave  May leave with any error code.
sl@0: 
sl@0: @publishedPartner
sl@0: @prototype
sl@0: */															
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::GetCurrentRelativeOrientationOptionsL(CCamera::CCameraImageProcessing::TOrientationReference& aOrientationReference, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeRotation& aRelativeRotation, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeMirror& aRelativeMirror, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeFlipping& aRelativeFlipping) const
sl@0: 	{
sl@0: 	if(iImpl3 != NULL)
sl@0: 		{
sl@0: 		iImpl3->GetCurrentRelativeOrientationOptionsL(aOrientationReference, aRelativeRotation, aRelativeMirror, aRelativeFlipping);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Sets the options which would be used with the desired orientation reference.
sl@0: 
sl@0: @param  aOrientationReference
sl@0: 		The desired TOrientationReference.
sl@0: 		
sl@0: @param  aRelativeRotation
sl@0: 		The desired TRelativeRotation which would be used with 'aOrientationReference'.
sl@0: 		
sl@0: @param  TRelativeMirror
sl@0: 		The desired TRelativeMirror which would be used with 'aOrientationReference'
sl@0: 
sl@0: @param  TRelativeFlipping
sl@0: 		The desired TRelativeFlipping which would be used with 'aOrientationReference'
sl@0: 		
sl@0: @leave  KErrNotSupported if the implementation of this method is not present.
sl@0: 		
sl@0: @note   Event KUidECamEventImageProcessingTransformRelativeOrientation is used to notify clients about relative 
sl@0: 		custom orientation setting operation.
sl@0: 		
sl@0: @note   If the current picture orientation (Refer CCamera::CCameraAdvancedSettings::TPictureOrientation) is not possible
sl@0: 		to be achieved with the relative custom orientation, event KUidECamEventPictureOrientationUnachievable will be
sl@0: 		notified to the client.
sl@0: 		
sl@0: @note   If the dimension of the image gets changed by the desired relative orientation options, notification 
sl@0: 		KUidECamEventCameraSettingImageSize will be notified to the client.
sl@0: 		
sl@0: @publishedPartner
sl@0: @prototype
sl@0: */												
sl@0: EXPORT_C void CCamera::CCameraImageProcessing::SetRelativeOrientationOptionsL(CCamera::CCameraImageProcessing::TOrientationReference aOrientationReference, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeRotation aRelativeRotation, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeMirror aRelativeMirror, 
sl@0: 											CCamera::CCameraImageProcessing::TRelativeFlipping aRelativeFlipping)
sl@0: 	{
sl@0: 	if(iImpl3 != NULL)
sl@0: 		{
sl@0: 		iImpl3->SetRelativeOrientationOptions(aOrientationReference, aRelativeRotation, aRelativeMirror, aRelativeFlipping);	
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);	
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Constructor for the TColorOperationCapabilities class.
sl@0: Sets the size and version of this class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraImageProcessing::TColorOperationCapabilities::TColorOperationCapabilities()
sl@0: 	{
sl@0: 	iSize = sizeof(CCamera::CCameraImageProcessing::TColorOperationCapabilities);
sl@0: 	iVersion = KECamColorOperationCapabilitiesCurrentVersion;
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0: Intended to be used for implementation of methods where this class reference is passed as function arguments. 
sl@0: Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application 
sl@0: is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting 
sl@0: the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be 
sl@0: properly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0: 
sl@0: @return The size of the class.
sl@0: 
sl@0: @note The size will be modified when the T-class gets updated.
sl@0: */
sl@0: EXPORT_C TInt CCamera::CCameraImageProcessing::TColorOperationCapabilities::Size() const
sl@0: 	{
sl@0: 	return static_cast<TInt>(iSize);
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved 
sl@0: members get used at a later stage.
sl@0: 
sl@0: @return The version of this class.
sl@0: 
sl@0: @note The version will be modified when the T-class gets updated.
sl@0: */
sl@0: EXPORT_C TUint CCamera::CCameraImageProcessing::TColorOperationCapabilities::Version() const
sl@0: 	{
sl@0: 	return iVersion;	
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Constructor for the TBitsIgnore class.
sl@0: Sets the size and version of this class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraImageProcessing::TBitsIgnore::TBitsIgnore()
sl@0: 	{
sl@0: 	iSize = sizeof(CCamera::CCameraImageProcessing::TBitsIgnore);
sl@0: 	iVersion = KECamBitsIgnoreCurrentVersion;
sl@0: 	iRedBitsIgnore = 0;
sl@0: 	iGreenBitsIgnore = 0;
sl@0: 	iBlueBitsIgnore = 0;
sl@0: 	iAlphaBitsIgnore = 0;
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0: Intended to be used for implementation of methods where this class reference is passed as function arguments. 
sl@0: Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application 
sl@0: is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting 
sl@0: the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be 
sl@0: properly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0: 
sl@0: @return The size of the class.
sl@0: 
sl@0: @note The size will be modified when the T-class gets updated.
sl@0: */	
sl@0: EXPORT_C TInt CCamera::CCameraImageProcessing::TBitsIgnore::Size() const
sl@0: 	{
sl@0: 	return static_cast<TInt>(iSize);
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved 
sl@0: members get used at a later stage.
sl@0: 
sl@0: @return The version of this class.
sl@0: 
sl@0: @note The version will be modified when the T-class gets updated.
sl@0: */
sl@0: EXPORT_C TUint CCamera::CCameraImageProcessing::TBitsIgnore::Version() const
sl@0: 	{
sl@0: 	return iVersion;	
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Constructor for the TColorOperationEntry class.
sl@0: Sets the size and version of this class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraImageProcessing::TColorOperationEntry::TColorOperationEntry()
sl@0: 	{
sl@0: 	iSize = sizeof(CCamera::CCameraImageProcessing::TColorOperationEntry);
sl@0: 	iVersion = KECamColorOperationEntryCurrentVersion;
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the size of the class. Used for extensibility by deriving from this base class and adding new member variables.
sl@0: Intended to be used for implementation of methods where this class reference is passed as function arguments. 
sl@0: Implementation of such methods can find out the whether the actual class passed is base or the derived one. So, if a new application 
sl@0: is made to run on an old implementation, an error may occur in such cases after the old implementation detects this by getting 
sl@0: the size information of the T class passed. Also, if old application is made to run on a new implementation, this could be 
sl@0: properly handled if the derived class variables handling is done in a proper 'if-else' statement.
sl@0: 
sl@0: @return The size of the class.
sl@0: 
sl@0: @note The size will be modified when the T-class gets updated.
sl@0: */	
sl@0: EXPORT_C TInt CCamera::CCameraImageProcessing::TColorOperationEntry::Size() const
sl@0: 	{
sl@0: 	return static_cast<TInt>(iSize);
sl@0: 	}
sl@0: 	
sl@0: /**	
sl@0: Returns the version of the class. Used for extensibility specially when the class members are not added but the Reserved 
sl@0: members get used at a later stage.
sl@0: 
sl@0: @return The version of this class.
sl@0: 
sl@0: @note The version will be modified when the T-class gets updated.
sl@0: */
sl@0: EXPORT_C TUint CCamera::CCameraImageProcessing::TColorOperationEntry::Version() const
sl@0: 	{
sl@0: 	return iVersion;	
sl@0: 	}