Sous ce nom barbare se cache un module qui tient particulièrement à cœur à l'un de nos développeurs, puisqu'il va permettre de redonner vie à tous ces jeux d'ordinateurs, oubliés de tous les Recalboxers qui n'ont pas de clavier branché, c'est a dire, presque tout le monde...
¶ De la Manette au Clavier...
Durant la glorieuse décennie des 80', nombre de micro-ordinateurs ont vu le jour... Mais à cette époque, la manette n'existait pas encore, et le Joystick n'était pleinement exploité que sur console.
Les jeux sur micro-ordinateur ont une ergonomie orientée clavier, et pour les plus chanceux, clavier ou joystick. Souvent, le clavier est nécessaire pour passer l'intro ou pour démarrer le jeu.
Il était donc impossible de profiter de ces jeux sans avoir un clavier connecté.
Du moins jusqu'à maintenant, car Recalbox inclut un module Pad-To-Keyboard qui est chargé de mapper des actions pads vers des appuis/relâchements de touches clavier !
Ceci s'effectue à l'aide de petits fichiers de configuration.
C'est très simple :
- Vous avez un jeu génial sur Commodore 64, mais vous ne pouvez pas y jouer parce qu'il demande d'appuyer sur la barre d'espace pour lancer une partie ? Aucun soucis :
- Mappez le bouton
STARTde votre pad sur la toucheESPACE, et le problème est réglé. - Lancez le jeu, appuyez sur
STARTet le jeu verra que vous avez appuyé sur la touche espace d"un clavier.
- Mappez le bouton
- Vous avez un jeu sur Amstrad qui se joue avec les 4 touches fléchées et la barre espace? Pas de problème :
- Mappez la croix directionnelle de votre pad sur les 4 flèches et le bouton
AsurESPACE. - Lancez votre jeu comme s'il avait toujours été fait pour un joystick !
- Mappez la croix directionnelle de votre pad sur les 4 flèches et le bouton
Et nul doute que de talentueux développeurs externes pourront même nous faire une petite interface pour créer ces configurations sans effort.
¶ Comment ça marche ?
Lorsqu'il détecte une configuration P2K (Pad to Keyboard) pour un jeu, l'interface va créer un clavier virtuel qui sera vu par le système comme un vrai clavier physique. Tout au long de la session de jeu, l'interface va intercepter les événements des pads, et en fonction de la configuration, il va générer des appuis et des relâchements de touches.
Les émulateurs qui sont à l'écoute du clavier vont alors utiliser ces événements clavier dans la machine qu'ils émulent, comme s'ils venaient d'un clavier physique.
¶ Ce qu'on ne peut pas encore faire
Une seule chose : les séquences de touches avec des combinaisons au milieu. C'est soit l'un, soit l'autre.
Il vous sera par exemple impossible d'écrire un mot qui nécessite des caractères accessibles avec SHIFT sur la machine émulée.
Ça viendra peut-être dans les prochaines versions 😉
¶ Configuration
¶ Fichier de configuration
Les fichiers de configuration d'un mapping pad-to-keyboard peuvent être définis de 2 façons différentes :
- Pour un dossier complet (et ses sous-dossiers)
Pour un dossier, il devra se situer à l’intérieur de celui-ci et s’appellera .p2k.cfg.
Ce qui donnera un chemin final du type /chemin/vers/.p2k.cfg. Celui-ci s'appliquera à tous les jeux dans ce dossier et ses sous-dossiers.
- Pour un jeu en particulier
Pour une rom (ou un jeu) spécifique, il devra porter le même nom que la rom, avec l'extension .p2k.cfg rajoutée à l'extension existante.
Ce qui donnera /chemin/vers/monjeu.ext pour la rom /chemin/vers/monjeu.ext.p2k.cfg.
Si plusieurs fichiers sont présents, ils se surchargent dans l'ordre descendant des dossiers, jusqu'à la configuration propre aux jeux, si elle existe. Ce sera vu en détail un peu plus loin.
¶ Configuration du mapping
La configuration du mapping se base sur l'emplacement des boutons d'une manette Nintendo (emplacement des boutons A / B / X / Y).
Partons d'un exemple utilisé lors des tests :
# dpad vers les flèches
0:up = up
0:down = down
0:right = right
0:left = left
# bouton A pour la barre d'espace
0:a = space
# bouton B pour la touche Y (pour les messages Y/N)
0:b = y
# Et finalement, bouton START pour la touche ENTER
0:start = enter
Comme on peut le voir dans cet exemple, la structure est très simple.
On peut laisser des lignes vides pour séparer les blocs, et utiliser le caractère # en début de ligne pour les commentaires / descriptifs / mémos.
Les lignes de configuration de mapping sont de la forme PAD:ACTION = KEY, avec :
PAD: N° de manette tel que défini dans l'interface, ou l'ordre naturel des pads s'il n'y a pas d'affectation forcée. Rares sont les cas où plus d'une manette sera mappé, donc le n° 0 sera utilisé dans la grande majorité des cas pour la manette 1.ACTION: Action de la manette à mapper. On peut mapper tous les boutons, les flèches directionnelles (D-Pad) et les 4 directions primaires des joysticks analogiques, ce qui représente jusqu'à 25 actions qu'on peut affecter à des touches clavier, sur un pad standard complet.KEY: La touche du clavier qu'on associe à l'action de la manette. Lorsque l'action de la manette est enclenchée, la touche correspondante est appuyée. Lorsque l'action de la manette est désenclenchée, la touche correspondante est relâchée. Comme vu plus haut, le mapping est du 1 pour 1. Si vous voulez simuler par exemple LEFTSHIFT + A, il faudra affecter LEFTSHIFT a un bouton de la manette (par exemple L1), et la touche A à un autre bouton (disons le bouton Y). L'appui simultané de L1 + Y donnera un LEFTSHIFT + A. Une exception existe pour les joysticks analogiques. Étant donné qu'on peut les placer en diagonale, cette particularité peut être utilisée pour appuyer sur 2 touches en même temps.
La casse des
ACTIONetKEYn'a pas d'importance, pas plus que les espaces en début de ligne, en fin de ligne, ou autour du=.
¶ Actions joysticks
Voici la liste complète des actions pad utilisables :
| Action | Description | Action | Description |
|---|---|---|---|
up |
Digital PAD, direction haute | j1up |
Joystick #1 (gauche), direction haute |
down |
Digital PAD, direction basse | j1down |
Joystick #1 (gauche), direction basse |
left |
Digital PAD, direction gauche | j1left |
Joystick #1 (gauche), direction gauche |
right |
Digital PAD, direction droite | j1right |
Joystick #1 (gauche), direction droite |
a |
Bouton A | j2up |
Joystick #2 (droite), direction haute |
b |
Bouton B | j2down |
Joystick #2 (droite), direction basse |
x |
Bouton X | j2left |
Joystick #2 (droite), direction gauche |
y |
Bouton Y | j2right |
Joystick #2 (droite), direction droite |
l1 |
Bouton L1 | l2 |
Bouton L2 |
r1 |
Bouton R1 | r2 |
Bouton R2 |
start |
Bouton START | l3 |
Bouton L3 |
select |
Bouton SELECT | r3 |
Bouton R3 |
¶ Combinaison avec HotKey
Les actions peuvent aussi être précédées du signe + pour indiquer qu'elles doivent être exécutées conjointement avec le bouton HOTKEY du pad.
L'exemple suivant permettra d'actionner les touches F1 à F4 lorsque le bouton HOTKEY sera combiné aux directions du DPAD :
# Actions spéciales au dpad
0:+up = f1
0:+down = f2
0:+right = f3
0:+left = f4
¶ Touches claviers utilisables
Le clavier virtuel créé par EmulationStation est un clavier agnostique. Il ne connait ni langue, ni disposition particulière. C'est donc un clavier 105 touches, QWERTY des plus basiques.
Pour ne pas perdre les utilisateurs, seules certaines touches communes à tous les claviers sont configurables. Et ce, pour deux bonnes raisons :
- Si je vous dis que sur mon clavier portugais, j'ai mappé le bouton Y sur la touche %, il y a toutes les chances qu'elle ne corresponde pas à la touche % sur votre clavier.
- L’émulateur va lui aussi devoir mapper un clavier 105 touches vers le clavier de la machine émulée. C'est parfois tellement complexe et peu intuitif que certains émulateurs proposent en plus un clavier virtuel à l'écran.
Cependant, pas d'affolement, dans la grande majorité des cas, vous allez utiliser des mapping de touches simples. Il faut juste garder en tête que la disposition des lettres est en QWERTY.
Une image vaut mieux qu'un long discours :
¶ Surcharge des configurations (oui, encore !)
Comme évoqué plus haut, les fichiers de configuration, lorsqu'il y en a plusieurs à différents étages de dossiers et/ou pour le jeu lui même, se surchargent les uns les autres.
Le module P2K va commencer par lire celui le plus haut, puis va descendre jusque dans le dossier de la rom en lisant tous les fichiers de configuration qu'il trouvera, pour finir avec celui de la rom, s'il existe.
Ce qui signifie, que les configurations peuvent s'ajouter, ou se modifier !
Exemple 1: Les configuration s'additionnent
Fichier /chemin/vers/.p2k.cfg :
# Bouton START vers la touche ENTER
0:start = enter
Fichier /chemin/vers/monjeu.ext.p2k.cfg :
# Bouton SELECT vers la touche SPACE
0:select = space
Donnera l’équivalent de:
# Bouton START vers la touche ENTER
0:start = enter
# Bouton SELECT vers la touche SPACE
0:select = space
Exemple 2: Les configurations se modifient
Fichier /chemin/vers/.p2k.cfg
# Bouton START vers la touche ENTER
0:start = enter
# Bouton SELECT vers la touche SPACE
0:select = space
Fichier /chemin/vers/monjeu.ext.p2k.cfg :
# Bouton SELECT vers la touche F1
0:select = f1
Donnera l’équivalent de :
# Bouton START vers la touche ENTER
0:start = enter
# Bouton SELECT vers la touche F1
0:select = f1
Exemple 3: Les configurations se modifient en supprimant des mappings
Fichier /chemin/vers/.p2k.cfg
# Bouton START vers la touche ENTER
0:start = enter
# Bouton SELECT vers la touche SPACE
0:select = space
Fichier /chemin/vers/monjeu.ext.p2k.cfg :
# Suppression de la configuration du bouton SELECT !
0:select =
Donnera l’équivalent de :
# Bouton START to ENTER
0:start = enter
¶ Ajout d'une brève description
Vous pouvez afficher une description dans l'interface comme ceci :
Pour cela, vous devez utiliser deux points virgules puis la description.
Voici un exemple :
# Recalbox's Pad-to-Keyboard configuration
#Arkanoid Revenge of Doh (1987)(Sharp - SPS)
#SHARP X6800
#left move key 4
0:left = kp4 ;; Move left
#right move key 6
0:right = kp6 ;; Move right
#shoot key space
0:a = space ;; Fire!
#hispeed move key shift
0:b = leftshift ;; Speedup!
¶ Emulation de la souris à 3 boutons
Vous pouvez émuler le déplacement de la souris et les appuis/relâchements de ses 3 boutons directement depuis votre pad.
Pour une émulation précise, un pad avec un joystick analogique est conseillé, mais l'émulation est parfaitement possible avec des boutons ou un d-pad.
¶ Configuration complète
Aux touches du clavier KEY vu plus haut viennent s'ajouter 7 valeurs, correspondantes aux 4 directions de déplacement plus les 3 boutons souris.
| Element souris | Description |
|---|---|
mouse.button.left |
Bouton gauche de la souris |
mouse.button.middle |
Bouton central de la souris ou clic molette |
mouse.button.right |
Bouton droit de la souris |
mouse.move.left |
Déplacement de la souris vers a gauche |
mouse.move.up |
Déplacement de la souris vers le haut |
mouse.move.right |
Déplacement de la souris vers la droite |
mouse.move.down |
Déplacement souris vers le bas |
Ces valeurs peuvent être affectées à n'importe quelle ACTION.
Admettons que nous ayons un simple pad SNES avec un DPAD et 4 boutons, et que nous souhaitons utiliser la souris sur un jeu DOS uniquement jouable à la souris, voilà à quoi ressemblera un fichier p2k:
# Recalbox's Pad-to-Keyboard configuration
# DOS GAME
# Déplacement de la souris
0:up = mouse.move.up
0:right = mouse.move.right
0:down = mouse.move.down
0:left = mouse.move.left
# Boutons de la souris
0:a = mouse.button.left
0:b = mouse.button.right
Avec une telle configuration, les déplacements du curseur accélèrent sur le départ avant de se stabiliser à une certaine vitesse.
Vous pouvez également utiliser un joystick analogique, par exemple le joystick droit d'une manette XBox :
# Recalbox's Pad-to-Keyboard configuration
# DOS GAME
# Déplacement de la souris
0:j2up = mouse.move.up ;; Mouvement souris
0:j2right = mouse.move.right ;; Mouvement souris
0:j2down = mouse.move.down ;; Mouvement souris
0:j2left = mouse.move.left ;; Mouvement souris
# Boutons de la souris
0:a = mouse.button.left ;; Bouton gauche
0:b = mouse.button.right ;; Bouton droit
Dans ce cas, c'est la poussée d'un joystick analogique qui régulera la vitesse de déplacement du curseur.
¶ Configuration simplifiée
Si vous utilisez les joysticks gauche ou droit pour émuler le déplacement de la souris, vous pouvez utiliser la configuration simplifiée 0:j1 = mouse.moves ou 0:j2 = mouse.moves (attention au 's' !).
Si on reprend la configuration précédente, elle peut se simplifier comme suit :
# Recalbox's Pad-to-Keyboard configuration
# DOS GAME
# Déplacements de la souris
0:j2 = mouse.moves ;; Mouvement souris
# Boutons de la souris
0:a = mouse.button.left ;; Bouton gauche
0:b = mouse.button.right ;; Bouton droit
Pour les jeux qui ont uniquement besoin d'une souris, et ils sont nombreux, vous pouvez mapper la souris sur plusieurs éléments du pad, comme ceci :
# Recalbox's Pad-to-Keyboard configuration
# DOS GAME
# Déplacements de la souris
0:up = mouse.move.up
0:right = mouse.move.right
0:down = mouse.move.down
0:left = mouse.move.left
0:j1 = mouse.moves ;; Mouvement souris
0:j2 = mouse.moves ;; Mouvement souris
# Boutons de la souris
0:a = mouse.button.left ;; Bouton gauche
0:b = mouse.button.right ;; Bouton droit
Avec ce fichier p2k, les deux joysticks et le dpad sont utilisables pour piloter finement le curseur de la souris, en fonction des préférences de chacun et du niveau de précision requis.
¶ Configuration étendue du clavier
Avec le P2K, les possibilités d'émulation du clavier s'étendent grandement pour supporter les combinaisons de touches, et les séquences de touches (comme quand on tape au clavier).
Dans les 2 cas, le système supporte jusqu'à 32 touches. Donc soit 32 touches appuyées presque simultanément, ou une séquence de 32 touches consécutives.
¶ Combinaisons de touches
Pour déclarer une combinaison de touches, c'est très simple, il suffit de séparer les touches par des espaces (et rien d'autre que des espaces !), comme ceci :
# Assigne CTRL+C au bouton R1
0:r1 = leftctrl c ;; Break the program!
Notez qu'à l'appui de R1, les touches sont appuyées dans l'ordre exact de la déclaration. Puis lorsque R1 est relâché, les touches sont relâchées dans l'ordre inverse.
Dans le cas où l'émulateur nécessiterait un délai entre les touches (maintenir un premier bouton et appuyer sur un second bouton) ou dans le cas ou vous auriez besoin d'un délai explicite pour une quelconque raison, vous pouvez précéder les touches devant être maintenues appuyées par +xxx ou xxx est un délai en millisecondes.
Exemple :
# Assigne CTRL+C au bouton R1
0:r1 = +100 leftctrl c ;; Break the program!
Ici, lorsqu'on appui sur R1, le P2K appuie sur la touche CONTROL GAUCHE, attends 100ms maintenu comme actif, puis appuie sur la touche C, effectuant la combinaison CTRL+C. La dernière touche, n'introduit pas de délai. Puis lorsque R1 est relâché, les touches sont relâchées dans l'ordre inverse : C est relâché, on attend 100ms, puis on relâche CONTROL GAUCHE.
Le + indique explicitement que c'est une combinaison de touches. Il peut être utilisé seul, sans le délai, mais ne servira à rien dans ce cas, car en l'absence d'un indicateur explicite, plusieurs touches déclarées formeront une combinaison.
¶ Séquences de touches
Pour une sequence de touche, nous devons utiliser l'indicateur explicite /, comme ceci :
# Assigne R1 à la séquence FGHJ
0:r1 = / f g h j ;; Écrit FGHJ!
Ici, lorsque R1 va être appuyé, le système va générer la séquence suivante : appui F, relâchement F, appui G, relâchement G, appui H, relâchement H, appui J, relâchement J. Sans délai entre les appuis et relâchements, et dans l'ordre strict de déclaration.
Notez qu'au relâchement de R1, il ne se passe rien. La séquence est envoyée uniquement sur un appui.
Encore une fois, certains émulateurs/jeux pourraient avoir des soucis avec des séquences de touches sans délais. Nous pouvons donc déclarer un délai de 25ms entre chaque appui/relâchement, comme ceci :
# Assign R1 à la séquence FGHJ
0:r1 = /25 f g h j ;; Écrit FGHJ!
Dans ce cas, la séquence sera la suivante : appui F, attente de 25ms, relâchement F, attente de 25ms, appui G, attente de 25ms, relâchement G, attente de 25ms, appui H, attente de 25ms, relâchement H, attente de 25ms, appui J, attente de 25ms, relâchement J.
Pas de délai après le dernier relâchement.
¶ Et l'input-lag ?
Garantie 100% sans input-lag, et ça fonctionne sur tous les ordinateurs !
Le module P2K est en priorité haute, ce qui signifie qu'il prends la main dés qu'un événement pad survient, pour le traduire et le renvoyer vers le clavier virtuel instantanément.
Sur Raspberry Pi 3, les mesures effectuées entre la réception de l'action Pad et la réception de l'appui clavier donnent des résultats très inférieurs à ce qui pourrait générer le moindre input lag.
¶ Section spéciale pour partager vos configurations
Ça y est, vous avez configuré vos jeux favoris pour qu'ils soient totalement jouables à la manette ?
Alors ne laissez pas les autres refaire le même travail encore et encore : partagez vos configurations !
Nous avons ouvert une discussion spéciale sur le forum de Recalbox, afin que chacun partage ses configurations.
Vous pouvez également inclure vos créations dans ScreenScraper afin qu'elles soient téléchargées automatiquement lors du scraping.
Cependant, faites attention : essayez de rester logique, et d'avoir un mapping qui soit au maximum intuitif :
- Un jeu doit se lancer avec START ou le bouton A.
- Si un jeu nécessite une action clavier pour configurer le joystick (souvent le cas sur ZX Spectrum par exemple), restez en clavier et faite un mapping complet de toutes les touches.
Bons jeux !