Add GPUSurfaceConfiguration.colorSpace

doc/articles/Surfaces.md

@@ -90,7 +90,7 @@ if (!wgpuSurfaceGetCapabilities(mySurface, myAdapter, &caps)) {
 
 // Do things with capabilities
 bool canSampleSurface = caps.usages & WGPUTextureUsage_TextureBinding;
-WGPUTextureFormat preferredFormat = caps.format[0];
+WGPUTextureFormat preferredFormat = caps.formats[0];
 
 bool supportsMailbox = false;
 for (size_t i = 0; i < caps.presentModeCount; i++) {

webgpu.h

@@ -366,6 +366,28 @@ typedef enum WGPUCallbackMode {
     WGPUCallbackMode_Force32 = 0x7FFFFFFF
 } WGPUCallbackMode WGPU_ENUM_ATTRIBUTE;
 
+/**
+ * Predefined sets of color space parameters.
+ */
+typedef enum WGPUColorSpace {
+    /**
+     * `0x00000000`.
+     * Use the default color space.
+     */
+    WGPUColorSpace_Undefined = 0x00000000,
+    /**
+     * `0x00000001`.
+     * The color space defined by [`srgb`](https://www.w3.org/TR/css-color-4/#predefined-sRGB) in CSS.
+     */
+    WGPUColorSpace_SRGB = 0x00000001,
+    /**
+     * `0x00000002`.
+     * The color space defined by [`display-p3`](https://www.w3.org/TR/css-color-4/#predefined-display-p3) in CSS.
+     */
+    WGPUColorSpace_DisplayP3 = 0x00000002,
+    WGPUColorSpace_Force32 = 0x7FFFFFFF
+} WGPUColorSpace WGPU_ENUM_ATTRIBUTE;
+
 typedef enum WGPUCompareFunction {
     WGPUCompareFunction_Undefined = 0x00000000,
     WGPUCompareFunction_Never = 0x00000001,
@@ -1539,6 +1561,14 @@ typedef struct WGPUSurfaceConfiguration {
      * When and in which order the surface's frames will be shown on the screen. Defaults to @ref WGPUPresentMode_Fifo.
      */
     WGPUPresentMode presentMode;
+    /**
+     * Color space to display the surface with.
+     *
+     * The only value that implementations are required to support is @ref WGPUColorSpace_Undefined,
+     * which may be either "unmanaged" or "sRGB".
+     * Wasm implementations should support @ref WGPUColorSpace_SRGB and @ref WGPUColorSpace_DisplayP3.
+     */
+    WGPUColorSpace colorSpace;
 } WGPUSurfaceConfiguration WGPU_STRUCTURE_ATTRIBUTE;
 
 /**

webgpu.yml

@@ -219,6 +219,15 @@ enums:
             Implementations _should_ fire spontaneous callbacks as soon as possible.
 
           @note Because spontaneous callbacks may fire at an arbitrary time on an arbitrary thread, applications should take extra care when acquiring locks or mutating state inside the callback. It undefined behavior to re-entrantly call into the webgpu.h API if the callback fires while inside the callstack of another webgpu.h function that is not `wgpuInstanceWaitAny` or `wgpuInstanceProcessEvents`.
+  - name: color_space
+    doc: Predefined sets of color space parameters.
+    entries:
+      - name: undefined
+        doc: Use the default color space.
+      - name: sRGB
+        doc: The color space defined by [`srgb`](https://www.w3.org/TR/css-color-4/#predefined-sRGB) in CSS.
+      - name: display_p3
+        doc: The color space defined by [`display-p3`](https://www.w3.org/TR/css-color-4/#predefined-display-p3) in CSS.
   - name: compare_function
     doc: |
       TODO
@@ -2699,6 +2708,14 @@ structs:
       - name: present_mode
         doc: When and in which order the surface's frames will be shown on the screen. Defaults to @ref WGPUPresentMode_Fifo.
         type: enum.present_mode
+      - name: color_space
+        doc: |
+          Color space to display the surface with.
+
+          The only value that implementations are required to support is @ref WGPUColorSpace_Undefined,
+          which may be either "unmanaged" or "sRGB".
+          Wasm implementations should support @ref WGPUColorSpace_SRGB and @ref WGPUColorSpace_DisplayP3.
+        type: enum.color_space
   - name: surface_descriptor
     doc: |
       The root descriptor for the creation of an @ref WGPUSurface with `::wgpuInstanceCreateSurface`.