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: /**
sl@0:  @file
sl@0:  @publishedPartner
sl@0:  @prototype
sl@0: */
sl@0: 
sl@0: #include <ecam/mcamerahistogram.h>
sl@0: #include "ecamversion.h"
sl@0: #include <ecam/implementationfactoryintf.h>
sl@0: 
sl@0: /**
sl@0: @deprecated use static CCamera::CCameraV2Histogram* CreateL(CCamera& aCamera, MImplementationFactory& aImplFactory)
sl@0: 
sl@0: Factory function that creates a new camera histogram object on the heap.
sl@0: 
sl@0: @param	aCamera
sl@0: 		A reference to the camera object for which a camera histogram object is to be created.
sl@0: 
sl@0: @leave  KErrNoMemory if out of memory; also any system wide error.
sl@0: 
sl@0: @return A pointer to the newly created camera histogram object.
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::CCameraHistogram* CCamera::CCameraHistogram::NewL(CCamera& aCamera)
sl@0: 	{
sl@0: 	CCamera::CCameraHistogram* self = new (ELeave) CCamera::CCameraHistogram(aCamera);
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL();
sl@0: 	CleanupStack::Pop(self);
sl@0: 	return self; 
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::ConstructL(const MImplementationFactory& aImplFactory)
sl@0: 
sl@0: CCameraHistogram second phase constructor. 
sl@0: 
sl@0: This function used to initialise internal state of the object. 
sl@0: It uses reference to the camera to retrieve histogram interface pointer.
sl@0: 
sl@0: @leave KErrNotSupported if this functionality is not supported; also any system wide error.
sl@0: */ 
sl@0: void CCamera::CCameraHistogram::ConstructL()
sl@0: 	{
sl@0: 	iImpl = static_cast<MCameraHistogram*>(iOwner.CustomInterface(KECamMCameraHistogramUid));
sl@0: 
sl@0: 	if (iImpl == NULL)
sl@0: 		{
sl@0: 		User::Leave(KErrNotSupported);
sl@0: 		}
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @deprecated use CCamera::CCameraV2Histogram::CCameraV2Histogram(CCamera& aOwner)
sl@0: 
sl@0: Constructor for the CCamera::CCameraHistogram class.
sl@0: 
sl@0: @param aOwner
sl@0: 		A reference to the camera object for which a camera histogram object is to be created.
sl@0: */
sl@0: CCamera::CCameraHistogram::CCameraHistogram(CCamera& aOwner):iOwner(aOwner), iImpl(NULL)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use CCamera::CCameraV2Histogram::~CCameraV2Histogram() 
sl@0: 
sl@0: Destructor for the CCamera::CCameraHistogram class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraHistogram::~CCameraHistogram()
sl@0: 	{
sl@0: 	if (iImpl != NULL)
sl@0: 		{
sl@0: 		iImpl->Release();	
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::GetSupportedHistogramsL(TUint& aSupportedHistogramType)
sl@0: 
sl@0: Gets a list of the types of histograms the ECam implementation supports.
sl@0: 
sl@0: @return	A bit field representing all supported types of histograms. 
sl@0: 
sl@0: @see CCamera::CCameraHistogram::THistogramType
sl@0: */
sl@0: EXPORT_C TUint32 CCamera::CCameraHistogram::SupportedHistograms()
sl@0: 	{
sl@0: 	return iImpl->SupportedHistograms();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::PrepareClientHistogramL
sl@0: 
sl@0: Request to prepare a non direct histogram.
sl@0: 
sl@0: @note 	A direct histogram is directly embedded into the viewfinder.
sl@0: 		If a non direct histogram is requested the histogram data will be passed to the camera client.
sl@0: 
sl@0: @param	aType		
sl@0: 		The type of histogram to be prepared. This must be one of the supported histogram types returned by
sl@0: 		SupportedHistograms().
sl@0: 
sl@0: @leave	KErrNotSupported if the histogram type supplied in aType is not supported.
sl@0: 
sl@0: @return An integer value which is the handle of the histogram on the ECam implementation.
sl@0:  		This value must be passed to other API functions when requesting operations 
sl@0:  		involving this particular histogram.
sl@0: 
sl@0: @see PrepareDSAHistogramL
sl@0: */
sl@0: EXPORT_C TUint CCamera::CCameraHistogram::PrepareHistogramL(THistogramType aType)
sl@0: 	{
sl@0: 	return iImpl->PrepareHistogramL(aType);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::PrepareDirectHistogramL
sl@0: 
sl@0: Request to prepare a direct histogram.
sl@0: 
sl@0: @note A Direct histogram is directly embedded into the viewfinder.
sl@0: 
sl@0: @param	aType		
sl@0: 		The type of histogram to be prepared. This must be one of the supported histogram types returned by
sl@0: 		SupportedHistograms().
sl@0: @param	aPosition
sl@0: 		The position on the screen (in pixels) where the histogram is to be displayed.
sl@0: @param	aSize
sl@0: 		The size of histogram in pixels.
sl@0: @param	aColor
sl@0: 		The colour and alpha blending with which the histogram will be displayed. 
sl@0: 
sl@0: @leave	KErrNotSupported if the histogram type supplied in aType is not supported.
sl@0: 		
sl@0: @return An integer value which is the handle of the histogram on the ECam implementation.
sl@0:  		This value must be passed to other API functions when requesting operations 
sl@0:  		involving this particular histogram.
sl@0: 
sl@0: @see PrepareHistogramL
sl@0: */
sl@0: EXPORT_C TUint CCamera::CCameraHistogram::PrepareDSAHistogramL(THistogramType aType, const TPoint& aPosition, const TSize& aSize, const TRgb& aColor)
sl@0: 	{
sl@0: 	return iImpl->PrepareDSAHistogramL(aType, aPosition, aSize, aColor);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::StartHistogram()
sl@0: 
sl@0: Request to start getting histogram notifications.
sl@0: 
sl@0: @param	aHistHandle	
sl@0: 		The handle identifying the histogram on the ECam implementation.
sl@0: 
sl@0: @leave	KErrArgument if aHistHandle is out of range; also any system wide error.
sl@0: 
sl@0: @see KUidECamEventCameraHistogram
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::StartHistogramL(TUint aHistHandle)
sl@0: 	{
sl@0: 	iImpl->StartHistogramL(aHistHandle);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::StopHistogram()
sl@0: 
sl@0: Request to stop getting histogram notifications.
sl@0: 
sl@0: @param	aHistHandle	
sl@0: 		The handle identifying the histogram on the ECam implementation.
sl@0: 		
sl@0: @leave	KErrArgument if aHistHandle is out of range; also any system wide error.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::StopHistogramL(TUint aHistHandle)
sl@0: 	{
sl@0: 	iImpl->StopHistogramL(aHistHandle);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated only one histogram is available per buffer with the usage of MHistogramV2Buffer and CCameraV2Histogram.
sl@0: 
sl@0: Destroys a histogram on the ECam implementation and releases its handle.
sl@0: 
sl@0: @param	aHistHandle	
sl@0: 		The handle identifying the histogram on the ECam implementation.
sl@0: 
sl@0: @leave	KErrArgument if aHistHandle is out of range; also any system wide error.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::DestroyHistogramL(TUint aHistHandle)
sl@0: 	{
sl@0: 	iImpl->DestroyHistogramL(aHistHandle);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::GetHistogramStateL(TBool& aIsHistogramActive)
sl@0: 
sl@0: Gets a list of all histograms that are active on the ECam implementation. 
sl@0: A histogram is in an active state if StartHistogramL() has been called on it.
sl@0: 
sl@0: @param	aActiveHistograms
sl@0: 		Returned list of histogram handles for which StartHistogramL() has been called. 
sl@0: 
sl@0: @leave	KErrNoMemory if the ECam implementation cannot add more histogram handles due to low memory; also any system wide error.  
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::GetActiveHistogramsL(RArray<TUint>& aActiveHistograms)
sl@0: 	{
sl@0: 	iImpl->GetActiveHistogramsL(aActiveHistograms);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::UpdateDirectHistogramPropertiesL
sl@0: 
sl@0: Updates the properties of a direct histogram.
sl@0: 
sl@0: @param	aHistHandle	
sl@0: 		The handle identifying the histogram on the ECam implementation.
sl@0: @param	aPosition	
sl@0: 		The new position on the screen (in pixels) where the histogram is to be displayed.
sl@0: @param	aSize	
sl@0: 		The new size of histogram in pixels.
sl@0: @param	aColor		
sl@0: 		The new colour and alpha blending with which the histogram will be displayed. 
sl@0: 
sl@0: @leave	KErrArgument if aHistHandle is out of range; also any system wide error.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::UpdateDSAHistogramPropertiesL(TUint aHistHandle, const TPoint& aPosition, const TSize& aSize, const TRgb& aColor)
sl@0: 	{
sl@0: 	iImpl->UpdateDSAHistogramPropertiesL(aHistHandle, aPosition, aSize, aColor);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @deprecated use void CCamera::CCameraV2Histogram::GetDirectHistogramPropertiesL
sl@0: 
sl@0: Gets the properties of a direct histogram.
sl@0: 
sl@0: @param 	aHistHandle		
sl@0: 		The handle on the ECam implementation of the direct histogram whose properties are to be retrieved.
sl@0: @param 	aPosition
sl@0: 		A reference to a TPoint object that will receive the position (in pixels) of the histogram on the screen.
sl@0: @param 	aSize	
sl@0: 		A reference to a TSize object that will receive the size of the histogram in pixels.
sl@0: @param 	aColor
sl@0: 		A reference to a TRgb object that will receive the colour and alpha blending of the histogram.
sl@0: 
sl@0: @leave	KErrArgument if aHistHandle is out of range; also any system wide error.
sl@0: 
sl@0: @note   If the method leaves, the reference arguments are not guaranteed to be valid.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraHistogram::GetDSAHistogramPropertiesL(TUint aHistHandle, TPoint& aPosition, TSize& aSize, TRgb& aColor)
sl@0: 	{
sl@0: 	iImpl->GetDSAHistogramPropertiesL(aHistHandle, aPosition, aSize, aColor);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: /**
sl@0: @deprecated use MCaptureImageObserver, MCaptureVideoObserver, MDirectViewFinderObserver, and MClientViewFinderObserver
sl@0: which have callback functions which notify the client about availability of histogram data. These are sent when 
sl@0: CCameraV2Histogram::StartHistogram() is called after CCameraV2Histogram::PrepareClientHistogramL(). If
sl@0: CCameraV2Histogram::PrepareClientHistogramL() is not called first then the callback returns KErrBadHandle.
sl@0: 	
sl@0: Returns to the client the histogram data for all the histograms generated by the ECam implementation.
sl@0: 
sl@0: @note The client application using this API should provide MCameraObserver2 interface to be 
sl@0: signalled when histogram data is available to be retrieved from the ECAM implementation.
sl@0: 
sl@0: @see 	KUidECamEventCameraHistogram
sl@0: 	
sl@0: @leave	KErrNoMemory if the ECam implementation has not been able to create the histogram buffer;
sl@0: 		also any system wide error.
sl@0: 
sl@0: @return A reference to a histogram buffer which will contain the returned histogram data.
sl@0: */	
sl@0: EXPORT_C MHistogramBuffer& CCamera::CCameraHistogram::HistogramDataL()
sl@0: 	{
sl@0: 	return iImpl->HistogramDataL();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @deprecated use MCaptureImageObserver, MCaptureVideoObserver, MDirectViewFinderObserver, and MClientViewFinderObserver
sl@0: which have callback functions which notify the client about availability of histogram data. These are sent when 
sl@0: CCameraV2Histogram::StartHistogram() is called after CCameraV2Histogram::PrepareClientHistogramL(). If
sl@0: CCameraV2Histogram::PrepareClientHistogramL() is not called first then the callback returns KErrBadHandle.
sl@0: 	
sl@0: Returns the data for a single histogram from the ECam implementation to the client.
sl@0: 
sl@0: @note The client application using this API should provide MCameraObserver2 interface to be 
sl@0: signalled when histogram data is available to be retrieved from the ECAM implementation.
sl@0: 
sl@0: @see 	KUidECamEventCameraHistogram
sl@0: 
sl@0: @param 	aHistHandle		
sl@0: 		The handle on the ECam implementation of the histogram whose data is to be retrieved.
sl@0: 			
sl@0: @leave	KErrNoMemory if the ECam implementation has not been able to create the histogram buffer;
sl@0: 		also any system wide error.
sl@0: 
sl@0: @return A reference to a histogram buffer which will contain the returned histogram data.
sl@0: */
sl@0: EXPORT_C MHistogramBuffer& CCamera::CCameraHistogram::HistogramDataL(TUint aHistHandle)
sl@0: 	{
sl@0: 	return iImpl->HistogramDataL(aHistHandle);
sl@0: 	}
sl@0:  
sl@0: 	
sl@0: //
sl@0: //			    	CCameraV2Histogram                                              //
sl@0: //	
sl@0: /**
sl@0: @internalComponent
sl@0: 
sl@0: Factory function that creates a new camera histogram object specifically for a camera mode, for example, still image,
sl@0: video, snapshot and specific viewfinder.
sl@0: 
sl@0: @param	aCamera
sl@0: 		A reference to the camera object for which a camera histogram object is to be created.
sl@0: 		
sl@0: @param aImplFactory 
sl@0: 	   A reference to the MImplementationFactory derived object.
sl@0: 
sl@0: @leave KErrNoMemory if out of memory; also any system wide error.
sl@0: 
sl@0: @leave KErrExtensionNotSupported When NewL/NewDuplicateL used instead of New2L/NewDuplicate2L.
sl@0: 
sl@0: @return A pointer to a fully constructed camera histogram object.
sl@0: 
sl@0: @note  This method is supposed to be used by internal ECAM components only.
sl@0: */	
sl@0: EXPORT_C CCamera::CCameraV2Histogram* CCamera::CCameraV2Histogram::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::CCameraV2Histogram* self = new (ELeave) CCamera::CCameraV2Histogram(aCamera);
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL(aImplFactory);
sl@0: 	CleanupStack::Pop(self);
sl@0: 	return self; 
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @internalComponent
sl@0: 
sl@0: CCameraV2Histogram second phase constructor 
sl@0: 
sl@0: Function used to initialise internal state of the object specifically for a camera mode, for example, still image,
sl@0: video, snapshot and specific viewfinder.
sl@0: 
sl@0: 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: void CCamera::CCameraV2Histogram::ConstructL(const MImplementationFactory& aImplFactory) 
sl@0: 	{
sl@0: 	TInt err = KErrNone;
sl@0: 	TAny* implPtr = NULL;
sl@0: 	
sl@0: 	err = aImplFactory.GetImpl(implPtr, KECamMCameraV2HistogramUid);
sl@0: 	if (err != KErrNone)
sl@0: 		{
sl@0: 		User::Leave(err);
sl@0: 		}
sl@0: 	iImpl = static_cast<MCameraV2Histogram*>(implPtr);
sl@0: 	
sl@0: 	iImpl->SetHistogramHandle(this);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Constructor for the CCamera::CCameraV2Histogram class.
sl@0: 
sl@0: @param aOwner
sl@0: 	   A reference to the camera object for which a camera histogram object is to be created.
sl@0: */
sl@0: CCamera::CCameraV2Histogram::CCameraV2Histogram(CCamera& aOwner):iOwner(aOwner), iImpl(NULL)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor for the CCamera::CCameraV2Histogram class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraV2Histogram::~CCameraV2Histogram()
sl@0: 	{
sl@0: 	if (iImpl != NULL)
sl@0: 		{
sl@0: 		iImpl->Release(this);	
sl@0: 		}
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Retrieves a list of the supported types of histograms.
sl@0: 
sl@0: @param 	aSupportedHistogramType
sl@0: 		A reference to bit field representing the supported types of histograms as given by CCamera::
sl@0: 		CCameraV2Histogram::THistogramType
sl@0: 
sl@0: @leave  May leave with any error code. 
sl@0: 
sl@0: @see CCamera::CCameraV2Histogram::THistogramType
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::GetSupportedHistogramsL(TUint& aSupportedHistogramType) const
sl@0: 	{
sl@0: 	return iImpl->GetSupportedHistogramsL(aSupportedHistogramType);
sl@0: 	} 
sl@0: 
sl@0: /**
sl@0: Informs whether or not the direct histogram is supported.
sl@0: 
sl@0: @param  aIsDirectHistogramSupported
sl@0: 		ETrue implies that direct histogram is supported.
sl@0: 		EFalse implies that direct histogram is not supported.
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::GetDirectHistogramSupportInfoL(TBool& aIsDirectHistogramSupported) const
sl@0: 	{
sl@0: 	return iImpl->GetDirectHistogramSupportInfoL(aIsDirectHistogramSupported);	
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Request to prepare a client based histogram.
sl@0: 
sl@0: @note 	A direct histogram is directly embedded into the viewfinder.
sl@0: 		If a non direct histogram is requested the histogram data will be passed to the camera client.
sl@0: 
sl@0: @param	aType		
sl@0: 		The type of histogram to be prepared. This must be one of the supported histogram types given by
sl@0: 		GetSupportedHistogramsL.
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: 
sl@0: @note   Each histogram object will either prepare direct histogram or client histogram. Preparing multiple histograms
sl@0: 		per object is an invalid case.
sl@0: 		
sl@0: @see PrepareDSAHistogramL
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::PrepareClientHistogramL(CCamera::CCameraV2Histogram::THistogramType aType) 
sl@0: 	{
sl@0: 	iImpl->PrepareClientHistogramL(aType);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Prepares the direct histogram.
sl@0: 
sl@0: @param  aDirectHistogramParameters
sl@0: 		The parameters required to prepare the direct histogram.
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: 
sl@0: @note   Each histogram object will either prepare direct histogram or client histogram. Preparing multiple histograms
sl@0: 		per object is an invalid case.
sl@0: 
sl@0: @see PrepareClientHistogramL
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::PrepareDirectHistogramL(const CCamera::CCameraV2Histogram::TDirectHistogramParameters& aDirectHistogramParameters)
sl@0: 	{
sl@0: 	iImpl->PrepareDirectHistogramL(aDirectHistogramParameters);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Update the parameters for the direct histogram.
sl@0: 
sl@0: @param  aDirectHistogramParameters
sl@0: 		The desired parameters which have to be used to update the direct histogram.
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::UpdateDirectHistogramPropertiesL(const CCamera::CCameraV2Histogram::TDirectHistogramParameters& aDirectHistogramParameters)
sl@0: 	{
sl@0: 	iImpl->UpdateDirectHistogramPropertiesL(aDirectHistogramParameters);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Retrieves the currently used parameters for the direct histogram.
sl@0: 
sl@0: @param  aDirectHistogramParameters
sl@0: 		Retrieves the parameters currently being used for the direct histogram.
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::GetDirectHistogramPropertiesL(CCamera::CCameraV2Histogram::TDirectHistogramParameters& aDirectHistogramParameters) const
sl@0: 	{
sl@0: 	iImpl->GetDirectHistogramPropertiesL(aDirectHistogramParameters);
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Request to start getting histogram notifications.
sl@0: 
sl@0: @note   Histogram should have been prepared before calling this method.
sl@0: 
sl@0: @note   Histogram notifications are sent to the client by using relevant callbacks for image capture, video capture and 
sl@0: 		viewfinders.
sl@0: 
sl@0: @see    MCaptureImageObserver
sl@0: @see    MCaptureVideoObserver
sl@0: @see    MDirectViewFinderObserver
sl@0: @see    MClientViewFinderObserver
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::StartHistogram()
sl@0:     {
sl@0:     iImpl->StartHistogram();	
sl@0:     }
sl@0: 
sl@0: /**
sl@0: Request to stop generating histogram.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::StopHistogram()
sl@0: 	{
sl@0: 	iImpl->StopHistogram();
sl@0: 	}
sl@0:     
sl@0: /**
sl@0: Informs whether the histogram is currently active or not.  
sl@0: A histogram is in an active state if StartHistogram() has been called on it and has not been yet stopped.
sl@0: 
sl@0: @param	aIsHistogramActive
sl@0: 		ETrue indicates that the histogram is active.
sl@0: 		EFalse indicates that the histogram is inactive. 
sl@0: 
sl@0: @leave  May leave with any error code.
sl@0: */
sl@0: EXPORT_C void CCamera::CCameraV2Histogram::GetHistogramStateL(TBool& aIsHistogramActive) const 
sl@0: 	{
sl@0: 	iImpl->GetHistogramStateL(aIsHistogramActive);
sl@0: 	}
sl@0:     
sl@0: /**
sl@0: Constructor for the TDirectHistogramParameters class.
sl@0: Sets the size and version of this class.
sl@0: */
sl@0: EXPORT_C CCamera::CCameraV2Histogram::TDirectHistogramParameters::TDirectHistogramParameters()
sl@0: 	{
sl@0: 	iSize = sizeof(CCamera::CCameraV2Histogram::TDirectHistogramParameters);
sl@0: 	iVersion = KECamDirectHistogramParametersCurrentVersion;
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 once the old implementation detects this by getting 
sl@0: 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: handled correctly 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 TUint CCamera::CCameraV2Histogram::TDirectHistogramParameters::Size() const
sl@0: 	{
sl@0: 	return 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 the 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::CCameraV2Histogram::TDirectHistogramParameters::Version() const
sl@0: 	{
sl@0: 	return iVersion;
sl@0: 	}