feat(desktop): Initial translation

Author: Berstanio

gdx-controllers-desktop/build.gradle

@@ -49,13 +49,11 @@ tasks.getByName('processResources') {
 dependencies {
 	api project(":gdx-controllers-core")
 	implementation "com.badlogicgames.gdx:gdx:$gdxVersion"
-	api("com.badlogicgames.jamepad:jamepad:$jamepadVersion") {
-		exclude group: 'com.badlogicgames.gdx', module: 'gdx-jnigen-loader'
-	}
+	implementation "org.lwjgl:lwjgl-sdl:3.4.0-SNAPSHOT"
 }
 
-targetCompatibility = 1.7
-sourceCompatibility = 1.7
+targetCompatibility = 1.8
+sourceCompatibility = 1.8
 
 
 ext {

gdx-controllers-desktop/src/main/java/com/badlogic/gdx/controllers/desktop/Configuration.java

@@ -0,0 +1,33 @@
+package com.badlogic.gdx.controllers.desktop;
+
+import com.badlogic.gdx.controllers.ControllerManager;
+
+/**
+ * Class defining the configuration of a {@link ControllerManager}.
+ *
+ * @author Benjamin Schulte
+ */
+public class Configuration {
+    /**
+     * The max number of controllers the ControllerManager should deal with
+     */
+    public int maxNumControllers = 4;
+
+    /**
+     * Use RawInput implementation instead of XInput on Windows, if applicable. Enable this if you
+     * need to use more than four XInput controllers at once. Comes with drawbacks.
+     */
+    public boolean useRawInput = false;
+
+    /**
+     * Disable this to skip loading of the native library. Can be useful if an application wants
+     * to use a loader other than {@link com.badlogic.gdx.utils.SharedLibraryLoader}.
+     */
+    public boolean loadNativeLibrary = true;
+
+    /**
+     * Disable this to return to legacy temporary file loading of database file.
+     */
+    public boolean loadDatabaseInMemory = true;
+}
+

gdx-controllers-desktop/src/main/java/com/badlogic/gdx/controllers/desktop/JamepadControllerManager.java

@@ -7,17 +7,18 @@
 import com.badlogic.gdx.controllers.desktop.support.CompositeControllerListener;
 import com.badlogic.gdx.controllers.desktop.support.JamepadControllerMonitor;
 import com.badlogic.gdx.controllers.desktop.support.JamepadShutdownHook;
+import com.badlogic.gdx.controllers.desktop.support.SDLControllerManager;
 import com.badlogic.gdx.utils.Array;
 import com.badlogic.gdx.utils.Disposable;
 
 import java.io.IOException;
 
 public class JamepadControllerManager extends AbstractControllerManager implements Disposable {
     // assign a Jamepad configuration to this field at game startup to override defaults
-    public static com.studiohartman.jamepad.Configuration jamepadConfiguration;
+    public static Configuration jamepadConfiguration;
 
     private static boolean nativeLibInitialized = false;
-    private static com.studiohartman.jamepad.ControllerManager controllerManager;
+    private static SDLControllerManager controllerManager;
 
     private final CompositeControllerListener compositeListener = new CompositeControllerListener();
 
@@ -26,10 +27,10 @@ public JamepadControllerManager() {
 
         if (!nativeLibInitialized) {
             if (jamepadConfiguration == null) {
-                jamepadConfiguration = new com.studiohartman.jamepad.Configuration();
+                jamepadConfiguration = new Configuration();
             }
 
-            controllerManager = new com.studiohartman.jamepad.ControllerManager(jamepadConfiguration);
+            controllerManager = new SDLControllerManager(jamepadConfiguration);
             controllerManager.initSDLGamepad();
 
             JamepadControllerMonitor monitor = new JamepadControllerMonitor(controllerManager, compositeListener);
@@ -70,7 +71,7 @@ public void dispose() {
     }
 
     /**
-     * @see com.studiohartman.jamepad.ControllerManager#addMappingsFromFile(String)
+     * @see SDLControllerManager#addMappingsFromFile(String)
      */
     public static void addMappingsFromFile(String path) throws IOException, IllegalStateException {
         controllerManager.addMappingsFromFile(path);

gdx-controllers-desktop/src/main/java/com/badlogic/gdx/controllers/desktop/support/ControllerAxis.java

@@ -0,0 +1,46 @@
+package com.badlogic.gdx.controllers.desktop.support;
+
+import org.lwjgl.sdl.SDLGamepad;
+
+/**
+ * The list of axes available on a gamepad
+ *
+ * Thumbstick axis values range from SDL_JOYSTICK_AXIS_MIN to
+ * SDL_JOYSTICK_AXIS_MAX, and are centered within ~8000 of zero, though
+ * advanced UI will allow users to set or autodetect the dead zone, which
+ * varies between gamepads.
+ *
+ * Trigger axis values range from 0 (released) to SDL_JOYSTICK_AXIS_MAX (fully
+ * pressed) when reported by SDL_GetGamepadAxis(). Note that this is not the
+ * same range that will be reported by the lower-level SDL_GetJoystickAxis().
+ */
+public enum ControllerAxis {
+    INVALID(SDLGamepad.SDL_GAMEPAD_AXIS_INVALID),
+    LEFTX(SDLGamepad.SDL_GAMEPAD_AXIS_LEFTX),
+    LEFTY(SDLGamepad.SDL_GAMEPAD_AXIS_LEFTY),
+    RIGHTX(SDLGamepad.SDL_GAMEPAD_AXIS_RIGHTX),
+    RIGHTY(SDLGamepad.SDL_GAMEPAD_AXIS_RIGHTY),
+    LEFT_TRIGGER(SDLGamepad.SDL_GAMEPAD_AXIS_LEFT_TRIGGER),
+    RIGHT_TRIGGER(SDLGamepad.SDL_GAMEPAD_AXIS_RIGHT_TRIGGER),;
+
+    public static final ControllerAxis[] VALUES = values();
+
+    private final int id;
+
+    ControllerAxis(int id) {
+        this.id = id;
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public static ControllerAxis getById(int id) {
+        for (ControllerAxis axis : VALUES) {
+            if (axis.id == id)
+                return axis;
+        }
+
+        return null;
+    }
+}

gdx-controllers-desktop/src/main/java/com/badlogic/gdx/controllers/desktop/support/ControllerButton.java

@@ -0,0 +1,77 @@
+package com.badlogic.gdx.controllers.desktop.support;
+
+import org.lwjgl.sdl.SDLGamepad;
+
+/**
+ * The list of buttons available on a gamepad
+ *
+ * For controllers that use a diamond pattern for the face buttons, the
+ * south/east/west/north buttons below correspond to the locations in the
+ * diamond pattern. For Xbox controllers, this would be A/B/X/Y, for Nintendo
+ * Switch controllers, this would be B/A/Y/X, for GameCube controllers this
+ * would be A/X/B/Y, for PlayStation controllers this would be
+ * Cross/Circle/Square/Triangle.
+ *
+ * For controllers that don't use a diamond pattern for the face buttons, the
+ * south/east/west/north buttons indicate the buttons labeled A, B, C, D, or
+ * 1, 2, 3, 4, or for controllers that aren't labeled, they are the primary,
+ * secondary, etc. buttons.
+ *
+ * The activate action is often the south button and the cancel action is
+ * often the east button, but in some regions this is reversed, so your game
+ * should allow remapping actions based on user preferences.
+ *
+ * You can query the labels for the face buttons using
+ * SDL_GetGamepadButtonLabel()
+ * */
+public enum ControllerButton {
+
+    INVALID(SDLGamepad.SDL_GAMEPAD_BUTTON_INVALID),
+    SOUTH(SDLGamepad.SDL_GAMEPAD_BUTTON_SOUTH),                    /** Bottom face button (e.g. Xbox A button) */
+    EAST(SDLGamepad.SDL_GAMEPAD_BUTTON_EAST),                      /** Right face button (e.g. Xbox B button) */
+    WEST(SDLGamepad.SDL_GAMEPAD_BUTTON_WEST),                      /** Left face button (e.g. Xbox X button) */
+    NORTH(SDLGamepad.SDL_GAMEPAD_BUTTON_NORTH),                    /** Top face button (e.g. Xbox Y button) */
+    BACK(SDLGamepad.SDL_GAMEPAD_BUTTON_BACK),
+    GUIDE(SDLGamepad.SDL_GAMEPAD_BUTTON_GUIDE),
+    START(SDLGamepad.SDL_GAMEPAD_BUTTON_START),
+    LEFT_STICK(SDLGamepad.SDL_GAMEPAD_BUTTON_LEFT_STICK),
+    RIGHT_STICK(SDLGamepad.SDL_GAMEPAD_BUTTON_RIGHT_STICK),
+    LEFT_SHOULDER(SDLGamepad.SDL_GAMEPAD_BUTTON_LEFT_SHOULDER),
+    RIGHT_SHOULDER(SDLGamepad.SDL_GAMEPAD_BUTTON_RIGHT_SHOULDER),
+    DPAD_UP(SDLGamepad.SDL_GAMEPAD_BUTTON_DPAD_UP),
+    DPAD_DOWN(SDLGamepad.SDL_GAMEPAD_BUTTON_DPAD_DOWN),
+    DPAD_LEFT(SDLGamepad.SDL_GAMEPAD_BUTTON_DPAD_LEFT),
+    DPAD_RIGHT(SDLGamepad.SDL_GAMEPAD_BUTTON_DPAD_RIGHT),
+    MISC1(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC1),                    /** Additional button (e.g. Xbox Series X share button, PS5 microphone button, Nintendo Switch Pro capture button, Amazon Luna microphone button, Google Stadia capture button) */
+    RIGHT_PADDLE1(SDLGamepad.SDL_GAMEPAD_BUTTON_RIGHT_PADDLE1),    /** Upper or primary paddle, under your right hand (e.g. Xbox Elite paddle P1) */
+    LEFT_PADDLE1(SDLGamepad.SDL_GAMEPAD_BUTTON_LEFT_PADDLE1),      /** Upper or primary paddle, under your left hand (e.g. Xbox Elite paddle P3) */
+    RIGHT_PADDLE2(SDLGamepad.SDL_GAMEPAD_BUTTON_RIGHT_PADDLE2),    /** Lower or secondary paddle, under your right hand (e.g. Xbox Elite paddle P2) */
+    LEFT_PADDLE2(SDLGamepad.SDL_GAMEPAD_BUTTON_LEFT_PADDLE2),      /** Lower or secondary paddle, under your left hand (e.g. Xbox Elite paddle P4) */
+    TOUCHPAD(SDLGamepad.SDL_GAMEPAD_BUTTON_TOUCHPAD),              /** PS4/PS5 touchpad button */
+    MISC2(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC2),                    /** Additional button */
+    MISC3(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC3),                    /** Additional button */
+    MISC4(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC4),                    /** Additional button */
+    MISC5(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC5),                    /** Additional button */
+    MISC6(SDLGamepad.SDL_GAMEPAD_BUTTON_MISC6),;                   /** Additional button */
+
+    public static final ControllerButton[] VALUES = values();
+
+    private final int id;
+
+    ControllerButton(int id) {
+        this.id = id;
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public static ControllerButton getById(int id) {
+        for (ControllerButton button : VALUES) {
+            if (button.id == id)
+                return button;
+        }
+
+        return null;
+    }
+}

gdx-controllers-desktop/src/main/java/com/badlogic/gdx/controllers/desktop/support/ControllerButtonLabel.java

@@ -0,0 +1,45 @@
+package com.badlogic.gdx.controllers.desktop.support;
+
+import org.lwjgl.sdl.SDLGamepad;
+
+/**
+ * The set of gamepad button labels
+ *
+ * This isn't a complete set, just the face buttons to make it easy to show
+ * button prompts.
+ *
+ * For a complete set, you should look at the button and gamepad type and have
+ * a set of symbols that work well with your art style.
+ */
+public enum ControllerButtonLabel {
+    UNKNOWN(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_UNKNOWN),
+    A(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_A),
+    B(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_B),
+    X(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_X),
+    Y(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_Y),
+    CROSS(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_CROSS),
+    CIRCLE(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_CIRCLE),
+    SQUARE(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_SQUARE),
+    TRIANGLE(SDLGamepad.SDL_GAMEPAD_BUTTON_LABEL_TRIANGLE),;
+
+    public static final ControllerButtonLabel[] VALUES = values();
+
+    private final int id;
+
+    ControllerButtonLabel(int id) {
+        this.id = id;
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public static ControllerButtonLabel getById(int id) {
+        for (ControllerButtonLabel label : VALUES) {
+            if (label.id == id)
+                return label;
+        }
+
+        return null;
+    }
+}