Google Git
Sign in
dawn / dawn / 410f2d0f31c100c0ae956246bdbac6c75f24478b
commit410f2d0f31c100c0ae956246bdbac6c75f24478b[log] [tgz]
authorAustin Eng <enga@chromium.org>Tue Apr 23 01:12:38 2024 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Tue Apr 23 01:12:38 2024 +0000
treeb46055ddf4c83e0df4350d482f1798e023343f91
parent6391acef4b6007a827546c5f226a384af4d008cb [diff]
Add dawn/wire/client/webgpu{_cpp}.h

client/webgpu.h includes webgpu/webgpu.h, but also declares
wgpuDawnWireClient-prefixed methods.

client/webgpu_cpp.h is a duplicate copy of the webgpu_cpp.h header
except it includes client/webgpu.h, has different include guards,
and uses wgpuDawnWireClient-prefixed methods.
Objects and structs are defined in the wgpu::dawn::wire::client
namespace, and then aliased into the wgpu:: namespace.
This means that use of the methods will dispatch to the wire client,
implementation of them, and we avoid duplicate definitions of other
definitions in the wgpu namespace

It is not valid to include both client/webgpu_cpp.h and
webgpu/webgpu_cpp.h. This will result in errors about duplicate dfns.

Bug: chromium:40195122
Change-Id: I6eec057253bfbe0cf2292210c82d2fc2b663dc89
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/184243
Reviewed-by: Loko Kung <lokokung@google.com>
Commit-Queue: Austin Eng <enga@chromium.org>
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
11 files changed
tree: b46055ddf4c83e0df4350d482f1798e023343f91
  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.