Add building DXC support to CMake

Adds CMake option DAWN_USE_BUILT_DXC, defaulted to OFF. The flag mimics
the GN arg "dawn_use_built_dxc".

When enabled:
- Targets "dxc" and "dxcompiler" are added from third_party/dxc
- New target "copy_dxil_dll" is added (Windows only)
-  Macro "DAWN_USE_BUILT_DXC" is defined for certain Dawn targets
- dawn_native depends on "dxcompiler" and "copy_dxil_dll" so that it
will use this built version of DXC.

Also, test-runner now first looks for the validation tool executable in
dxc same directory as the tint executable before looking for it in PATH.
This allows it to use the DXC binary when built.

Bug: dawn:2258
Change-Id: Ide64e3e1cc1179fc0f1bac7947bc6d4275d0c413
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/161420
Reviewed-by: Ben Clayton <bclayton@google.com>
Kokoro: Kokoro <noreply+kokoro@google.com>
Commit-Queue: Antonio Maiorano <amaiorano@google.com>
5 files changed
tree: dce3b214f88833308d38dc3d8d3488fd582c3899
  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-tidy
  17. .gitattributes
  18. .gitignore
  19. .gitmodules
  20. .gn
  21. AUTHORS
  22. BUILD.bazel
  23. BUILD.gn
  24. CMakeLists.txt
  25. CMakeSettings.json
  26. CODE_OF_CONDUCT.md
  27. codereview.settings
  28. CONTRIBUTING.md
  29. CPPLINT.cfg
  30. dawn.json
  31. dawn_wire.json
  32. DEPS
  33. DIR_METADATA
  34. Doxyfile
  35. go.mod
  36. go.sum
  37. go_presubmit_support.py
  38. LICENSE
  39. OWNERS
  40. PRESUBMIT.py
  41. README.chromium
  42. README.md
  43. 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.