4e42229bdd
git-subtree-dir: external/gainput git-subtree-split: 2be0a50089eafcc6fccb66142180082e48f27f4c
88 lines
3.4 KiB
C++
88 lines
3.4 KiB
C++
|
|
#ifndef GAINPUTROTATEGESTURE_H_
|
|
#define GAINPUTROTATEGESTURE_H_
|
|
|
|
#ifdef GAINPUT_ENABLE_ROTATE_GESTURE
|
|
|
|
namespace gainput
|
|
{
|
|
|
|
/// Buttons provided by the RotateGesture.
|
|
enum RotateAction
|
|
{
|
|
RotateTriggered, ///< The button that triggers when both rotate buttons are down.
|
|
RotateAngle ///< The current rotation angle in radians if rotation is triggered (::RotateTriggered).
|
|
};
|
|
|
|
/// A multi-touch rotate gesture.
|
|
/**
|
|
* This gesture, mainly meant for multi-touch devices, triggers (::RotateTriggered is down) when both specified
|
|
* source buttons are down. It then determines the angle between the two specified 2D touch points and reports any
|
|
* change in angle using ::RotateAngle. The initial angle between the two points is defined as no rotation.
|
|
*
|
|
* After instantiating the gesture like any other input device, call Initialize() to properly
|
|
* set it up.
|
|
*
|
|
* In order for this gesture to be available, Gainput must be built with \c GAINPUT_ENABLE_ALL_GESTURES or
|
|
* \c GAINPUT_ENABLE_ROTATE_GESTURE defined.
|
|
*
|
|
* \sa Initialize
|
|
* \sa InputManager::CreateDevice
|
|
*/
|
|
class GAINPUT_LIBEXPORT RotateGesture : public InputGesture
|
|
{
|
|
public:
|
|
/// Initializes the gesture.
|
|
RotateGesture(InputManager& manager, DeviceId device, unsigned index, DeviceVariant variant);
|
|
/// Uninitializes the gesture.
|
|
~RotateGesture();
|
|
|
|
/// Sets up the gesture for operation with the given axes and buttons.
|
|
/**
|
|
* \param downDevice ID of the input device containing the first touch button.
|
|
* \param downButton ID of the device button to be used as the first touch button.
|
|
* \param xAxisDevice ID of the input device containing the X coordinate of the first touch point.
|
|
* \param xAxis ID of the device button/axis to be used for the X coordinate of the first touch point.
|
|
* \param yAxisDevice ID of the input device containing the Y coordinate of the first touch point.
|
|
* \param yAxis ID of the device button/axis to be used for the Y coordinate of the first touch point.
|
|
* \param down2Device ID of the input device containing the second touch button.
|
|
* \param downButton2 ID of the device button to be used as the second touch button.
|
|
* \param xAxis2Device ID of the input device containing the X coordinate of the second touch point.
|
|
* \param xAxis2 ID of the device button/axis to be used for the X coordinate of the second touch point.
|
|
* \param yAxis2Device ID of the input device containing the Y coordinate of the second touch point.
|
|
* \param yAxis2 ID of the device button/axis to be used for the Y coordinate of the second touch point.
|
|
*/
|
|
void Initialize(DeviceId downDevice, DeviceButtonId downButton,
|
|
DeviceId xAxisDevice, DeviceButtonId xAxis,
|
|
DeviceId yAxisDevice, DeviceButtonId yAxis,
|
|
DeviceId down2Device, DeviceButtonId downButton2,
|
|
DeviceId xAxis2Device, DeviceButtonId xAxis2,
|
|
DeviceId yAxis2Device, DeviceButtonId yAxis2);
|
|
|
|
bool IsValidButtonId(DeviceButtonId deviceButton) const { return deviceButton == RotateTriggered || deviceButton == RotateAngle; }
|
|
|
|
ButtonType GetButtonType(DeviceButtonId deviceButton) const { GAINPUT_ASSERT(IsValidButtonId(deviceButton)); return deviceButton == RotateTriggered ? BT_BOOL : BT_FLOAT; }
|
|
|
|
protected:
|
|
void InternalUpdate(InputDeltaState* delta);
|
|
|
|
private:
|
|
DeviceButtonSpec downButton_;
|
|
DeviceButtonSpec xAxis_;
|
|
DeviceButtonSpec yAxis_;
|
|
DeviceButtonSpec downButton2_;
|
|
DeviceButtonSpec xAxis2_;
|
|
DeviceButtonSpec yAxis2_;
|
|
|
|
bool rotating_;
|
|
float initialAngle_;
|
|
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|