Struct luminance::shader::program::UniformBuilder

pub struct UniformBuilder<'a> { /* fields omitted */ }

Build uniforms to fold them to a uniform interface.

Methods

impl<'a> UniformBuilder<'a>

pub fn ask<T>(&self, name: &str) -> Result<Uniform<T>, UniformWarning> where
    T: Uniformable, 

Have the builder hand you a Uniform of the type of your choice.

Keep in mind that it’s possible that this function fails if you ask for a type for which the one defined in the shader doesn’t type match. If you don’t want a failure but an unbound uniform, head over to the ask_unbound function.

pub fn ask_unbound<T>(&mut self, name: &str) -> Uniform<T> where
    T: Uniformable, 

Get an unbound Uniform.

Unbound Uniforms are not any different from typical Uniforms but when resolving mapping in the shader program, if the Uniform is found inactive or doesn’t exist, instead of returning an error, this function will return an unbound uniform, which is a uniform that does nothing interesting.

That function is useful if you don’t really care about silently sending values down a shader program and getting them ignored. It might be the case for optional uniforms, for instance.

pub fn unbound<T>(&self) -> Uniform<T> where
    T: Uniformable, 

Special uniform that won’t do anything.

Use that function when you need a uniform to complete a uniform interface but you’re sure you won’t use it.