その他の機能

プリミティブ

3Dモデルファイルを用意しなくても、簡単な形のオブジェクト （プリミティブ）をすぐに表示できます。

• a3.Box — 直方体。数値を渡すと幅・高さ・奥行き、文字列を渡すと 色（CSSカラー文字列）を指定できます。
• a3.Sphere — 球体。数値を渡すと半径・水平セグメント数・ 垂直セグメント数、文字列を渡すと色を指定できます。

const box1 = new a3.Box();                 // 1×1×1の灰色の箱
const box2 = new a3.Box(2,1,1,'red');      // 幅2の赤い箱
const ball1 = new a3.Sphere();             // 半径1の灰色の球
const ball2 = new a3.Sphere(0.5,'blue');   // 半径0.5の青い球

このほか、three.jsのObject3Dをそのまま表示できる a3.ThreeObjectもあります。three.jsの機能をフルに使いたいときに 便利です。

Text3Dクラス

3D空間に立体的な文字を表示するクラスです。

ImagePlaneクラス

3D空間に画像を表示するクラスです。

CarControlクラス

本格的な車の物理シミュレーションを行うクラスです。

Scene.setPhysicsDebugMode()

物理演算のデバッグ表示を有効にすると、コライダー（衝突判定の形状）の 輪郭線が3D空間に表示されます。「当たっているはずなのに当たらない」 「なぜか弾き飛ばされる」といった物理演算のトラブルの原因調査に とても役立ちます。

view.scene.setPhysicsDebugMode(true);

StandardLights.setDebugMode()

StandardLightsクラスのデバッグ表示を 有効にすると、影の計算に使われるライトのカメラ（シャドーカメラ）の 範囲が直方体で表示されます。「影が途中で切れる」「影が出ない」 といったトラブルの原因調査に役立ちます。影については 影を表示する方法を参照してください。

light.setDebugMode(true);

ObjectA3.add()

オブジェクトにはadd()で別のオブジェクトを子として取り付けられ ます。子の位置・回転は親からの相対になり、親を動かすと子も 一緒に動きます。ロボットアームのような多関節の構造や、 キャラクターへのアイテムの持たせなどに使えます。 取り外すときはremove()です。

以下はプリミティブをadd()でつないだ2関節のアームのサンプルです。

import * as a3 from 'a3js';

const view = new a3.Window(600,300);
view.camera.setPosition(0,0,6);

// 赤い箱(腕1)をシーンに追加
const arm1 = new a3.Box(0.3,2,0.3,'red');
view.scene.add(arm1);
// 青い箱(腕2)をarm1の子として取り付ける
const arm2 = new a3.Box(0.3,2,0.3,'blue');
arm1.add(arm2);
arm2.setPosition(0,1,0);
// 緑の球をarm2の子として取り付ける
const ball = new a3.Sphere(0.3,'green');
arm2.add(ball);
ball.setPosition(0,1,0);

let t = 0;
while (true) {
  await view.waitForRender();
  t += 1;
  arm1.setRotation(0,0,t);   // 親が回ると子もついてくる
  arm2.setRotation(0,0,2*t); // 子の回転は親からの相対
}