Struct three_d::Program

pub struct Program { /* fields omitted */ }

A shader program consisting of a programmable vertex shader followed by a programmable fragment shader. Functionality includes transferring per vertex data to the vertex shader (see the use_attribute functionality) and transferring uniform data to both shader stages (see the use_uniform and use_texture functionality) and execute the shader program (see the draw functionality).

Implementations

impl Program

pub fn from_source(
    context: &Context,
    vertex_shader_source: &str,
    fragment_shader_source: &str
) -> Result<Program, Error>

Creates a new shader program from the given vertex and fragment glsl shader source.

pub fn use_uniform_int(&self, name: &str, data: &i32) -> Result<(), Error>

Send the given integer value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform int, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_float(&self, name: &str, data: &f32) -> Result<(), Error>

Send the given float value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform float, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_vec2(&self, name: &str, data: &Vec2) -> Result<(), Error>

Send the given Vec2 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform vec2, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_vec3(&self, name: &str, data: &Vec3) -> Result<(), Error>

Send the given Vec3 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform vec3, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_vec4(&self, name: &str, data: &Vec4) -> Result<(), Error>

Send the given Vec4 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform vec4, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_mat2(&self, name: &str, data: &Mat2) -> Result<(), Error>

Send the given Mat2 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform mat2, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_mat3(&self, name: &str, data: &Mat3) -> Result<(), Error>

Send the given Mat3 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform mat3, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_uniform_mat4(&self, name: &str, data: &Mat4) -> Result<(), Error>

Send the given Mat4 value to this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform mat4, meaning it is uniformly available across all processing of vertices and fragments.

pub fn use_texture(
    &self,
    texture: &impl Texture,
    texture_name: &str
) -> Result<(), Error>

Use the given Texture2D in this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform sampler2D and can only be accessed in the fragment shader.

pub fn use_texture_array(
    &self,
    texture: &impl TextureArray,
    texture_name: &str
) -> Result<(), Error>

Use the given TextureArray in this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform sampler2DArray and can only be accessed in the fragment shader.

pub fn use_texture_cube(
    &self,
    texture: &impl TextureCube,
    texture_name: &str
) -> Result<(), Error>

Use the given TextureCube in this shader program and associate it with the given named variable. The glsl shader variable must be of type uniform samplerCube and can only be accessed in the fragment shader.

pub fn use_uniform_block(&self, buffer: &UniformBuffer, block_name: &str)

pub fn use_attribute(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str
) -> Result<(), Error>

pub fn use_attribute_divisor(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str,
    divisor: usize
) -> Result<(), Error>

pub fn use_attribute_vec2(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str
) -> Result<(), Error>

pub fn use_attribute_vec2_divisor(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str,
    divisor: usize
) -> Result<(), Error>

pub fn use_attribute_vec3(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str
) -> Result<(), Error>

pub fn use_attribute_vec3_divisor(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str,
    divisor: usize
) -> Result<(), Error>

pub fn use_attribute_vec4(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str
) -> Result<(), Error>

pub fn use_attribute_vec4_divisor(
    &self,
    buffer: &VertexBuffer,
    attribute_name: &str,
    divisor: usize
) -> Result<(), Error>

pub fn draw_arrays(
    &self,
    render_states: RenderStates,
    cull: CullType,
    viewport: Viewport,
    count: u32
)

pub fn draw_arrays_instanced(
    &self,
    render_states: RenderStates,
    cull: CullType,
    viewport: Viewport,
    count: u32,
    instance_count: u32
)

pub fn draw_elements(
    &self,
    render_states: RenderStates,
    cull: CullType,
    viewport: Viewport,
    element_buffer: &ElementBuffer
)

pub fn draw_subset_of_elements(
    &self,
    render_states: RenderStates,
    cull: CullType,
    viewport: Viewport,
    element_buffer: &ElementBuffer,
    first: u32,
    count: u32
)

pub fn draw_elements_instanced(
    &self,
    render_states: RenderStates,
    cull: CullType,
    viewport: Viewport,
    element_buffer: &ElementBuffer,
    count: u32
)

Trait Implementations

impl Drop for Program

fn drop(&mut self)

Executes the destructor for this type.