Austin Eng | 165c1c0 | 2023-11-09 23:12:35 +0000 | [diff] [blame] | 1 | <div align="center"> |
| 2 | <img |
| 3 | title="Dawn's logo" |
| 4 | alt="Dawn's logo: a sun rising behind a stylized mountain inspired by the WebGPU logo." |
| 5 | src="docs/imgs/dawn_logo_notext.png" |
| 6 | width="50%"> |
| 7 | |
| 8 | ![Build Status](https://github.com/google/dawn/actions/workflows/ci.yml/badge.svg?branch=main&event=push) |
| 9 | [![Matrix Space](https://img.shields.io/static/v1?label=Space&message=%23webgpu-dawn&color=blue&logo=matrix)](https://matrix.to/#/#webgpu-dawn:matrix.org) |
| 10 | </div> |
Corentin Wallez | 749e144 | 2021-09-02 09:51:40 +0000 | [diff] [blame] | 11 | |
Corentin Wallez | 3b24668 | 2018-08-16 13:50:49 +0200 | [diff] [blame] | 12 | # Dawn, a WebGPU implementation |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 13 | |
Austin Eng | 165c1c0 | 2023-11-09 23:12:35 +0000 | [diff] [blame] | 14 | Dawn is an open-source and cross-platform implementation of the [WebGPU](https://webgpu.dev) standard. |
dan sinclair | fb5a492 | 2022-04-19 22:25:45 +0000 | [diff] [blame] | 15 | More precisely it implements [`webgpu.h`](https://github.com/webgpu-native/webgpu-headers/blob/main/webgpu.h) that is a one-to-one mapping with the WebGPU IDL. |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 16 | Dawn is meant to be integrated as part of a larger system and is the underlying implementation of WebGPU in Chromium. |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 17 | |
Corentin Wallez | 3b24668 | 2018-08-16 13:50:49 +0200 | [diff] [blame] | 18 | Dawn provides several WebGPU building blocks: |
| 19 | - **WebGPU C/C++ headers** that applications and other building blocks use. |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 20 | - The `webgpu.h` version that Dawn implements. |
| 21 | - A C++ wrapper for the `webgpu.h`. |
Corentin Wallez | d072e11 | 2022-08-09 14:09:00 +0000 | [diff] [blame] | 22 | - **A "native" implementation of WebGPU** using platforms' GPU APIs: D3D12, Metal, Vulkan and OpenGL. See [per API support](docs/support.md) for more details. |
Corentin Wallez | 3b24668 | 2018-08-16 13:50:49 +0200 | [diff] [blame] | 23 | - **A client-server implementation of WebGPU** for applications that are in a sandbox without access to native drivers |
Corentin Wallez | d072e11 | 2022-08-09 14:09:00 +0000 | [diff] [blame] | 24 | - **Tint** is a compiler for the WebGPU Shader Language (WGSL) that can be used in standalone to convert shaders from and to WGSL. |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 25 | |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 26 | Helpful links: |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 27 | |
dan sinclair | 5ee22f3 | 2022-04-28 16:25:43 +0000 | [diff] [blame] | 28 | - [Dawn bug tracker](https://bugs.chromium.org/p/dawn/issues/entry) if you find issues with Dawn. |
| 29 | - [Tint bug tracker](https://bugs.chromium.org/p/tint/issues/entry) if you find issues with Tint. |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 30 | - [Dawn's mailing list](https://groups.google.com/forum/#!members/dawn-graphics) for other discussions related to Dawn. |
| 31 | - [Dawn's source code](https://dawn.googlesource.com/dawn) |
Corentin Wallez | d05e532 | 2020-09-11 10:38:46 +0000 | [diff] [blame] | 32 | - [Dawn's Matrix chatroom](https://matrix.to/#/#webgpu-dawn:matrix.org) for live discussion around contributing or using Dawn. |
Corentin Wallez | 094d1d4 | 2020-04-24 12:38:13 +0000 | [diff] [blame] | 33 | - [WebGPU's Matrix chatroom](https://matrix.to/#/#WebGPU:matrix.org) |
dan sinclair | 5ee22f3 | 2022-04-28 16:25:43 +0000 | [diff] [blame] | 34 | - [Tint mirror](https://dawn.googlesource.com/tint) for standalone usage. |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 35 | |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 36 | ## Documentation table of content |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 37 | |
Corentin Wallez | 1d6250d | 2019-12-05 11:01:41 +0000 | [diff] [blame] | 38 | Developer documentation: |
Corentin Wallez | f07e3bd | 2017-04-20 14:38:20 -0400 | [diff] [blame] | 39 | |
Ben Clayton | 26c31f6 | 2022-01-27 18:33:47 +0000 | [diff] [blame] | 40 | - [Dawn overview](docs/dawn/overview.md) |
dan sinclair | 5ee22f3 | 2022-04-28 16:25:43 +0000 | [diff] [blame] | 41 | - [Building](docs/building.md) |
| 42 | - [Contributing](CONTRIBUTING.md) |
| 43 | - [Code of Conduct](CODE_OF_CONDUCT.md) |
Ben Clayton | 26c31f6 | 2022-01-27 18:33:47 +0000 | [diff] [blame] | 44 | - [Testing Dawn](docs/dawn/testing.md) |
David Neto | 750120f | 2023-09-19 21:15:38 +0000 | [diff] [blame] | 45 | - [Testing Tint](docs/tint/testing.md) |
Ben Clayton | 26c31f6 | 2022-01-27 18:33:47 +0000 | [diff] [blame] | 46 | - [Debugging Dawn](docs/dawn/debugging.md) |
| 47 | - [Dawn's infrastructure](docs/dawn/infra.md) |
| 48 | - [Dawn errors](docs/dawn/errors.md) |
dan sinclair | 5ee22f3 | 2022-04-28 16:25:43 +0000 | [diff] [blame] | 49 | - [Tint experimental extensions](docs/tint/experimental_extensions.md) |
| 50 | |
David Neto | b5bced2 | 2018-11-13 09:10:37 +0000 | [diff] [blame] | 51 | |
Corentin Wallez | e3faaae | 2020-10-21 14:37:52 +0000 | [diff] [blame] | 52 | User documentation: (TODO, figure out what overlaps with the webgpu.h docs) |
David Neto | b5bced2 | 2018-11-13 09:10:37 +0000 | [diff] [blame] | 53 | |
Corentin Wallez | 3b24668 | 2018-08-16 13:50:49 +0200 | [diff] [blame] | 54 | ## License |
| 55 | |
Austin Eng | cc2516a | 2023-10-17 20:57:54 +0000 | [diff] [blame] | 56 | BSD 3-Clause License, please see [LICENSE](/LICENSE). |
Corentin Wallez | 3b24668 | 2018-08-16 13:50:49 +0200 | [diff] [blame] | 57 | |
| 58 | ## Disclaimer |
| 59 | |
| 60 | This is not an officially supported Google product. |