S式の宣言的なWebGPU
Declarative WebGPU with S-Expressions (hugodaniel.com)
要約
pngineは、WebGPUのパイプライン、バッファ、シェーダーコードなどをS式(S-expressions)で宣言的に記述し、管理するためのフォーマットとランタイムです。これにより、クロスプラットフォームでのWebGPUの利用、設定の検証、そして単一のファイル(PNG形式も含む)へのエクスポートが可能になります。このツールは、WebGPUの複雑な設定を簡素化し、開発者がより高レベルな抽象化に集中できるようにすることを目指しています。
全文翻訳
S式による宣言的なWebGPU
出荷・共有可能なWebGPU配線
2026年8月23日 私について ここから始める 全投稿 フィード
これは私が過去2.5年間取り組んできた、WebGPUのための宣言的なフォーマットとランタイムであるpngineです。
(shader-module :name code :code """
@vertex
fn vertexMain(
@builtin(vertex_index) VertexIndex : u32
) -> @builtin(position) vec4f {
var pos = array<vec2f, 3>(
vec2(0.0, 0.5),
vec2(-0.5, -0.5),
vec2(0.5, -0.5)
);
return vec4f(pos[VertexIndex], 0.0, 1.0);
}
@fragment
fn fragMain() -> @location(0) vec4f {
return vec4(1.0, 0.0, 0.0, 1.0);
}
""")
(render-pipeline :name pipeline
:layout auto
(vertex :module code :entry vertexMain)
(fragment :module code :entry fragMain
(target :format preferred-canvas-format))
)
(render-pass :name trianglePass
(color-attachment :view context-current-texture
:clear-value [0 0 0 0] :load-op clear :store-op store)
:pipeline pipeline
(draw :vertex-count 3))
(frame :name main :perform [trianglePass])
上記のコードは、WebGPU仕様に1対1で対応するS式を用いた、シンプルな赤い三角形を描画する例です。
1-2-3 pngine
Pgineには3つの主要な機能があります。
- WebGPUの配線(シェーダーとCPU/wasm初期化を含む)を宣言し、クロスプラットフォームで出荷できます(ブラウザに限定されず、Rustのwgpuでも動作し、AndroidやiOS向けのプレイヤーも存在します)。
- WGSLのリフレクションと仕様チェックを使用して宣言されたWebGPU構成を検証し、ライブなWebGPUコンテキストを必要とせずにエラーや警告を生成します。また、入力中にエラーを検出できるLSPも備えています。
- すべてを単一の.html、.zip、または.pngファイルにエクスポートできます。これにより、実行可能なPNGファイルを渡すことができます(PNGは自動実行されませんが、バイトコードが含まれており、要求に応じて再生するための小さなプレイヤーが必要です)。
最後の機能がクールな部分で、pngineの「png」の由来でもあります。S式はバイナリ表現にコンパイルされ、それを小さなランタイムが解釈します。そのランタイムとペイロードは追加のPNGチャンクに含めることができ、PNG自体は出荷するもののプレビュー画像として機能します。
これらすべてについて、専用ページで詳しく読むことができます。
コードはCC0ライセンスで、GitHubで問題や議論を受け付けており、リリースは私のセルフホスト型リポジトリからカットされます。
[画像: pngine logo]
なぜ?
カスタムWebGPU配線を配布・共有することは、私にとって未解決の問題でした。WebGPUパイプライン/バッファー/パスなどのすべてを記述する単一のファイルと、シェーダーモジュールおよびWGSLコードを求めていました。
現在、WebGPUをサポートする汎用言語でこれを行うことは可能ですが、私はより高い抽象化レベルで、気を散らすものがないものを求めていました。これは他のツールの基盤として使用でき、人間または機械によるより深い洞察を提供できるものです。
SJONは、自動検証可能で、S式を通じて一貫した構成可能な方法で配信できるDSLを構築する手段を与えてくれました。これはWebGPUの配線と一部にのみ使用され、シェーダーコード用ではありません。WGSLはそれ自体がDSLと見なしており、そのまま保持されています。
プログラム表現自体が読み取り可能なデータであるというこのアイデアは、pngineの中心にあります。この特性は私にとって非常に有用です。プログラム表現自体が通常の構造化データである場合、検証、再生、検査、最小化、シリアル化、機械生成などがすべて事前に可能になり、各機能が同じ表現で動作します。
このトピックについては、SJONの投稿とページで広範囲に記述しているので、これ以上深くは掘り下げません。
配線をパッケージ化する
今日、パイプラインを共有したい場合、まず一連の規約に合意する必要があります。どの言語を使用しますか?TypeScript、JavaScript、Rust?ハンドルはどのように表現され、渡されますか?このパイプラインは、小さなアニメーション、ゲーム、または他の何かのの一部ですか?これらの選択は、同じWebGPU配線がどのようにパッケージ化され、共有されるかに影響します。
Pgineはこれらを削除しませんが、表面積を削減しようと非常に努力しています。これにより、非常に異なる目的やターゲットに対して、複数のWebGPU配線を同じ方法でバンドルできます。
ほとんどのWebGPU配線は静的です
WebGPU仕様は、グラフィックスの世界がそうなってしまった泥沼で複雑なトピックに適用された、一貫性とエレガンスの驚くべき成果です。WebGPUは、暗黙的な状態を取り除き、慎重に設計されたAPI呼び出しや構成オブジェクトにそれらを移動させるために多大な努力を払っています。
この点を少し強調したいので、最初に示したシンプルな三角形の同等のJavaScriptコードを見てみましょう。
// (shader-module :name code ...)
const code = device.createShaderModule({
code: `
@vertex
fn vertexMain(
@builtin(vertex_index) VertexIndex : u32
) -> @builtin(position) vec4f {
var pos = array<vec2f, 3>(
vec2(0.0, 0.5),
vec2(-0.5, -0.5),
vec2(0.5, -0.5)
);
return vec4f(pos[VertexIndex], 0.0, 1.0);
}
@fragment
fn fragMain() -> @location(0) vec4f {
return vec4(1.0, 0.0, 0.0, 1.0);
}
`,
});
// (render-pipeline :name pipeline ...)
const pipeline = device.createRenderPipeline({
layout: "auto",
vertex: { module: code, entryPoint: "vertexMain" },
fragment: { module: code, entryPoint: "fragMain", targets: [{ format }] },
primitive: { topology: "triangle-list" }, // default
});
// (frame :name main :perform [trianglePass])
const encoder = device.createCommandEncoder();
// (render-pass :name trianglePass ...)
const pass = encoder.beginRenderPass({
colorAttachments: [{
view: context.getCurrentTexture().createView(),
clearValue: [0, 0, 0, 0],
loadOp: "clear",
storeOp: "store",
}],
});
pass.setPipeline(pipeline);
pass.draw(3); // (draw :vertex-count 3)
pass.end();
device.queue.submit([encoder.finish()]);
このコードは、もの(createShaderModule、createRenderPipeline、createCommandEncoder)を作成し、それらを配線し、最後にパスでシーケンス化します。
(ちなみに、JavaScriptコードはpngineで生成されたもので、S式からの可能な出力の一つです)
作成、配線、シーケンス化はWebGPUの処理であり、通常は好みに応じて抽象化できる手続き的な環境で行われます。
WebGPU配線を宣言的な空間に持ち込むのは簡単で、ほぼ即座に可能です。これにより、概念やブロックを、順序に関係なく記述できる方法で操作できます。それらはそのまま存在し、宣言され、自由に移動できます。
WebGPUのシーケンス部分もそれほど難しくありません。順序どおりに実行する必要があることの説明を保持し、適切なタイミングで実行します。
Pgineでは、frameは順序が重要な数少ない場所の1つであり、:performの各名前はファイル内の別の場所で宣言されたパスを参照します。
(frame :name main :perform [
update-uniforms
update-textures
sdf-pass
post-processing
])
パイプラインに沿って
シェーダーコードの共有は素晴らしいです。shadertoyは、さらに優れたコミュニティ、多くの例や学習できるコードを備えた素晴らしいツールです。ぜひ使用してください。
もう少し深く掘り下げたい場合は、compute.toysがあります。これは、複数のコンピュートシェーダーが互いにフィードし、最終的なバッファーがピクセルとして画面に送信されるようにするものです(まあ、これはもう少しですが、例として)。WGSLを拡張し、パイプライン構成などを指定できる#マクロを備えています。素晴らしいツールで、私はそこで多くの作業を行いました。WGSLを学び、アイデアを試すのに最適です。
今日では、このようなツールがたくさんあります。「より良いバージョンを作成して、自分のシェーダーの好みに合わせることができる」という考えは素晴らしいです。シェーダーのツールはアーティストによって進化しています。しかし、これはpngineではありません。残念ながら、プレイグラウンドはありません(LSPはありますが)、それがここでは意図ではありません。
私の考えでは、pngineは基盤であり、非常に汎用性の高いものです。あなたを制限するのではなく、高レベルの抽象化では簡単には得られないクレイジーなこと(シーングラフ、マテリアルノードなど)を構築するのを助けます(または、必要であればお気に入りのマシンが)。
三角形、そして...
三角形は楽しいですが、その単純な例はpngineがあなたをどこに置くかをよく示していません。CPUに一切触れないパーティクルシステムが欲しいですか?
2048個のGPUパーティクルがバッファープーリングを使用して、ノズルから噴射され、重力で引き下げられ、寿命が尽きると新鮮なランダムな速度で再スポーンします。
この例では、属性バッファーもシミュレーションが書き込むものです。
完全なドキュメントはパーティクルファウンテンサンプルページにあります。または、上記のPNGを使用してください。それはプログラムであり、ポスターであり、すべてです。
パーティクルファウンテン、そして...
単一の描画呼び出しで、400本のローポリツリーが風に揺れ、空に対して深度テストが行われます。
ツリー自体は、ドキュメントに直接入力された12個の頂点(トランクの四角形と2つの葉の三角形)で構成されています。それらを配置、スケーリング、回転、色付けする400個のインスタンスレコードは、コンピュートパスによって一度だけ埋められます。どちらも同じパイプライン上の頂点バッファーであり、1つは頂点ごと、もう1つはインスタンスごとにステップするため、森全体は(draw :vertex-count 12 :instance-count NUM_TREES)となります。
ここでも、完全なドキュメントはインスタンスツリーサンプルページにあります。前述のように、プログラム、ポスター、すべてがここでもPNGです。
バンドラーと覗き見
上記の画像は.pngファイルであり、実際のWebGPUプレイヤーとそのペイロードを保持する追加のバイナリチャンクが含まれているため、実際のJavaScriptロードは非常に小さくなります。これは、これらのpngine .sjonファイルをエクスポートするオプションの1つであり、簡単な小さな静的ファイルに便利です。HTMLファイル、ZIPバンドル、またはPNGなしの生のバイナリバイトコードを生成することもできます。
しかし、はい、pngineのpngは、画像がプレビュー/ポスターと同時にバイトコード/ランタイムペイロードのコンテナでもあるという、私の最初のキックスターターのアイデアへのオマージュです。
結論
締めくくりとして、基盤という言葉を少し広げたいと思います。
土壌や成長基盤は3つの主要な機能を提供します。根の構造的な固定、酸素交換を可能にしながらの水の保持、そして栄養素の貯蔵または供給です。
私にとってpngineは、WebGPUとグラフィックスのためのそのような成長基盤です。低レベルの実験と探求の場であり、本質的に制約がありWebGPUにのみ焦点を当てていますが、ジェネリックな相互作用とCPU(wasm)コードをシェーダーで使用できるバッファーにフックする簡単な方法を提供します。
すべて、ターミナルやその他の場所(LSP、エディター、入力中)で検証やエラー・欠陥チェックを行えるパッケージで提供されます。
より高レベルの実験が根を張り、成長するための場所となり得ます。そして、自動化された.pngプレビューを実行できるシェーダーを共有できます。
pngineはこちら、またはコードはこちらをご覧ください。