Struct KittyLifecycle 

pub struct KittyLifecycle { /* private fields */ }

Renderer-owned Kitty protocol state for reconciling successive image frames.

A lifecycle retains terminal upload and placement identities, but owns no terminal connection, session, frame scheduling, or application state. The renderer keeps this value across frames for one terminal presentation and calls Self::clear before resize teardown or exit.

Self::present commits its candidate state only after every command and the final flush succeed. After a partial failure, the next presentation first deletes every image that may have reached the terminal, then rebuilds the desired frame with fresh protocol identifiers.

Implementations

impl KittyLifecycle

pub fn new() -> Self

pub fn present( &mut self, view: &View, resolved: &ResolvedView, cell_pixels: Option<CellPixelSize>, terminal: &mut (impl CommandWriter + ?Sized), ) -> Result<()>

Reconciles and presents one immutable desired image frame.

resolved must be the result of resolving view; the lifecycle finds the Image snapshots embedded in that View and matches their keys to the resolved anchors without requiring a parallel image list.

Images without a visible, non-empty resolved placement are absent from the desired frame. A partial placement keeps the same upload and placement identities while its source crop and visible cell rectangle change. Hidden uploads may remain cached for later reuse.

pub fn clear( &mut self, terminal: &mut (impl CommandWriter + ?Sized), ) -> Result<()>

Deletes every Kitty image that may belong to this lifecycle.

Call this when a resize invalidates placement geometry and when the renderer releases the terminal presentation. A failed cleanup remains pending so a later clear or Self::present retries conservatively.

Trait Implementations

impl Debug for KittyLifecycle

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

Formats the value using the given formatter.

impl Default for KittyLifecycle

fn default() -> Self

Returns the “default value” for a type.