mirror of
https://github.com/encounter/dawn-cmake.git
synced 2025-06-27 08:53:35 +00:00
a8236a5529
There's a few reasons for this change: * Not all values have identifiers, and carrying redundant fields is inefficent. * Not all IDs will be integers - much like LLVM IR and SPIR-V, we will likely want to disassemble with textual identifiers, so a uint32_t is not ideal, and a std::string is even more bloat for each value. * Transforms don't use identifiers, but instead raw pointers. We don't want to encourage using IDs as they're simply a less-efficient way to refer to values. * This makes values consistent with types and flow-control blocks, as they will both have their disassembly ID generated by the disassembler. The next step will be to add a hashmap to the module so that pre-declared value names can be stored out-of-band. Bug: tint:1718 Change-Id: I80beafc165f2bde54cc44a91015776926ca952b2 Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/131740 Kokoro: Kokoro <noreply+kokoro@google.com> Reviewed-by: James Price <jrprice@google.com> Commit-Queue: 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.