glsl-include 0.3.1

A library for expanding #include directives in GLSL source strings

glsl-include   Build Status Build Status-win Latest Version

glsl-include is a rust library for expanding #include directives in GLSL source strings

Quick Start


glsl-include = "0.3"

extern crate glsl_include;
use glsl_include::Context;

fn main () {
    let main = r"
        #version 410
        #include <platform.glsl>
        #include <common.glsl>
        out vec4 fragColor;
        void main () {
            fragColor = vec4(1.0);
    let platform = "void platform_fn() {}";
    let common = "uniform float iTime;";
    let expanded_src = Context::new()
        .include("platform.glsl", platform)

#pragma include

The library also expands #pragma include statements with no additonal configuration required.


cargo bench

The workflow I currently use for benchmarking a changeset:

git checkout master; cargo bench
git checkout feature-branch; cargo bench

For the best results with criterion, install gnuplot (macos: brew install gnuplot)


Licensed under either of

at your option.


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