SDL Wiki
(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)


Open a game controller for use.


SDL_GameController* SDL_GameControllerOpen(int joystick_index);

Function Parameters

joystick_index the device_index of a device, up to SDL_NumJoysticks()

Return Value

Returns a gamecontroller identifier or NULL if an error occurred; call SDL_GetError() for more information.


joystick_index is the same as the device_index passed to SDL_JoystickOpen().

The index passed as an argument refers to the N'th game controller on the system. This index is not the value which will identify this controller in future controller events. The joystick's instance id (SDL_JoystickID) will be used there instead.


This function is available since SDL 2.0.0.


[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.