falling_box
English | 日本語
概要
200体のBox落下シナリオをCPU版とCompute版で比較します。CPU版は通常のPhysicsSpaceを使い、Box/Plane接触にはCPUのBox接触処理を適用します。Compute版はコアのComputePhysicsSpaceを使用します。両方とも同じseed、初期配置、姿勢、角速度、重力、五つのPlane境界、fixed step、solver反復数、sleep条件で開始します。
実行方法
- CPU版 falling_box_cpu.html:
PhysicsNodeとPlaneColliderを通常のPhysicsSpaceへ登録します
- Compute版 falling_box_compute.html:
ComputePhysicsSpaceのGPU BodyStateとWGSL solverを使い、Boxをinstance描画します
どちらもWebGPU対応ブラウザで開いてください。起動時のHelp Panelは畳まれています。Hで展開するとframe間隔、GPU Render時間・負荷率、JavaScript時間・負荷率、active body数、sleeping body数、fixed step数を確認できます。
使用しているwebg機能
WebgApp: WebGPU、canvas、depth texture、camera、入力、Help Panel、frame計測を初期化するPhysicsSpace: CPU版のfixed step、Box/Plane接触、摩擦、反発、position correction、persistent sleepを処理し、結果をPhysicsNodeへ同期する
ComputePhysicsSpace: Compute版のGPU BodyState、予測AABB、XZ Grid、candidate bitset、combined solver、persistent sleepを処理するPhysicsNode、BoxCollider、PlaneCollider: CPU版のBox bodyと無限Plane境界を構成するPrimitive、Shape: CPU版の実寸Boxと、Compute版のinstance描画用unit cubeを作るgetRenderState(): Compute版の最新ping-pong BodyStateを描画へ渡す
共通シナリオ
初期条件はfallingBoxScenario.jsへまとめています。200体を4列×4行のlayerとして配置し、seed20260822から配置の揺らぎを再現します。各bodyはBoxで、五つのPlaneは床と四壁を表します。重力は-4.9m/s²、fixed stepは1/120s、solver反復数は14です。
CPU版では各descriptorをPhysicsNodeとBoxColliderへ変換し、五つのPlaneをstaticなPhysicsNodeとしてPhysicsSpaceへ登録します。PhysicsSpaceは登録したPlaneをsolver入力へ変換し、登録NodeのBox/Plane接触を一つのCPU処理で解決します。表示用の床板は物理Planeとは別の通常Nodeとして作るため、床との接触計算は登録した物理Planeが担当します。Compute版では同じdescriptorをGPU BodyStateへ変換し、ComputePhysicsSpaceへ登録します。CPU PhysicsNodeの角速度はdegree/secで保持されるため、共通descriptorのrad/secからNodeへ同期する境界で変換します。
確認内容
同じシナリオをCPU版とCompute版で起動し、200体が落下して境界Planeと接触し、衝突後に停止へ向かうことを確認します。目的は、同じ初期条件から物体群が落下し、接触し、sleepへ向かう処理全体を両backendで確認することです。CPU版はPhysicsNodeのscene描画、Compute版はGPU BodyStateのinstance描画という状態受け渡しの違いも比較できます。CPU版はPhysicsSpaceの通常APIだけを使い、Box/Plane接触はコアのCPU接触処理を使います。
操作方法
PまたはSpace: pause / resumeR: ページを再読み込みして初期条件へresetH: Help Panelの展開 / 折りたたみ- ドラッグ: camera orbit
- ホイール: zoom