Joystick:getGamepadAxis

Available since LÖVE 0.9.0

This function is not supported in earlier versions.

Gets the direction of a virtual gamepad axis. If the Joystick isn't recognized as a gamepad or isn't connected, this function will always return 0.

Function

Synopsis

direction = Joystick:getGamepadAxis( axis )

Arguments

GamepadAxis axis

The virtual axis to be checked.

Returns

number direction

Current value of the axis.

Examples

Move x and y values based on a gamepad thumbstick

function love.load()
    x = 0
    y = 0
    p1joystick = nil
end

function love.joystickadded(joystick)
    p1joystick = joystick
end

function love.update(dt)
    -- Check if joystick connected
    if p1joystick ~= nil then
        -- getGamepadAxis returns a value between -1 and 1.
        -- It returns 0 when it is at rest

        x = x + p1joystick:getGamepadAxis("leftx")
        y = y + p1joystick:getGamepadAxis("lefty")
    end
end

See Also

• Joystick
• Joystick:isGamepad
• Joystick:isGamepadDown
• Joystick:isConnected

• GamepadAxis
• love.gamepadaxis

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info