gecko-dev/third_party/rust/naga/README.md

# Naga

[![Matrix](https://img.shields.io/badge/Matrix-%23naga%3Amatrix.org-blueviolet.svg)](https://matrix.to/#/#naga:matrix.org)
[![Crates.io](https://img.shields.io/crates/v/naga.svg?label=naga)](https://crates.io/crates/naga)
[![Docs.rs](https://docs.rs/naga/badge.svg)](https://docs.rs/naga)
[![Build Status](https://travis-ci.org/gfx-rs/naga.svg?branch=master)](https://travis-ci.org/gfx-rs/naga)

This is an experimental shader translation library for the needs of gfx-rs project and WebGPU. It's meant to provide a safe and performant way of converting to and from SPIR-V.

## Supported end-points

Front-end       |       Status       | Notes |
--------------- | ------------------ | ----- |
SPIR-V (binary) | :construction:     |       |
WGSL (Tint)     | :construction:     |       |
GLSL (Vulkan)   |                    |       |
Rust            |                    |       |

Back-end        |       Status       | Notes |
--------------- | ------------------ | ----- |
SPIR-V (binary) |                    |       |
WGSL            |                    |       |
Metal           | :construction:     |       |
HLSL            |                    |       |
GLSL            |                    |       |
AIR             |                    |       |
DXIR            |                    |       |
DXIL            |                    |       |
DXBC            |                    |       |
Bug 1641370 - Add optional SPIR-V shader validation to WebGPU, via naga r=jgilbert This change attempts to parse the incoming SPIR-V shader modules with Naga SPIR-V front-end. It's not complete, but it returns an Error if it's unable to parse, in which case we just continue without the validation (for now). If it succeeds, we extract the reflection information from it, and use it for the pipeline. This is just a start. More states would need to be validated, and SPIR-V front-end needs more work. Differential Revision: https://phabricator.services.mozilla.com/D77170 2020-06-23 00:21:18 +03:00			`# Naga`

			`[![Matrix](https://img.shields.io/badge/Matrix-%23naga%3Amatrix.org-blueviolet.svg)](https://matrix.to/#/#naga:matrix.org)`
			`[![Crates.io](https://img.shields.io/crates/v/naga.svg?label=naga)](https://crates.io/crates/naga)`
			`[![Docs.rs](https://docs.rs/naga/badge.svg)](https://docs.rs/naga)`
			`[![Build Status](https://travis-ci.org/gfx-rs/naga.svg?branch=master)](https://travis-ci.org/gfx-rs/naga)`

			`This is an experimental shader translation library for the needs of gfx-rs project and WebGPU. It's meant to provide a safe and performant way of converting to and from SPIR-V.`

			`## Supported end-points`

			`Front-end \| Status \| Notes \|`
			`--------------- \| ------------------ \| ----- \|`
			`SPIR-V (binary) \| :construction: \| \|`
			`WGSL (Tint) \| :construction: \| \|`
			`GLSL (Vulkan) \| \| \|`
			`Rust \| \| \|`

			`Back-end \| Status \| Notes \|`
			`--------------- \| ------------------ \| ----- \|`
			`SPIR-V (binary) \| \| \|`
			`WGSL \| \| \|`
			`Metal \| :construction: \| \|`
			`HLSL \| \| \|`
			`GLSL \| \| \|`
			`AIR \| \| \|`
			`DXIR \| \| \|`
			`DXIL \| \| \|`
			`DXBC \| \| \|`