PORTFOLIO & WEB DESIGN MEMORANDOM BLOG   
PORTFOLIO & WEB DESIGN MEMORANDOM BLOG   

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

Three.js Practice 06

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表現につながる内容です。

MILMONA   MILMONA   MILMONA   MILMONA   MILMONA   
MILMONA   MILMONA   MILMONA   MILMONA   MILMONA