Permutation de bases

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

Système de référence standard de Haply

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

Axe	Direction
+X	À droite
+Y	En avant
+Z	En haut

Voici comment cela fonctionne

Une chaîne de permutation indique au service comment les axes de votre application sont mis en correspondance avec ceux deHaply . Une fois définie , 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 s'effectue automatiquement et dans les deux sens.

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

Exemples

Permutation	Signification	Utilisation typique
XYZ	Identité — pas de reclassement	Haply- Applications natives
XZY	Échanger Y et Z → votre axe Y est orienté vers le haut	Y-up-Engines
X-YZ	Y negieren → Z-up pour gauchers	Unreal Engine
ZXY	Les trois axes tournent	Système de référence personnalisé

Interprétation

"YZX" signifie :

• Son axe X correspond à l'axe Y de Haply (en avant)
• Son axe Y correspond à l'axe Z de Haply (ci-dessus)
• Son axe Z correspond à l'axe X de Haply (à droite)

Définir la 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 base est persistante: vous la définissez une seule fois lors du premier message, et 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 la commande Legacy session.set_basis et session.configure.basis modifiée. Une permutation qui fonctionnait avec l'ancienne commande peut générer une transformation inversée avec la nouvelle commande. Inversez les signes des axes si nécessaire (par exemple, X-ZY zu XZ-Y). Vous trouverez plus de détails dans le Guide de migration vers la version 3.5.