#shader #spirv #glsl #hlsl #reflect


Reflection API in rust for SPIR-V shader byte code, intended for Vulkan applications

14 releases

0.2.3 Nov 3, 2019
0.2.2 Nov 3, 2019
0.2.1 Mar 30, 2019
0.1.9 Mar 10, 2019
0.1.6 Nov 21, 2018

#1 in Rendering engine

Download history 134/week @ 2020-06-01 69/week @ 2020-06-08 54/week @ 2020-06-15 61/week @ 2020-06-22 47/week @ 2020-06-29 51/week @ 2020-07-06 73/week @ 2020-07-13 51/week @ 2020-07-20 71/week @ 2020-07-27 64/week @ 2020-08-03 1458/week @ 2020-08-10 981/week @ 2020-08-17 2574/week @ 2020-08-24 1687/week @ 2020-08-31 1159/week @ 2020-09-07 1283/week @ 2020-09-14

369 downloads per month
Used in 27 crates (4 directly)



Rust 3.5K SLoC // 0.0% comments C 3.5K SLoC // 0.0% comments


spirv-reflect on travis-ci.com Latest version Documentation MIT APACHE2

Reflection API in rust for SPIR-V shader byte code, intended for Vulkan applications.

This crate provides an FFI layer and idiomatic rust wrappers for the excellent SPIRV-Reflect C/C++ library.


  • Extract descriptor bindings from SPIR-V bytecode, to assist in the generation of Vulkan descriptor set and pipeline layouts.
  • Extract push constant block size from SPIR-V bytecode to assist in the generation of pipeline layouts.
  • Extract full layout data for uniform buffer and push constant blocks from SPIR-V bytecode, to assist in application updates of these structures.
  • Extract input/output variables from SPIR-V bytecode (including semantic decorations for HLSL shaders), to assist in validation of pipeline input/output settings.
  • Easily map Vulkan types to DirectX 12 resource types
  • Remap descriptor bindings, and update the source SPIR-V bytecode accordingly.
  • Log all reflection data as human-readable text.

Planned Features

  • Extensive unit tests and examples.
  • Pure rust version.
  • Command line tool for reflection and manipulation.


Add this to your Cargo.toml:

spirv-reflect = "0.2.3"

and add this to your crate root:

extern crate spirv_reflect;


Currently there is only a single monolithic demo example, which shows some usage. A CLI tool is planned that will be useful on its own, and as a clean example of usage patterns.

cargo run --release --example demo


Licensed under either of

at your option.

Credits and Special Thanks


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contributions are always welcome; please look at the issue tracker to see what known improvements are documented.

Code of Conduct

Contribution to the spirv-reflect crate is organized under the terms of the Contributor Covenant, the maintainer of spirv-reflect, @gwihlidal, promises to intervene to uphold that code of conduct.


~38K SLoC