# `ExRatatui.Widgets.Image`
[🔗](https://github.com/mcass19/ex_ratatui/blob/v0.10.0/lib/ex_ratatui/widgets/image.ex#L1)

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.

```elixir
{: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)

# `t`

```elixir
@type t() :: %ExRatatui.Widgets.Image{state: reference() | nil}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*