Joystick:getGamepadMapping

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Gets the button, axis or hat that a virtual gamepad input is bound to.

Function

Synopsis

inputtype, inputindex, hatdirection = Joystick:getGamepadMapping( axis )

Arguments

GamepadAxis axis
The virtual gamepad axis to get the binding for.

Returns

JoystickInputType inputtype
The type of input the virtual gamepad axis is bound to.
number inputindex
The index of the Joystick's button, axis or hat that the virtual gamepad axis is bound to.
JoystickHat hatdirection (nil)
The direction of the hat, if the virtual gamepad axis is bound to a hat. nil otherwise.

Notes

Returns nil if the Joystick isn't recognized as a gamepad or the virtual gamepad axis is not bound to a Joystick input.

Function

Synopsis

inputtype, inputindex, hatdirection = Joystick:getGamepadMapping( button )

Arguments

GamepadButton button
The virtual gamepad button to get the binding for.

Returns

JoystickInputType inputtype
The type of input the virtual gamepad button is bound to.
number inputindex
The index of the Joystick's button, axis or hat that the virtual gamepad button is bound to.
JoystickHat hatdirection (nil)
The direction of the hat, if the virtual gamepad button is bound to a hat. nil otherwise.

Notes

Returns nil if the Joystick isn't recognized as a gamepad or the virtual gamepad button is not bound to a Joystick input.

Notes

The physical locations for the virtual gamepad axes and buttons correspond as closely as possible to the layout of a standard Xbox 360 controller.

360 controller.png

See Also

© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/Joystick:getGamepadMapping