Struct RenderEngine 

pub struct RenderEngine { /* private fields */ }

render engine resource, owns all GPU rendering state.

managed by the engine — game code reads it via Res<RenderEngine> when it needs direct GPU access for custom draw calls or render target operations.

Implementations

impl RenderEngine

pub fn from_surface( instance: &Instance, surface: Surface<'static>, config: RenderConfig, ) -> Self

create render engine from a surface (native, blocking)

Panics

panics if no adapter or device can be created.

pub fn save_pipeline_cache(&self)

save the vulkan pipeline cache to disk. call this before shutting down to speed up future launches.

pub fn add_render_pass<P: RenderPass>(&mut self, pass: P)

register a custom render pass. passes are executed in registration order after the default 2D pass.

pub const fn config(&self) -> &RenderConfig

get the current render config

pub const fn device(&self) -> &Device

get the wgpu device

pub const fn queue(&self) -> &Queue

get the wgpu queue

pub fn resize(&mut self, width: u32, height: u32)

resize the render surface

pub fn remove_texture(&mut self, tex_id: u32)

remove a texture and its cached bind group. call this when a texture is no longer needed to free GPU memory.

pub fn create_render_target( &mut self, store: &mut RenderTargetStore, width: u32, height: u32, ) -> (RenderTargetId, Handle<Texture>)

create an offscreen render target of the given pixel dimensions.

returns a (RenderTargetId, Handle<Texture>) pair:

• use the id in Camera.target to direct a camera at this target.
• use the texture handle with draw_sprite to display the target’s contents.

also registers the entry in the supplied RenderTargetStore so it can be looked up later via RenderTargetStore::get_texture.

pub fn upload_font(&mut self, font_id: u32, data: &[u8])

register font bytes with the glyph atlas. glyphs are rasterized on demand during render() and the atlas is uploaded then.

pub fn upload_texture(&mut self, handle: &Handle<Texture>, texture: &Texture)

upload a texture to the GPU, returns its handle id. if the texture is already uploaded, this is a no-op.

pub fn surface_size(&self) -> (u32, u32)

current surface size

pub fn render( &mut self, commands: &[DrawCommand], camera: Option<&Camera>, render_info: &mut RenderInfo, )

render all draw commands for this frame. sprites are batched by texture — one draw call per unique texture. rects (no texture) are drawn in a single additional draw call.

Trait Implementations

impl Drop for RenderEngine

Available on non-WebAssembly only.

save the pipeline cache on shutdown so the next launch benefits from it.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Resource for RenderEngine

where Self: Send + Sync + 'static,