Struct Embedded 

pub struct Embedded<A: App> { /* private fields */ }

A fenestra app embedded in a caller-owned wgpu world. See the module docs for the contract.

Implementations

impl<A: App> Embedded<A>

where A::Msg: Send,

pub fn new( app: A, theme: Theme, device: &Device, target_format: TextureFormat, ) -> Self

Builds the renderer on your device. target_format is the format of the views you will pass to Self::render (usually your surface format).

Panics

If vello’s shaders fail to compile on the device.

pub fn set_clear(&mut self, color: Color)

The base color behind the UI. Defaults to the theme background; set Color::TRANSPARENT to composite over your own scene.

pub fn set_theme(&mut self, theme: Theme)

Replaces the theme (e.g. a light/dark toggle driven by your app).

pub fn app(&self) -> &A

The app under the UI.

pub fn app_mut(&mut self) -> &mut A

Mutable app access (the next Self::render rebuilds).

pub fn pump(&mut self) -> bool

Drains proxied messages (from App::init / threads) into the app. Returns whether anything was applied — repaint if so.

pub fn input(&mut self, event: InputEvent) -> EventResponse

Routes one raw input event into the UI. Prefer Self::handle_window_event in winit apps; this is the window-system-agnostic form (and what tests drive).

pub fn handle_window_event( &mut self, window: &Window, event: &WindowEvent, ) -> EventResponse

Translates and routes one winit event (cursor, buttons, wheel, keyboard with the printable/shortcut split, IME commit/preedit, modifiers) — the same mapping the built-in runner uses.

pub fn animating(&self) -> bool

Whether the last built frame is still animating (keep rendering).

pub fn render( &mut self, device: &Device, queue: &Queue, target: &TextureView, physical: (u32, u32), scale: f64, )

Builds the current frame and composites it onto target with premultiplied-alpha blending. physical is the target size in physical pixels; scale the DPI factor (logical = physical / scale). Call after your own passes each frame.

Panics

If vello fails to render (device loss).

pub fn frame(&self) -> Option<&Frame>

The last built frame (after Self::render) — semantic queries and inspector dumps work on it like anywhere else.

pub fn texture_view(&self) -> Option<&TextureView>

The internal premultiplied-alpha texture view from the last Self::render — sample it in your own pipeline for custom compositing instead of the built-in blit.