// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

//

// Description:

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef PANORAMA_H

#define PANORAMA_H

#include <icl/imagecodecdata.h>

const TInt KPanoramaDefaultOverlap = 63; //Default overlap value in percent.

const TInt KPanoramaDefaultDirectionTrigger = 10; //Default direction value in percent.

const TInt KPanLensIndex = 2; //Focal length and principal point index value

const TInt KPanLensDist = 5; //Distortion index value

//fwd ref

class CImagePanoramaImpl;

class CVFTrackerImpl;

class CPanoramaTransformImpl;

class CImageFrame;

/**

Defines the direction

*/

enum TDirection

	{

	EPanoramaDirectionUnknown = 0,

	EPanoramaDirectionRight,

	EPanoramaDirectionLeft,

	EPanoramaDirectionUp,

	EPanoramaDirectionDown

	};

/**

This class provides the lens parameters that describe the internal camera characteristics.

*/

class TPanoramaLens

	{

public:

	IMPORT_C TPanoramaLens();

	IMPORT_C TPanoramaLens(TReal32* aFocalLength, TReal32* aPrincipalPoint, TReal32 aSkew, TReal32* aDist, TUint32 aWidth, TUint32 aHeight);

public:

	TReal32 iFocalLength[KPanLensIndex]; //Focal length coordinates

	TReal32 iPrincipalPoint[KPanLensIndex]; //Principal point coordinates

	TReal32 iSkew; //Skew coefficient. @remark 0.0f means no skew

	TReal32 iDist[KPanLensDist];// Distortion coefficients. If there are fewer parameter values available, fill the last values with zeros

	TUint32 iWidth; // Image width when the camera was calibrated

	TUint32 iHeight; // Image height when the camera was calibrated

private:	

	// Future proof

	TAny* iPad1;

	TAny* iPad2;

	TAny* iPad3;

	TAny* iPad4;

	};

/**

This class provides help functions for handling the result of the viewfinder tracking.

It contains getters and setters.

*/

class CPanoramaTransform : public CBase

	{

public:

	IMPORT_C static CPanoramaTransform* NewL();

	IMPORT_C void GetTranslation(TPoint& aDxDy, TSize& aDims) const;

	IMPORT_C void SetTranslationL(const TPoint& aDxDy, const TSize& aDims);

	IMPORT_C void GetDirection(TDirection& aDirection);

	IMPORT_C void GetDirection(TDirection& aDirection, TInt& aMinimumDelta);

	IMPORT_C void SetDirection(TDirection& aDirection);

	IMPORT_C void SetDirection(TDirection& aDirection, TInt aMinDelta);

	IMPORT_C ~CPanoramaTransform();

private:

	CPanoramaTransform();

	void ConstructL();

private:

	CPanoramaTransformImpl* iPanTransImpl;

	};

/**

This class provides functions to register the image that has got from viewfinder

and checks the appropriate time to capture that image.

*/

class CVFTracker : public CBase

	{

public:

	IMPORT_C static CVFTracker* NewL();

	IMPORT_C void RegisterImageL(const CFbsBitmap& aBitmap, CPanoramaTransform& aPanTrans);

	IMPORT_C void RegisterImageL(const CImageFrame& aImageFrame, CPanoramaTransform& aPanTrans);

	IMPORT_C TBool IsTimeToCapture(TDirection& aDirection) const;

	IMPORT_C TBool IsTimeToCapture(TDirection& aDirection, TInt aOverlap) const;

	IMPORT_C void Reset();

	IMPORT_C void InitializeL(const TSize& aSize);		

	IMPORT_C TAny* Extension(TUid aExtension);

	IMPORT_C ~CVFTracker();

private:

	CVFTracker();

	void ConstructL();

private:

	CVFTrackerImpl* iVFTrackImpl;

	};

/**

This class provides functions to get basic stitching. Input can be a file,

descriptor, bitmap, imageframe.

*/

class CImagePanorama : public CBase

	{

public:

	IMPORT_C static CImagePanorama* NewL();

	IMPORT_C void AddFileL(const TDesC& aFilename, CPanoramaTransform& aPanTrans);

	IMPORT_C void AddBufferL(const TDesC8& aData, CPanoramaTransform& aPanTrans);

	IMPORT_C void AddImageL(const CFbsBitmap& aBitmap, CPanoramaTransform& aPanTrans);

	IMPORT_C void AddImageL(const CImageFrame& aImageFrame, CPanoramaTransform& aPanTrans);

	IMPORT_C void CurrentImageSizeL(TSize& aSize);

	IMPORT_C void RenderL(const TDesC& aFilename); 

	IMPORT_C void RenderL(const TDesC& aFilename, const TSize& aSize, const TBool aMaintainAspectRatio, const TUid& aImageTypeUid); 

	IMPORT_C void RenderL(RFile& aFile); 

	IMPORT_C void RenderL(RFile& aFile, const TSize& aSize, const TBool aMaintainAspectRatio, const TUid& aImageTypeUid);

	IMPORT_C void RenderL(HBufC8*& aDestData);

	IMPORT_C void RenderL(HBufC8*& aDestData, TUint32 aMaxBufferSize, const TSize& aSize, const TBool aMaintainAspectRatio, const TUid& aImageTypeUid);

	IMPORT_C void RenderL(const CFbsBitmap& aBitmap);

	IMPORT_C void RenderL(const CFbsBitmap& aBitmap, const TBool aMaintainAspectRatio);

	IMPORT_C void RenderL(const CImageFrame& aImageFrame);

	IMPORT_C void RenderL(const CImageFrame& aImageFrame, const TBool aMaintainAspectRatio);

	IMPORT_C void InitializeL(const TSize & aSize, const TPanoramaLens& aPanoramaLens, const TDirection& aDirection);

	IMPORT_C TAny* Extension(TUid aExtension);

	IMPORT_C ~CImagePanorama();

private:

	CImagePanorama();

	void ConstructL();

private:

	CImagePanoramaImpl* iImgPanImpl;

	};

#endif //PANORAMA_H