CMake-only fork of https://dawn.googlesource.com/dawn with cleaned, vendored dependencies
Go to file
Austin Eng 0eff5987f0 Add chained DawnTextureInternalUsageDescriptor
This chained struct can be used for internally adding usages to
Dawn textures. It will affect how the texture is allocated, but
not affect frontend validation.

One use case for this is so that Chromium can use an internal
copyTextureToTexture command to implement copies from a WebGPU
texture-backed canvas to other Web platform primitives when the
swapchain texture was not explicitly created with CopySrc usage
in Javascript.

Usage:

wgpu::DawnTextureInternalUsageDescriptor internalDesc = {};
internalDesc.internalUsage = wgpu::TextureUsage::CopySrc;

wgpu::TextureDescriptor desc = {};
// set properties of desc.
desc.nextInChain = &internalDesc;

device.createTexture(&desc);

Fixed: dawn:1027
Change-Id: Id4d08b5588d4960d150d559aa11502c69f40a674
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/58140
Commit-Queue: Austin Eng <enga@chromium.org>
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
2021-07-27 19:59:58 +00:00
.vscode .vscode: Fix quotations in windows 'gn gen' task 2021-07-21 14:07:49 +00:00
build_overrides dawn_native: Add a force_wgsl_step toggle. 2021-06-28 10:23:08 +00:00
docs Add chained DawnTextureInternalUsageDescriptor 2021-07-27 19:59:58 +00:00
examples wgpu::InputStepMode -> VertexStepMode 2021-07-25 18:40:19 +00:00
generator wgpu::InputStepMode -> VertexStepMode 2021-07-25 18:40:19 +00:00
infra/config Force Python 3 in presubmit 2021-07-20 17:57:20 +00:00
scripts Disable OpenGLES in uwp compilation. 2021-05-31 08:46:21 +00:00
src Add chained DawnTextureInternalUsageDescriptor 2021-07-27 19:59:58 +00:00
third_party Remove the dependency on shaderc and glslang. 2021-03-24 16:02:13 +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 Remove the dependency on shaderc and glslang. 2021-03-24 16:02:13 +00:00
.gn Use .gn to set overrides for VulkanMemoryAllocator 2021-04-06 16:54:19 +00:00
AUTHORS Rename NXT -> Dawn in the comments 2018-07-18 22:54:06 +02:00
BUILD.gn GN: add a default build target 2021-02-02 17:03:30 +00:00
CMakeLists.txt CMake: update backend selection 2021-06-30 15:06:43 +00:00
DEPS Roll Tint from 97668c8c37 to dffa60ca98 (1 revision) 2021-07-27 17:17:18 +00:00
DIR_METADATA Move metadata in OWNERS files to DIR_METADATA files 2021-02-04 01:26:43 +00:00
LICENSE Initial commit of all the NXT integration. 2017-04-20 14:38:20 -04:00
OWNERS Move metadata in OWNERS files to DIR_METADATA files 2021-02-04 01:26:43 +00:00
PRESUBMIT.py Force Python 3 in presubmit 2021-07-20 17:57:20 +00:00
README.chromium Add component to OWNERS and fixup repo URL in README.chromium 2018-09-25 20:53:37 +00:00
README.md Add docs/contributing.md 2021-04-21 18:05:01 +00:00
codereview.settings codereview.setings: default to not squashing on git cl upload 2021-03-10 18:35:58 +00:00
dawn.json Add chained DawnTextureInternalUsageDescriptor 2021-07-27 19:59:58 +00:00
dawn_wire.json MapAsync update: keep read/write handle through lifetime of mappable buffers 2021-07-08 22:48:57 +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 the webgpu.h docs)

Status

(TODO)

License

Apache 2.0 Public License, please see LICENSE.

Disclaimer

This is not an officially supported Google product.