Add Surface API

src/generated_struct_info32.json

@@ -1260,6 +1260,29 @@
             "limits": 8,
             "nextInChain": 0
         },
+        "WGPUSurfaceCapabilities": {
+            "__size__": 28,
+            "alphaModeCount": 20,
+            "alphaModes": 24,
+            "formatCount": 4,
+            "formats": 8,
+            "nextInChain": 0,
+            "presentModeCount": 12,
+            "presentModes": 16
+        },
+        "WGPUSurfaceConfiguration": {
+            "__size__": 40,
+            "alphaMode": 24,
+            "device": 4,
+            "format": 8,
+            "height": 32,
+            "nextInChain": 0,
+            "presentMode": 36,
+            "usage": 12,
+            "viewFormatCount": 16,
+            "viewFormats": 20,
+            "width": 28
+        },
         "WGPUSurfaceDescriptor": {
             "__size__": 8,
             "label": 4,
@@ -1270,6 +1293,12 @@
             "chain": 0,
             "selector": 8
         },
+        "WGPUSurfaceTexture": {
+            "__size__": 12,
+            "status": 8,
+            "suboptimal": 4,
+            "texture": 0
+        },
         "WGPUSwapChainDescriptor": {
             "__size__": 28,
             "format": 12,

src/generated_struct_info64.json

@@ -1260,6 +1260,29 @@
             "limits": 8,
             "nextInChain": 0
         },
+        "WGPUSurfaceCapabilities": {
+            "__size__": 56,
+            "alphaModeCount": 40,
+            "alphaModes": 48,
+            "formatCount": 8,
+            "formats": 16,
+            "nextInChain": 0,
+            "presentModeCount": 24,
+            "presentModes": 32
+        },
+        "WGPUSurfaceConfiguration": {
+            "__size__": 56,
+            "alphaMode": 40,
+            "device": 8,
+            "format": 16,
+            "height": 48,
+            "nextInChain": 0,
+            "presentMode": 52,
+            "usage": 20,
+            "viewFormatCount": 24,
+            "viewFormats": 32,
+            "width": 44
+        },
         "WGPUSurfaceDescriptor": {
             "__size__": 16,
             "label": 8,
@@ -1270,6 +1293,12 @@
             "chain": 0,
             "selector": 16
         },
+        "WGPUSurfaceTexture": {
+            "__size__": 16,
+            "status": 12,
+            "suboptimal": 8,
+            "texture": 0
+        },
         "WGPUSwapChainDescriptor": {
             "__size__": 40,
             "format": 20,

src/library_webgpu.js

@@ -99,6 +99,13 @@ wgpu${type}Release: (id) => WebGPU.mgr${type}.release(id),`;
       DeviceLost: 2,
       Unknown: 3,
     },
+    CompositeAlphaMode: [
+      'auto',
+      'opaque',
+      'premultiplied',
+      'unpremultiplied',
+      'inherit',
+    ],
     CreatePipelineAsyncStatus: {
       Success: 0,
       ValidationError: 1,
@@ -568,6 +575,14 @@ var LibraryWebGPU = {
       'store',
       'discard',
     ],
+    SurfaceGetCurrentTextureStatus: [
+      'success',
+      'timeout',
+      'outdated',
+      'lost',
+      'out-of-memory',
+      'device-lost',
+    ],
     TextureAspect: [
       undefined,
       'all',
@@ -2673,13 +2688,89 @@ var LibraryWebGPU = {
     sampler.label = UTF8ToString(labelPtr);
   },
 
+  // WGPUSurfaceCapabilities
+
+  wgpuSurfaceCapabilitiesFreeMembers: (value) => {
+    // wgpuSurfaceCapabilities does currently allocate anything
+  },
+
   // WGPUSurface
 
+  wgpuSurfaceConfigure: (surfaceId, config) => {
+    {{{ gpu.makeCheckDescriptor('config') }}}
+    var deviceId = {{{ makeGetValue('config', C_STRUCTS.WGPUSurfaceConfiguration.device, '*') }}};
+    var context = WebGPU.mgrSurface.get(surfaceId);
+
+#if ASSERTIONS
+    assert({{{ gpu.PresentMode.Fifo }}} ===
+      {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.presentMode) }}});
+#endif
+
+    var canvasSize = [
+      {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.width) }}},
+      {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.height) }}}
+    ];
+
+    if (canvasSize[0] !== 0) {
+      context["canvas"]["width"] = canvasSize[0];
+    }
+
+    if (canvasSize[1] !== 0) {
+      context["canvas"]["height"] = canvasSize[1];
+    }
+
+    var configuration = {
+      "device": WebGPU.mgrDevice.get(deviceId),
+      "format": WebGPU.TextureFormat[
+        {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.format) }}}],
+      "usage": {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.usage) }}},
+      // viewFormatCount
+      // viewFormats
+      "alphaMode": "opaque",
+      "width": canvasSize[0],
+      "height": canvasSize[1],
+      "presentMode": {{{ gpu.makeGetU32('config', C_STRUCTS.WGPUSurfaceConfiguration.presentMode) }}},
+    };
+    context.configure(configuration);
+  },
+
+  wgpuSurfaceGetCapabilities: (surfaceId, adapterId, capabilitiesPtr) => {
+    if (capabilitiesPtr !== 0) {
+      {{{ makeSetValue('capabilitiesPtr', C_STRUCTS.WGPUSurfaceCapabilities.formatCount, '1', 'i32') }}};
+      var formatsPtr = WebGPU.TextureFormat.indexOf("bgra8unorm"); // FIXME
+      {{{ makeSetValue('capabilitiesPtr', C_STRUCTS.WGPUSurfaceCapabilities.formats, 'formatsPtr', 'i32') }}};
+      // "presentModeCount",
+      // "presentModes",
+      // "alphaModeCount",
+      // "alphaModes"
+    }
+  },
+
+  wgpuSurfaceGetCurrentTexture: (surfaceId, surfaceTexturePtr) => {
+    var context = WebGPU.mgrSurface.get(surfaceId);
+    var texture = WebGPU.mgrTexture.create(context.getCurrentTexture());
+    if (surfaceTexturePtr !== 0) {
+      {{{ makeSetValue('surfaceTexturePtr', C_STRUCTS.WGPUSurfaceTexture.texture, 'texture', '*') }}};
+      {{{ makeSetValue('surfaceTexturePtr', C_STRUCTS.WGPUSurfaceTexture.suboptimal, '0', 'i32') }}};
+      {{{ makeSetValue('surfaceTexturePtr', C_STRUCTS.WGPUSurfaceTexture.status, '0', 'i32') }}};
+    }
+  },
+
   wgpuSurfaceGetPreferredFormat: (surfaceId, adapterId) => {
     var format = navigator["gpu"]["getPreferredCanvasFormat"]();
     return WebGPU.Int_PreferredFormat[format];
   },
 
+  wgpuSurfacePresent: (surfaceId) => {
+    // TODO: This could probably be emulated with ASYNCIFY.
+    abort('wgpuSurfacePresent is unsupported (use requestAnimationFrame via html5.h instead)');
+  },
+
+  wgpuSurfaceUnconfigure: (surfaceId) => {
+    var context = WebGPU.mgrSurface.get(surfaceId);
+    context.unconfigure();
+  },
+
   // WGPUSwapChain
 
   wgpuDeviceCreateSwapChain: (deviceId, surfaceId, descriptor) => {

src/struct_info.json

@@ -1480,6 +1480,27 @@
                 "format",
                 "viewDimension"
             ],
+            "WGPUSurfaceCapabilities": [
+                "nextInChain",
+                "formatCount",
+                "formats",
+                "presentModeCount",
+                "presentModes",
+                "alphaModeCount",
+                "alphaModes"
+            ],
+            "WGPUSurfaceConfiguration": [
+                "nextInChain",
+                "device",
+                "format",
+                "usage",
+                "viewFormatCount",
+                "viewFormats",
+                "alphaMode",
+                "width",
+                "height",
+                "presentMode"
+            ],
             "WGPUSurfaceDescriptor": [
                 "nextInChain",
                 "label"
@@ -1488,6 +1509,11 @@
                 "chain",
                 "selector"
             ],
+            "WGPUSurfaceTexture": [
+                "texture",
+                "suboptimal",
+                "status"
+            ],
             "WGPUSwapChainDescriptor": [
                 "nextInChain",
                 "label",

system/include/webgpu/README.md

@@ -2,7 +2,7 @@ These files, and several snippets of other files, are generated by Dawn
 (Chromium's WebGPU library):
 - [Generator](https://source.chromium.org/chromium/chromium/src/+/main:third_party/dawn/generator/)
 - [Generator input](https://source.chromium.org/chromium/chromium/src/+/main:third_party/dawn/dawn.json)
-- [Generator output](https://source.chromium.org/chromium/chromium/src/+/main:out/Debug/gen/third_party/dawn/emscripten-bits/)
+- [Generator output](https://source.chromium.org/chromium/chromium/src/+/main:out/linux-Debug/gen/third_party/dawn/emscripten-bits/)
 
 The C header is intended to be mostly the same as the "upstream"
 [`webgpu.h`](https://github.com/webgpu-native/webgpu-headers/blob/main/webgpu.h),
@@ -16,13 +16,13 @@ is included here because it is strongly tied to an exact `webgpu.h` revision.
 To update these bindings from Dawn:
 1. Copy [`webgpu_enum_class_bitmasks.h`](https://source.chromium.org/chromium/chromium/src/+/main:third_party/dawn/include/webgpu/webgpu_enum_class_bitmasks.h) from Dawn's source to `system/include/webgpu/webgpu_enum_class_bitmasks.h`
 1. Build Dawn's `emscripten_bits_gen` target (in a gn or CMake build of Dawn, or a build of Chromium) - or, use the Chromium Code Search copy of the generated files if no changes are needed
-1. Copy the generated [`emscripten-bits/system`](https://source.chromium.org/chromium/chromium/src/+/main:out/Debug/gen/third_party/dawn/emscripten-bits/system/) files into Emscripten's `system` directory
+1. Copy the generated [`emscripten-bits/system`](https://source.chromium.org/chromium/chromium/src/+/main:out/linux-Debug/gen/third_party/dawn/emscripten-bits/system/) files into Emscripten's `system` directory
     - `system/include/webgpu/webgpu.h`
     - `system/include/webgpu/webgpu_cpp.h`
     - `system/include/webgpu/webgpu_cpp_chained_struct.h`
     - `system/lib/webgpu/webgpu_cpp.cpp`
-1. Paste the contents of [`library_webgpu_enum_tables.js`](https://source.chromium.org/chromium/chromium/src/+/main:out/Debug/gen/third_party/dawn/emscripten-bits/library_webgpu_enum_tables.js) over the "Map from enum number to enum string" section of [`library_webgpu.js`](../../../src/library_webgpu.js)
-1. Paste [`webgpu_struct_info.json`](https://source.chromium.org/chromium/chromium/src/+/main:out/Debug/gen/third_party/dawn/emscripten-bits/webgpu_struct_info.json) over the "WebGPU" section of [`struct_info.json`](../../../src/struct_info.json).
+1. Paste the contents of [`library_webgpu_enum_tables.js`](https://source.chromium.org/chromium/chromium/src/+/main:out/linux-Debug/gen/third_party/dawn/emscripten-bits/library_webgpu_enum_tables.js) over the "Map from enum number to enum string" section of [`library_webgpu.js`](../../../src/library_webgpu.js)
+1. Paste [`webgpu_struct_info.json`](https://source.chromium.org/chromium/chromium/src/+/main:out/linux-Debug/gen/third_party/dawn/emscripten-bits/webgpu_struct_info.json) over the "WebGPU" section of [`struct_info.json`](../../../src/struct_info.json).
 1. **Manually update the `globalThis.gpu` compile-time enum tables (AdapterType, BackendType, etc.)**:
     - Inspect the `webgpu.h` diff for changes to the integer values of any enums used here. (It's not necessary to add new enum values to these tables until they're needed for something.)
 1. **Manually update the "Map from enum string back to enum number" tables.**