WebGPU の新機能(Chrome 118)

François Beaufort
François Beaufort

copyExternalImageToTexture() での HTMLImageElement と ImageData のサポート

GPUQueuecopyExternalImageToTexture() メソッドを使用すると、ソース画像、動画、キャンバスから取得したスナップショットを特定の GPUTexture にコピーできます。HTMLImageElement および ImageData オブジェクトをソースとして渡すことができるようになりました。次の例と、問題 chromium:1471372 をご覧ください。

// Fetch and decode image.
const source = document.createElement("img");
source.src = "my-image.png";
await source.decode();

// Create destination texture.
const size = [source.width, source.height];
const texture = myDevice.createTexture({
 size,
 format: "rgba8unorm",
 usage:
   GPUTextureUsage.COPY_DST |
   GPUTextureUsage.RENDER_ATTACHMENT |
   GPUTextureUsage.TEXTURE_BINDING,
});

// Copies a snapshot taken from the source image into a texture.
myDevice.queue.copyExternalImageToTexture({ source }, { texture }, size);

読み取り / 書き込みと読み取り専用のストレージ テクスチャの試験運用版サポート

ストレージ テクスチャ バインディング タイプを使用すると、サンプリングなしでテクスチャを読み取り、シェーダーの任意の位置に保存できます。GPUAdapter"chromium-experimental-read-write-storage-texture" 機能が利用可能になったら、この機能を使用して GPUDevice をリクエストし、バインド グループ レイアウトの作成時に GPUStorageTexture アクセスを "read-write" または "read-only" に設定できるようになりました。これまでは "write-only" に制限されていました。

これを利用するには、WGSL のコードで enable chromium_experimental_read_write_storage_texture を使用して、この拡張機能を明示的に有効にする必要があります。有効にすると、ストレージ テクスチャに read_write および read アクセス修飾子を使用でき、textureLoad() および textureStore() 組み込み関数はそれに応じて動作し、新しい textureBarrier() 組み込み関数を使用してワークグループ内のテクスチャ メモリアクセスを同期できるようになります。次の例と問題 dawn:1972 をご覧ください。

この機能はまだ試験運用版であり、変更される可能性があります。標準化が進んでいる間は、--enable-dawn-features=allow_unsafe_apis フラグを指定して Chrome を実行することで利用できるようにします。

const feature = "chromium-experimental-read-write-storage-texture";
const adapter = await navigator.gpu.requestAdapter();
if (!adapter.features.has(feature)) {
  throw new Error("Read-write storage texture support is not available");
}
// Explicitly request read-write storage texture support.
const device = await adapter.requestDevice({
  requiredFeatures: [feature],
});

const bindGroupLayout = device.createBindGroupLayout({
  entries: [{
    binding: 0,
    visibility: GPUShaderStage.COMPUTE,
    storageTexture: {
      access: "read-write", // <-- New!
      format: "r32uint",
    },
  }],
});

const shaderModule = device.createShaderModule({ code: `
  enable chromium_experimental_read_write_storage_texture;
  @group(0) @binding(0) var tex : texture_storage_2d<r32uint, read_write>;

  @compute @workgroup_size(1, 1)
  fn main(@builtin(local_invocation_id) local_id: vec3u) {
    var data = textureLoad(tex, vec2i(local_id.xy));
    data.x *= 2;
    textureStore(tex, vec2i(local_id.xy), data);
  }`,
});

// You can now create a compute pipeline with this shader module and
// send the appropriate commands to the GPU.

夜明けの最新情報

一貫性を保つために、webgpu.h C API のフィールド名が requiredFeaturesCount から requiredFeatureCountpipelineStatisticsCount から pipelineStatisticCountcolorFormatsCount から colorFormatCount に変更されました。問題 dawn:146040 をご覧ください。

新しい DawnInfo プログラム(vulkaninfo と同様)を使用すると、切り替え、アダプター、アダプターの機能、アダプターの制限を一覧表示できます。これは、夜明け samples を作成するときに使用できます。簡潔にするために、出力を大幅に省略しています。変更 dawn:149020 をご覧ください。

./out/Debug/DawnInfo
Toggles
=======
  Name: allow_unsafe_apis
    Suppresses validation errors on API entry points or parameter combinations
    that aren't considered secure yet.
    http://crbug.com/1138528
[…]

Adapter
=======
VendorID: 0x106B
Vendor: apple
Architecture: common-3
DeviceID: 0x0000
Name: Apple M1 Pro
Driver description: Metal driver on macOS Version 13.5.1 (Build 22G90)
Adapter Type: discrete GPU
Backend Type: Metal
Power: <undefined>

  Features
  ========
   * depth_clip_control
      Disable depth clipping of primitives to the clip volume
      https://bugs.chromium.org/p/dawn/issues/detail?id=1178
[…]

  Adapter Limits
  ==============
    maxTextureDimension1D: 16,384
    maxTextureDimension2D: 16,384
[…]

ここでは、主なハイライトの一部のみを取り上げています。コミットの一覧をご確認ください。

WebGPU の新機能

WebGPU の新機能」シリーズに記載されている全内容のリスト。

Chrome 128

Chrome 127

Chrome 126

Chrome 125

Chrome 124

Chrome 123

Chrome 122

Chrome 121

Chrome 120

Chrome 119

Chrome 118

Chrome 117

Chrome 116

Chrome 115

Chrome 114

Chrome 113