#opengl #spir-v #glsl #proc-macro

nightly macro glsl-quasiquote

The glsl! procedural macro, providing quasiquoting of the glsl crate

15 releases (8 stable)

7.0.0 Dec 22, 2023
6.0.1 Dec 19, 2023
6.0.0 Dec 7, 2020
5.0.0 Jul 27, 2020
0.3.0 Nov 21, 2018

#63 in #spir-v

BSD-3-Clause

350KB
10K SLoC

Build Status crates.io docs.rs License

GLSL quasiquoting.

This crate exports a procedural macro: glsl!. It enables quasiquoting by allowing you to embed GLSL source code directly into rust via the syntax:

#![feature(proc_macro_hygiene)]

use glsl::syntax::TranslationUnit;
use glsl_quasiquote::glsl;

let tu: TranslationUnit = glsl!{
  // your GLSL code here
  void main() {
  }
};

The glsl! macro accepts the GLSL code directly. You can then write plain GLSL. Especially, since version 0.2, the macro accepts plain GLSL pragmas (both #version and #extension).

The glsl! procedural macro resolves at compile-time to TranslationUnit, allowing you to manipulate the GLSL AST directly. Feel free to have a look at the glsl crate for further information.

Getting started

Add the following to your dependencies in your Cargo.toml:

glsl = "1"
glsl-quasiquote = "1"

Then, you currently need to have a nightly compiler and the following feature enabled:

#![feature(proc_macro_hygiene)]

Then, depending on which you’re using the 2018 edition or not:

Non-2018 edition

extern crate glsl;
#[macro_use] extern crate glsl_quasiquote;

2018 edition

use glsl_quasiquote::glsl;

Special warnings and considerations

Because of the nature of the Rust tokenizer, dots (.) at the beginning of a token is not part of the token. For instance, .3 is reinterpreted as . and 3 (two tokens). This will lead to incorrect parsing if you try to represent the number 0.3 with .3. While accepted by glsl, this is not accepted by this crate. This limitation is due to how Rust tokenizes input in procedural macro and is very unlikely to change.

Dependencies

~1MB
~20K SLoC