Prototype de vibrations SDL3
État
Le code se compile en Win32 et le jeu de développement charge le pont SDL3. Le diagnostic SDL3 séparé a détecté une Xbox 360 Controller (045E:028E) avec la capacité de vibration classique, sans vibration indépendante des gâchettes. La capacité annoncée n'est pas, à elle seule, une confirmation physique des moteurs.
Ce prototype ne constitue pas encore le module complet de commandes SDL3. Le jeu continue d'utiliser son système d'entrée original ; le clavier et les commandes manette n'ont pas été remplacés.
Validation physique du 17 novembre 2026 : l'utilisateur confirme que F8 et certains événements du jeu font vibrer la manette. L'essai valide la chaîne jeu → plugin → SDL3 → moteurs sur cette manette. Il ne valide pas une couverture complète de tous les chocs, surfaces ou dérapages.
Fonctionnement
- Initialisation de SDL3 depuis le thread qui charge le plugin ASI, puis traitement des événements uniquement depuis ce même thread dans la routine véhicule observée.
- Réénumération périodique des manettes et fermeture des handles déconnectés.
- F8 pendant la conduite : demande d'une vibration de test de 200 ms, intensité brute 16000/65535 sur les deux moteurs.
- Traduction expérimentale des demandes natives de type
0, à l'entrée de0x005C9760, désormais identifié comme chemin d'impulsion carrée par son GUID. Les fonctions originales continuent de s'exécuter. - Seules les valeurs positives de 1 à 10000 sont acceptées pour cette traduction.
- Conversion tactile configurable, à deux moteurs identiques, avec impulsion de 150 ms par défaut. Ce n'est pas une reproduction exacte du retour de force d'un volant.
- Pas de vibration issue du type
6: il s'agit d'un chemin d'amortissement (GUID_Damper), qui ne se transpose pas directement en une impulsion sur deux moteurs. - Lorsque le jeu n'est pas au premier plan, les demandes sont effacées et une commande d'arrêt est envoyée lors du prochain passage dans la routine véhicule. Les demandes envoyées ont dans tous les cas une durée finie.
La boucle dépend encore de la routine véhicule : le test F8 et la mise à jour SDL ne sont pas garantis dans les menus ou lorsque cette routine n'est pas appelée. L'affectation multijoueur des manettes n'est pas validée ; seul le contrôleur présent a été détecté.
Configuration
Dans NFSU2-dev/scripts/NFSU2_InputTrace.ini :
[Trace]
Enabled=1
[Rumble]
Enabled=1
GainPercent=60
MinimumPercent=10
MaximumPercent=45
PulseMs=150
La formule du prototype est min(MaximumPercent*100, raw*GainPercent/100 + MinimumPercent*100), puis conversion de l'échelle 0–10000 vers 0–65535. Ce choix vise un premier retour tactile mesurable ; son réglage doit être validé sur les événements réels.
Jeu fermé, Rumble/Enabled=0 désactive le pont moteur au lancement suivant tout en conservant les traces. Trace/Enabled=0 empêche l'installation des points de trace et du pont dans ce prototype. Ne pas décharger le plugin pendant une partie.
Résultats des traces avant SDL3
- Premier essai : un appel natif de type 0, quatre repères manuels ; aucun appel bas niveau de création/mise à jour périodique.
- Second essai : 2361 entrées du calcul véhicule, 2361 demandes de type 6, un appel de type 0, deux repères et aucune perte signalée.
- Les demandes des types 0 et 6 avaient une entrée de périphérique non nulle mais un compteur d'axes actionneurs nul à
0x0086FF80. - Le désassemblage de
0x005C9760vérifie ce compteur et quitte la routine s'il est nul, avant la création/mise à jour de l'effet. Le callback0x005C8660permet désormais de relier ce compteur au bit DirectInputDIDOI_FFACTUATOR.
La cartographie consolidée décrit les nouvelles identifications, les banques d'effets et les paramètres reconstruits. L'impulsion carrée native utilise notamment 150 ms de durée et 75 ms de période ; le prototype ne reproduit pas encore sa forme d'onde complète.
Compilation
build.ps1 -Target Trace construit le plugin et copie la DLL SDL3 x86 dans build. build.ps1 -Target Probe construit le diagnostic de détection sans envoyer de vibrations.
SDK épinglé : SDL3 3.4.20 VC, provenant de la version officielle.
SHA-256 de l'archive : 1EC3009655EE37B1F73E52B3B120ACC5AFD8ABAF9532F3303B1BF1DFE91B5969.
Le chemin SDK par défaut est celui de l'espace de travail, sous work/tools/SDL3-3.4.20/SDL3-3.4.20. Pour une compilation ailleurs, passer la propriété MSBuild SDLRoot vers un SDK VC extrait. La licence SDL est fournie dans SDL3-LICENSE.txt.
Le test automatique des trampolines reste PASS après l'ajout de la réinitialisation temporaire du contexte flottant des callbacks. Il ne remplace pas les tests de stabilité du jeu et les retours physiques de la manette.