11 releases

0.2.7 May 5, 2021
0.2.6 Jun 8, 2020
0.2.4 May 24, 2020
0.2.2 Aug 18, 2019
0.1.1 Feb 26, 2019
Download history 14/week @ 2023-05-21 72/week @ 2023-05-28 36/week @ 2023-06-04 9/week @ 2023-06-11 107/week @ 2023-06-18 54/week @ 2023-06-25 68/week @ 2023-07-02 44/week @ 2023-07-09 40/week @ 2023-07-16 73/week @ 2023-07-23 25/week @ 2023-07-30 50/week @ 2023-08-06 70/week @ 2023-08-13 30/week @ 2023-08-20 35/week @ 2023-08-27 46/week @ 2023-09-03

182 downloads per month


178 lines


Documentation Crates.io License: MIT License: Apache 2.0

A procedural macro for compiling GLSL into SPIR-V constants.

Unlike the standard include_bytes macro, paths are currently resolved relative to crate root. This is due to a temporary limitation in the procedural macro API.


const VERT: &[u32] = include_glsl!("shaders/example.vert");
const FRAG: &[u32] = include_glsl!("shaders/example.glsl", kind: frag);
const RGEN: &[u32] = include_glsl!("shaders/example.rgen", target: vulkan1_2); // vulkan1_2 is required to build with GL_EXT_ray_tracing

Debug info is generated by default; pass strip to the macro to omit it, or build the crate with the strip feature enabled.

Why [u32]?

SPIR-V is a stream of 32-bit words, not bytes, and this is reflected in APIs that consume it. In particular, passing a [u8] of SPIR-V that is not 4-byte-aligned to Vulkan is undefined behavior. Storing SPIR-V in its native format guarantees that this will never occur, without requiring copying or unsafe code.


This crate currently depends on the foreign shaderc library. By default, it will attempt to use an installed shaderc library. However if it does not exist, it will fall back to building from source, requiring git, cmake, python 3, and a supported C++ compiler to be available in the build environment. When using a pre-compiled shaderc, care must be taken to use a version that is binary-compatible with the one checked out by the shaderc crate. You can force shaderc to be built from source by enabling the build-from-source feature on vk-shader-macros.


~630K SLoC