|
Size: 1436
Comment: Fix 'related functions'
|
← Revision 9 as of 2016-04-10 22:49:34 ⇥
Size: 1729
Comment: Added Version section.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 17: | Line 17: |
| SDL_GameController *SDL_GameControllerOpen(int joystick_index) | SDL_GameController* SDL_GameControllerOpen(int joystick_index) |
| Line 45: | Line 45: |
| joystick_index is the same as the device_index passed to [[SDL_JoystickOpen]]. | '''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. == Version == This function is available since SDL 2.0.0. |
| Line 49: | Line 55: |
| .[[SDL_GameControllerClose]] .[[SDL_GameControllerNameForIndex]] |
|
| Line 50: | Line 58: |
| .[[SDL_GameControllerNameForIndex]] | |
| Line 54: | Line 61: |
| ##See the Style Guide for instructions on editing the footer. |
DRAFT |
SDL_GameControllerOpen
Use this function to open a gamecontroller for use.
Contents
Syntax
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.
Code Examples
/* Open the first available controller. */
SDL_GameController *controller = NULL;
for (int i = 0; i < SDL_NumJoysticks(); ++i) {
if (SDL_IsGameController(i)) {
controller = SDL_GameControllerOpen(i);
if (controller) {
break;
} else {
fprintf(stderr, "Could not open gamecontroller %i: %s\n", i, SDL_GetError());
}
}
}
Remarks
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.
Version
This function is available since SDL 2.0.0.
