[−][src]Module glsl::transpiler::glsl
A GLSL450/GLSL460 transpiler that takes a syntax tree and writes it as a plain raw GLSL
String.
Foreword
This module exports several functions that just transform a part of a syntax tree into its raw
GLSL String representation.
Important note: this module – and actually, any
transpilermodule – is not responsible in optimizing the syntax tree nor semantically check its validity. This is done in other stages of the compilation process.
In order to achieve that purpose, you could:
- For each elements in the AST, return a
StringorCow<str>. - Insert the string representation via a formatter.
The second solution is better because it lets the user handle the memory the way they want:
they might just use a dynamic buffer that implements Write or simply pass a &mut
String. It’s up to you.
How to use this module
First, head over to the syntax module. That module defines the AST items defined by GLSL. This
very module provides you with functions like show_* taking the AST item and writing it to a
Write object. You’re likely to be interested in show_translation_unit to start with.