A widget that renders a real image (PNG/JPEG/GIF/WebP/BMP) inside a TUI.

Image is a stateful widget: the decoded image data and the active protocol encoder live in Rust via a ResourceArc. Construct the state with ExRatatui.Image.new/2, which returns the widget struct ready to drop into a render tree.

{:ok, picture} = ExRatatui.Image.new(File.read!("priv/slides/cover.png"))

def view(model, area) do
  [{picture, area}]
end

The widget itself is just a wrapper around the :state reference; render options (:resize, :protocol, :background) are set once at ExRatatui.Image.new/2 and stored on the resource. To change them, build a new image handle.

See ExRatatui.Image for the construction API and the protocol/transport fallback rules.

Fields

• :state - the image state reference returned by ExRatatui.Image.new/2 (required)