Permutation de base

La correspondance de base entre le système de coordonnées interne Haply et celui de votre application.

Cadre Haply

Haply un système de coordonnées de type « droitier »:

Axis	Direction
+X	À droite
+Y	Suivant
+Z	Haut

Comment ça marche

Une chaîne de permutation indique au service comment les axes de votre application sont mis en correspondance avec Haply. Une fois cette configuration effectuée, chaque valeur renvoyée par le service (positions, vitesses, forces, orientations) est exprimée dans votre système de référence, et chaque valeur que vous envoyez est interprétée dans votre système de référence. La conversion est automatique et bidirectionnelle.

La chaîne est une permutation de X, Y, Z, éventuellement précédé de + ou - pour annuler un axe.

Exemples

Permutation	Signification	Utilisation courante
XYZ	Identité — pas de remappage	Applications Haply
XZY	Échangez Y et Z → votre +Y est en haut	Moteurs Y-up
X-YZ	Inverser Y → Z vers le haut (rotation à gauche)	Unreal Engine
ZXY	Faire défiler les trois axes	Cadre sur mesure

Interprétation

"YZX" signifie :

• Votre axe X = l'axe Y Haply(vers l'avant)
• Votre axe Y = l'axe Z Haply(vers le haut)
• Votre axe Z = l'axe X Haply(à droite)

Poser les bases

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 base est persistante: une fois définie lors du premier message, elle reste active jusqu'à ce qu'elle soit modifiée ou que la session prenne fin.

Migration depuis session.set_basis

La convention relative aux signes des axes a changé entre l'ancienne version session.set_basis et session.configure.basis. Une permutation qui fonctionnait avec l'ancienne commande peut donner lieu à une transformation inversée avec la nouvelle. Inversez les signes des axes si nécessaire (par exemple, X-ZY devient XZ-Y). Voir le Note de dépréciation pour plus de détails.