Three.js 基礎学習⑥|GLB・GLTFモデルの読み込み方を理解する
目次
1. 今回学ぶこと
これまでの学習では、Three.jsのGeometryを使って立方体や球体などの3Dオブジェクトを作成してきました。
しかし、実際のWebサイトでは、もっと複雑な3Dモデルを使用することがあります。
例えば、次のようなものです。
- 人物やキャラクター
- 建物や家具
- 車や機械
- 商品モデル
- 自然物や植物
- Webサイトの背景に配置する3Dオブジェクト
このようなモデルを表示する場合、Blenderなどの3Dソフトで制作したモデルを読み込む方法が便利です。
今回は、次の内容を学びます。
- GLTF・GLBとは何か
- GLTFLoaderとは何か
- 3Dモデルの読み込み方法
- モデルの位置・大きさ・回転の調整
- モデルのアニメーション再生
- BlenderからThree.jsへのモデルの受け渡し
2. GLTF・GLBとは?
GLTF(GL Transmission Format)は、3Dモデルを保存・受け渡しするためのファイル形式です。
Web上で3Dモデルを扱うことを想定して設計されており、Three.jsでも利用できます。
GLTFには、主に次の2種類があります。
GLTF形式(.gltf)
GLTF形式は、3Dモデルの情報をJSON形式で記述したファイルです。
モデルの形状やマテリアル、アニメーションなどの情報を管理します。
ただし、テクスチャ画像や形状データなどが別ファイルになっている場合があります。
例えば、次のような構成です。
1//text
2
3model/
4
5├── model.gltf
6
7├── model.bin
8
9└── textures/
10
11 ├── color.jpg
12
13 └── normal.jpg
それぞれの役割は次のとおりです。
- model.gltf:モデルの構造や設定情報
- model.bin:頂点や形状などのデータ
- textures:モデルに使用する画像データ
GLB形式(.glb)
GLB形式は、GLTFの情報を1つのバイナリファイルにまとめた形式です。
1//text
2
3model/
4
5└── model.glb
GLTFと異なり、モデルの情報やテクスチャなどを1つのファイルにまとめられるため、管理しやすいという特徴があります。
GLTFとGLBの違い
| 項目 | GLTF | GLB |
|---|---|---|
| ファイル形式 | JSON形式 | バイナリ形式 |
| 拡張子 | .gltf | .glb |
| ファイル構成 | 複数になる場合がある | 1つにまとめられる |
| テクスチャ | 別ファイルの場合がある | 内包できる |
| 管理のしやすさ | ファイルが複数になる場合がある | 比較的管理しやすい |
Webサイトで3Dモデルを扱う場合は、GLB形式が便利です。
3. GLTFLoaderとは?
Three.jsには、GLTF・GLB形式の3Dモデルを読み込むためのGLTFLoaderという機能があります。
通常のGeometryとMaterialを使ったオブジェクトとは異なり、GLTFLoaderを利用すると、外部ファイルに保存されている3Dモデルを読み込めます。
GLTFLoaderをインポートする
まず、JavaScriptでGLTFLoaderを読み込みます。
1//js
2
3import { GLTFLoader } from
4
5 "https://cdn.jsdelivr.net/npm/three@0.170.0/examples/jsm/loaders/GLTFLoader.js";
このコードによって、GLTFLoaderを利用できるようになります。
GLTFLoaderのインスタンスを作成する
1//js
2
3const loader = new GLTFLoader();
`new GLTFLoader()`によって、モデルを読み込むためのインスタンスを作成します。
load()でモデルを読み込む
1//js
2
3loader.load(
4
5 "./models/model.glb",
6
7
8
9 function (gltf) {
10
11
12
13 scene.add(gltf.scene);
14
15
16
17 }
18
19
20
21);
このコードでは、GLBファイルを読み込んでSceneに追加しています。
load()の基本構造
1//js
2
3loader.load(
4
5 URL,
6
7 onLoad,
8
9 onProgress,
10
11 onError
12
13);
それぞれの役割は次のとおりです。
- URL:読み込む3Dモデルの場所
- onLoad:読み込みが成功したときの処理
- onProgress:読み込みの進行状況を確認する処理
- onError:読み込みに失敗したときの処理
onProgressとonErrorは省略することもできます。
4. GLBモデルを読み込んで表示する
実際にGLB形式のモデルを読み込んでみましょう。
今回は、Three.jsの公式サンプルで公開されているロボットモデルを使用します。
フォルダ構成
まず、次のようにファイルを用意します。
1//text
2
3threejs-practice06/
4
5├── index.html
6
7└── main.js
今回は、外部のGLBファイルをURLから読み込むため、モデルファイルを自分のフォルダに用意する必要はありません。
HTML
html
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/three@0.170.0/build/three.module.js"
}
}
JavaScript(main.js)
1//js
2
3import * as THREE from "three";
4
5
6
7import { GLTFLoader } from
8
9 "https://cdn.jsdelivr.net/npm/three@0.170.0/examples/jsm/loaders/GLTFLoader.js";
10
11
12
13// Scene
14
15const scene = new THREE.Scene();
16
17
18
19scene.background = new THREE.Color(0x111318);
20
21
22
23// Camera
24
25const camera = new THREE.PerspectiveCamera(
26
27 45,
28
29 window.innerWidth / window.innerHeight,
30
31 0.1,
32
33 100
34
35);
36
37
38
39camera.position.set(0, 1, 5);
40
41
42
43// Renderer
44
45const renderer = new THREE.WebGLRenderer({
46
47 antialias: true
48
49});
50
51
52
53renderer.setSize(
54
55 window.innerWidth,
56
57 window.innerHeight
58
59);
60
61
62
63renderer.setPixelRatio(
64
65 Math.min(window.devicePixelRatio, 2)
66
67);
68
69
70
71document.body.appendChild(renderer.domElement);
72
73
74
75// Light
76
77const ambientLight = new THREE.AmbientLight(
78
79 0xffffff,
80
81 2
82
83);
84
85
86
87scene.add(ambientLight);
88
89
90
91const directionalLight = new THREE.DirectionalLight(
92
93 0xffffff,
94
95 3
96
97);
98
99
100
101directionalLight.position.set(3, 5, 5);
102
103
104
105scene.add(directionalLight);
106
107
108
109// GLTFLoader
110
111const loader = new GLTFLoader();
112
113
114
115// Model
116
117let model = null;
118
119
120
121loader.load(
122
123 "https://threejs.org/examples/models/gltf/RobotExpressive/RobotExpressive.glb",
124
125
126
127 function (gltf) {
128
129
130
131 model = gltf.scene;
132
133
134
135 model.scale.set(0.8, 0.8, 0.8);
136
137
138
139 model.position.set(0, -1, 0);
140
141
142
143 scene.add(model);
144
145
146
147 },
148
149
150
151 function (progress) {
152
153
154
155 console.log(
156
157 "読み込み進行状況:",
158
159 progress.loaded / progress.total * 100,
160
161 "%"
162
163 );
164
165
166
167 },
168
169
170
171 function (error) {
172
173
174
175 console.error("モデルの読み込みに失敗しました:", error);
176
177
178
179 }
180
181
182
183);
184
185
186
187// Animation
188
189function animate() {
190
191
192
193 requestAnimationFrame(animate);
194
195
196
197 if (model) {
198
199 model.rotation.y += 0.005;
200
201 }
202
203
204
205 renderer.render(scene, camera);
206
207
208
209}
210
211
212
213animate();
214
215
216
217// Window Resize
218
219window.addEventListener("resize", () => {
220
221
222
223 camera.aspect = window.innerWidth / window.innerHeight;
224
225
226
227 camera.updateProjectionMatrix();
228
229
230
231 renderer.setSize(
232
233 window.innerWidth,
234
235 window.innerHeight
236
237 );
238
239
240
241 renderer.setPixelRatio(
242
243 Math.min(window.devicePixelRatio, 2)
244
245 );
246
247
248
249});
コードの重要ポイント
**① GLTFLoaderを読み込む**
1//js
2
3import { GLTFLoader } from
4
5 "https://cdn.jsdelivr.net/npm/three@0.170.0/examples/jsm/loaders/GLTFLoader.js";
GLTFLoaderをインポートしています。
これによって、GLBやGLTF形式のモデルを読み込めるようになります。
**② GLTFLoaderを作成する**
1//js
2
3const loader = new GLTFLoader();
モデルを読み込むためのインスタンスを作成しています。
**③ モデルを読み込む**
1//js
2
3loader.load(
4
5 "https://threejs.org/examples/models/gltf/RobotExpressive/RobotExpressive.glb",
6
7
8
9 function (gltf) {
10
11
12
13 model = gltf.scene;
14
15
16
17 scene.add(model);
18
19
20
21 }
22
23
24
25);
GLBファイルを読み込み、成功したらSceneに追加しています。
**④ gltf.sceneとは?**
1//js
2
3model = gltf.scene;
GLTFLoaderで読み込んだモデルの中から、シーンの情報を取得しています。
`gltf.scene`には、モデルの形状やMaterial、階層構造などが含まれています。
そのため、通常のGeometryを作成する必要はありません。
**⑤ 読み込み後にサイズや位置を変更する**
1//js
2
3model.scale.set(0.8, 0.8, 0.8);
4
5model.position.set(0, -1, 0);
読み込んだモデルも、通常のMeshと同じようにposition・rotation・scaleを利用できます。
5. GLBモデルのアニメーションを再生する
GLB形式のファイルには、3Dモデルだけでなく、アニメーション情報が含まれている場合があります。
例えば、次のような動きです。
- 人物の歩行
- キャラクターの走行
- 手を振る動作
- 機械の可動部分
- 商品の回転
Three.jsでは、AnimationMixerを使って、これらのアニメーションを再生できます。
AnimationMixerとは?
AnimationMixerは、3Dモデルに含まれるアニメーションを管理・再生するための機能です。
簡単にいうと、モデルの動きを制御するための仕組みです。
基本構造のコード
1//js
2
3let mixer;
4
5loader.load(
6
7 "./models/model.glb",
8
9 function (gltf) {
10
11 const model = gltf.scene;
12
13 scene.add(model);
14
15 mixer = new THREE.AnimationMixer(model);
16
17 const action = mixer.clipAction(
18
19 gltf.animations[0]
20
21 );
22
23 action.play();
24
25 }
26
27);
コードの解説
**① AnimationMixerを作成する**
1//js
2
3mixer = new THREE.AnimationMixer(model);
読み込んだモデルのアニメーションを管理するMixerを作成しています。
**② アニメーションを取得する**
1//js
2
3const action = mixer.clipAction(
4
5 gltf.animations[0]
6
7);
`gltf.animations`には、モデルに含まれるアニメーションが配列として格納されています。
`[0]`は、最初のアニメーションを取得するという意味です。
**③ アニメーションを再生する**
1//js
2
3action.play();
取得したアニメーションを再生します。
アニメーションを更新する
AnimationMixerは、作成しただけでは時間が進みません。
そのため、animate関数の中で時間を更新する必要があります。
1//js
2
3const clock = new THREE.Clock();
4
5
6
7function animate() {
8
9
10
11 requestAnimationFrame(animate);
12
13
14
15 const deltaTime = clock.getDelta();
16
17
18
19 if (mixer) {
20
21 mixer.update(deltaTime);
22
23 }
24
25
26
27 renderer.render(scene, camera);
28
29
30
31}
32
33
34
35animate();
`mixer.update(deltaTime)`によって、前回の描画から経過した時間分だけアニメーションを進めています。
アニメーションを切り替える
複数のアニメーションが含まれているモデルでは、次のように切り替えられます。
1//js
2
3const idleAction = mixer.clipAction(
4
5 gltf.animations[0]
6
7);
8
9
10
11const walkAction = mixer.clipAction(
12
13 gltf.animations[1]
14
15);
16
17
18
19idleAction.play();
20
21
22
23walkAction.play();
ただし、このまま両方を再生すると、アニメーションが同時に作用する場合があります。
実際に切り替える場合は、現在のアニメーションを停止したり、fadeIn・fadeOutを使って滑らかに切り替えたりします。
6. Blenderで制作したモデルを読み込む
ここからは、BlenderとThree.jsの連携について学びます。
Blenderは、3Dモデルの制作やアニメーション制作ができるソフトウェアです。
Blenderで制作したモデルをGLB形式で書き出すことで、Three.jsに読み込めるようになります。
BlenderからGLBを書き出す
基本的な流れは次のとおりです。
- 1. Blenderで3Dモデルを制作する
- 2. モデルの位置・回転・大きさを調整する
- 3. Materialやテクスチャを設定する
- 4. 必要に応じてアニメーションを制作する
- 5. GLB形式でエクスポートする
- 6. Three.jsでGLBを読み込む
Blenderのエクスポート方法
Blenderの画面上部から、次の操作を行います。
1//text
2
3File
4
5 ↓
6
7Export
8
9 ↓
10
11glTF 2.0 (.glb/.gltf)
エクスポート画面で、フォーマットをGLB形式に設定します。
その後、保存先を指定してエクスポートします。
Three.js側のフォルダ構成
書き出したモデルをプロジェクト内に配置します。
1//text
2
3threejs-project/
4
5├── index.html
6
7├── main.js
8
9└── models/
10
11 └── my-model.glb
ローカルモデルを読み込む
//js
loader.load(
“./models/my-model.glb”,
function (gltf) {
const model = gltf.scene;
scene.add(model);
}
);
これで、Blenderで制作したモデルをThree.jsに表示できます。
※ローカルファイルを読み込む場合も、VS CodeのLive Serverなどを使ってHTTP経由で表示してください。HTMLファイルを直接開く方法では、モジュールやモデルの読み込みが制限されることがあります。
7. モデルの読み込みで気をつけること
GLBモデルを読み込む際には、いくつか注意点があります。
① モデルのサイズ
Blenderで制作したモデルとThree.jsの座標のスケールが合わない場合があります。
その場合は、次のように調整します。
1//js
2
3model.scale.set(0.5, 0.5, 0.5);
モデル全体を半分の大きさにしています。
② モデルの位置
1//js
2
3model.position.set(0, -1, 0);
モデルがカメラの外に表示されたり、床に埋まったりする場合は、positionを調整します。
③ モデルの向き
1//js
2
3model.rotation.y = Math.PI;
Y軸を中心に180度回転させています。
④ 読み込みエラー
モデルが表示されない場合は、次の点を確認します。
- GLBファイルのURLが正しいか
- ファイルが正常に書き出されているか
- ブラウザの開発者ツールにエラーが出ていないか
- 外部サイトから読み込む場合、アクセスが許可されているか
- モデルがカメラの視野内にあるか
⑤ ファイルサイズ
高解像度のテクスチャや複雑なモデルは、ファイルサイズが大きくなる場合があります。
Webサイトで使用する場合は、モデルのポリゴン数やテクスチャサイズを調整し、読み込み時間を短縮することも重要です。
8. 今回のまとめ
今回学んだ内容を整理します。
| 要素 | 役割 |
|---|---|
| GLTF | 3Dモデルを保存する形式 |
| GLB | 3Dモデルの情報をまとめたバイナリ形式 |
| GLTFLoader | GLTF・GLBを読み込む機能 |
| gltf.scene | 読み込んだモデルのシーン |
| AnimationMixer | モデルのアニメーションを管理する機能 |
| clipAction() | アニメーションを操作するためのアクションを取得 |
| mixer.update() | アニメーションの時間を進める |
これまでの学習では、GeometryやMaterialをコードで作成していました。
しかし、GLTFLoaderを利用することで、Blenderなどで制作した複雑なモデルもWebサイトに表示できるようになります。
9. 練習課題
今回の内容を使って、実際にモデルを操作してみましょう。
**課題①:モデルの大きさを変更する**
1//js
2
3model.scale.set(1.5, 1.5, 1.5);
モデルを1.5倍に拡大してください。
**課題②:モデルの位置を変更する**
1//js
2
3model.position.set(2, 0, 0);
モデルを右方向に移動させてください。
**課題③:モデルを回転させる**
1//js
2
3model.rotation.y = Math.PI;
モデルを180度回転させてください。
**課題④:アニメーションを再生する**
GLBモデルにアニメーションが含まれている場合は、AnimationMixerを使って再生してみましょう。
**課題⑤:自分のGLBモデルを読み込む**
Blenderで簡単な立方体やオリジナルのオブジェクトを制作し、GLB形式で書き出してThree.jsに読み込んでみましょう。
**次回:Three.js 基礎学習⑦|マウス・スクロールとの連携**
次回は、マウス操作やスクロールに合わせて3Dモデルを動かす方法を学びます。
例えば、次のような演出です。
- マウスを動かすと3Dモデルが追従する
- スクロールするとモデルが回転する
- ページの進行に合わせてカメラが移動する
- スクロールに合わせて3Dモデルの位置や大きさが変化する
実際のWebサイトで使われるインタラクティブな3D表現につながる内容です。















