Add DAWN_MULTILINE for minifying WGSL strings

And use it instead of raw strings in most places.

While doing that, also fixed the indentation of a bunch of strings (and
tried to make them look nice in the surrounding context) and removed a
bit of manually-added whitespace from generated strings, since generated
shaders are no longer nicely formatted at all.

Both clang-format and cpplint have minor issues with this approach
because they can't tell that the string is not C++ code.
- clang-format's WhitespaceSensitiveMacros option is buggy, so we
  need to pepper blank comments in a few places to prevent it from
  reformatting things it's not supposed to touch.
- cpplint has no option to disable for multiple lines, so one rule that
  triggers often on WGSL is easiest to just disable. Maybe this will
  not matter in the future, if we fully replace cpplint with clang-tidy.

In a local Skia build (with clang 17.0.0 from the system Xcode because
Skia isn't using a hermetic build on my Mac), this saves 22.3k:
  -159255840 out/DawnVulkan/libdawn_combined.a
  +159233520 out/DawnVulkan/libdawn_combined.a

Fixed: 475274568
Change-Id: Ibd70eefc7e314f8689bf06803e681a1ec10302d0
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/284555
Auto-Submit: Kai Ninomiya <kainino@chromium.org>
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
Reviewed-by: Kaylee Lubick <kjlubick@google.com>
Commit-Queue: Kai Ninomiya <kainino@chromium.org>
20 files changed
tree: 25a46d5ace620122fdc6aa10b47d0189a0defef5
  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. .bazelrc
  15. .clang-format
  16. .clang-format-ignore
  17. .clang-tidy
  18. .git-blame-ignore-revs
  19. .gitattributes
  20. .gitignore
  21. .gitmodules
  22. .gn
  23. .style.yapf
  24. .vpython3
  25. AUTHORS
  26. BUILD.bazel
  27. BUILD.gn
  28. CMakeLists.txt
  29. CMakeSettings.json
  30. CODE_OF_CONDUCT.md
  31. codereview.settings
  32. CONTRIBUTING.md
  33. CPPLINT.cfg
  34. DEPS
  35. DIR_METADATA
  36. go.mod
  37. go.sum
  38. go_presubmit_support.py
  39. LICENSE
  40. OWNERS
  41. PRESUBMIT.py
  42. README.chromium
  43. README.md
  44. test_spec_presubmit_support.py
  45. unsafe_buffers_paths.txt
  46. WATCHLISTS
  47. 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.