2018-08-16 11:50:49 +00:00
# Dawn, a WebGPU implementation
2019-12-05 11:01:41 +00:00
Dawn is an open-source and cross-platform implementation of the work-in-progress [WebGPU ](https://webgpu.dev ) standard.
More precisely it implements [`webgpu.h` ](https://github.com/webgpu-native/webgpu-headers/blob/master/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.
2018-08-16 11:50:49 +00:00
Dawn provides several WebGPU building blocks:
- **WebGPU C/C++ headers** that applications and other building blocks use.
2019-12-05 11:01:41 +00:00
- The `webgpu.h` version that Dawn implements.
- A C++ wrapper for the `webgpu.h` .
2018-08-16 11:50:49 +00:00
- **A "native" implementation of WebGPU** using platforms' GPU APIs:
2018-08-20 11:30:46 +00:00
- **D3D12** on Windows 10
2019-12-05 11:01:41 +00:00
- **Metal** on macOS and iOS
- **Vulkan** on Windows, Linux, ChromeOS, Android and Fuchsia
2018-08-20 11:30:46 +00:00
- OpenGL as best effort where available
2018-08-16 11:50:49 +00:00
- **A client-server implementation of WebGPU** for applications that are in a sandbox without access to native drivers
2019-12-05 11:01:41 +00:00
Helpful links:
2018-08-16 11:50:49 +00:00
2019-12-05 11:01:41 +00:00
- [Dawn's bug tracker ](https://bugs.chromium.org/p/dawn/issues/entry ) if you find issues with Dawn.
- [Dawn's mailing list ](https://groups.google.com/forum/#!members/dawn-graphics ) for other discussions related to Dawn.
- [Dawn's source code ](https://dawn.googlesource.com/dawn )
2020-09-11 10:38:46 +00:00
- [Dawn's Matrix chatroom ](https://matrix.to/#/#webgpu-dawn:matrix.org ) for live discussion around contributing or using Dawn.
2020-04-24 12:38:13 +00:00
- [WebGPU's Matrix chatroom ](https://matrix.to/#/#WebGPU:matrix.org )
2018-08-16 11:50:49 +00:00
2019-12-05 11:01:41 +00:00
## Documentation table of content
2018-08-16 11:50:49 +00:00
2019-12-05 11:01:41 +00:00
Developer documentation:
2018-08-16 11:50:49 +00:00
2019-12-05 11:01:41 +00:00
- [Dawn overview ](docs/overview.md )
- [Building Dawn ](docs/buiding.md )
- [Contributing to Dawn ](CONTRIBUTING.md )
- [Testing Dawn ](docs/testing.md )
- [Debugging Dawn ](docs/debugging.md )
- [Dawn's infrastructure ](docs/infra.md )
2018-11-13 09:10:37 +00:00
2020-10-21 14:37:52 +00:00
User documentation: (TODO, figure out what overlaps with the webgpu.h docs)
2018-11-13 09:10:37 +00:00
2019-12-05 11:01:41 +00:00
## Status
2017-04-20 18:38:20 +00:00
2019-12-05 11:01:41 +00:00
(TODO)
2018-10-08 13:51:18 +00:00
2018-08-16 11:50:49 +00:00
## License
2017-04-20 18:38:20 +00:00
2019-12-05 11:01:41 +00:00
Apache 2.0 Public License, please see [LICENSE ](/LICENSE ).
2017-04-20 18:38:20 +00:00
2018-08-16 11:50:49 +00:00
## Disclaimer
2017-04-20 18:38:20 +00:00
2018-08-16 11:50:49 +00:00
This is not an officially supported Google product.