Permutation de base (Basis Permutation)

Le moteur assure la mise en correspondance entre le système de coordonnées interne de Haply et celui de l'application utilisateur.

Haply Cadre de base

Haply utilise un système de coordonnées droitier:

axe	Direction
+X	à droite
+Y	à l'avant
+Z	en haut

Principe de fonctionnement

La chaîne de permutation indique au service comment les axes de l'application correspondent aux axes de Haply. Une fois cette option configurée, toutes les valeurs renvoyées par le service(position, vitesse, force, direction) sont exprimées dans le système de référence de l'utilisateur, et toutes les valeurs transmises par l'utilisateursont interprétées par rapport à ce système de référence. La conversion s'effectue automatiquement et fonctionne dans les deux sens.

Cette chaîne de caractères est X, Y, ZIl s'agit d'une permutation ; pour inverser l'axe, on peut, si on le souhaite, + ou bien - Vous pouvez ajouter un préfixe.

Exemple

Permutation	Signification	Utilisations courantes
XYZ	Identité — pas de remappage	Haply Application native
XZY	Échange entre Y et Z → le +Y de l'utilisateur se trouve en haut	Moteur Y-up
X-YZ	Inversion Y → Z-up à gauche	Unreal Engine
ZXY	Faire le tour des trois axes	Cadre personnalisé

Interprétation

"YZX"signifie :

• Axe X de l'utilisateur = axe Y de Haply (à l'avant)
• Axe Y de l'utilisateur = axe Z de Haply (en haut)
• Axe Z de l'utilisateur = axe X de Haply (à droite)

Paramètres de base

WebSocket

{
  "session": {
    "configure": {
      "basis": { "permutation": "XZY" }
    }
  }
}

HTTP

curl -X POST "http://localhost:10001/inverse3/0/config/basis?session=:0" \
     -H "Content-Type: application/json" \
     -d '{"permutation": "XZY"}'

La valeur par défaut est conservée de manière permanente. Une fois définie dans le premier message, elle ne peut plus être modifiée et reste active jusqu'à la fin de la session.

session.set_basisMigration depuis

Les règles de signe des axes sont obsolètes session.set_basisWa session.configure.basis A été modifié. Une permutation qui fonctionnait avec la commande précédente peut produire une transformation inversée avec la nouvelle commande. Si nécessaire, inversez le signe de l'axe (par exemple : X-ZYest XZ-Y(devient). Pour plus d'informations, 3.5 Guide de migrationVeuillez consulter [...].