Struct RenderPass

#[non_exhaustive]
pub struct RenderPass<'pass> { /* private fields */ }

Implementations

impl<'pass> RenderPass<'pass>

pub fn select_render_target(&mut self, target: &'pass Target<'_>) -> Result<()>

Select the given render target for the following draw calls.

Errors

Fails if the given target cannot be used for drawing.

pub fn buffer_info(&self) -> Option<Info>

Get the buffer info being used, if it exists.

Notes

The resulting buffer::Info is copied (and not taken) from the one currently in use.

pub fn set_buffer_info(&mut self, buffer_info: &Info)

Set the buffer info to use for for the following draw calls.

pub fn attr_info(&self) -> Option<Info>

Get the attribute info being used, if it exists.

Notes

The resulting attrib::Info is copied (and not taken) from the one currently in use.

pub fn set_attr_info(&mut self, attr_info: &Info)

Set the attribute info to use for any following draw calls.

pub fn draw_arrays(&mut self, primitive: Primitive, vbo_data: Slice<'pass>)

Render primitives from the current vertex array buffer.

Panics

Panics if no shader program was bound (see RenderPass::bind_program).

pub fn draw_elements<I: Index>( &mut self, primitive: Primitive, vbo_data: Slice<'pass>, indices: &Indices<'pass, I>, )

Draws the vertices in buf indexed by indices.

Panics

Panics if no shader program was bound (see RenderPass::bind_program).

pub fn bind_program(&mut self, program: &'pass Program)

Use the given shader::Program for the following draw calls.

pub fn bind_light_env(&mut self, env: Option<Pin<&'pass mut LightEnv>>)

Binds a LightEnv for the following draw calls.

pub fn bind_vertex_uniform(&mut self, index: Index, uniform: impl Into<Uniform>)

Bind a uniform to the given index in the vertex shader for the next draw call.

Panics

Panics if no shader program was bound (see RenderPass::bind_program).

Example

let idx = uniform::Index::from(0);
let mtx = Matrix4::identity();
instance.bind_vertex_uniform(idx, &mtx);

pub fn bind_geometry_uniform( &mut self, index: Index, uniform: impl Into<Uniform>, )

Bind a uniform to the given index in the geometry shader for the next draw call.

Panics

Panics if no shader program was bound (see RenderPass::bind_program).

Example

let idx = uniform::Index::from(0);
let mtx = Matrix4::identity();
instance.bind_geometry_uniform(idx, &mtx);

pub fn texenv(&mut self, stage: Stage) -> &mut TexEnv

Retrieve the TexEnv for the given stage, initializing it first if necessary.

Example

let stage0 = texenv::Stage::new(0).unwrap();
let texenv0 = instance.texenv(stage0);

Trait Implementations

impl Drop for RenderPass<'_>

fn drop(&mut self)

Executes the destructor for this type.