メインコンテンツまでスキップ

圧縮メッシュ

GLB ファイルのサイズの大部分は、多くの場合ジオメトリが占めています。ジオメトリを圧縮するとファイルを数分の一に小さくでき、ダウンロードが速くなります。その代わり、読み込み時にデコードが必要になります。

エンジンは、glTF の代表的な 2 つの圧縮方式のいずれかで圧縮された GLB および glTF ファイルを読み込めます。

方式glTF 拡張デコーダー
DracoKHR_draco_mesh_compressionDraco WebAssembly モジュール (Web Worker 上で実行)
meshoptEXT_meshopt_compression, KHR_meshopt_compressionmeshoptimizer デコーダーモジュール

どちらのデコーダーもエンジンには含まれていません。以下で説明するように、デコーダーのファイルをアプリケーションと一緒に配信し、その場所をエンジンに指定します。デコーダーなしで圧縮ファイルを読み込むと、読み込みに失敗します。

方式の選択​

どちらの方式もジオメトリを大幅に縮小しますが、仕組みが異なります。

  • Draco はメッシュプリミティブ (頂点位置、法線、テクスチャ座標などの属性とインデックス) を圧縮します。静的なジオメトリでは通常もっとも小さなファイルになりますが、デコードが比較的遅いため、エンジンは Web Worker 上でデコードします。Draco はアニメーションやモーフターゲットを圧縮しません。
  • meshopt は glTF のバッファビュー自体を圧縮するため、頂点属性、インデックス、アニメーションのキーフレーム、モーフターゲットなど、ファイル内のすべてのバイナリデータに適用されます。ファイルは通常 Draco よりやや大きくなりますが、デコードははるかに高速です。また、meshopt で圧縮したデータは、Web サーバーが適用する gzip や Brotli 圧縮でさらに小さくなります。

アニメーションやスキニングを含むモデルや、低速なデバイスでの読み込み時間が重要な場合は meshopt を、静的なジオメトリのダウンロードサイズを最小にしたい場合は Draco を選ぶとよいでしょう。

テクスチャはどちらの方式でも圧縮されません。テクスチャも圧縮するには、Basis テクスチャを使用してください。

Draco​

Draco ファイルの作成​

  • gltf-pipeline: gltf-pipeline -i model.glb -o model-draco.glb -d
  • glTF-Transform: gltf-transform draco model.glb model-draco.glb
  • Blender の glTF エクスポーターで Compression オプションを有効にする。
  • エディターはモデルのインポート時に Draco で圧縮できます。インポート設定のメッシュ圧縮を参照してください。

Draco ファイルの読み込み​

Draco デコーダーは、WebAssembly モジュールと JavaScript のグルースクリプトで構成されます。Draco のリリースからファイルを入手するか、エンジンのサンプルにあるファイル一式をコピーし、Draco 圧縮モデルを読み込む前にその URL をエンジンに設定します。

import { WasmModule } from 'playcanvas';

WasmModule.setConfig('DracoDecoderModule', {
glueUrl: 'lib/draco/draco.wasm.js',
wasmUrl: 'lib/draco/draco.wasm.wasm',
fallbackUrl: 'lib/draco/draco.js'
});

// 必要に応じて、モデルを読み込む前にデコーダーの読み込みを待つ
await new Promise((resolve) => {
WasmModule.getInstance('DracoDecoderModule', resolve);
});

または、dracoInitialize でデコーダーを直接設定することもできます。この方法では、並列にデコードする Worker の数も指定できます。

import { dracoInitialize } from 'playcanvas';

dracoInitialize({
jsUrl: 'lib/draco/draco.wasm.js',
wasmUrl: 'lib/draco/draco.wasm.wasm',
numWorkers: 2,
lazyInit: true // 最初の Draco メッシュが読み込まれるときに Worker を開始する
});

どちらも行わない場合、エンジンはページと同じ場所にある draco.wasm.js と draco.wasm.wasm を探します。

エディターでは、レンダリング設定の Draco Library ボタンでデコーダーをプロジェクトに追加すると、エンジンが自動的に設定されます。

動作するプロジェクトについては、Draco 圧縮 GLB の読み込みチュートリアルを参照してください。

Meshopt​

meshopt のサポートには Engine 2.24 以降が必要です。

Meshopt ファイルの作成​

  • gltfpack: gltfpack -i model.glb -o model-meshopt.glb -cc。-c オプションで圧縮し、-cc でさらに強く圧縮します。gltfpack は KHR_mesh_quantization で頂点データの量子化も行い、エンジンはこれに対応しています。
  • glTF-Transform: gltf-transform meshopt model.glb model-meshopt.glb

Meshopt ファイルの読み込み​

デコーダーは、meshoptimizer JavaScript パッケージの meshopt_decoder.mjs です。meshopt 圧縮モデルを読み込む前に、meshoptInitialize で初期化します。デコーダーモジュールの URL を渡すと、最初に meshopt 圧縮ファイルが読み込まれるときにエンジンがそのモジュールをインポートします。

import { meshoptInitialize } from 'playcanvas';

meshoptInitialize({ url: 'lib/meshopt/meshopt_decoder.mjs' });

アプリケーションをバンドルする場合は、meshoptimizer npm パッケージからデコーダーをインポートして渡すこともできます。

import { MeshoptDecoder } from 'meshoptimizer';
import { meshoptInitialize } from 'playcanvas';

meshoptInitialize({ decoder: MeshoptDecoder });

相対的な url は、ドキュメント内の他の URL と同様にページを基準に解決されます。KHR_meshopt_compression を使用するファイルには、meshoptimizer 1.0 以降のデコーダーが必要です。

デフォルトでは、デコーダーはメインスレッドで実行されます。ほとんどのモデルではこれで十分高速です。大きなファイルをメインスレッドをブロックせずにデコードするには、numWorkers を設定して Web Worker 上でデコードします。

meshoptInitialize({ url: 'lib/meshopt/meshopt_decoder.mjs', numWorkers: 2 });

デコーダーを初期化すれば、meshopt 圧縮モデルは他のモデルと同様に container アセットとして読み込めます。

import { Asset } from 'playcanvas';

const asset = new Asset('model', 'container', { url: 'models/model-meshopt.glb' });
asset.ready(() => {
const entity = asset.resource.instantiateRenderEntity();
app.root.addChild(entity);
});
app.assets.add(asset);
app.assets.load(asset);

デコーダーが初期化されていない場合、バッファビューが meshopt で圧縮されていることを示し、meshoptInitialize に言及するエラーで読み込みが失敗します。例外は、gltfpack の -cf で書き出したファイルのように、非圧縮のフォールバックデータも含むファイルです。デコーダーがない場合はエンジンがフォールバックデータを読み込み、デコーダーがある場合はフォールバックデータのダウンロードを省略します。