CMake-only fork of https://dawn.googlesource.com/dawn with cleaned, vendored dependencies
This change ensures that when errors are raised from WebGPU, including lost context errors, they can include any associated Vulkan validation layer messages in the message text if backend validation is enabled. This will allow these messages to be surfaced in places like when running CTS tests on browser build infrastructure. Because of how Vulkan messages are raised at the instance level, some routing of the messages to the appropriate device needed to be added. This is based on appending message IDs to object labels and then parsing them out of the message when it comes in. This change also makes Vulkan validation messages cause a device loss, which is inline with the behavior of the D3D12 backend. Bug: dawn:1396 Change-Id: I2b309ba5475a338e7e99d4b4daaa7c3d5de61011 Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/88460 Reviewed-by: Kai Ninomiya <kainino@chromium.org> Commit-Queue: Brandon Jones <bajones@chromium.org> |
||
---|---|---|
.vscode | ||
build_overrides | ||
docs | ||
generator | ||
include | ||
infra | ||
scripts | ||
src | ||
test | ||
third_party | ||
tools | ||
webgpu-cts | ||
.clang-format | ||
.gitattributes | ||
.gitignore | ||
.gn | ||
AUTHORS | ||
BUILD.gn | ||
CMakeLists.txt | ||
CMakeSettings.json | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
CPPLINT.cfg | ||
DEPS | ||
DIR_METADATA | ||
Doxyfile | ||
LICENSE | ||
OWNERS | ||
PRESUBMIT.py | ||
README.chromium | ||
README.md | ||
codereview.settings | ||
dawn.json | ||
dawn_wire.json | ||
go.mod | ||
go.sum | ||
tint_overrides_with_defaults.gni |
README.md
Dawn, a WebGPU implementation
Dawn is an open-source and cross-platform implementation of the work-in-progress 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
.
- The
- A "native" implementation of WebGPU using platforms' GPU APIs:
- D3D12 on Windows 10
- Metal on macOS and iOS
- Vulkan on Windows, Linux, ChromeOS, Android and Fuchsia
- OpenGL as best effort where available
- 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).
Helpful links:
- Dawn bug tracker if you find issues with Dawn.
- Tint bug tracker if you find issues with Tint.
- Dawn's mailing list for other discussions related to Dawn.
- Dawn's source code
- Dawn's Matrix chatroom for live discussion around contributing or using Dawn.
- WebGPU's Matrix chatroom
- Tint mirror for standalone usage.
Documentation table of content
Developer documentation:
- Dawn overview
- Building
- Contributing
- Code of Conduct
- Testing Dawn
- Debugging Dawn
- Dawn's infrastructure
- Dawn errors
- Tint experimental extensions
User documentation: (TODO, figure out what overlaps with the webgpu.h docs)
Status
(TODO)
License
Apache 2.0 Public License, please see LICENSE.
Disclaimer
This is not an officially supported Google product.