glslang 0.8.0

Rust bindings to glslang
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

use std::sync::OnceLock;

mod ctypes;

/// Error types.
pub mod error;

/// Helpers for processing includes.
pub mod include;
/// Shader resouce limits.
pub mod limits;
mod program;
mod shader;

static COMPILER_INSTANCE: OnceLock<Option<Compiler>> = OnceLock::new();

/// A handle representing the glslang compiler instance.
#[derive(Debug)]
pub struct Compiler;

pub use crate::ctypes::*;

pub use program::Program;
pub use shader::*;

impl Compiler {
    /// Acquire a global instance of the compiler.
    pub fn acquire() -> Option<&'static Self> {
        COMPILER_INSTANCE
            .get_or_init(|| {
                unsafe {
                    if glslang_sys::glslang_initialize_process() == 0 {
                        return None;
                    }
                };
                Some(Self)
            })
            .as_ref()
    }

    /// Create a [`Shader`](crate::Shader) with the given inputs.
    pub fn create_shader(&self, input: ShaderInput) -> Result<Shader<'_>, error::GlslangError> {
        Shader::new(&self, input)
    }

    /// Create a [`Program`](crate::Program) instance.
    pub fn create_program(&self) -> Program<'_> {
        Program::new(&self)
    }
}

impl Drop for Compiler {
    fn drop(&mut self) {
        unsafe {
            glslang_sys::glslang_finalize_process();
        }
    }
}