Struct PlayerHost 

pub struct PlayerHost {
    pub player: Player,
    pub renderer: SceneRenderer,
    pub view: ViewTransform,
    pub playing: bool,
    pub last_tick: Instant,
    pub dirty_images: bool,
    pub last_pointer: DVec2,
    pub fit: FitState,
}

Per-surface state for one embedded player: the engine, the tessellator (SceneRenderer), the viewport fit/zoom mapping, and playback control.

Fields

player: Player

renderer: SceneRenderer

view: ViewTransform

Screen - world mapping for the embed surface.

playing: bool

True while the widget keeps ticking playback each frame.

last_tick: Instant

dirty_images: bool

Set when image assets changed. Uploaded to RenderContext on the next draw. Constructors mark it dirty so a fresh renderer uploads once.

last_pointer: DVec2

Most recent pointer position in surface px (wheel-zoom anchor).

fit: FitState

Fit-state tracker: remembers the last fitted surface (+ artboard) and only refits on resize or explicit invalidation, so interactive zoom survives redraws.

Implementations

impl PlayerHost

pub fn new(player: Player) -> PlayerHost

pub fn from_ren_str(text: &str) -> Result<PlayerHost, PlayerError>

pub fn from_ren_bytes(bytes: &[u8]) -> Result<PlayerHost, PlayerError>

pub fn artboard(&self) -> DVec2

Artboard size of the active composition.

pub fn mark_images_dirty(&mut self)

Mark image assets dirty so the next draw re-uploads them to RenderContext. Call after replacing the player’s project.

pub fn play(&mut self)

pub fn pause(&mut self)

pub fn toggle(&mut self)

pub fn tick_playback(&mut self) -> bool

Advance playback by the wall-clock delta since the last call. Returns true while playing so callers (or hosts with their own loop) can keep requesting frames. Zero-cost whenever paused.

pub fn tick_playback_fixed(&mut self, dt_secs: f64) -> bool

Advance playback by a fixed dt_secs, for sim-driven embeds where pause must freeze playback (no wall clock, no 50 ms clamp). Returns true while playing so callers can keep requesting frames. Zero-cost whenever paused.

pub fn fit(&mut self, surface: DVec2)

Fit the artboard inside surface with a margin, centering it. Records surface so zoom_at / zoom_centered work after an explicit fit.

pub fn fit_exact(&mut self, surface: DVec2)

Exact-fit the artboard with no margin (presentational embeds): records surface and centers, letterboxing on aspect mismatch.

pub fn zoom_centered(&mut self, factor: f64)

pub fn zoom_at(&mut self, screen_pos: DVec2, factor: f64)

Zoom by factor keeping the world point under screen_pos anchored.

pub fn surface_size(&self) -> DVec2

Last fitted surface size (zero before first layout).