shader_version 0.7.0

A helper library for detecting and picking compatible shaders
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

#![deny(missing_docs)]
#![deny(missing_copy_implementations)]

//! A helper library for detecting and picking compatible shaders.

extern crate graphics_api_version;

pub use opengl::{OpenGL, ParseOpenGLError};

pub mod opengl;
pub mod glsl;

use std::collections::BTreeMap;

/// Shader picker.
pub struct Shaders<'a, V, S: 'a + ?Sized>(BTreeMap<V, &'a S>);

impl<'a, V, S: ?Sized> Shaders<'a, V, S> where V: PickShader {
    /// Creates a new shader picker.
    pub fn new() -> Self {
        Shaders(BTreeMap::new())
    }

    /// Sets source for a shader version.
    pub fn set(&mut self, version: V, source: &'a S) -> &mut Self {
        self.0.insert(version, source);
        self
    }

    /// Get the closest shader to a shader version.
    pub fn get(&self, version: V) -> Option<&S> {
        version.pick_shader(self)
    }
}

/// Implemented by shader version enums.
pub trait PickShader: Ord + Sized {
    /// Pick shader.
    fn pick_shader<'a, S: ?Sized>(self, shaders: &Shaders<'a, Self, S>) -> Option<&'a S>;
}