2020-03-02 20:47:43 +00:00
|
|
|
# Tint
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
## Build options
|
|
|
|
* `TINT_BUILD_SPV_PARSER` : enable the SPIR-V input parser
|
|
|
|
|
|
|
|
## Building
|
2020-03-05 15:58:27 +00:00
|
|
|
Tint uses Chromium dependency management so you need to [install depot_tools] and add it to your PATH.
|
2020-03-02 20:47:43 +00:00
|
|
|
|
2020-03-05 15:58:27 +00:00
|
|
|
[install depot_tools]: http://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up
|
|
|
|
|
|
|
|
### Getting source & dependencies
|
|
|
|
|
|
|
|
```sh
|
|
|
|
# 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
|
2020-03-02 20:47:43 +00:00
|
|
|
```
|
2020-03-05 15:58:27 +00:00
|
|
|
|
|
|
|
### Compiling using CMake + Ninja
|
|
|
|
```sh
|
2020-03-02 20:47:43 +00:00
|
|
|
mkdir -p out/Debug
|
|
|
|
cd out/Debug
|
|
|
|
cmake -GNinja ../..
|
2020-03-05 15:58:27 +00:00
|
|
|
ninja # or autoninja
|
|
|
|
```
|
|
|
|
|
|
|
|
### Compiling using CMake + make
|
|
|
|
```sh
|
|
|
|
mkdir -p out/Debug
|
|
|
|
cd out/Debug
|
|
|
|
cmake ../..
|
|
|
|
make # -j N for N-way parallel build
|
2020-03-02 20:47:43 +00:00
|
|
|
```
|
|
|
|
|
2020-03-05 15:06:38 +00:00
|
|
|
## Issues
|
|
|
|
Please file any issues or feature requests at
|
|
|
|
https://bugs.chromium.org/p/tint/issues/entry
|
|
|
|
|
2020-03-02 20:47:43 +00:00
|
|
|
## Contributing
|
|
|
|
Please see the CONTRIBUTING and CODE_OF_CONDUCT files on how to contribute to
|
|
|
|
Tint.
|