Cross-platform, safe, pure-rust graphics api.
Go to file
Jim Blandy 86b6db6f76
[wgsl-in] Let lowering contexts point to a Function directly. (#2580)
Change `StatementContext` and `RuntimeExpressionContext` in
`front::wgsl::lower` to hold a `&mut crate::Function` reference,
rather than separate pointers to individual fields of the `Function`.
This replaces three fields with one, and clarifies their
relationships.
2023-10-24 12:04:41 +02:00
.cargo build: move from make to cargo xtask workflows 2023-06-08 16:56:57 +02:00
.github Add codeowners file 2023-10-11 14:05:04 -04:00
benches add debug info for spv-out (#2379) 2023-06-28 14:30:25 +02:00
cli Change naga:🔙:spv::DebugInfo::file_name to a &Path. 2023-09-25 07:59:41 -07:00
fuzz add Capabilities::MULTISAMPLED_SHADING 2023-02-16 18:16:49 -05:00
hlsl-snapshots Fix installing naga-cli from git (#2398) 2023-07-08 01:33:48 +02:00
src [wgsl-in] Let lowering contexts point to a Function directly. (#2580) 2023-10-24 12:04:41 +02:00
tests Don't use layout qualifiers to allow for GLSL 140 support (#2575) 2023-10-24 11:56:04 +02:00
xtask [ci] Specify -HV 2018 to dxc (#2447) 2023-08-29 19:59:50 +02:00
.gitattributes Require LF for snapshots (#2253) 2023-02-16 01:54:49 +01:00
.gitignore Add vim .swp files to gitignore (#2448) 2023-08-19 17:35:22 +02:00
Cargo.toml Implement module compaction. 2023-09-20 18:46:33 +02:00
CHANGELOG.md Bump MSRV to 1.65. 2023-08-02 09:25:31 -07:00
codecov.yml stop code coverage comments (#2283) 2023-04-05 17:54:07 +02:00
LICENSE-APACHE Relicense under MIT+Apache2 2020-06-21 16:59:16 -04:00
LICENSE-MIT Add MIT license 2021-02-17 09:34:17 -05:00
README.md Bump MSRV to 1.65. 2023-08-02 09:25:31 -07:00

Naga

Matrix Crates.io Docs.rs Build Status MSRV codecov.io

The shader translation library for the needs of wgpu.

Supported end-points

Front-end Status Feature Notes
SPIR-V (binary) spv-in
WGSL wgsl-in Fully validated
GLSL 🆗 glsl-in GLSL 440+ and Vulkan semantics only
Back-end Status Feature Notes
SPIR-V spv-out
WGSL 🆗 wgsl-out
Metal msl-out
HLSL hlsl-out Shader Model 5.0+ (DirectX 11+)
GLSL 🆗 glsl-out GLSL 330+ and GLSL ES 300+
AIR
DXIL/DXIR
DXBC
DOT (GraphViz) 🆗 dot-out Not a shading language

= Primary support — 🆗 = Secondary support — 🚧 = Unsupported, but support in progress

Conversion tool

Naga can be used as a CLI, which allows to test the conversion of different code paths.

First, install naga-cli from crates.io or directly from GitHub.

# release version
cargo install naga-cli

# development version
cargo install naga-cli --git https://github.com/gfx-rs/naga.git

Then, you can run naga command.

naga my_shader.wgsl # validate only
naga my_shader.spv my_shader.txt # dump the IR module into a file
naga my_shader.spv my_shader.metal --flow-dir flow-dir # convert the SPV to Metal, also dump the SPIR-V flow graph to `flow-dir`
naga my_shader.wgsl my_shader.vert --profile es310 # convert the WGSL to GLSL vertex stage under ES 3.20 profile

As naga includes a default binary target, you can also use cargo run without installation. This is useful when you develop naga itself, or investigate the behavior of naga at a specific commit (e.g. wgpu might pin a different version of naga than the HEAD of this repository).

cargo run my_shader.wgsl

Development workflow

The main instrument aiding the development is the good old cargo test --all-features --workspace, which will run the unit tests, and also update all the snapshots. You'll see these changes in git before committing the code.

If working on a particular front-end or back-end, it may be convenient to enable the relevant features in Cargo.toml, e.g.

default = ["spv-out"] #TEMP!

This allows IDE basic checks to report errors there, unless your IDE is sufficiently configurable already.

Finally, when changes to the snapshots are made, we should verify that the produced shaders are indeed valid for the target platforms they are compiled for:

cargo xtask validate spv # for Vulkan shaders, requires SPIRV-Tools installed
cargo xtask validate msl # for Metal shaders, requires XCode command-line tools installed
cargo xtask validate glsl # for OpenGL shaders, requires GLSLang installed
cargo xtask validate dot # for dot files, requires GraphViz installed
cargo xtask validate wgsl # for WGSL shaders
cargo xtask validate hlsl dxc # for HLSL shaders via DXC
cargo xtask validate hlsl fxc # for HLSL shaders via FXC