Wiki Page Content

Differences between revisions 5 and 6
Revision 5 as of 2013-10-13 11:43:42
Size: 1897
Comment: Fixed syntax errors in C++ example and changed it to C.
Revision 6 as of 2015-12-04 23:08:58
Size: 1664
Comment: Added remark.
Deletions are marked like this. Additions are marked like this.
Line 49: Line 49:
''You can add useful comments here''

##Leave this section as-is unless you have a remark to put in. In that case, replace ''You can add useful comments here'' with your remark(s) following the Style Guide instructions. Leave the rest of the markup alone and delete this comment.
The returned string must be freed with SDL_free().

DRAFT

SDL_GameControllerMapping

Use this function to get the current mapping of a Game Controller.

Syntax

char* SDL_GameControllerMapping(SDL_GameController* gamecontroller)

Function Parameters

gamecontroller

the game controller you want to get the current mapping for

Return Value

Returns a string that has the controller's mapping. More information about the mapping can be found on SDL_GameControllerAddMapping; call SDL_GetError() for more information.

Code Examples

#include <stdio.h> /* for printf() */

/* ... */

SDL_GameController *ctrl;
int i;

for (i = 0; i < SDL_NumJoysticks(); ++i) {
    if (SDL_IsGameController(i)) {
        printf("Index \'%i\' is a compatible controller, named \'%s\'\n", i, SDL_GameControllerNameForIndex(i));
        ctrl = SDL_GameControllerOpen(i);
        printf("Controller %i is mapped as \"%s\".\n", i, SDL_GameControllerMapping(ctrl));
    } else {
        printf("Index \'%i\' is not a compatible controller.", i);
    }
}

Remarks

The returned string must be freed with SDL_free().


CategoryAPI, CategoryGameController

None: SDL_GameControllerMapping (last edited 2016-04-10 22:39:25 by PhilippWiesemann)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit