Google Git
Sign in
dawn / dawn / c0a1a03bd7574c0d0c9a76c52e218ab580478139
commitc0a1a03bd7574c0d0c9a76c52e218ab580478139[log] [tgz]
authorKai Ninomiya <kainino@chromium.org>Thu Dec 07 01:22:59 2023 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Thu Dec 07 01:22:59 2023 +0000
tree654e933cdf0fdc2441c374ca227cee4e9d198e03
parent0ee94c900a987ab2c723b5bea07a4de72bc51296 [diff]
webgpu.h: Reserve 0 for "undefined" in enums, and match spec enum order

Also add some TODOs and fix some formatting.

There is some risk of breakage in other projects if they assumed
certain values would be used when they zero-initialized. In particular:
- AddressMode_Repeat
- BlendFactor_Zero
- BlendOperation_Add
- AlphaMode_Premultiplied
- CullMode_None
- VertexStepMode_Vertex
- MipmapFilterMode_Nearest
- StencilOperation_Keep
- TextureAspect_All

Not done yet:
- DeviceLostReason, because it also needs renaming work (bug 2139)
- Possibly removing any 0 values that aren't needed
- Adding new Undefined values that will need more code changes

Bug: dawn:2224
Change-Id: I115be149fd84a816c8b8e746b5dffbb34b1ca6f4
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/155984
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
Reviewed-by: Loko Kung <lokokung@google.com>
Kokoro: Kokoro <noreply+kokoro@google.com>
Commit-Queue: Kai Ninomiya <kainino@chromium.org>
2 files changed
tree: 654e933cdf0fdc2441c374ca227cee4e9d198e03
  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.