/*

* Copyright (c) 2010 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: 

*

*/

#ifndef QSTMZOOMGESTURERECOGNISER_H_

#define QSTMZOOMGESTURERECOGNISER_H_

#include <qstmgestureengine_if.h>

#include <qstmgesture_if.h>

#include <qstmgesturelistener_if.h>

namespace qstmGesture

{

/*!

 * QStm_ZoomGestureRecogniser handles zoomin gesture: start from near lower left / upper right corner and drag

 * This is useful if one wants to implement single handed zooming so can be done using thumb

 * (no need to use pinch i.e. hold device in one hand and use two fingers of the other)

 * Current spec is:

 * - touch lower left corner and start dragging => initialize ZOOM IN

 * - touch upper right corner and start dragging => initialize ZOOM OUT

 * store the touch point and then calculate the distance until release

 * The distance is the zoom factor (probably needs some adjustment, not just the pixels...)

 */

class QStm_ZoomGestureRecogniser : public QStm_GestureRecogniser

{

public:

	static const QStm_GestureUid KUid = EGestureUidCornerZoom;

	virtual ~QStm_ZoomGestureRecogniser();

	virtual QStm_GestureRecognitionState recognise(int numOfActiveStreams, QStm_GestureEngineIf* ge) ;

	virtual void release(QStm_GestureEngineIf* ge) ;

	virtual QStm_GestureUid gestureUid() const { return KUid; }

	/*!

	 * Additional methods to set up zoom in gesture recogniser:

	 * define the rectangle where the lower left corner is

	 * \param theArea

	 */

	void setArea(const QRect& theArea) ;

	/*!

	 * Additional methods to set up zoom in gesture recogniser:

	 * Define how close to the lower left corner the touch must happen

	 * \param rangeInPixels

	 */

	void setRange(int rangeInMm) ;

	QStm_ZoomGestureRecogniser(QStm_GestureListenerIf* listener) ;

	float calculateDistance(const QPoint& aTp) ;

	int adjustZoom(float& previousDistance, float newDistance) ;

private:

	QRect         m_area ;

	int           m_rangesizeInPixels ;

	QStm_ZoomType m_zoomtype ;

	bool          m_zooming ;

	QPoint        m_startingtouch ;

	QPoint        m_previoustouch ;

	int           m_delta ;

};

} // namespace

#endif /* QSTMZOOMGESTURERECOGNISER_H_ */