/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - Initial contribution
*
* Contributors:
* Ixonos Plc
*
* Description:  
*
*/


//----IMAAMI----
//*************************************************************************
//CDCIETD.h
//
//Version 2.00
//
//Contains:
//	CDCIETD 
//		Display specific color contrast enhancement, 
//		Image Enhancement for Transflective Displays version 2,
//		IETD 2.
//
// The class implements the following image enhancements algorithms:
//	    - Histogram guided contrast stretch
//	    - Color saturation increase
//
// Usage:
//  	- First an instance of this class is created by factory functions NewL() or NewLC.
//		- All settings and configurations can be done by calling function SetParams().
//		  Current parameters can be checked by calling function GetParams().
//		- Then the The Analyze() function is called with CFbsBitmap as an argumet.
//		  This function have to be called at least once before ProcessL().  
//		- Then the The ProcessL() function is called with CFbsBitmap as an argumet.
//		  The bitmap is handled in place so this function modifies the given bitmap.
//
//History:
//	23.10.2003 version 2.00 created using existing IMAAMI IETD	
//*************************************************************************

#ifndef  __DCIetd_H__
#define  __DCIetd_H__

//  INCLUDES

#ifndef   __E32STD_H__
#include  <e32std.h>   // for Fundamental Types
#endif // __E32STD_H__

#ifndef   __E32BASE_H__
#include  <e32base.h>  // for CBase
#endif // __E32BASE_H__

//Default parameters
#include "DCInit.h"


//-------------------
//  CLASS DEFINITIONS 
// CDCIetd - The one and ony class to contain all required methods
// to implement DCIetd functionality.
class CDCIetd : public CBase
    {
    public:     

		//Parameter struct
		struct DCIetdParameters
		{
			TUint8 aWhitePixels; 	//Percentage of pixels stretched to maximum value
			TUint8 aBlackPixels;	//Percentage of pixels stretched to minimum value
			TUint8 aStretchLimit;	//Narrowest histogram to be stretched to full range
			TUint8 aSaturationGain;	//Saturation increase gain
			TUint8 aBitLimit;		//Minimum number of color values for full gain		
			TUint8 aWBC;			//White balance correction limit
			TUint8 aDBC;			//Dark balance correction limit
		};

        CDCIetd();				// Constructor
        static CDCIetd* NewL();	// Factory function NewL
        static CDCIetd* NewLC();// Factory function NewLC
        ~CDCIetd();				// Destructor
        void ConstructL();		// Second Phase contructor (may leave)
        
		// Analyze image referenced by aBPtr
		void Analyze(CFbsBitmap& aBPtr);

		// Process and store image referenced by aBPtr
		void ProcessL(CFbsBitmap& aBPtr);

		// Parameter exchange
		void SetParams(DCIetdParameters* parameters);
		void GetParams(DCIetdParameters* parameters);
        
    private:

		void GatherHistograms(const CFbsBitmap& aBPtr); // Construct the R, G, and B Histograms
        void MakeMappings();                            // Calculate the mapping LUTs

        // Limit integer value to byte [0,255]
        static inline TUint8 Limit255(TInt i) {return (TUint8)(i<0?0:(i>255?255:i));}

        TUint    iHistogram[3][256];  // Histogram data
        TUint8   iMap[3][256];        // Color component mapping funtions
        HBufC8*  iScanLineBuffer;     // Scan line buffer

        TUint8 iReducedStretchLimit[3]; //Stretch limits for each component

		DCIetdParameters iParameters; //Parameters
    };

#endif // __DCIetd_H__
            
// End of File
//----IMAAMI----