###### (This is the legacy documentation for stable SDL2, the current stable version; [SDL3](https://wiki.libsdl.org/SDL3/) is the current development version.) # SDL_GameControllerGetAxis Get the current state of an axis control on a game controller. ## Syntax ```c extern DECLSPEC Sint16 SDLCALL SDL_GameControllerGetAxis(SDL_GameController *gamecontroller, SDL_GameControllerAxis axis); ``` ## Function Parameters | | | | ---------------------- | ---------------------------------------------------------------------------------- | | **gamecontroller** | a game controller | | **axis** | an axis index (one of the [SDL_GameControllerAxis](SDL_GameControllerAxis) values) | ## Return Value Returns axis state (including 0) on success or 0 (also) on failure; call [SDL_GetError](SDL_GetError)() for more information. ## Remarks The axis indices start at index 0. The state is a value ranging from -32768 to 32767. Triggers, however, range from 0 to 32767 (they never return a negative value). ## Version This function is available since SDL 2.0.0. ## Related Functions * [SDL_GameControllerGetButton](SDL_GameControllerGetButton) ---- [CategoryAPI](CategoryAPI)