Basispermutation

Die Basis bildet die Zuordnung zwischen dem internen Koordinatensystem Haply und dem Ihrer Anwendung.

Haply

Haply ein rechtshändiges Koordinatensystem:

Achse	Richtung
+X	Richtig
+Y	Weiter
+Z	Nach oben

So funktioniert es

Eine Permutationszeichenfolge teilt dem Dienst mit, wie die Achsen Ihrer Anwendung aufHaply abgebildet werden. Sobald dies festgelegt ist, wird jeder vom Dienst zurückgegebene Wert (Positionen, Geschwindigkeiten, Kräfte, Orientierungen) in Ihrer Basis ausgedrückt, und jeder von Ihnen gesendete Wert wird in Ihrer Basis interpretiert. Die Umwandlung erfolgt automatisch und in beide Richtungen.

Die Zeichenfolge ist eine Permutation von X, Y, Z, optional mit dem Präfix + oder - um eine Achse zu negieren.

Beispiele

Permutation	Bedeutung	Typische Anwendung
XYZ	Identität – keine Neuzuordnung	Haply Apps
XZY	Y und Z vertauschen → dein +Y ist oben	Y-Up-Motoren
X-YZ	Y negieren → linkshändig, Z nach oben	Unreal Engine
ZXY	Alle drei Achsen durchlaufen	Individuell angefertigter Rahmen

Übersetzung

"YZX" bedeutet:

• Deine X -Achse = Haply Y-Achse (vorwärts)
• Deine Y -Achse = Haply Z-Achse (nach oben)
• Deine Z-Achse = Haply X-Achse (rechts)

Die Grundlagen schaffen

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"}'

Die Basis ist persistent – wird sie einmal bei der ersten Nachricht festgelegt, bleibt sie aktiv, bis sie geändert wird oder die Sitzung endet.

Migration von session.set_basis

Die Konvention für die Achsenbezeichnungen hat sich zwischen den älteren Versionen geändert session.set_basis und session.configure.basis. Eine Permutation, die unter dem alten Befehl funktionierte, kann unter dem neuen Befehl eine umgekehrte Transformation ergeben. Kehren Sie die Vorzeichen der Achsen bei Bedarf um (z. B. X-ZY wird XZ-Y). Siehe die Abschreibungshinweis Weitere Informationen finden Sie hier.