Add Hori Pokken Tournament DX Pro Pad gamepad

.github/workflows/check.yml

@@ -0,0 +1,11 @@
+name: Data check
+on:
+  push:
+    branches: [master]
+jobs:
+  duplicates:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - run: |
+        python duplicates.py

LICENSE

@@ -1,6 +1,4 @@
-
-Simple DirectMedia Layer
-Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
+Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages

README.md

@@ -1,24 +1,51 @@
-##SDL_GameControllerDB
+# SDL_GameControllerDB
 
+A community sourced database of game controller mappings to be used with SDL2 and SDL3 Game Controller functionality.
 
-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 it.
 
-####Usage:
+SDL2:
+```c
+SDL_GameControllerAddMappingsFromFile("gamecontrollerdb.txt");
+```
+
+SDL3:
+```c
+SDL_AddGamepadMappingsFromFile("gamecontrollerdb.txt");
+```
 
-Download gamecontrollerdb.txt, place it in your app's directory and load with:
+The database is compatible with SDL v2.0.10 and newer.
 
+## Create New Mappings
+A mapping looks like this:
 ```
-SDL_GameControllerAddMappingsFromFile("gamecontrollerdb.txt");
+030000004c050000c405000000010000,PS4 Controller,a:b1,b:b2,back:b8,dpdown:h0.4,dpleft:h0.8,dpright:h0.2,dpup:h0.1,guide:b12,leftshoulder:b4,leftstick:b10,lefttrigger:a3,leftx:a0,lefty:a1,rightshoulder:b5,rightstick:b11,righttrigger:a4,rightx:a2,righty:a5,start:b9,x:b0,y:b3,platform:Mac OS X,
 ```
+It includes controller GUID (`030000004c050000c405000000010000`), a name (`PS4 Controller`), button / axis mappings (`leftshoulder:b4`) and a platform (`platform:Mac OS X`).
+
+Please make sure to check that the name is a good description of the controller. If relevant, include the controller's name and model number.
+
+## Mapping Guide
 
-####Creating new mappings:
+![SDL Game Controller Mapping Guide](mapping_guide.png)
 
-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.
+## Mapping Tools
+There are a few different tools that let you create mappings.
+
+### [SDL2 Gamepad Tool](http://www.generalarcade.com/gamepadtool/)
+Third party cross-platform tool with GUI (Windows, macOS and Linux)
+
+*While convenient, this tool has fallen out of date as SDL has amended and added new features for gamepad support (see [#478](https://github.com/gabomdq/SDL_GameControllerDB/issues/476)). Maps authored with this tool require maintainer scrutiny to ensure they will not break support for explicit mappings the SDL project provides.*
+
+### [SDL](https://github.com/libsdl-org/SDL/releases/latest)
+[testcontroller (SDL3)](https://github.com/libsdl-org/SDL/blob/main/test/testcontroller.c) and [controllermap (SDL2)](https://github.com/libsdl-org/SDL/blob/SDL2/test/controllermap.c) utilities are the official tools to create these mappings on all SDL supported platforms (Windows, Mac, Linux, iOS, Android, etc).
+
+```
+"SDL_GamepadBind"		"030000004c050000c405000000010000,PS4 Controller,platform:Windows,a:b1,b:b2,back:b8,dpdown:h0.4,dpleft:h0.8,dpright:h0.2,dpup:h0.1,guide:b12,leftshoulder:b4,leftstick:b10,lefttrigger:a3,leftx:a0,lefty:a1,rightshoulder:b5,rightstick:b11,righttrigger:a4,rightx:a2,righty:a5,start:b9,x:b0,y:b3,"
+```
 
-####References:
+## Resources
 
-* [SDL2](http://www.libsdl.org)
-* [SDL_GameControllerAddMappingsFromFile](http://wiki.libsdl.org/SDL_GameControllerAddMappingsFromFile)
+* [SDL](http://www.libsdl.org)
+* [SDL_GameControllerAddMappingsFromFile](http://wiki.libsdl.org/SDL_GameControllerAddMappingsFromFile)

duplicates.py

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: Zlib
+
+import difflib
+import sys
+
+CROSS_PLATFORM=False
+
+cdict = {}
+for i, l in enumerate(open("gamecontrollerdb.txt")):
+    l = l.strip()
+    if l.startswith("#") or not l:
+        continue
+
+    c = l.split(",")
+    key = tuple([c[0]]+[ce for ce in c[1:] if "platform:" in ce])
+    if CROSS_PLATFORM:
+        key = c[0]
+
+    if key in cdict:
+        print("Duplicate:", c[1], "at line", i + 1)
+        out = list(difflib.unified_diff(cdict[key], sorted(c), n=0))[3:]
+        out = [o for o in out if not o.startswith("@@")]
+        print("\t", " ".join(out))
+        if not CROSS_PLATFORM:
+            sys.exit(1)
+    cdict[key] = sorted(c)