Struct web_glitz::rendering::ActiveGraphicsPipeline

pub struct ActiveGraphicsPipeline<'a, V, R, Tf> { /* fields omitted */ }

An activated GraphicsPipeline which may be used to draw to a Framebuffer.

A handle to an ActiveGraphicsPipeline is obtained by using a GraphicsPipeline to create a [PipelineTask] for a Framebuffer, see [Framebuffer::pipeline_task].

Implementations

impl<'a, V, R, Tf> ActiveGraphicsPipeline<'a, V, R, Tf>

pub fn task_builder(
    &self
) -> GraphicsPipelineTaskBuilder<'a, V, R, Unspecified, Unspecified, Unspecified, Empty>

A builder interface that enforces valid sequencing of pipeline commands.

Notably, this builder will not allow the sequencing of a DrawCommand, before vertex buffers and/or resources have been bound (if the pipeline requires vertex buffers, resp. resources), see GraphicsPipelineTaskBuilder::draw; it will not allow the sequencing of a DrawIndexedCommand before an index buffer has been bound and before vertex buffers and/or resources have been bound (if the pipeline requires vertex buffers, resp. resources), see GraphicsPipelineTaskBuilder::draw_indexed.

Example

let render_pass = render_target.create_render_pass(|framebuffer| {
    framebuffer.pipeline_task(&graphics_pipeline, |active_pipeline| {
        active_pipeline.task_builder()
            .bind_vertex_buffers(vertex_buffer)
            .bind_resources(resources)
            .draw(16, 1)
            .finish()
    })
});