Struct FrameInput 

pub struct FrameInput {
    pub cam: Camera2d,
    pub world_size: [f32; 2],
    pub viewport_dp: [f32; 2],
    pub sprites: Vec<SpriteInstance>,
    pub texts: Vec<WorldText>,
    pub background: Option<[f32; 4]>,
    pub overlay_color: Option<[f32; 4]>,
    pub chroma: f32,
}

Everything the viewport draws this frame. Plain data, snapshot per frame.

Framing contract (single source of truth): canvas, GPU, and picks all derive from world_size + cam through effective_fit / fit_view_proj / world_to_dp. cam.effective_center() is the look point (rest + offset shake included); cam.zoom / cam.units_per_pixel scale the fit uniformly on every backend.

Fields

cam: Camera2d

world_size: [f32; 2]

World-space extent the contain-fit maps into the viewport.

viewport_dp: [f32; 2]

Cold-start viewport size in dp (physical px / density), used for the GPU camera until the first painted FrameGeom arrives. Named for its units: divide physical px by density before storing here, or the first frame’s fit is off by the density factor on HiDPI screens. (Contrast FrameGeom::viewport_px, which is genuinely physical px.)

sprites: Vec<SpriteInstance>

texts: Vec<WorldText>

World-anchored text, drawn after the sprite pass on the canvas viewport. The GPU viewport ignores this field: compose texts as sibling views (same pattern as overlay_color consumers that need typography) so GPU and canvas agree by construction.

background: Option<[f32; 4]>

Full-viewport fill under everything (letterbox included).

overlay_color: Option<[f32; 4]>

Optional fullscreen tint/color-grading hook (e.g. FOW dimming, damage flash). Applied after the sprite pass on canvas and GPU (after the chroma composite when chroma > 0.0), with the same byte semantics as the canvas path ((c * 255) as u8 per channel, alpha-blended over the scene).

chroma: f32

Chromatic aberration amount (bevy chromatic_intensity units; NT pulses land at 0.04..0.7). GPU viewports render the scene offscreen and composite it back with an RGB split; 0.0 keeps the zero-cost direct path. Canvas viewports ignore it (sampling FX need pixels, and the canvas path is vector commands).

Trait Implementations

impl Clone for FrameInput

fn clone(&self) -> FrameInput

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FrameInput

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for FrameInput

fn default() -> FrameInput

Returns the “default value” for a type.