CMake-only fork of https://dawn.googlesource.com/dawn with cleaned, vendored dependencies
Go to file
Corentin Wallez 73ea1f1106 Simplify the device lifecycle.
What was previously the Device's loss status is now a state that also
contains the "being created" state. Its transitions are entirely
handled in the frontend which enforces somewhat uniform lifecycles
between backends.

The backend devices' ShutDownImpl() function is now guaranteed to be
called only during the destructor, which leads to further simplification.
Previously Destroy() could also be called when the device was first
lost. This require complications because, for example, a WGPUBuffer
could still exist, and would want to call some resource allocator
service after the call to Destroy(). Now destruction of the device's
backing API objects is deferred to the destructor. (that's ok as long
as the application can't submit any more work).

WaitForCompletion is now guaranteed to be called before ShutDownImpl() iff
the call to DeviceBase::Initialize was succesful and the backing device
not lost. The idea is that after DeviceBase::Initialize, the GPU can
have some work enqueued and we need to wait for it to complete before
deleting backing API objects. In the future we might also have backend
be reentrant, using WebGPU itself to implement parts of the backend.
Reentrant calls would only be allowed after DeviceBase::Initialize.

Also the DynamicUploader that was special-cased in all backends is
now handled entirely by the frontend.

Bug: dawn:373

Change-Id: I985417d67727ea3bc11849c999c5ef0e02403223
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/18801
Commit-Queue: Corentin Wallez <cwallez@chromium.org>
Reviewed-by: Austin Eng <enga@chromium.org>
2020-04-07 16:19:47 +00:00
build_overrides GN: Use the hermetic XCode if available. 2020-03-06 12:25:20 +00:00
docs BUILD.gn: rename libdawn_native/wire to dawn_native/wire 2020-04-07 07:44:00 +00:00
examples Use the default values for Dispatch in examples and tests 2020-03-31 16:23:35 +00:00
generator Fix a -Wstrict-prototypes 2020-04-07 16:09:27 +00:00
infra/config infra: Use macOS 10.15 and newer OSX SDK. 2020-02-25 17:12:27 +00:00
scripts perf_tests: Update perf_test_runner format. 2020-03-26 17:46:25 +00:00
src Simplify the device lifecycle. 2020-04-07 16:19:47 +00:00
third_party BUILD.gn: rename libdawn_native/wire to dawn_native/wire 2020-04-07 07:44:00 +00:00
tools/memory/asan Fix is_asan build (at least on Mac) 2020-04-06 22:27:02 +00:00
.clang-format Add .clang-format 2017-11-28 16:18:39 -05:00
.gitattributes Add .gitattributes to normalize EOL 2019-07-15 12:23:18 +00:00
.gitignore Allow using swiftshader with the Vulkan backend 2019-11-26 18:21:51 +00:00
.gn Re-enable -Wunguarded-availability in Dawn standalone builds 2019-12-11 16:54:51 +00:00
AUTHORS Rename NXT -> Dawn in the comments 2018-07-18 22:54:06 +02:00
BUILD.gn Fix Dawn's proxy groups to use public_deps instead of deps 2020-04-07 16:16:37 +00:00
CMakeLists.txt CMake: Add support for the D3D12 backend 2020-02-24 13:27:28 +00:00
CONTRIBUTING.md docs: write an overview of Dawn and split README.md 2019-12-05 11:01:41 +00:00
DEPS Fix is_asan build (at least on Mac) 2020-04-06 22:27:02 +00:00
LICENSE Initial commit of all the NXT integration. 2017-04-20 14:38:20 -04:00
OWNERS Add enga@chromium.org as OWNER 2020-04-02 18:14:37 +00:00
PRESUBMIT.py PRESUBMIT.py: Add formatting checks. 2018-09-11 08:06:36 -04:00
README.chromium Add component to OWNERS and fixup repo URL in README.chromium 2018-09-25 20:53:37 +00:00
README.md docs: write an overview of Dawn and split README.md 2019-12-05 11:01:41 +00:00
codereview.settings Initial CQ configuration 2018-08-23 08:33:35 -04:00
dawn.json Rename BG[L]Binding to BG[L]Entry 2020-04-07 07:11:12 +00:00
dawn_wire.json Introduce wgpu::Surface and implement it for HWND, X11 and Metal 2020-01-15 13:14:12 +00:00

README.md

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 on Windows 10
    • Metal on macOS and iOS
    • Vulkan on Windows, Linux, ChromeOS, Android and Fuchsia
    • OpenGL as best effort where available
  • A client-server implementation of WebGPU for applications that are in a sandbox without access to native drivers

Helpful links:

Documentation table of content

Developer documentation:

User documentation: (TODO, figure out what overlaps with webgpu.h docs)

Status

(TODO)

License

Apache 2.0 Public License, please see LICENSE.

Disclaimer

This is not an officially supported Google product.