# Image widgets: `<image>`, `<gocomics>`, `<weather.icon>`

All three of these load a bitmap and optionally resize it into a bounding box; they only differ in
*where the bitmap comes from*. In the Python source (see {doc}`../api/index`), they share a common base,
`ImageBaseView` (`todays_paper_web/widgets/core/image.py`) — not registered as a tag itself, just the
shared resize/fit logic — and each implements its own `fetch_img()` on top. The sizing/fitting attributes
(`width`, `height`, `fillmode`) are shared the same way, via a common `ImageParams` model every concrete
widget's own `Params` inherits, and work identically everywhere they appear below.

If resizing fails to produce a target size (e.g. `fillmode` misspelled), a warning is logged and the
original image is returned unresized rather than the render failing — unlike an unrecognized `color` on
other widgets, an unrecognized `fillmode` doesn't raise.

## `<image>`

Loads an arbitrary image file from config storage.

```xml
<image x="0" y="0" width="300" height="200" path="home/cal_task.png" />
```

```{eval-rst}
.. autopydantic_model:: todays_paper_web.widgets.core.image.LocalImageParams
   :inherited-members: BaseModel
```

Any format Pillow can open. `path` is the one attribute specific to `<image>` — `width`/`height`/
`fillmode` above come from `ImageParams`, shared with `<gocomics>`/`<weather.icon>` below.

## `<gocomics>`

Fetches today's strip for a given [GoComics](https://www.gocomics.com/) title, fresh on every render (no
caching beyond whatever the `Runner`'s render schedule provides — see {doc}`../screen-design/index`).

```xml
<gocomics identifier="calvinandhobbes" width="800" />
```

```{eval-rst}
.. autopydantic_model:: todays_paper_web.widgets.misc.gocomics.GoComicsParams
   :inherited-members: BaseModel
```

## `<weather.icon>`

Renders a weather condition icon. Meant to be used with the id produced by a `weather.yr`-sourced
forecast's `icon.id()` — see {doc}`../data-sources/weather` for how that id is built and what values it
can take.

```xml
<weather.icon icon="{{ forecast.icon.id() }}" theme="erikflower" width="80" height="80" />
```

```{eval-rst}
.. autopydantic_model:: todays_paper_web.widgets.weather.core.WeatherIconParams
   :inherited-members: BaseModel
```

If the requested `icon`/`theme` combination doesn't exist as a file, nothing is rendered for that tag
(no error) — check `todays_paper_web/widgets/weather/img/<theme>/` for the available filenames if an
icon silently doesn't show up.