Struct Presenter 

pub struct Presenter {
    render: Option<Entity>,
    renderer: Entity,
    scene_pass: Entity,
    blit: Option<Blit>,
    surface: WindowSurface,
    attachments: FrameAttachments,
    target: Option<PersistentTarget>,
    pub fallback_size: (u32, u32),
}

Everything needed to render a frame and present it.

The presenter is a component of its own entity, built by build_presenter: everything it holds arrives after the GPU request resolves, and a component set fixed at spawn has no room for that.

Fields

render: Option<Entity>

renderer: Entity

scene_pass: Entity

blit: Option<Blit>

surface: WindowSurface

attachments: FrameAttachments

target: Option<PersistentTarget>

fallback_size: (u32, u32)

The size used until the window reports its own.

Implementations

impl Presenter

pub fn present(&mut self, host: &World) -> Result<(), PresenterError>

Draw the frame’s result into the swap chain and present it.

The presenting pass parks first and takes the frame’s view only after the swap chain image has been acquired. Between the two, and after the image has been presented and destroyed, the pass states no attachment – so a frame rendered by anything other than this loop, an MCP tool’s screenshot of the scene, skips the pass rather than recording into a dead swap-chain image.

A surface released by Self::release is opened again here, so a host that suspended only has to keep presenting.

Errors

Returns an error when the render world’s renderer or its resources are gone, or the window can no longer back a surface. A render sub-world that is gone presents nothing and returns Ok.

pub fn resize( &mut self, host: &World, size: (u32, u32), ) -> Result<(), PresenterError>

Match the surface, the swap-chain attachments and the offscreen target to a new size.

The surface resizes first and reports the size it ended up with; the swap chain’s attachments follow it, and the offscreen target is rebuilt for that size. The target’s texture and view are replaced in place – their resource nodes keep their ids – so the blit reading the view rebuilds its bind group through its own dependency, without the presenter touching the source.

Errors

Returns an error when the render world or its resources are gone.

pub fn release(&mut self, host: &World) -> Result<(), PresenterError>

Drop the swap chain the platform is about to invalidate, keeping everything the scene drew from.

The presenting pass parks first: it still names a view of the swap chain, and that id is what keeps the view alive – parking it drops the view, so the view goes with the surface this release collects. The scene keeps its state and presents again through a surface built from the same window.

Errors

Returns an error when the render world or its renderer is gone.