Neu in WebGPU (Chrome 118)

François Beaufort
François Beaufort

Unterstützung von HTMLImageElement und ImageData in copyExternalImageToTexture()

Mit der Methode copyExternalImageToTexture() für GPUQueue können Sie einen Snapshot, der aus einem Quellbild, ‑video oder ‑Arbeitsbereich erstellt wurde, in ein bestimmtes GPUTexture kopieren. Sie können jetzt HTMLImageElement- und ImageData-Objekte als Quelle übergeben. Hier finden Sie ein Beispiel.

// 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);

Experimentelle Unterstützung für Lese-/Schreib- und schreibgeschützte Speichertexturen

Mit dem Speichertextur-Bindungstyp können Sie Texturen lesen, ohne sie zu samplen, und an beliebigen Positionen in Shadern speichern. Wenn die Funktion "chromium-experimental-read-write-storage-texture" in einem GPUAdapter verfügbar ist, können Sie jetzt ein GPUDevice mit dieser Funktion anfordern und beim Erstellen eines Bindungsgruppenlayouts den GPUStorageTexture-Zugriff auf "read-write" oder "read-only" festlegen. Bisher war dies auf "write-only" beschränkt.

Dazu müssen Sie diese Erweiterung in Ihrem WGSL-Code explizit mit enable chromium_experimental_read_write_storage_texture aktivieren. Wenn diese Option aktiviert ist, können Sie die Zugriffsqualifizierer read_write und read für Speichertexturen verwenden. Die integrierten Funktionen textureLoad() und textureStore() verhalten sich entsprechend und eine neue integrierte Funktion textureBarrier() ist verfügbar, um Texturspeicherzugriffe in einer Arbeitsgruppe zu synchronisieren. Hier finden Sie ein Beispiel.

Diese Funktion befindet sich noch in der Testphase und kann sich ändern. Während die Funktion standardisiert wird, können Sie Chrome mit dem --enable-dawn-features=allow_unsafe_apis-Flag ausführen, um sie verfügbar zu machen.

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.

Dawn-Updates

In der C-API webgpu.h wurden die folgenden Felder aus Gründen der Einheitlichkeit umbenannt: requiredFeaturesCount in requiredFeatureCount, pipelineStatisticsCount in pipelineStatisticCount und colorFormatsCount in colorFormatCount. Siehe Problem dawn:146040.

Mit einem neuen DawnInfo-Programm (ähnlich wie vulkaninfo) können Sie Schalter, Adapter, Adapterfunktionen und Adapterlimits auflisten. Sie ist beim Erstellen von Dawn-samples verfügbar. Die Ausgabe unten wurde der Kürze halber stark gekürzt. Siehe Änderung 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
[…]

Dies sind nur einige der wichtigsten Neuerungen. Vollständige Liste der Commits

Neues zu WebGPU

Eine Liste mit allen Themen, die in der Reihe Neu in WebGPU behandelt wurden.

Chrome 140

Chrome 139

Chrome 138

Chrome 137

Chrome 136

Chrome 135

Chrome 134

Chrome 133

Chrome 132

Chrome 131

Chrome 130

Chrome 129

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