[WebGPU][Kotlin] Use addins in dawn_kotlin.json

- Replace the bespoke customize_api block with the generic addins
  mechanism from https://dawn-review.googlesource.com/c/dawn/+/332056,
  matching dawn_native.json.
- Lets include_*/kotlin_name read attributes directly off the parsed
  Python objects instead of walking five parallel lookup dicts, and
  drops the obj/structure_name plumbing from include_method and
  kotlin_record_members.
- exclude_members becomes per-member "omitted" addins. Among record
  members, "omitted" is asserted to only appear on structure members,
  since omitting a function/method argument would silently pass a
  zero-initialized value to the native call.
- additional_members are now appended to struct.members
  (kotlin_only=True) so templates see a single member list; the
  converter analysis skips kotlin_only members accordingly.
- Document the dawn_kotlin.json schema and addin vocabulary in
  docs/dawn/codegen.md.
- No change to generated Kotlin/JNI output (verified by diffing the
  output of the kotlin generator target against origin/main, and
  running connectedDebugAndroidTest on device).

Suggested by lokokung@ in
https://dawn-review.googlesource.com/c/dawn/+/343975.

Bug: 568205909, 462825233
Change-Id: I2abdc9ef4f8f5c76dd636ca1b99caaba6b4c9b3c
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/347535
Commit-Queue: Nikita Gupta <nikigupta@google.com>
Reviewed-by: Loko Kung <lokokung@google.com>
9 files changed
tree: db17bf4c88dbc3fe48d735d937948185661415bb
  1. .github/
  2. .vscode/
  3. agents/
  4. build_overrides/
  5. docs/
  6. generator/
  7. include/
  8. infra/
  9. scripts/
  10. src/
  11. test/
  12. third_party/
  13. tools/
  14. webgpu-cts/
  15. .bazelignore
  16. .bazelrc
  17. .bazelversion
  18. .clang-format
  19. .clang-format-ignore
  20. .clang-tidy
  21. .git-blame-ignore-revs
  22. .gitattributes
  23. .gitignore
  24. .gitmodules
  25. .gn
  26. .style.yapf
  27. AUTHORS
  28. BUILD.bazel
  29. BUILD.gn
  30. CMakeLists.txt
  31. CMakeSettings.json
  32. CODE_OF_CONDUCT.md
  33. codereview.settings
  34. CONTRIBUTING.md
  35. CPPLINT.cfg
  36. DEPS
  37. DIR_METADATA
  38. go.mod
  39. go.sum
  40. go_presubmit_support.py
  41. LICENSE
  42. MODULE.bazel
  43. OWNERS
  44. PRESUBMIT.py
  45. PRESUBMIT_test.py
  46. README.chromium
  47. README.md
  48. unsafe_buffers_paths.txt
  49. vpython.toml
  50. vpython.toml.uv.lock
  51. WATCHLISTS
  52. 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.