Three.js 基礎学習①|Three.jsとは何か?基本構造を理解する
目次
## 1. Three.jsとは何か?
Three.js(スリードットジェイエス)とは、JavaScriptを使ってWebブラウザ上に3Dグラフィックスを表示・操作するためのライブラリです。
通常のWebサイトでは、HTMLでページの構造を作り、CSSでデザインを整え、JavaScriptで動きを付けます。
Three.jsを使用すると、これらに加えて、Webブラウザ上に3D空間を作り、立体的なオブジェクトやアニメーションを表現できるようになります。
例えば、次のような表現が可能です。
- 3Dモデルを画面上に表示する
- マウス操作に合わせてオブジェクトを回転させる
- スクロールに合わせてカメラを移動させる
- 光や影を使って立体感を演出する
- Blenderで制作した3DモデルをWebサイトに表示する
Three.jsは、商品紹介サイトやブランドサイト、大学の特設サイトなど、視覚的なインパクトを重視するWebサイトでも活用されています。
### HTML・CSS・JavaScriptとの違い
それぞれの役割を整理すると、次のようになります。
| 技術 | 主な役割 |
|---|---|
| HTML | Webページの構造を作る |
| CSS | 色・レイアウト・デザインを整える |
| JavaScript | 動作や機能を実装する |
| Three.js | JavaScriptを使って3D表現を実装する |
Three.jsはJavaScriptをベースに動作するため、JavaScriptの知識があると理解しやすくなります。
## 2. Three.jsの基本構造
Three.jsで3D空間を作る際には、基本となる仕組みがあります。
特に重要なのが、次の5つです。
- 1. Scene(シーン)
- 2. Camera(カメラ)
- 3. Renderer(レンダラー)
- 4. Geometry(ジオメトリ)
- 5. Material(マテリアル)
それぞれの役割を理解しておきましょう。
### ① Scene(シーン)
Sceneとは、3Dオブジェクトやライトなどを配置するための3D空間そのものです。
現実世界に例えると、建物や家具などを配置する部屋やステージのようなものです。
Three.jsでは、`THREE.Scene()`を使って作成します。
1//javascript
2// 3D空間を作成
3const scene = new THREE.Scene();
このコードによって、3Dオブジェクトを配置するための空間が作られます。
### ② Camera(カメラ)
Cameraとは、3D空間をどの位置から、どのような範囲で見るかを決めるものです。
現実世界に例えると、写真や動画を撮影するカメラのような役割です。
Three.jsでは、主にPerspectiveCamera(パースペクティブカメラ)を使用します。
1//javascript
2// カメラを作成
3const camera = new THREE.PerspectiveCamera(
4 45,
5 window.innerWidth / window.innerHeight,
6 0.1,
7 100
8);
9
10// カメラの位置を設定
11camera.position.set(0, 0.5, 5);
PerspectiveCameraの引数は、次の4つです。
| 引数 | 意味 |
|---|---|
| 45 | 視野角(Field of View) |
| window.innerWidth / window.innerHeight | 画面の縦横比 |
| 0.1 | カメラに映す範囲の最小距離 |
| 100 | カメラに映す範囲の最大距離 |
視野角は、カメラがどれくらい広い範囲を映すかを表します。
また、`camera.position.set()`によって、カメラの位置を設定できます。
### ③ Renderer(レンダラー)
Rendererとは、3D空間の情報をブラウザ上に描画するための仕組みです。
SceneやCameraを用意しただけでは、3Dオブジェクトは画面に表示されません。
Rendererを使用して、3D空間を実際の画面に描画する必要があります。
1//javascript
2// Rendererを作成
3const renderer = new THREE.WebGLRenderer({
4 antialias: true
5});
6
7// 画面サイズを設定
8renderer.setSize(
9 window.innerWidth,
10 window.innerHeight
11);
12
13// HTMLにCanvasを追加
14document.body.appendChild(renderer.domElement);
15
16// 3D空間を描画
17renderer.render(scene, camera);
ここで登場する`antialias`は、オブジェクトの輪郭のギザギザを軽減するための設定です。
`renderer.domElement`は、Three.jsが描画に使用するCanvas要素です。
### ④ Geometry(ジオメトリ)
Geometryとは、3Dオブジェクトの形状を定義するものです。
例えば、立方体・球体・円柱・トーラスなど、さまざまな形状を作ることができます。
1//javascript
2// 立方体の形状を作成
3const geometry = new THREE.BoxGeometry(
4 1,
5 1,
6 1
7);
この場合、横・縦・奥行きがそれぞれ1の立方体が作られます。
Geometryは、あくまでもオブジェクトの形状を定義するものです。
色や金属感などの見た目は、別のMaterialで設定します。
### ⑤ Material(マテリアル)
Materialとは、3Dオブジェクトの表面の見た目や質感を設定するものです。
例えば、色・金属感・透明感・表面の粗さなどを設定できます。
1//javascript
2// マテリアルを作成
3const material = new THREE.MeshStandardMaterial({
4 color: 0xc5a779,
5 metalness: 0.7,
6 roughness: 0.3
7});
主な設定は次のとおりです。
| プロパティ | 意味 |
|---|---|
| color | オブジェクトの色 |
| metalness | 金属らしさ |
| roughness | 表面の粗さ |
`metalness`と`roughness`は、基本的に0〜1の範囲で設定します。
metalnessが高いほど金属らしい質感になり、roughnessが低いほど表面が滑らかで光沢のある見た目になります。
なお、MeshStandardMaterialは光の影響を受けるマテリアルなので、ライトの設定も重要になります。
## 3. GeometryとMaterialを組み合わせる
GeometryとMaterialを用意しただけでは、まだ3DオブジェクトとしてSceneに配置できません。
そこで使用するのが、Mesh(メッシュ)です。
Meshとは、GeometryとMaterialを組み合わせて、3Dオブジェクトを作る仕組みです。
### Meshの基本コード
1//javascript
2// 形状を作成
3const geometry = new THREE.BoxGeometry(1, 1, 1);
4
5// 質感を作成
6const material = new THREE.MeshStandardMaterial({
7 color: 0xc5a779
8});
9
10// 形状と質感を組み合わせる
11const cube = new THREE.Mesh(
12 geometry,
13 material
14);
15
16// 3D空間に追加
17scene.add(cube);
この処理によって、色が付いた立方体が3D空間に配置されます。
それぞれの役割は次のとおりです。
- Geometry:オブジェクトの形
- Material:オブジェクトの見た目
- Mesh:形状と見た目を組み合わせたもの
- Scene:オブジェクトを配置する空間
## 4. Three.jsの基本的な処理の流れ
ここまで学んだ内容を整理すると、Three.jsの基本的な処理は次の順番になります。
- 1. Sceneを作成する
- 2. Cameraを作成する
- 3. Rendererを作成する
- 4. Geometryを作成する
- 5. Materialを作成する
- 6. Meshで組み合わせる
- 7. Sceneに追加する
- 8. Rendererで描画する
この流れは、今後Three.jsで制作するときの基本になります。
## 5. 基本構造をまとめたサンプルコード
ここまで学んだ内容を組み合わせて、実際に立方体を表示するコードを作成してみましょう。
以下は、Three.jsの基本構造を一通り確認できるサンプルです。
1//javascript
2// ==============================
3// 1. Scene
4// ==============================
5
6const scene = new THREE.Scene();
7
8
9// ==============================
10// 2. Camera
11// ==============================
12
13const camera = new THREE.PerspectiveCamera(
14 45,
15 window.innerWidth / window.innerHeight,
16 0.1,
17 100
18);
19
20camera.position.set(0, 0, 5);
21
22
23// ==============================
24// 3. Renderer
25// ==============================
26
27const renderer = new THREE.WebGLRenderer({
28 antialias: true
29});
30
31renderer.setSize(
32 window.innerWidth,
33 window.innerHeight
34);
35
36document.body.appendChild(renderer.domElement);
37
38
39// ==============================
40// 4. Geometry
41// ==============================
42
43const geometry = new THREE.BoxGeometry(
44 1,
45 1,
46 1
47);
48
49
50// ==============================
51// 5. Material
52// ==============================
53
54const material = new THREE.MeshStandardMaterial({
55 color: 0xc5a779,
56 metalness: 0.7,
57 roughness: 0.3
58});
59
60
61// ==============================
62// 6. Mesh
63// ==============================
64
65const cube = new THREE.Mesh(
66 geometry,
67 material
68);
69
70scene.add(cube);
71
72
73// ==============================
74// 7. Light
75// ==============================
76
77const ambientLight = new THREE.AmbientLight(
78 0xffffff,
79 2
80);
81
82scene.add(ambientLight);
83
84const directionalLight = new THREE.DirectionalLight(
85 0xffffff,
86 3
87);
88
89directionalLight.position.set(3, 5, 5);
90
91scene.add(directionalLight);
92
93
94// ==============================
95// 8. Render
96// ==============================
97
98renderer.render(scene, camera);
※このサンプルは基本構造を理解するためのものです。アニメーションや画面サイズ変更への対応は、次回以降で学習します。
## 6. 今回のまとめ
Three.jsは、JavaScriptを使ってWebブラウザ上に3D空間を作り、オブジェクトやアニメーションを表現するためのライブラリです。
今回特に重要なのは、次の5つの役割です。
| 用語 | 覚えること |
|---|---|
| Scene | 3D空間を作る |
| Camera | 3D空間を見る視点 |
| Renderer | 画面に描画する |
| Geometry | 3Dオブジェクトの形状 |
| Material | 3Dオブジェクトの質感 |
また、GeometryとMaterialを組み合わせることでMeshが作られ、それをSceneに追加することで3D空間にオブジェクトを配置できます。
最初はすべてを暗記する必要はありません。それぞれの役割と処理の流れを理解することが大切です。
## 学習課題
今回の内容を理解できているか、次の課題に取り組んでみましょう。
### 課題1:用語の理解
次の5つの役割を、自分の言葉で説明してみましょう。
- Scene
- Camera
- Renderer
- Geometry
- Material
### 課題2:コードの変更
サンプルコードを実行して、次の変更を試してみましょう。
- 1. BoxGeometryをSphereGeometryに変更して球体を作る。
- 2. Materialのcolorを変更する。
- 3. Cameraの位置を変更する。
- 4. ライトの位置や明るさを変更する。
### 課題3:自分で説明する
「GeometryとMaterialは何が違うのか?」
この質問に、コードを見ずに答えられるようにしましょう。
**今回の到達目標:Three.jsの基本構造と、それぞれの役割を理解すること。**
次回は「Geometry・Material・Meshを理解する」をテーマに、さまざまな3D形状の作成や質感の設定について詳しく学習します。















