Google Git
Sign in
dawn / tint / 874d1b66186ff8d0cb249bc73ccaea08144c36b0
commit874d1b66186ff8d0cb249bc73ccaea08144c36b0[log] [tgz]
authorTint team <no-reply@google.com>Fri Oct 21 15:00:29 2022 +0000
committerTint LUCI CQ <tint-scoped@luci-project-accounts.iam.gserviceaccount.com>Fri Oct 21 15:00:29 2022 +0000
treea4c8309e806d02bd4967c2eb0441527727f3f11e
parent5062c025640a19bc50dc7fa09eefbb060ee0b6bf [diff]
Import Tint changes from Dawn

Changes:
  - b8b0c21918d43d64ccd34c795431f9b3bfd03514 Add break-if support. by dan sinclair <dsinclair@chromium.org>
  - b69c6066c4f0d73f2e3f226c840bcb2d90f0ba5b tint: Fix uniformity ICE during error reporting wrt non-u... by Antonio Maiorano <amaiorano@google.com>
  - 481b2ed959fff0497fb12762c8a243a5c5349593 Fix issue resolving address of numeric. by dan sinclair <dsinclair@chromium.org>
  - 882b38a2f50829e1205c8b7bd955c438a44d78a7 Update fallthrough deprecation notice. by dan sinclair <dsinclair@chromium.org>
  - 6e77b47ed98e5a81ac2edd6115bd3434d5c766b9 Update internals to initializer instead of constructor. by dan sinclair <dsinclair@chromium.org>
  - fdd2ff11455b9c628e7b9383e5cabe1825878c55 Add tests to show correct handling of mixed && and ||. by dan sinclair <dsinclair@chromium.org>
  - 1c94938726db859f555167d5028f5230d83a0567 tint: implement updated spec rules for shift left of conc... by Antonio Maiorano <amaiorano@google.com>
  - 3fa6887679673c88aa7e8e3bcfb7a16aa749ecc9 tint: use struct instead of tuple for test cases by Antonio Maiorano <amaiorano@google.com>
  - f148f0891bf5c36d9631ebe03020e83ed1c6070a [WGSL] Allow default as a case selector by dan sinclair <dsinclair@chromium.org>
  - d32fbe07e76a37f0df143bbdd1fb1be70c29b93b Store expressions in switch case statements. by dan sinclair <dsinclair@chromium.org>
  - 00aa7ef462c5cbc450f081a97dc68dddb7b2425a tint/reader/wgsl: Better diagnostics for missing parenthe... by Ben Clayton <bclayton@google.com>
  - b6e1bc7d5d2fcd5166816ca4c4d1d5e33b3ce255 tint: Fix C++ UB when shifting abstract 0 left by >= 64 by Antonio Maiorano <amaiorano@google.com>
GitOrigin-RevId: b8b0c21918d43d64ccd34c795431f9b3bfd03514
Change-Id: I03ade9548ff45b78ad6a6dcea8f4e4f64eaf9eec
Reviewed-on: https://dawn-review.googlesource.com/c/tint/+/106412
Kokoro: Kokoro <noreply+kokoro@google.com>
Reviewed-by: Ben Clayton <bclayton@google.com>
Commit-Queue: Copybara Prod <copybara-worker-blackhole@google.com>
Commit-Queue: Ben Clayton <bclayton@google.com>
178 files changed
tree: a4c8309e806d02bd4967c2eb0441527727f3f11e
  1. .vscode/
  2. build_overrides/
  3. docs/
  4. include/
  5. infra/
  6. kokoro/
  7. src/
  8. third_party/
  9. tools/
  10. .clang-format
  11. .gitignore
  12. .gn
  13. AUTHORS
  14. BUILD.gn
  15. CMakeLists.txt
  16. CMakeSettings.json
  17. CODE_OF_CONDUCT.md
  18. CPPLINT.cfg
  19. DEPS
  20. Doxyfile
  21. LICENSE
  22. OWNERS
  23. PRESUBMIT.py
  24. README.md
  25. standalone.gclient
  26. tint_overrides_with_defaults.gni
README.md

Tint

Note: This repo is read-only, minimized mirror of the Dawn repo.

Tint changes should be made in the Dawn repo.

Tint is a compiler for the WebGPU Shader Language (WGSL).

This is not an officially supported Google product.

Requirements

  • Git
  • CMake (3.10.2 or later)
  • Ninja (or other build tool)
  • Python, for fetching dependencies
  • depot_tools in your path

Build options

  • TINT_BUILD_SPV_READER : enable the SPIR-V input reader (off by default)
  • TINT_BUILD_WGSL_READER : enable the WGSL input reader (on by default)
  • TINT_BUILD_SPV_WRITER : enable the SPIR-V output writer (on by default)
  • TINT_BUILD_WGSL_WRITER : enable the WGSL output writer (on by default)
  • TINT_BUILD_FUZZERS : enable building fuzzzers (off by default)

Building

Tint uses Chromium dependency management so you need to install depot_tools and add it to your PATH.

Getting source & dependencies

# Clone the repo as "tint"
git clone https://dawn.googlesource.com/tint tint
cd tint

# Bootstrap the gclient configuration
cp standalone.gclient .gclient

# Fetch external dependencies and toolchains with gclient
gclient sync

Compiling using CMake + Ninja

mkdir -p out/Debug
cd out/Debug
cmake -GNinja ../..
ninja # or autoninja

Compiling using CMake + make

mkdir -p out/Debug
cd out/Debug
cmake ../..
make # -j N for N-way parallel build

Compiling using gn + ninja

mkdir -p out/Debug
gn gen out/Debug
autoninja -C out/Debug

Fuzzers on MacOS

If you are attempting fuzz, using TINT_BUILD_FUZZERS=ON, the version of llvm in the XCode SDK does not have the needed libfuzzer functionality included.

The build error that you will see from using the XCode SDK will look something like this:

ld: file not found:/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.0/lib/darwin/libclang_rt.fuzzer_osx.a

The solution to this problem is to use a full version llvm, like what you would get via homebrew, brew install llvm, and use something like CC=<path to full clang> cmake .. to setup a build using that toolchain.

Checking [chromium-style] issues in CMake builds

The gn based work flow uses the Chromium toolchain for building in anticipation of integration of Tint into Chromium based projects. This toolchain has additional plugins for checking for style issues, which are marked with [chromium-style] in log messages. This means that this toolchain is more strict then the default clang toolchain.

In the future we will have a CQ that will build this work flow and flag issues automatically. Until that is in place, to avoid causing breakages you can run the [chromium-style] checks using the CMake based work flows. This requires setting CC to the version of clang checked out by gclient sync and setting the TINT_CHECK_CHROMIUM_STYLE to ON.

mkdir -p out/style
cd out/style
cmake ../..
CC=../../third_party/llvm-build/Release+Asserts/bin/clang cmake -DTINT_CHECK_CHROMIUM_STYLE=ON ../../ # add -GNinja for ninja builds

Issues

Please file any issues or feature requests at https://bugs.chromium.org/p/tint/issues/entry

Contributing

Please see the contributing guide in the Dawn repo.