Google Git
Sign in
dawn / dawn / refs/heads/chromium/7627
commit0b88469034e0e93ed8f5e42f57c0468a9f4c2b24[log] [tgz]
authorLokbondo Kung <lokokung@google.com>Fri Jan 09 16:02:41 2026 -0800
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Fri Jan 09 16:02:41 2026 -0800
treeb5bd2feb3e5c34cb61dbb3d126159f52966de135
parent6c870d0d2261e8931af759c984d24a61a3360bd3 [diff]
[dawn] Make the Instance simply RefCounted.

- Before, the Instance needed to be externally refcounted because
  there wasn't a way to get the Instance once the last external
  reference was dropped, hence it could cause any WaitAnyOnly or
  AllowProcessEvent events to be leaked. Since then, we have
  added a `GetInstance()` API on the Adapter which means that as
  long as we have a Device (which has `GetAdapter()`) on it, the
  instance can be reached. As a result, we only need to clear all
  events when the last device reference is dropped. This means
  that the Instance can just be a simple refcounted object now.
- This is also necessary because the `WaitAny()` and
  `ProcessEvents()` APIs implicitly assume that if they are called,
  that the Instance is externally alive. However, because users
  can drop the last external reference, then get a new one when
  they need it via the Device/Adapter, some teardown code in
  Chromium could cause a crash by calling those APIs on an
  Instance retrieved via the getter APIs after the original
  external reference was dropped.

Bug: 467732049, 474662276
Change-Id: Ib04c6243538983c2ba4c3060beb23487da66a499
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/283515
Reviewed-by: Kai Ninomiya <kainino@chromium.org>
Reviewed-by: Sunny Sachanandani <sunnyps@chromium.org>
Auto-Submit: Loko Kung <lokokung@google.com>
Commit-Queue: Kai Ninomiya <kainino@chromium.org>
3 files changed
tree: b5bd2feb3e5c34cb61dbb3d126159f52966de135
  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-format-ignore
  20. .clang-tidy
  21. .git-blame-ignore-revs
  22. .gitattributes
  23. .gitignore
  24. .gitmodules
  25. .gn
  26. .style.yapf
  27. .vpython3
  28. AUTHORS
  29. BUILD.bazel
  30. BUILD.gn
  31. CMakeLists.txt
  32. CMakeSettings.json
  33. CODE_OF_CONDUCT.md
  34. codereview.settings
  35. CONTRIBUTING.md
  36. CPPLINT.cfg
  37. DEPS
  38. DIR_METADATA
  39. go.mod
  40. go.sum
  41. go_presubmit_support.py
  42. LICENSE
  43. OWNERS
  44. PRESUBMIT.py
  45. README.chromium
  46. README.md
  47. test_spec_presubmit_support.py
  48. unsafe_buffers_paths.txt
  49. WATCHLISTS
  50. 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.