[cpp] Refactors callback info handling in cpp header.

- This refactor adds new utilities to unify callback info handling in
  the cpp header. This change only updates the methods that return a
  wgpu::Future, but in follow ups, we will also unify the generator to
  use the helpers for structs that have callback info members, i.e.
  the DeviceDescriptor.
- The refactor also introduces the concept of CArgConverter, which
  will allow us to extend the C++ API to handle more types of
  callbacks. The extensibility of this design will allow us to manually
  implement conversions when they are not trivial, i.e. the DeviceLost
  and UncapturedError callbacks will use this in a follow up. This
  will also allow us to provide callbacks that are more C++ friendly,
  i.e. the DawnCacheDeviceDescriptor and it's callbacks could be
  updated to be more like the one's in the DeviceDescriptor, and in
  C++, we can wrap the raw pointers in those callbacks with a
  std::span to provide additional safety.
- This change also implicitly removes support for the old char* types
  for messages in callbacks, and instead only supports
  wgpu::StringView for those. In another follow up, we could actually
  use the CArgConverter design to support std::string_view directly
  and potentially remove the wgpu::StringView type from the C++
  bindings entirely.

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