{"id":606,"date":"2014-02-24T17:48:25","date_gmt":"2014-02-24T15:48:25","guid":{"rendered":"http:\/\/pila.fr\/wordpress\/?p=606"},"modified":"2015-06-30T15:46:59","modified_gmt":"2015-06-30T13:46:59","slug":"simple-xbox-360-controller-une-classe-permettant-lutilisation-des-manettes-xbox-360-sous-windows-avec-qt","status":"publish","type":"post","link":"https:\/\/pila.fr\/wordpress\/archives\/606","title":{"rendered":"Simple Xbox 360 Controller : une classe permettant l’utilisation des manettes Xbox 360 sous Windows avec Qt"},"content":{"rendered":"

Pour utiliser les manettes de xbox 360 sous Windows, Microsoft a mis au point la librairie Xinput. Si plusieurs d\u00e9veloppeurs ont d\u00e9j\u00e0 mis a disposition des classes C++ pour faciliter l’acc\u00e8s \u00e0 Xinput, aucune n’a \u00e9t\u00e9 \u00e9crite pour tirer partie du m\u00e9canisme des slot \/ signal de Qt. La classe SimpleXbox360Controller a pour objectif de pallier ce manque.<\/p>\n

\"Le<\/a>

Le logiciel de d\u00e9mo :\u00a0 Simple Xbox 360 Controller Tester<\/p><\/div>\n

Le programme d’exemple Xbox 360 Controller Tester permet de tester rapidement le fonctionnement d’une manette. L’ex\u00e9cutable est disponible ici : SimpleXbox360ControllerTester<\/a><\/p>\n

L’ensemble du code de la classe, celui du programme d’exemple, et la documentation en anglais du code est disponible sur GitLab<\/a>.<\/p>\n

Pour mes amis francophones, vous trouverez ci-dessous une version fran\u00e7aise de la doc :
\n<\/p>\n

Important<\/h1>\n

 <\/p>\n

Il faut imp\u00e9rativement ajouter la ligne suivante dans votre fichier .pro, sans quoi le compilateur ne trouvera pas le fichier XInput.lib :<\/p>\n

win32:LIBS += $${PRO_FILE_PWD<\/em>}\/SimpleXbox360Controller\/XInput.lib<\/p>\n

 <\/p>\n

Principe<\/h1>\n

 <\/p>\n

La classe SimpleXbox360Controller permet de r\u00e9cup\u00e9rer l’\u00e9tat d’une manette de xbox 360 connect\u00e9e \u00e0 l’ordinateur. (pour g\u00e9rer 4 manettes, utiliser 4 instances de la classe). Cette classe a \u00e9t\u00e9 \u00e9crite pour offrir un maximum de flexibilit\u00e9, il y a par cons\u00e9quente plusieurs fa\u00e7on de l’utiliser. La r\u00e9cup\u00e9ration des infos de la manette peut se faire soit de fa\u00e7on automatique (la classe dispose de son propre QTimer<\/em><\/span>) soit manuellement, \u00e0 chaque appel de la fonction update()<\/em>. De m\u00eame, la classe \u00e9met des signaux \u00e0 chaque changement d’\u00e9tat de la manette, mais il est \u00e9galement possible de Statlire manuellement le dernier \u00e9tat re\u00e7u.<\/p>\n

Mais commen\u00e7ons par le d\u00e9but :<\/p>\n

 <\/p>\n

Le constructeur<\/h1>\n

 <\/p>\n

Celui ci prend jusqu’\u00e0 5 param\u00e8tres :<\/p>\n

    \n
  1. Le num\u00e9ro de la manette associ\u00e9e (de 0 \u00e0 3, correspond au manettes des joueurs 1 \u00e0 4).<\/li>\n
  2. Le rayon du point mort du stick analogique gauche (de 0 \u00e0 32767). Il est conseill\u00e9 d’omettre ce param\u00e8tre, la valeur par d\u00e9faut \u00e9tant alors utilis\u00e9e.<\/li>\n
  3. Le rayon du point mort du stick analogique droit (de 0 \u00e0 32767). Il est conseill\u00e9 d’omettre ce param\u00e8tre, la valeur par d\u00e9faut \u00e9tant alors utilis\u00e9e.<\/li>\n
  4. Le seuil de d\u00e9tection des g\u00e2chettes (de 0 \u00e0 255). Il est conseill\u00e9 d’omettre ce param\u00e8tre, la valeur par d\u00e9faut \u00e9tant alors utilis\u00e9e.<\/li>\n
  5. Le QObject<\/em> parent. Permet \u00e0 Qt d’am\u00e9liorer la gestion m\u00e9moire. Pas vraiment n\u00e9cessaire si l’on pense \u00e0 mettre les delete<\/em>.<\/li>\n<\/ol>\n

     <\/p>\n

    La classe Input<\/h1>\n

     <\/p>\n

    Cette classe repr\u00e9sente l’\u00e9tat de la manette. Elle appartient \u00e0 la classe SimpleXbox360Controller ( pour en d\u00e9clarer une nouvelle instance, il faut donc \u00e9crire SimpleXbox360Controller::InputState monInputState<\/em>) Chaque stick analogique est repr\u00e9sent\u00e9 par 2 variables de type float dont la valeur varie de -1 (haut\/gauche) \u00e0 1 (bas\/droite), 0 correspondant \u00e0 la position au repos.<\/p>\n

    Chaque g\u00e2chette est repr\u00e9sent\u00e9e par une variable float<\/em> de valeur comprise entre 0 (g\u00e2chette au repos) \u00e0 1 (appuy\u00e9e au maximum)<\/p>\n

    Ces valeurs sont obtenues apr\u00e8s calcul des seuils et des des points morts, donc vous n’avez pas d’effectuer ces calculs.<\/p>\n

    Le type et l’\u00e9tat de la batterie sont repr\u00e9sent\u00e9s par des variables de type quint8<\/em> (entiers non sign\u00e9s sur 8 bits). Ces variables doivent \u00eatre interpr\u00e9t\u00e9es par comparaison avec les d\u00e9finitions BATTERY_TYPE_<\/em> et BATTERY_LEVEL_<\/em> du fichier XInput.h<\/em><\/p>\n

    L’\u00e9tat des boutons est repr\u00e9sent\u00e9 par une variable de type quint16. L’\u00e9tat de chaque bouton peut \u00eatre \u00e9valu\u00e9 par appel de la m\u00e9thode InputState::isButtonPressed()<\/em> . Par exemple, pour v\u00e9rifier si le bouton A est appuy\u00e9 : myInputState.isButtonPressed(XINPUT_GAMEPAD_A)<\/em> retourne true<\/em> si A est appuy\u00e9, et false<\/em> sinon.<\/p>\n

     <\/p>\n

    Signaux<\/h1>\n

     <\/p>\n