mirror of
https://github.com/encounter/dawn-cmake.git
synced 2025-07-15 17:45:58 +00:00
9ae8ed2f62
This adds a DAWN_FETCH_DEPENDENCIES CMake option (default: OFF) that if turned ON fetches dependencies using a basic Python script that reads DEPS files instead of requiring the installation of depot_tools by all projects that depend on Dawn. The script is not equivalent to gclient as it is not aware of advanced configuration options (it always gets the list of dependencies that is hardcoded at the beginning) but at least for a regular use of Dawn as a dependency that provides a WebGPU backend (the intended use of this DAWN_FETCH_DEPENDENCIES option) it is enough. This is an attempt at merging upstream [this repository](https://github.com/eliemichel/WebGPU-distribution/tree/dawn) that I currently recommend in [Learn WebGPU for native C++](https://eliemichel.github.io/LearnWebGPU/getting-started/hello-webgpu.html) as a shallow intermediary to avoid requiring depot_tools (and turn some options on/off). By default, the script performs shallow clones, getting only the very commit that is needed. This is a great improvement over naive clone: | Regular | Shallow | ----------------|---------|---------| Downloaded size | 194 MB | 15 MB | Stored size | 294 MB | 103 MB | Change-Id: Iaedb4af78036a1696b68787c36f1d3d70e18ba2c Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/131750 Commit-Queue: Austin Eng <enga@chromium.org> Reviewed-by: Ben Clayton <bclayton@google.com> Kokoro: Kokoro <noreply+kokoro@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.