compute_particles

compute_particles

English | 日本語

概要

ComputeParticleEmitterを使い、49,152個の粒子をGPUで生成・更新・描画するサンプルです。利用側のコードは発生位置、方向、速度、寿命を標準APIへ渡し、WGSLと粒子bufferの構築は標準クラスが担当します。粒子の位置・速度・寿命はGPU上のstorage bufferで更新され、同じbufferがbillboard描画に使われます。

fountainは一つの発生要求から上向きの粒子群を作り、ringは24個の発生要求を円周上へ配置します。どちらもComputeParticleEmitterの同じAPIで構成しています。発光色は線形HDRで加算合成されます。

実行方法

HTTPサーバー経由でcompute_particles.htmlを開いてください。WebGPUに対応したブラウザが必要です。

使用しているwebg機能

操作方法

実装の要点

main.jsはComputeParticleEmitterを次の設定で生成します。

const emitter = new ComputeParticleEmitter(screen.getGPU(), {
  capacity: 49152,
  preset: "spark",
  targetFormat: screen.getGPU().format,
  overflow: "replace-oldest",
  simulation: { gravity: [0, -0.70, 0], drag: 0.05 },
  appearance: {
    colors: [[1.0, 0.28, 0.04], [0.04, 0.46, 1.0]],
    intensity: 1.26,
    size: [0.006, 0.018]
  }
});

fountainは1件の要求、ringは24件の要求としてemit()を呼びます。1件の要求にはposition、direction、spreadAngle、speed、lifetimeを指定します。発生要求とカメラ・時間はuniformへまとめて転送され、粒子の初期値生成と移動はCompute Shaderが行います。

targetFormatは、このサンプルのようにCanvasへ直接描画するときのswapchain formatです。PBRシーンへ登録する場合は、WebgSceneApp.createComputeParticleEmitter()がHDR中間画像とComputeParticlePassを用意します。

表示中のestimatedは最大寿命からCPUが管理する予約数の推定値です。通常の描画では粒子位置をGPU上で直接参照し、容量と発生要求はCPUが管理する予約数から確認できます。

確認ポイント