Skip to content

Commit

Permalink
SDL2: Add game controller mapping database file.
Browse files Browse the repository at this point in the history
  • Loading branch information
rjehangir committed Oct 1, 2016
1 parent bf90d41 commit 50a0e51
Show file tree
Hide file tree
Showing 4 changed files with 206 additions and 0 deletions.
20 changes: 20 additions & 0 deletions resources/SDL_GameControllerDB/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@

Simple DirectMedia Layer
Copyright (C) 1997-2013 Sam Lantinga <[email protected]>

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

32 changes: 32 additions & 0 deletions resources/SDL_GameControllerDB/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
##SDL_GameControllerDB

[![Build Status](https://travis-ci.org/gabomdq/SDL_GameControllerDB.svg?branch=master)](https://travis-ci.org/gabomdq/SDL_GameControllerDB)

A community source database of game controller mappings to be used with SDL2 Game Controller functionality.

####Usage:

Download gamecontrollerdb.txt, place it in your app's directory and load with:

```
SDL_GameControllerAddMappingsFromFile("gamecontrollerdb.txt");
```

####Creating new mappings:

To create new mappings, you can use the controllermap utility provided with
SDL2, or using Steam's Big Picture mode, configure your joystick and then
look in config/config.vdf in your Steam installation directory for the
SDL_GamepadBind entry.

####Checking your mappings:
You need to have python3 installed. Run

```
python3 check.py gamecontrollerdb.txt
```

####References:

* [SDL2](http://www.libsdl.org)
* [SDL_GameControllerAddMappingsFromFile](http://wiki.libsdl.org/SDL_GameControllerAddMappingsFromFile)
Loading

0 comments on commit 50a0e51

Please sign in to comment.