Struct ImagePreviews 

pub struct ImagePreviews { /* private fields */ }

Render-state owner for inline image previews: protocol detection, the settings kill-switch, the transmit budget, the pending queue, and the per-frame anchors shared between the render pass (recorder) and the post-draw emit step (consumer).

Implementations

impl ImagePreviews

pub fn new(support: ImageSupport) -> Self

pub fn set_enabled(&mut self, enabled: bool)

Settings kill-switch (inline_images, default ON).

pub fn enqueue(&mut self, id: u32, png: Arc<Vec<u8>>, label: String)

Queue a decoded image for its first live placement. Called by the generate_image result hook with the label embedded in the fallback row. The queue is capped: rows that never render live (immediately committed) would otherwise pile up forever.

pub fn pending(&self) -> &[PendingImage]

Pending queue (inspected by tests and the render pre-pass).

pub fn record_anchor( &self, id: u32, x: u16, y: u16, rows: u16, transcript_index: usize, )

Record where a pending image’s tool box was painted this frame. Called from the live render pass; consumed by Self::emit_live right after the frame flushes.

pub fn pending_len(&self) -> usize

Pending queue length.

pub fn emit_live(&mut self, committed_entries: usize) -> String

Build the image escape stream for anchors recorded during this frame’s LIVE render and return it — the caller writes the string through the terminal backend. Rows already committed to scrollback never emit — the transcript’s fallback text is all history keeps (omp lesson: image pixels must not be expected to survive history).

Every write is wrapped in DECSC/DECRC (save/restore cursor) and CUP to the anchor so the sequences land on the tool box without disturbing the frame’s cursor state.

Trait Implementations

impl Default for ImagePreviews

fn default() -> Self

Live-env detection + kill-switch default ON.