Google Git
Sign in
dawn / dawn / 6b425c756b81a3ab0b5bd649078204a5921c3ebc
commit6b425c756b81a3ab0b5bd649078204a5921c3ebc[log] [tgz]
authorKai Ninomiya <kainino@chromium.org>Tue Jun 03 14:17:44 2025 -0700
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Tue Jun 03 14:17:44 2025 -0700
tree84cc6a4a583610f6ac5d7facb59c48a9778e5e45
parent086bb5d125dbe866689ada5cbde30a3f7d712756 [diff]
[emscripten] Link to README from emcc --use-port=emdawnwebgpu:help

This makes emcc --use-port=emdawnwebgpu:help point directly at the
README file, and shortens the prose description as all that other info
is in the readme.

emdawnwebgpu (--use-port=emdawnwebgpu; Some files: BSD 3-Clause License. Other files: Emscripten's license (available under both MIT License and University of Illinois/NCSA Open Source License))
Emdawnwebgpu implements webgpu.h on WebGPU, replacing -sUSE_WEBGPU. **For info on usage and filing feedback, see link below.**
Options:
* cpp_bindings: Add the include path for Dawn-like <webgpu/webgpu_cpp.h> C++ bindings. Default: true.
* opt_level: Optimization (-O) level for the bindings' Wasm layer. Default: choose based on -sASSERTIONS.
* shared_memory: Enable -sSHARED_MEMORY. Default: choose based on whether linker has -sSHARED_MEMORY enabled.
More info: https://dawn.googlesource.com/dawn/+/8c096fd9f643c8dc03639c127eb9593e4f5681fb/src/emdawnwebgpu/pkg/README.md

No-Try: true
Change-Id: Ib0e9be50ddf773df38f7e1952db5546ead806700
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/245195
Reviewed-by: Loko Kung <lokokung@google.com>
Auto-Submit: Kai Ninomiya <kainino@chromium.org>
Commit-Queue: Loko Kung <lokokung@google.com>
2 files changed
tree: 84cc6a4a583610f6ac5d7facb59c48a9778e5e45
  1. .github/
  2. .vscode/
  3. build_overrides/
  4. docs/
  5. generator/
  6. include/
  7. infra/
  8. scripts/
  9. src/
  10. test/
  11. third_party/
  12. tools/
  13. webgpu-cts/
  14. build
  15. buildtools
  16. testing
  17. .bazelrc
  18. .clang-format
  19. .clang-format-ignore
  20. .clang-tidy
  21. .git-blame-ignore-revs
  22. .gitattributes
  23. .gitignore
  24. .gitmodules
  25. .gn
  26. .style.yapf
  27. .vpython3
  28. AUTHORS
  29. BUILD.bazel
  30. BUILD.gn
  31. CMakeLists.txt
  32. CMakeSettings.json
  33. CODE_OF_CONDUCT.md
  34. codereview.settings
  35. CONTRIBUTING.md
  36. CPPLINT.cfg
  37. DEPS
  38. DIR_METADATA
  39. go.mod
  40. go.sum
  41. go_presubmit_support.py
  42. LICENSE
  43. OWNERS
  44. PRESUBMIT.py
  45. README.chromium
  46. README.md
  47. WATCHLISTS
  48. WORKSPACE.bazel
README.md

Build Status Matrix Space

Dawn, a WebGPU implementation

Dawn is an open-source and cross-platform implementation of the 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)

License

BSD 3-Clause License, please see LICENSE.

Disclaimer

This is not an officially supported Google product.