CMake-only fork of https://dawn.googlesource.com/dawn with cleaned, vendored dependencies
Go to file
Elie Michel 9ae8ed2f62 Add fetch_dawn_dependencies
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>
2023-05-12 20:19:41 +00:00
.vscode .vscode: Simplify build setup task 2023-03-04 00:49:51 +00:00
build_overrides remove use_system_libwayland 2023-01-25 19:32:15 +00:00
docs Add MSVS build instructions 2023-05-08 16:45:38 +00:00
generator Renames C++ object Release function to MoveToCHandle. 2023-05-10 23:48:22 +00:00
include [tint] Move AST transforms to a subdirectory 2023-05-11 13:10:59 +00:00
infra Add platforms to milestones.json 2023-05-12 17:03:13 +00:00
scripts d3d11: compile d3d11 backend in chromium build 2023-05-03 23:42:25 +00:00
src [tint] static_assert that C in Castable<C[, B]> is correct 2023-05-12 12:00:06 +00:00
test test/tint: Fix spvasm expectation 2023-05-09 20:09:58 +00:00
third_party Add fetch_dawn_dependencies 2023-05-12 20:19:41 +00:00
tools Add fetch_dawn_dependencies 2023-05-12 20:19:41 +00:00
webgpu-cts Roll third_party/webgpu-cts/ 499ce7de2..4fd26fe4a (7 commits) 2023-05-12 19:14:35 +00:00
.clang-format Add InsertBraces: true to .clang-format 2022-05-19 20:08:19 +00:00
.clang-tidy Update some forward declarations. 2022-05-30 18:00:58 +00:00
.gitattributes Fix Kokoro Windows build 2023-05-08 17:04:38 +00:00
.gitignore Add .gitignore entry for /third_party/google_benchmark/src 2023-04-18 19:55:47 +00:00
.gn Roll third_party/angle/ 52c42e5a8..4aa0975e6 (35 commits) 2022-05-25 16:06:54 +00:00
AUTHORS Merge remote-tracking branch 'tint/main' into HEAD 2022-04-06 15:37:27 -04:00
BUILD.gn Remove old src/include folder 2022-06-18 16:16:11 +00:00
CMakeLists.txt Add fetch_dawn_dependencies 2023-05-12 20:19:41 +00:00
CMakeSettings.json Normalize all line endings to LF 2022-04-08 14:18:28 +00:00
CODE_OF_CONDUCT.md Initial commit 2020-03-02 15:47:43 -05:00
CONTRIBUTING.md Combine contributing files. 2022-04-10 22:14:00 +00:00
CPPLINT.cfg Fixup CQ and Kokoro lint mismatches. 2022-04-13 16:14:26 +00:00
DEPS Roll third_party/webgpu-cts/ 499ce7de2..4fd26fe4a (7 commits) 2023-05-12 19:14:35 +00:00
DIR_METADATA Move metadata in OWNERS files to DIR_METADATA files 2021-02-04 01:26:43 +00:00
Doxyfile tint: add pretty printers for gdb and lldb 2022-10-27 20:17:45 +00:00
LICENSE Fix google3 license related issues 2021-12-02 21:25:58 +00:00
OWNERS Set OWNERS to * on .txt files needed for CTS rolls 2023-02-13 10:17:04 +00:00
PRESUBMIT.py tools: Move idlgen and run-cts to from dawn/node to tools/ 2022-12-12 23:06:43 +00:00
README.chromium Fix addition of README.md's content to README.chromium 2022-08-09 14:09:00 +00:00
README.md Fix addition of README.md's content to README.chromium 2022-08-09 14:09:00 +00:00
builder_impl_builtin_test.cc [ir] Spit builder_impl tests. 2023-05-04 18:01:26 +00:00
builder_impl_function_test.cc [ir] Spit builder_impl tests. 2023-05-04 18:01:26 +00:00
codereview.settings codereview.setings: default to not squashing on git cl upload 2021-03-10 18:35:58 +00:00
dawn.json Unset vertex buffer: validations and unittests 2023-05-11 19:26:30 +00:00
dawn_wire.json Add Device::GetSupportedSurfaceUsage() method. 2023-04-20 20:42:05 +00:00
go.mod Improvements to tint perfmon 2023-04-28 09:25:44 +00:00
go.sum Improvements to tint perfmon 2023-04-28 09:25:44 +00:00
go_presubmit_support.py Reland "Add expectations.txt validation to presubmit" 2022-12-08 21:57:55 +00:00
tint_overrides_with_defaults.gni tint/ir: Add GN option for building the IR 2023-04-26 22:05:42 +00:00

README.md

Dawn's logo: a sun rising behind a stylized mountain inspired by the WebGPU logo. The text "Dawn" is written below it.

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.h version that Dawn implements.
    • A C++ wrapper for the webgpu.h.
  • 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:

Documentation table of content

Developer documentation:

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.