threejs-webgpu

WebGPU と TSL

プロジェクトにインストールされているバージョンと既存のアーキテクチャを使用してください。これらの指示はユーザーのタスクを補足するものであり、無関係な変更や外部アクションを許可するものではありません。

まず、インストールされている Three.js のエクスポートと、対応するレンダラー／TSL のドキュメントを確認してください。これらの API は急速に変化するため、現在のスニペットを古いインストール環境に混在させず、プロジェクトで固定されているリビジョンを使用してください。

必要な機能とバックエンドの制約を列挙してください。WebGPURenderer は、対応していれば WebGL バックエンドを使用できますが、バックエンドを選択しても、すべてのコンピュート機能やエフェクト機能が両方で動作するとは限りません。実際に選択されたバックエンドでテストしてください。要求された機能や移行の必要性がない限り、動作中の WebGLRenderer を置き換えないでください。

レンダリングや機能に依存するセットアップを行う前に、該当リビジョンで定められた非同期初期化の契約に従ってください。初期化の失敗や非対応デバイスに対して、明示的なフォールバック状態を用意してください。重複したクラス／モジュールインスタンスを避けるため、インポートをレンダラービルドと一貫させてください。

対応しているノード／TSL の仕組みを通じてマテリアルを表現してください。カスタム GLSL、シェーダーパッチ、コンポーザーエフェクトは意図的に移植してください。自動的に互換性が保たれるわけではありません。コンピュートでは、ストレージレイアウト、境界チェック、ディスパッチサイズ、同期、読み戻しの頻度を定義してください。データを GPU 上に保持できる場合は、フレームごとの CPU 読み戻しを避けてください。

現行 API に従って、コンピュートバッファー、レンダーターゲット、バックエンドのデバイスロストを管理してください。初期化失敗後にワークロードを際限なく再試行しないでください。

要求された WebGPU デバイス／ブラウザーと、約束されたフォールバックバックエンドで検証してください。バックエンドと機能の結果は分けて報告してください。ブラウザーで navigator.gpu が公開されていることは、このシーンが正常にレンダリングされた証拠にはなりません。

API リファレンス

正確なシグネチャとリビジョン固有の動作については、公式ドキュメントを参照してください。ドキュメントを参照できない場合は、インストールされている型定義／ソースを調べ、残る不確実性を明記してください。