Google Git
Sign in
dawn / dawn / 622dbaf37b55d374e6ca7e47d6bd830c7a648b90
commit622dbaf37b55d374e6ca7e47d6bd830c7a648b90[log] [tgz]
authorAustin Eng <enga@chromium.org>Tue Jul 23 00:09:52 2024 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Tue Jul 23 00:09:52 2024 +0000
tree613a5ef5002ec6580270e222864b28a81329fba9
parentab2bb0ccc39aff70c376dd235fdc00b3a463c700 [diff]
Support WGPUStringView in non-struct input arguments

- Add WGPUStringView struct. In C++ there is both wgpu::StringView and
  wgpu::NullableStringView to differentiate different types of strings.
  These structs appear identically in C.
- Add support for serializing / deserializing WGPUStringView in the wire,
  with tests.
- Update methods with input args to take WGPUStringView in addition to
  the legacy const char* path.
  Methods with WGPUStringView are suffixed with "2", but overloaded
  without the suffix in the C++ API.
- wgpu::StringView may be implicitly constructed from std::string_view,
  const char* to ease use in C++. Add tests for
  these constructors. wgpu::NullableStringView may be constructed from
  nullptr and std::nullopt
- Add tests for passing wgpu::StringView or passing it via implicit
  conversion into the API.
- WGPUStringView is passed into Dawn as std::string_view or as a
  std::optional<std::string_view> depending on whether the arg is
  nullable or not. This simplifies usage in Dawn and makes it more
  type safe.

Bug: 42241188
Change-Id: Ia3dc6ef5d55f382dc8d132d3f997bb84c08cda5b
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/198795
Reviewed-by: Kai Ninomiya <kainino@chromium.org>
Commit-Queue: Austin Eng <enga@chromium.org>
35 files changed
tree: 613a5ef5002ec6580270e222864b28a81329fba9
  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.