mirror of
https://github.com/encounter/dawn-cmake.git
synced 2025-07-11 07:35:55 +00:00
20881f39e7
Adds a basic adapter blocklist and adds two cases to it. By default, the blocklist is disabled until Chromium can enable it explicitly - perhaps based on --enable-unsafe-webgpu or some other flag. It will be switched to default to true in the future. about://gpu would disable the blocklist so all the adapters are visible there, but WebGPU would enable it. Trusted users of Dawn that are aware of potential bugs may also disable it. One downside is that about://gpu won't surface directly that an adapter is on the system, but blocklisted for WebGPU. Something like that can be added in the future, if necessary. In the future, this should probably be merged with Chromium's software_rendering_list.json, but that list doesn't support multi-adapter systems well (for blocklisting just one adapter), and it doesn't understand all the information we need for the current blocklist. Bug: dawn:1254, dawn:1196, tint:1753 Change-Id: I992bcd10dd5d3f5b23319fc4ec699b06bb1117da Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/119061 Kokoro: Kokoro <noreply+kokoro@google.com> Reviewed-by: Corentin Wallez <cwallez@chromium.org> Commit-Queue: Austin Eng <enga@chromium.org> Reviewed-by: Ben Clayton <bclayton@google.com>
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.hversion that Dawn implements. - A C++ wrapper for the
webgpu.h.
- The
- 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:
- 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.