Immediates: promote/rename, use limit only, remove feature

- Promote/rename immediateSize and maxImmediateSize to match webgpu.h.
  - Avoided renaming related symbols, to reduce the size of the CL.
- Since maxImmediateSize is now core, it defaults to 0 instead of 16.
  - Vulkan backend now needs to explicitly set it, others keep it as 0.
- Since there's no longer an extension struct for the limits, we also
  need new rules for how it's validated. Keeping the feature with the
  limit introduces questions about how the feature and the limit
  interact (what happens if you request one but not the other?), so
  instead this removes the feature entirely and gates maxImmediateSize>0
  on AllowUnsafeAPIs.
  - This simplifies some validation, as it all relies on
    maxImmediateSize and not the feature. Only
    AdapterBase::UpdateLimits() needs to care about the toggle, and
    SetImmediateData needs to explicitly error if maxImmediateSize=0.
  - The WGSL feature is gated on AllowUnsafeAPIs, along with other
    existing experimental features.
- In Wasm, pass maxImmediateSize through, but only if it's > 0.

No other projects seem to depend on immediates, so this changes
everything at once without any deprecations.

Fixed: 415086848
Change-Id: I980856fee5b5ec4ff98444291c410f5ab35bc178
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/240934
Reviewed-by: Loko Kung <lokokung@google.com>
Commit-Queue: Kai Ninomiya <kainino@chromium.org>
26 files changed
tree: 981030600ce54d59fc40b4dcab291cbb7eabc956
  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-format-ignore
  17. .clang-tidy
  18. .git-blame-ignore-revs
  19. .gitattributes
  20. .gitignore
  21. .gitmodules
  22. .gn
  23. .style.yapf
  24. .vpython3
  25. AUTHORS
  26. BUILD.bazel
  27. BUILD.gn
  28. CMakeLists.txt
  29. CMakeSettings.json
  30. CODE_OF_CONDUCT.md
  31. codereview.settings
  32. CONTRIBUTING.md
  33. CPPLINT.cfg
  34. DEPS
  35. DIR_METADATA
  36. go.mod
  37. go.sum
  38. go_presubmit_support.py
  39. LICENSE
  40. OWNERS
  41. PRESUBMIT.py
  42. README.chromium
  43. README.md
  44. WATCHLISTS
  45. 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.