Boutons, utilisation au niveau du rapport (touchpad-buttons-report-level-usages)
Cette rubrique décrit les utilisations au niveau du rapport pour les boutons, dans le contexte de la collection de pavés tactiles de précision Windows.
Voici un tableau indiquant toutes les utilisations obligatoires qui doivent être présentes dans tous les rapports d’entrée de pavé tactile de précision Windows. Le tableau inclut les utilisations des boutons 1, 2 et 3.
Membre | Description | Page | id | Obligatoire/facultatif |
---|---|---|---|---|
ID du rapport | ID de rapport de pavé tactile de précision Windows. | 0x0D | 0x05 | Obligatoire |
Heure de l’analyse | Temps d’analyse relatif. | 0x0D | 0x56 | Facultatif |
Nombre de contacts | Nombre total de contacts à signaler dans un rapport donné. | 0x0D | 0x54 | Obligatoire |
Bouton 1 | Indique l'état du bouton pour le bouton du pavé tactile intégré au numériseur. | 0x09 | 0x01 | Facultatif |
Bouton 2 | Indique l'état du bouton pour le bouton externe pour le clic principal (gauche par défaut). | 0x09 | 0x02 | Facultatif |
Bouton 3 | Indique l'état du bouton pour le bouton externe pour le clic secondaire (droit par défaut). | 0x09 | 0x03 | Facultatif |
Les sections suivantes fournissent des informations sur les utilisations des boutons. Pour plus d’informations sur les autres membres (par exemple, ID de rapport), consultez Collection de pavés tactiles de précision Windows.
Bouton 1
Le commutateur du Bouton 1 spécifie l’état haut/bas du bouton Pavé tactile de précision Windows sous le numériseur. Quelle que soit l’implémentation de type de bouton (pression ou mécanique), lorsque le bouton a reçu la quantité requise de force d’activation, son état bas (enfoncé) doit être signalé en définissant le bit du bouton. Lorsque la force d’activation qui est appliquée au bouton passe sous le seuil requis, l’état haut (relâché) doit être signalé en désactivant le bit du bouton.
En référence à l’exemple illustré dans le diagramme précédent, supposez qu’un contact est placé sur un pavé tactile de précision Windows avec une force d’activation suffisante pour appeler un bouton bas (enfoncé). Puis, plus tard, la force d’activation est réduite de sorte que l’état de bouton haut (relâché) est appelé, tandis que le contact reste sur la surface pendant un certain temps supplémentaire. Cela serait signalé comme décrit dans le tableau suivant.
Rapport | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
---|---|---|---|---|---|---|---|---|---|---|---|
Nombre de contacts | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
Bouton | 1 | 1 | 1 | 1 | 1 | 0 | NR | NR | NR | NR | NR |
Contact 2 : commutateur de pointe | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 0 |
Contact 2 : X,Y | X₁, Y₁ | X₂,Y₂ | X₃, Y₃ | X₄, Y₄ | X₅, Y₅ | X₆, Y₆ | X₇, Y₇ | X₈, Y₈ | X₉, Y₉ | X₁₀,Y₁₀ | X₁₀,Y₁₀ |
En référence à l’exemple décrit dans le diagramme précédent, supposons qu’un contact non capacitif soit placé sur un pavé tactile de précision Windows avec une force d’activation suffisante pour appeler un bouton vers le bas. Plus tard, à un certain moment, la force d’activation est réduite de telle sorte qu’elle appelle un bouton vers le haut. Cela serait signalé comme décrit dans le tableau suivant.
Rapport | 1 | 2 | 3 | 4 | 5 | 6 |
---|---|---|---|---|---|---|
Nombre de contacts | 0 | 0 | 0 | 0 | 0 | 0 |
Bouton | 1 | 1 | 1 | 1 | 1 | 0 |
Boutons 2 et 3 (clic gauche et droit discrets)
L’appareil pavé tactile de précision Windows prend en charge en mode natif les utilisations des boutons (clic gauche et clic droit) intégrés au numériseur, mais les boutons supplémentaires doivent être gérés par un pilote tiers.
Et si un appareil prend uniquement en charge les boutons externes, il doit toujours utiliser les boutons 2 et 3 pour référencer les boutons externes.
Si plusieurs boutons sont présents pour une utilisation avec le pavé tactile, des commutateurs de bouton supplémentaires doivent être déclarés dans le descripteur. Les boutons externes sont signalés au niveau du paquet comme les boutons du numériseur, mais il n’y a aucune exigence sur la coordination des boutons externes avec l’état contact.
Modes de rapports de paquets
Mode parallèle
En mode parallèle, les appareils signalent toutes les informations de contact dans un seul paquet. Chaque contact physique est représenté par une collection logique incorporée dans la collection de niveau supérieur. Cette collection logique contient toutes les utilisations que l’appareil prend en charge pour chaque contact. Lorsque vous utilisez le mode parallèle, chacune des collections logiques doit être identique. Étant donné que l’appareil signale généralement moins de contacts que la valeur maximale, le nombre de contacts signalés dans un paquet parallèle doit être communiqué via l’utilisation du Nombre de contacts.
Prenons l’exemple d’un appareil qui prend en charge trois contacts. Si l’utilisateur n’a que deux doigts sur le numériseur, le paquet parallèle n’aura que deux données de contact valides dans un rapport qui peut transporter des données pour trois contacts. Dans ce cas, le Nombre de contacts doit être défini sur 2 pour que l’application cliente sache que les informations sur plus de deux contacts ne sont pas valides.
L’inconvénient de signaler plusieurs contacts dans un même rapport est que de l’espace est gaspillé par rapport chaque fois qu’il y a moins de contacts que le nombre maximal de contacts possible. Les appareils peuvent utiliser le mode hybride pour réduire cette inefficacité.
Mode hybride
En mode hybride, le nombre de contacts pouvant être signalés dans un rapport est inférieur au nombre maximal de contacts pris en charge par l’appareil. Par exemple, un appareil qui prend en charge un maximum de 4 contacts physiques simultanés peut configurer sa collection de niveau supérieur pour fournir un maximum de 2 contacts dans un même rapport. Si 4 points de contact sont présents, l’appareil peut les décomposer en 2 rapports série qui fournissent chacun 2 contacts.
Lorsqu’un appareil fournit des données de cette manière, la valeur d’utilisation du Nombre de contacts dans le premier rapport doit refléter le nombre total de contacts remis dans les rapports hybrides. Les autres rapports de série doivent avoir un nombre de contacts de zéro (0).
Mode de création de rapports hybride avec un seul doigt
Le premier rapport d’entrée pour une image donnée indique le nombre total de contacts à signaler via l’utilisation du nombre de contacts. Tous les rapports d’entrée suivants pour la même image doivent avoir une valeur de zéro (0) pour l’utilisation du nombre de contacts, afin d’indiquer qu’ils font partie de la trame précédemment signalée. La durée d’analyse de tous les rapports d’une image donnée doit être identique.
Voici un tableau indiquant la séquence de rapports pour 2 contacts (en mode de création de rapports hybrides à doigt unique).
Rapport | 1 | 2 | 3 | 4 | 5 | 6 |
---|---|---|---|---|---|---|
Nombre de contacts | 2 | 0 | 2 | 0 | 2 | 0 |
Contact ID | 1 | 2 | 1 | 2 | 1 | 2 |
Contact 1 : X,Y | X₁, Y₁ | NR | X₂,Y₂ | NR | X₃, Y₃ | NR |
Contact 1 : commutateur de pointe | 1 | NR | 1 | NR | 1 | NR |
Contact 2 : X,Y | NR | X₁, Y₁ | NR | X₂,Y₂ | NR | X₃, Y₃ |
Commutateur de pointe contact 2 | NR | 1 | NR | 1 | NR | 1 |
Heure de l’analyse | T₁ | T₁ | T₂ | T₂ | T₃ | T₃ |
Les appareils de pavés tactiles de précision Windows connectés par USB et I²C peuvent fournir des rapports d’entrée en mode de création de rapports hybride à doigt unique ou en mode de création de rapports hybride à deux doigts.