Google Git
Sign in
dawn / dawn / 03d524b15fb5d0129b7a4e0746576d49f3cb993a
commit03d524b15fb5d0129b7a4e0746576d49f3cb993a[log] [tgz]
authorCorentin Wallez <cwallez@chromium.org>Wed Jul 10 07:07:28 2024 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Wed Jul 10 07:07:28 2024 +0000
tree82c5a6460f7a4d34c1729ebe82a531f69693289b
parent99272625cef9a7b377fc54b2a0c9e72dac158b83 [diff]
dawn::wire::client Use Refcounted for ObjectBase.

In future CLs this will let objects references each other, without
breaking the semantic that Instance/Device are destroyed/lost
immediately when their external refcount reaches 0.

This changes the lifetime semantics in the Dawn wire client to have each
object manage its own allocation lifetime through refcounting.
Previously the dawn::wire::client::Client managed their lifetime inside
the ObjectStores by getting a signal from the object when it reached a
refcount of 0.

This CL also changes Instance and Device to use
RefCountedWithExternalCount so that they can get a signal to unregister
themselves from the wire when the external refcount gets to 0.

Future cleanups will come in follow-up CLs:
 - Removing the logic to destroy Device first on Client disconnects.
   as it is no longer needed to preserve semantics.
 - Replacing the Device::mIsAlive weak_ptr with refs to the device.
 - Removing the LinkedList used to keep the list of all ObjectBase.
 - <your suggestion here?>

Bug: 344963953
Change-Id: I277ceef4ef30291d16c75df543eeae1d6552aff1
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/197235
Reviewed-by: Austin Eng <enga@chromium.org>
Reviewed-by: Loko Kung <lokokung@google.com>
Commit-Queue: Corentin Wallez <cwallez@chromium.org>
13 files changed
tree: 82c5a6460f7a4d34c1729ebe82a531f69693289b
  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. DEPS
  34. DIR_METADATA
  35. go.mod
  36. go.sum
  37. go_presubmit_support.py
  38. LICENSE
  39. OWNERS
  40. PRESUBMIT.py
  41. README.chromium
  42. README.md
  43. 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.