基底の順列

このベースは、Haply の内部座標系と、お客様のアプリケーションの座標系との間をマッピングします。

の標準座標系Haply

Haply 右利き座標系を使用しています：

軸	方向
+X	右
+Y	フォアヴァルト
+Z	上

仕組みはこうです

順列文字列は、アプリケーションの軸がHaply の軸にどのようにマッピングされるかをサービスに指定します。これを設定すると、サービスが返すすべての値（位置、速度、 力、向き）は、指定した基準系で表現され、送信するすべての値も 指定した基準系で解釈されます。変換は自動的に、双方向に行われます。

この文字列は、以下の要素の順列です。 X, Y, Z、必要に応じて、その前に + oder -、軸を否定するために。

例

順列	意味	代表的な用途
XYZ	アイデンティティ — 再割り当てなし	Haply-ネイティブアプリ
XZY	YとZを入れ替える → Y軸が上を向くようになります	Y-up-Engines
X-YZ	Yを否定 → 左利きのZ-up	アンリアルエンジン
ZXY	3つの軸すべてが回転する	ユーザー定義座標系

通訳

"YZX" の意味は：

• X軸は、Haply のY軸（前方）に相当します。
• そのY軸は、Haply （上図）のZ軸に対応しています。
• このZ軸は、Haply のX軸に相当します（右図）。

基準を設定する

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

このベースは永続的です。最初のメッセージで一度設定すれば、変更されるかセッションが終了するまで 有効なままとなります。

移行元： session.set_basis

軸の符号の規則は、Legacy コマンドの間で session.set_basis und session.configure.basis 変更されました。以前のコマンドでは正常に動作していた順列が、 新しいコマンドでは逆の変換を生成してしまう場合があります。必要に応じて、軸の符号を 反転させてください（例： X-ZY zu XZ-Y). 詳細は 3.5 向け移行ガイド.