New: Option in setting to adjust gamepad sensitivity

Author: ollm

CHANGELOG.md

@@ -16,10 +16,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Support for `HEIC` image format [`4f4b5a1`](https://github.com/ollm/OpenComic/commit/4f4b5a16572ea2bd5aff2e519d473b42d80312fb)
 - Option to apply configuration profile based on folder/file label [`71d9ff5`](https://github.com/ollm/OpenComic/commit/71d9ff5655f934e4d710e1833b081e4fddf8d428)
 - Option to disable `Align with next horizontal` when reading on double page [`97d8ecd`](https://github.com/ollm/OpenComic/commit/97d8ecdde04c2a5c418440d8fbbf06496b16c8ba)
+- Option in setting to adjust gamepad sensitivity
 
 ##### 🐛 Bug Fixes
 
-- Gamepad menus do not work correctly
+- Gamepad menus do not work correctly [`b997d6b`](https://github.com/ollm/OpenComic/commit/b997d6bb6e05c597306169cb4fbbe035a4ab12d1)
 
 ## [v1.4.1](https://github.com/ollm/OpenComic/releases/tag/v1.4.1) (08-02-2025)
 

languages/ca.json

@@ -310,6 +310,7 @@
 			"gamepadMenu": "Menú del comandament",
 			"useGamepad": "Fes servir un comandament per canviar l'acció",
 			"restoreDefaults": "Restaurar valors per defecte",
+			"gamepadSensitivity": "Sensibilitat del comandament",
 			"gamepadDeadZone": "Zona morta del comandament",
 			"screen": "Pantalla",
 			"zoom": "Zoom",

languages/en.json

@@ -310,6 +310,7 @@
 			"gamepadMenu": "Gamepad menu",
 			"useGamepad": "Use a gamepad to change the action",
 			"restoreDefaults": "Restore default values",
+			"gamepadSensitivity": "Gamepad sensitivity",
 			"gamepadDeadZone": "Gamepad dead zone",
 			"screen": "Screen",
 			"zoom": "Zoom",

languages/es.json

@@ -310,6 +310,7 @@
 			"gamepadMenu": "Menú del mando",
 			"useGamepad": "Utiliza un mando para cambiar la acción",
 			"restoreDefaults": "Restaurar valores por defecto",
+			"gamepadSensitivity": "Sensibilidad del mando",
 			"gamepadDeadZone": "Zona muerta del mando",
 			"screen": "Pantalla",
 			"zoom": "Zoom",

scripts/gamepad.js

@@ -68,34 +68,35 @@ function gamepadLoop()
 	let buttons = [];
 	let axes = false;
 
-	// Merge all connected gamepad into one
+	// Merge all connected gamepads into one
 	for(let i = 0, len = gamepads.length; i < len; i++)
 	{
 		if(gamepads[i])
 		{
-			let controller = gamepads[i];
+			let gamepad = gamepads[i];
 
-			for(let i = 0, len = controller.buttons.length; i < len; i++)
+			for(let i = 0, len = gamepad.buttons.length; i < len; i++)
 			{
-				let button = controller.buttons[i];
+				let button = gamepad.buttons[i];
 
 				if(button.value == 1 || !buttons[i])
 					buttons[i] = button;
 			}
 
-			// Avoid controller dead zone
-			let deadZone = config.controllerDeadZone;
+			// Avoid gamepad dead zone
+			let deadZone = config.gamepadDeadZone;
+			let aAbs0 = Math.abs(gamepad.axes[0]), aAbs1 = Math.abs(gamepad.axes[1]), aAbs2 = Math.abs(gamepad.axes[2]), aAbs3 = Math.abs(gamepad.axes[3]);
 
-			let aAbs0 = Math.abs(controller.axes[0]), aAbs1 = Math.abs(controller.axes[1]), aAbs2 = Math.abs(controller.axes[2]), aAbs3 = Math.abs(controller.axes[3]);
-
-			// Prioritize first controller
+			// Prioritize first gamepad
 			if(!axes && (aAbs0 > deadZone || aAbs1 > deadZone || aAbs2 > deadZone || aAbs3 > deadZone))
 			{
+				let sensitivity = config.gamepadSensitivity / 5;
+
 				axes = [
-					(aAbs0 > deadZone ? controller.axes[0] : 0),
-					(aAbs1 > deadZone ? controller.axes[1] : 0),
-					(aAbs2 > deadZone ? controller.axes[2] : 0),
-					(aAbs3 > deadZone ? controller.axes[3] : 0),
+					(aAbs0 > deadZone ? gamepad.axes[0] * sensitivity : 0),
+					(aAbs1 > deadZone ? gamepad.axes[1] * sensitivity : 0),
+					(aAbs2 > deadZone ? gamepad.axes[2] * sensitivity : 0),
+					(aAbs3 > deadZone ? gamepad.axes[3] * sensitivity : 0),
 				];
 			}
 		}

scripts/migration.js

@@ -83,6 +83,13 @@ function migrateOpeningBehavior(data)
 	return data;
 }
 
+function migrateControllerDeadZone(data)
+{
+	data.config.gamepadDeadZone = data.config.controllerDeadZone;
+
+	return data;
+}
+
 function start(data)
 {
 	let changes = data.config.changes;
@@ -98,6 +105,9 @@ function start(data)
 	if(changes < 92) // Change the old opening behavior setting
 		data = migrateOpeningBehavior(data);
 
+	if(changes < 99) // Change controllerDeadZone to gamepadDeadZone
+		data = migrateControllerDeadZone(data);
+
 	return data;
 }
 

scripts/storage.js

@@ -1,4 +1,4 @@
-var changes = 98; // Update this if readingPagesConfig is updated
+var changes = 99; // Update this if readingPagesConfig is updated
 
 var readingPagesConfig = {
 	readingConfigName: '',
@@ -158,7 +158,8 @@ var storageDefault = {
 			play: false,
 			volume: 1.0,
 		},
-		controllerDeadZone: 0.1,
+		gamepadSensitivity: 5,
+		gamepadDeadZone: 0.1,
 		disableGamepadInput: false,
 		saveImageTemplate: '[parentFolder] - [folder] - [image] - [page]',
 		saveImageToFolder: false,

templates/settings.content.right.shortcuts.html

@@ -9,7 +9,7 @@ <h2 class="headline-small">{{language.settings.shortcuts.whenReading}}</h2>
 </div>
 
 <div class="simple-slider gamepad-item" data-gamepad-left="events.rangeMoveStep(this, -1)" data-gamepad-right="events.rangeMoveStep(this, 1)" style="margin-top: 10px;">
-	<div class="simple-slider-text">{{language.settings.shortcuts.gamepadDeadZone}}<div><i class="material-icon slider-reset" onclick="events.resetRange(this)" data-default="0.1" style="right: 70px;">undo</i><span>{{config.controllerDeadZone}}</span></div></div>
+	<div class="simple-slider-text">{{language.settings.shortcuts.gamepadSensitivity}}<div><i class="material-icon slider-reset" onclick="events.resetRange(this)" data-default="5" style="right: 70px;">undo</i><span>{{config.gamepadSensitivity}}</span></div></div>
 	<div class="range">
 		<div class="range-position">
 			<span class="range-line" style="width: 100%"></span>
@@ -18,7 +18,21 @@ <h2 class="headline-small">{{language.settings.shortcuts.whenReading}}</h2>
 				<div class="range-point" position="100" style="left: 100%;"><div class="elevation-1"></div></div>
 			</div>
 		</div>
-		<input type="range" max="0.3" min="0" step="0.01" value="{{config.controllerDeadZone}}" onrange="settings.set('controllerDeadZone', \{{value}})">
+		<input type="range" max="50" min="1" step="1" value="{{config.gamepadSensitivity}}" onrange="settings.set('gamepadSensitivity', \{{value}})">
+	</div>
+</div>
+
+<div class="simple-slider gamepad-item" data-gamepad-left="events.rangeMoveStep(this, -1)" data-gamepad-right="events.rangeMoveStep(this, 1)" style="margin-top: 10px;">
+	<div class="simple-slider-text">{{language.settings.shortcuts.gamepadDeadZone}}<div><i class="material-icon slider-reset" onclick="events.resetRange(this)" data-default="0.1" style="right: 70px;">undo</i><span>{{config.gamepadDeadZone}}</span></div></div>
+	<div class="range">
+		<div class="range-position">
+			<span class="range-line" style="width: 100%"></span>
+			<span class="range-steps"></span>
+			<div>
+				<div class="range-point" position="100" style="left: 100%;"><div class="elevation-1"></div></div>
+			</div>
+		</div>
+		<input type="range" max="0.3" min="0" step="0.01" value="{{config.gamepadDeadZone}}" onrange="settings.set('gamepadDeadZone', \{{value}})">
 	</div>
 </div>