Struct StreamingRenderer 

pub struct StreamingRenderer<PerFrameDataT: Copy = ()> { /* private fields */ }

A renderer optimized for streaming new vertex data to the GPU every frame.

Implementations

impl<PerFrameDataT: Copy> StreamingRenderer<PerFrameDataT>

pub fn new( ctx: &VulkanContext, image_format: Format, frames_in_flight: &FramesInFlight, texture_atlas: &TextureAtlas, ) -> Result<Self>

pub fn new_material( &self, ctx: &VulkanContext, vertex_shader: Option<&ShaderModule>, fragment_shader: Option<&ShaderModule>, ) -> Result<Arc<Material>>

Creates a new rendering material. See the documentation for [Material] for details on allowed shader inputs and outputs.

Default vertex and fragment shaders are used automatically if either is omitted.

pub fn default_material(&self) -> &Arc<Material>

Returns the default material for use by meshes without special material requirements.

pub fn prepare_meshes( &mut self, ctx: &VulkanContext, frame: &Frame, meshes: &[&dyn Mesh], ) -> Result<()>

Prepares the meshes for this frame.

This should only be called once per frame, calling it repeatedly will only render whatever meshes were provided last.

pub fn set_frame_constants( &mut self, frame: &Frame, data: PerFrameDataT, ) -> Result<()>

pub fn bind_texture_atlas( &mut self, ctx: &VulkanContext, frame: &Frame, texture_atlas: &TextureAtlas, )

Binds the texture atlas for the frame.

This only needs to be done once a frame, regardless of how many meshes there are as mesh pipelines are required to have compatible pipeline layouts.

pub fn write_draw_commands( &mut self, ctx: &VulkanContext, frame: &Frame, ) -> Result<()>

Emits draw commands for all of the meshes in the current frame.

NOTE: it is incorrect to call this multiple times for the same frame as there is only one internal vertex buffer per frame.