Gainput
v1.0.0
|
A mouse input device. More...
#include <GainputInputDeviceMouse.h>
Public Member Functions | |
InputDeviceMouse (InputManager &manager, DeviceId device, unsigned index, DeviceVariant variant) | |
Initializes the device. More... | |
~InputDeviceMouse () | |
Shuts down the device. | |
DeviceType | GetType () const |
Returns DT_MOUSE. | |
DeviceVariant | GetVariant () const |
Returns the device variant. | |
const char * | GetTypeName () const |
Returns the device type's name. | |
bool | IsValidButtonId (DeviceButtonId deviceButton) const |
Returns if the given button is valid for this device. | |
size_t | GetAnyButtonDown (DeviceButtonSpec *outButtons, size_t maxButtonCount) const |
Checks if any button on this device is down. More... | |
size_t | GetButtonName (DeviceButtonId deviceButton, char *buffer, size_t bufferLength) const |
Gets the name of the given button. More... | |
ButtonType | GetButtonType (DeviceButtonId deviceButton) const |
Returns the type of the given button. | |
DeviceButtonId | GetButtonByName (const char *name) const |
Returns the button's ID if the name is of this device's buttons. More... | |
InputDeviceMouseImpl * | GetPimpl () |
Returns the platform-specific implementation of this device (internal use only). | |
Public Member Functions inherited from gainput::InputDevice | |
InputDevice (InputManager &manager, DeviceId device, unsigned index) | |
Initializes the input device. More... | |
virtual | ~InputDevice () |
Empty virtual destructor. | |
void | Update (InputDeltaState *delta) |
Update this device, internally called by InputManager. More... | |
DeviceId | GetDeviceId () const |
Returns this device's ID. | |
unsigned | GetIndex () const |
Returns the device's index among devices of the same type. | |
virtual bool | IsLateUpdate () const |
Returns if this device should be updated after other devices. | |
DeviceState | GetState () const |
Returns the device state. | |
virtual bool | IsAvailable () const |
Returns if this device is available. | |
bool | GetBool (DeviceButtonId deviceButton) const |
Returns the current state of the given button. | |
bool | GetBoolPrevious (DeviceButtonId deviceButton) const |
Returns the previous state of the given button. | |
float | GetFloat (DeviceButtonId deviceButton) const |
Returns the current state of the given button. | |
float | GetFloatPrevious (DeviceButtonId deviceButton) const |
Returns the previous state of the given button. | |
InputState * | GetInputState () |
Returns the device's state, probably best if only used internally. | |
const InputState * | GetInputState () const |
Returns the device's state, probably best if only used internally. | |
InputState * | GetPreviousInputState () |
Returns the device's previous state, probably best if only used internally. | |
virtual InputState * | GetNextInputState () |
Returns the device's state that is currently being determined, may be 0 if not available. | |
float | GetDeadZone (DeviceButtonId buttonId) const |
Returns the previously set dead zone for the given button or 0.0f if none was set yet. | |
void | SetDeadZone (DeviceButtonId buttonId, float value) |
Sets the dead zone for the given button. | |
void | SetDebugRenderingEnabled (bool enabled) |
Enable/disable debug rendering of this device. | |
bool | IsDebugRenderingEnabled () const |
Returns true if debug rendering is enabled, false otherwise. | |
bool | IsSynced () const |
void | SetSynced (bool synced) |
Sets if this device is being controlled remotely or from a recording. More... | |
Protected Member Functions | |
void | InternalUpdate (InputDeltaState *delta) |
Implementation of the device's Update function. More... | |
DeviceState | InternalGetState () const |
Implementation of the device's GetState function. More... | |
Protected Member Functions inherited from gainput::InputDevice | |
size_t | CheckAllButtonsDown (DeviceButtonSpec *outButtons, size_t maxButtonCount, unsigned start, unsigned end) const |
Checks which buttons are down. More... | |
Additional Inherited Members | |
Public Types inherited from gainput::InputDevice | |
enum | DeviceType { DT_MOUSE, DT_KEYBOARD, DT_PAD, DT_TOUCH, DT_BUILTIN, DT_REMOTE, DT_GESTURE, DT_CUSTOM, DT_COUNT } |
Type of an input device. More... | |
enum | DeviceVariant { DV_STANDARD, DV_RAW, DV_NULL } |
Variant of an input device type. More... | |
enum | DeviceState { DS_OK, DS_LOW_BATTERY, DS_UNAVAILABLE } |
State of an input device. More... | |
Static Public Attributes inherited from gainput::InputDevice | |
static const unsigned | AutoIndex = unsigned(-1) |
Protected Attributes inherited from gainput::InputDevice | |
InputManager & | manager_ |
The manager this device belongs to. | |
DeviceId | deviceId_ |
The ID of this device. | |
unsigned | index_ |
Index of this device among devices of the same type. | |
InputState * | state_ |
The current state of this device. | |
InputState * | previousState_ |
The previous state of this device. | |
float * | deadZones_ |
bool | debugRenderingEnabled_ |
Specifies if this device is currently rendering debug information. | |
bool | synced_ |
A mouse input device.
This input device provides support for standard mouse devices. The valid device buttons are defined in the MouseButton enum.
This device is implemented on Linux and Windows.
The raw variants (InputDevice::DV_RAW) of this device do not offer normalized absolute axis values. That means that the values of MouseAxisX and MouseAxisY don't have defined mininum or maximum values. Therefore only the delta (InputMap::GetFloatDelta()) should be used with raw mouse devices.
gainput::InputDeviceMouse::InputDeviceMouse | ( | InputManager & | manager, |
DeviceId | device, | ||
unsigned | index, | ||
DeviceVariant | variant | ||
) |
Initializes the device.
Instantiate the device using InputManager::CreateDevice().
manager | The input manager this device is managed by. |
device | The ID of this device. |
|
virtual |
Checks if any button on this device is down.
[out] | outButtons | An array with maxButtonCount fields to receive the device buttons that are down. |
maxButtonCount | The number of fields in outButtons. |
Reimplemented from gainput::InputDevice.
|
virtual |
Returns the button's ID if the name is of this device's buttons.
name | Name of the device button to look for. |
Reimplemented from gainput::InputDevice.
|
virtual |
Gets the name of the given button.
deviceButton | ID of the button. |
buffer | A char-buffer to receive the button name. |
bufferLength | Length of the buffer receiving the button name in bytes. |
Reimplemented from gainput::InputDevice.
|
protectedvirtual |
Implementation of the device's GetState function.
Implements gainput::InputDevice.
|
protectedvirtual |
Implementation of the device's Update function.
delta | The delta state to add changes to. May be 0. |
Implements gainput::InputDevice.