OrbitControlsで手軽にカメラを制御する
Three.jsにはカメラの動きを自動的に制御する THREE.OrbitControls クラスが存在します。
立体を中心にして周回軌道を描くように、カメラを配置するのが便利です。
導入方法
OrbitControls.jsは、Three.jsライブラリの本体に含まれていないので注意が必要です。公式GitHubのexamples/js/controlsフォルダーにJavaScriptファイルがあるので、これをscript要素で読み込みます。作業用フォルダーにOrbitControls.jsファイルをコピーしておきましょう。
<script src="js/controls/OrbitControls.js"></script>
使い方
THREE.OrbitControlsは次のような書式で利用します。THREE.OrbitControlsクラスのコンストラクターにカメラのインスタンスを指定します。これだけで、自動的にマウスと連動してインタラクションが効くようになります。
// カメラを作成
const camera = new THREE.PerspectiveCamera(/*省略*/);
// カメラの初期座標を設定
camera.position.set(0, 0, 1000);
// カメラコントローラーを作成
const controls = new THREE.OrbitControls(camera);
マウス操作で次のようにカメラを制御できます。
- オービット(周回軌道): 左ボタンでドラッグ
- ズーム: マウスホイール
- パン: 右ボタンでドラッグ
実行可能な最小のサンプルコードはこちらです。
// サイズを指定
const width = 960;
const height = 540;
// レンダラーを作成
const renderer = new THREE.WebGLRenderer({
canvas: document.querySelector('#myCanvas'),
});
renderer.setSize(width, height);
// シーンを作成
const scene = new THREE.Scene();
// カメラを作成
const camera = new THREE.PerspectiveCamera(45, width / height, 1, 10000);
camera.position.set(0, 0, 1000);
// カメラコントローラーを作成
const controls = new THREE.OrbitControls(camera);
// 形状とマテリアルからメッシュを作成します
const mesh = new THREE.Mesh(
new THREE.BoxGeometry(300, 300, 300),
new THREE.MeshNormalMaterial());
scene.add(mesh);
tick();
// 毎フレーム時に実行されるループイベントです
function tick() {
// レンダリング
renderer.render(scene, camera);
requestAnimationFrame(tick);
}

この続きはBasicプラン限定です