Rapports d’entrée du contrôleur radial Windows
Cette rubrique détaille les rapports d’entrée IHM utilisés pour la prise en charge des retours haptiques du contrôleur radial dans les systèmes d’exploitation Windows 10, version 1607 et ultérieurs.
L’hôte utilise les utilisations suivantes lors de l’extraction de données à partir d’un rapport d’entrée :
Membre | Description | Page | id | Obligatoire/facultatif |
---|---|---|---|---|
Bouton | État du bouton situé sur le contrôleur radial | 0x09 | 0x01 | Obligatoire |
Composer | Rotation relative du contrôleur radial | 0x01 | 0x37 | Obligatoire |
X | Coordonnée X de la position de contact | 0x01 | 0x30 | Facultatif |
O | Coordonnée Y de la position de contact | 0x01 | 0x31 | Facultatif |
Largeur | Largeur du cadre de limitation autour d’un contact | 0x0D | 0x48 | Facultatif |
Hauteur | Hauteur du cadre de limitation autour d’un contact | 0x0D | 0x49 | Facultatif |
Utilisations facultatives obligatoires et prises en charge par Windows
Tout appareil qui ne signale pas toutes les utilisations obligatoires ne sera pas fonctionnel en tant que contrôleur radial Windows. Les utilisations obligatoires sont strictement appliquées par l’hôte Windows. Lorsqu’une valeur maximale logique n’a pas été restreinte, elle peut être optimisée pour réduire la taille du descripteur.
Les sections suivantes fournissent plus de détails sur les utilisations facultatives obligatoires et prises en charge par Windows qui ont été présentées dans le tableau ci-dessus.
Bouton
Permet d’indiquer quand le bouton principal de l’appareil de contrôleur radial est enfoncé. Cela est indiqué par un élément principal avec une taille de rapport de 1 bit. Lors de la remise d’un rapport d’entrée, le bit doit être défini lorsque ce bouton est enfoncé et effacé lorsque le bouton est relâché.
Composer
Utilisé pour indiquer la rotation dans le sens des aiguilles d’une montre du contrôleur radial autour de son propre axe principal. Lors de la remise d’un rapport d’entrée, la valeur signalée doit être l’ampleur de la rotation relative au rapport précédent. Cette valeur est positive si le contrôleur radial est pivoté dans le sens des aiguilles d’une montre et négative si le contrôleur radial est pivoté dans le sens inverse des aiguilles d’une montre.
La plage physique et la plage logique doivent être spécifiées. Les degrés ou radians peuvent être utilisés pour la plage physique. Dans les deux cas, la plage logique doit être suffisamment grande pour signaler des valeurs exactes à au moins une décimale.
X/Y
X et Y indiquent les coordonnées du contact d’un contrôleur radial à l’écran. Cette coordonnée représente le centre du contact relatif à l’affichage.
Les appareils qui signalent X et Y doivent également signaler une utilisation de la largeur ou de la hauteur. L’hôte utilise la coordonnée signalée pour générer le rectangle englobant autour du contact.
Les éléments globaux suivants doivent être spécifiés pour les utilisations de X et Y :
- Minimum logique
- Maximum logique
- Minimum physique
- Maximum physique
- Unité
- Exposant d’unité
La plage physique de l’appareil et les unités doivent être signalées avec précision. Si les informations sont inexactes, l’appareil ne fonctionnera pas correctement. Les appareils doivent également signaler des données dans la plage logique spécifiée dans le descripteur de rapport.
X et Y peuvent fournir une valeur NULL au système, ce qui implique que l’appareil n’a actuellement pas de position par rapport à un affichage, en fournissant une valeur en dehors de la plage logique signalée et en ajoutant le support Null au rapport d’entrée de l’utilisation (Bit 6 {Aucune position Null (0) | État Null(1)}).
Largeur et hauteur
Les utilisations de largeur et hauteur représentent la largeur et la hauteur du cadre de limitation autour du contact du contrôleur radial. La largeur et la hauteur doivent être définies en tant que constantes dans le descripteur de rapport.
Un appareil de contrôleur radial Windows est supposé être circulaire par le système. Pour cette raison, il n’est pas nécessaire de signaler à la fois la largeur et la hauteur d’un contact à l’écran. Si la hauteur ou la largeur est prise en charge, les limites du contact sont interprétées correctement par le système. Windows ne prend pas en charge les périphériques de contrôleur radial avec des valeurs différentes pour la largeur et la hauteur.