webg

はじめに

本章では、webgで3Dアプリケーションを作るときに利用できる機能と、目的に応じた本書の読み進め方を説明します。 webg 3.0で加わった物理ベースレンダリング(PBR:Physically Based Rendering)、手続きテクスチャと手続きマテリアル、Compute版物理エンジン、コンピュートエフェクトも、シーン、カメラ、アセット、入力、UI、診断と共通のアプリケーション基盤から利用できます。 まず全体像を把握し、作りたい機能に対応する章と利用するAPIを選べるようになることが本章の目標です。

アプリを作り始めるときは、開発の入口と実行例(book/examples/guide.html)を参照してください。このページは、作りたいアプリに合うサンプルを選ぶための案内です。最初に動かす例、読むコード、機能を追加する順序、表示や操作の確認ポイントをまとめています。人間もAIも、この案内から同じ実行例へ進めます。AIが文書を読む場合は、Markdown版の開発の入口と実行例も利用できます。

PBRの表示から移動・選択・粒子を持つゲームへ進む場合は、 PBRシーンから小さなゲームへ.mdとsamples/fantasy/を読みます。 補足のブラウザ版は、読む関数と小さな変更実験を案内します。

PBRへ水面の反射・屈折やコースティクスを加える場合は、35章と samples/water/index.htmlから始めます。水中ゲームの照明演出は samples/fantasy/で、動く部隊への適用とON/OFF後の操作を確認できます。

統合版を使う場合は、02章の「統合版を読み込む」から始めてください。 04章には個別モジュール版と同じ例のimportの置き換えがあり、 付録C_統合版の利用.mdにはサンプル変換の手順があります。 lib/webg.core.min.jsを利用する場合も、本書のクラスとメソッドの説明を使えます。

この章の読み方

この章を読む前に必要な知識

JavaScriptの基本文法と、ブラウザでHTMLを実行する基本操作を知っていると読みやすくなります。

初回に読む範囲

webgの全体像、標準アプリ構成、目的別の読書案内を読み、API(Application Programming Interface:プログラムから機能を呼び出すための接続方法)より先に機能の配置を把握してください。

必要になったときに読む範囲

物理ベースレンダリング(PBR)、コンピュートシェーダー、物理エンジン、低水準APIは、実際に必要になったときに該当部を参照してください。

この章を終えた時点でできること

webgの機能範囲を把握し、標準描画、物理ベースレンダリング(PBR)、物理、GPU(Graphics Processing Unit:画像処理装置)計算のどこから学ぶか判断できます。

webgの全体像

webg version 3.0は、対応ブラウザ上で3Dアプリケーションを構築するためのJavaScriptライブラリです。ここでいうAPI(Application Programming Interface)は、アプリケーションからライブラリの機能を呼び出すための公開されたメソッドやクラスの組み合わせを指します。 最小限の描画から始め、入力、音声、モデル、アニメーション、UI(User Interface:利用者との操作・表示の接点)、物理演算、画面効果へ段階的に機能を組み合わせられます。

本書では、計算によってColor、Height、Normalなどの画像を作る機能を「手続きテクスチャ」、それらの画像とPBR値、実寸UV(テクスチャ画像上の2次元座標)を一つにまとめた利用単位を「手続きマテリアル」と呼びます。 また、物理計算をGPU上で実行する版を「Compute版物理エンジン」と呼びます。 CPU(Central Processing Unit:中央処理装置)版とCompute版はbody、Collider、物理設定の基本的な意味を共有し、計算場所と描画状態の受け渡し方が異なります。

webg 3.0では、金属度と粗さに基づくPBR、HDR(High Dynamic Range:広い輝度範囲)環境マップを使うIBL(Image-Based Lighting:画像ベース照明)、透明物のPBRとTransmission、手続きマテリアル、Compute版物理エンジンを追加しました。 不透明物では表面情報をG-buffer(照明計算へ渡す画面単位の表面情報)へ保存してから照明を計算し、半透明物では画面の前後関係を保つため別の前方描画で合成します。 G-buffer、IBL、GGX(鏡面反射の分布を表す関数)、SSR(Screen Space Reflections:画面空間反射)、Transmissionなどの用語と、各処理を分ける理由はIII部とIV部で順に説明します。

一方、標準のフォワードレンダリング経路も重要です。 ここでいうフォワードレンダリング経路とは、普通に頂点シェーダーで形状の頂点を変換し、フラグメントシェーダーでマテリアルと照明を評価しながら、シーンをカラー描画先へ直接描く方式です。 先にG-bufferへ表面情報を蓄積する遅延レンダリング経路とは、照明を評価する段階が異なります。 どちらの経路を選ぶかは機能の多さだけで決めず、マテリアルと画面空間のエフェクトを共通データから評価する必要があるかで判断します。

JavaScript、WebGPU API、WebAudio APIを利用し、PCとスマートフォンの両方を対象にします。GPU(Graphics Processing Unit:画像処理装置)を利用できることがWebGPU実行の前提です。 入力、音声、GLB(glTF(3Dモデル交換形式)のバイナリ形式)アニメーション、パーティクル、DoF(Depth of Field:被写界深度)、フォグ、物理演算を扱えます。 コンピュートシェーダーを使うPBR G-buffer、SSAO(Screen Space Ambient Occlusion:画面空間で求める環境遮蔽)、シャドウマップ、SSR、トゥーン、輪郭抽出、手続きテクスチャも同じ設計へ接続します。 実行可否は、ブラウザ名に加えて、セキュアコンテキスト、navigator.gpu、必要なGPU機能、OSとGPUの組み合わせで確認します。

外部ライブラリや複雑なビルドツールを導入する必要はなく、実装に必要なコードと詳細な解説はすべて webg 自身に含まれています。 そのため、学習目的での利用はもちろん、AIを活用した効率的なアプリ開発にも適しています。 また、WebGPUによる3D開発で不可欠な座標計算やGPU制御といった低水準(低レイヤー)なプログラミングから、多くの機能が抽象化された WebgApp クラスによる高水準(高レイヤー)なプログラミングまで、柔軟に使い分けることが可能です。

circular_breaker

webg では、低水準と高水準の両方を扱えます。 学習の初期段階では、個別のメソッド名よりも、「どの用途に向いたライブラリか」「どの文書から読むか」「サンプルとunittestをどう使い分けるか」という学習の指針をつかみます。

本章では、webg の全体像、設計思想、プロジェクト内のファイル配置、そして学習のロードマップについて解説します。

webg が提供する価値と設計思想

WebGPUを用いた3D実装では、描画処理が完成した後、アプリケーションの規模が大きくなるにつれて、シーングラフ、アセット管理、カメラ制御、入力処理、診断情報、音声再生といった周辺機能が必要になります。 特にAIと共同で実装を進める場合、「どの機能がどこに定義されているか」「現在の挙動を理解するために何を読めばよいか」が曖昧であると、調査や修正の効率が著しく低下します。

webg はこの問題を解決するため、3Dアプリケーションを構成する各レイヤーをリポジトリ内で明確に分離し、サンプルコードと解説文書を対にして読める構造を採用しています。 巨大なエンジンをブラックボックスとして利用するのではなく、プロジェクトに必要な部分を順に読み解き、組み上げていくスタイルを重視しています。

コンピュートシェーダーによる並列計算処理を使うと、GPU内部で状態を更新するシミュレーション、画面上の幾何学情報を利用したポストプロセス、HDR環境の事前積分、Color/Height/Normalを生成する手続きマテリアルを構築できます。 CPU基準、GPU生成、比較用の読み戻しを別の処理として分け、通常描画は不要な同期を避けた経路で実行します。

入力では、タッチ、マウス、ペンの操作をPointer Eventsへ集約します。 これにより、タップ、ダブルタップ、長押し、フリックなどのジェスチャーをPCブラウザ上でも同じ条件で確認できます。 3Dビューアや編集ツールに、機器をまたいだ直接操作を設計しやすくなります。

具体的に、webg は以下のような場面で真価を発揮します。

本書の構成

webgの特徴は、3Dの基礎からアプリケーション構成までが、一つのリポジトリで完結する点です。本書は、作り始めるための説明を先に置き、作品の機能を増やしたい読者が必要な章へ進み、さらに仕組みを知りたい読者が内部実装へ進める構成にしています。

第I部 作り始めるための基礎

02章でWebGPUを実行できる環境を整え、03章で位置、回転、親子座標、カメラの見え方、表面の法線とUVを学びます。04章から07章では、WebgAppで立方体を表示し、カメラ、更新処理、材質を加えてアプリケーションの基本構成を組み立てます。行列やクォータニオンの詳しい計算規則は、内部の仕組みを読む41章で確認できます。

第II部 アプリケーションを組み立てる

外部モデル、シーン、アニメーション、ユーザーインターフェース(UI)、入力、衝突判定、音声、診断情報を扱います。最初に08章から11章でアセットを読み込み、モデルやアニメーションを表示できる状態を作ります。その後、12章から17章で操作、表示、音声、診断を加え、作品として使えるアプリケーションへ発展させます。

第III部 シェーダーとコンピュート処理を理解する

第I部と第II部で使った描画を、シェーダーの側から詳しく読みます。18章と19章では、WGSL(WebGPU Shading Language:WebGPU用シェーディング言語)とカスタムシェーダーを学び、20章から22章ではコンピュートシェーダーの実行モデル、ストレージ資源、ワークグループ、同期、性能を学びます。必要になった機能の章から読み始めることもできます。

第IV部 表現を広げる

ブルーム、被写界深度、透明効果、パーティクル、物理エンジン、手続きテクスチャ、物理ベースレンダリング(PBR)、高度な画面効果を扱います。23章から26章で画面効果と軽量なエフェクトを追加し、27章と28章でCPU版のPhysicsSpaceとCompute版のComputePhysicsSpaceを使い分けます。29章から33章では、実寸の手続きマテリアル、環境光、PBR統合を学び、34章から36章では個別のコンピュートパスと高度な表現を組み合わせます。

第V部 内部の仕組みを読む

低水準API、Shape、プロシージャル形状、スキニング、描画内部の共通規則、物理エンジンの詳細設計を扱います。37章から40章では、公開APIの下で形状やアニメーションがどのように組み立てられるかを読み、41章で座標、深度、G-buffer、HDR、トーンマッピングなど複数の描画処理に共通する規則を整理します。42章では、物理エンジンの衝突判定、接触ソルバー、固定ステップ、安定化処理を詳しく説明します。

以前のwebgで作成したコードを移行する場合も、現行APIの説明から読み始められます。 版ごとの差分は付録B_webg_1.0・2.0から3.0への移行.mdにまとめています。通常章では、現行の深度、座標、PBRマテリアル、IBL、手続きテクスチャ、カメラフレーム、表示パスを基準に説明します。

付録AではコーディングAIを使ってwebgアプリケーションを作るときの読み方と依頼方法を説明します。APIの全項目を調べるときは、書籍とは別にリリースへ同梱される付録D_API一覧.mdを参照してください。

プロジェクトの構成

webg を読み解く際は、まずファイル配置と役割を把握してください。

webg で実現できること

webg は、WebGPU上で3Dアプリケーションを構築するための基盤を包括的に備えています。

コーディングAIに作ってもらう

この本と webg のリポジトリは、コーディング用のAI(コーディングエージェント)も読者として意識して設計されています。 人間にとっての読みやすさと、AIにとっての解析しやすさの両立を追求しています。

コーディングエージェントを使う場合は、webg をプロジェクトフォルダーとして読み込ませます。 次に、「book/開発の入口と実行例.mdとbook/付録A_コーディングAIの皆さまへ.mdを読み、目的に合う既存例を選んで、my_webgフォルダー以下にXXXXを作成して」と指示します。 一次資料と作成先を明示することで、アプリケーションを効率よく構築できます。

問題調査の考え方

3Dアプリケーションの開発では、単なるコンソール出力だけでなく、「なぜその結果になったか」を画面上で可視化して追跡することが重要です。 webg では、HUDやパネルに情報を表示し、必要に応じて診断情報レポートやプローブを出力する手法を標準としています。 後の章で解説する Diagnostics や DebugDock は、この「可視化によるデバッグ」という思想に基づいています。

まとめ

本章で最も重要な点は、webg version 3.0を単なるAPI集としてではなく、WebGPUの低水準な描画からWebgAppによる高水準な構成、PBRのマテリアル・光源・HDR環境、手続きテクスチャ、コンピュートシェーダーを使った空間表現の統合までを体系的に学べるフレームワークとして捉えることです。

まずは02章で環境を整え、03章で3D空間の基礎を学び、04章で最初の描画に挑戦してください。アプリケーションとして機能を増やすときは第II部へ、描画やGPU計算の仕組みに関心が生まれたときは第III部と第V部へ進んでください。 本書が、WebGPUを用いた3Dアプリケーション開発の地図として役立つことを願っています。