Remove SwapChain from the API

This applies the switch from manipulating a SwapChain object to calling
Surface::configure that was brung to the standard webgpu.h a couple of
months ago.

I believe this needs a bit of extra work, but at this stage I need a
review from people more familiar with the codebase to tell me if I am
going in the right direction.

The SwapChain object is still here, but no longer present in the API.
Instances of the swap chain are now owned by the surface object. The
test for surface capabilities is partly calling a method of the
PhysicalDevice in order to have backend-specific capabilities.

So far I mostly tested with the Vulkan backend, though I tried to
provide a valid implementation for all backends.

Bug: dawn:2320
Change-Id: I69d3c64873213eca375c66170cb648debd8ec91d
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/167600
Kokoro: Kokoro <noreply+kokoro@google.com>
Commit-Queue: Élie Michel <elie.michel.fr@gmail.com>
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
Reviewed-by: Austin Eng <enga@chromium.org>
53 files changed
tree: f4f8a078c007ea808bc18d4a63b9bc72568b7b97
  1. .github/
  2. .vscode/
  3. build_overrides/
  4. docs/
  5. generator/
  6. include/
  7. infra/
  8. scripts/
  9. src/
  10. test/
  11. third_party/
  12. tools/
  13. webgpu-cts/
  14. .bazelrc
  15. .clang-format
  16. .clang-tidy
  17. .gitattributes
  18. .gitignore
  19. .gitmodules
  20. .gn
  21. AUTHORS
  22. BUILD.bazel
  23. BUILD.gn
  24. CMakeLists.txt
  25. CMakeSettings.json
  26. CODE_OF_CONDUCT.md
  27. codereview.settings
  28. CONTRIBUTING.md
  29. CPPLINT.cfg
  30. DEPS
  31. DIR_METADATA
  32. go.mod
  33. go.sum
  34. go_presubmit_support.py
  35. LICENSE
  36. OWNERS
  37. PRESUBMIT.py
  38. README.chromium
  39. README.md
  40. WORKSPACE.bazel
README.md

Build Status Matrix Space

Dawn, a WebGPU implementation

Dawn is an open-source and cross-platform implementation of the WebGPU standard. More precisely it implements webgpu.h that is a one-to-one mapping with the WebGPU IDL. Dawn is meant to be integrated as part of a larger system and is the underlying implementation of WebGPU in Chromium.

Dawn provides several WebGPU building blocks:

  • WebGPU C/C++ headers that applications and other building blocks use.
    • The webgpu.h version that Dawn implements.
    • A C++ wrapper for the webgpu.h.
  • A “native” implementation of WebGPU using platforms' GPU APIs: D3D12, Metal, Vulkan and OpenGL. See per API support for more details.
  • A client-server implementation of WebGPU for applications that are in a sandbox without access to native drivers
  • Tint is a compiler for the WebGPU Shader Language (WGSL) that can be used in standalone to convert shaders from and to WGSL.

Helpful links:

Documentation table of content

Developer documentation:

User documentation: (TODO, figure out what overlaps with the webgpu.h docs)

License

BSD 3-Clause License, please see LICENSE.

Disclaimer

This is not an officially supported Google product.