Google Git
Sign in
dawn / dawn / 7d09d55cee2e840eebd0c45af3d25c8df885eefa
commit7d09d55cee2e840eebd0c45af3d25c8df885eefa[log] [tgz]
authorKai Ninomiya <kainino@chromium.org>Wed Dec 20 23:39:28 2023 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Wed Dec 20 23:39:28 2023 +0000
treec59372d86fffc1f7b656dea1b6be9c4ae753bdd1
parent5566afc92caff56df84a8666b7364412ed0d5f39 [diff]
webgpu.h: Reserve 0 for enums, in a few more possibly-breaking cases

These enums should be required to be set explicitly, so 0 is now
supposed to be invalid (where previously zero-init would just give you
the 0th enum value).

- AlphaMode is used in CopyTextureForBrowser. Since Chromium tests run
  on CQ, any breakage here should be caught (except it's known that the
  reftests aren't running on CQ and could hit this. I've run those
  locally.)
  - It is also reordered to sort-of mirror GPUCanvasAlphaMode even
    though it is not the same thing.
- QueryType is used in QuerySetDescriptor. Since there's no reasonable
  default here it's less likely anyone has written code that's using
  zero-init to get occlusion queries, but there could be.

Bug: dawn:2224
Change-Id: I0e74b37baa7b164ee6f3ad4fe05e91d91e25f104
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/166388
Kokoro: Kokoro <noreply+kokoro@google.com>
Commit-Queue: Loko Kung <lokokung@google.com>
Reviewed-by: Loko Kung <lokokung@google.com>
Auto-Submit: Kai Ninomiya <kainino@chromium.org>
2 files changed
tree: c59372d86fffc1f7b656dea1b6be9c4ae753bdd1
  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. build
  15. buildtools
  16. testing
  17. .bazelrc
  18. .clang-format
  19. .clang-tidy
  20. .gitattributes
  21. .gitignore
  22. .gitmodules
  23. .gn
  24. AUTHORS
  25. BUILD.bazel
  26. BUILD.gn
  27. CMakeLists.txt
  28. CMakeSettings.json
  29. CODE_OF_CONDUCT.md
  30. codereview.settings
  31. CONTRIBUTING.md
  32. CPPLINT.cfg
  33. dawn.json
  34. dawn_wire.json
  35. DEPS
  36. DIR_METADATA
  37. Doxyfile
  38. go.mod
  39. go.sum
  40. go_presubmit_support.py
  41. LICENSE
  42. OWNERS
  43. PRESUBMIT.py
  44. README.chromium
  45. README.md
  46. 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.