UI Components

Draw the first frame of an image at (x, y)

Note — Opaque, like gfx_draw_xbm(): the image's whole bounding box is overwritten.

Draw one frame of a multi-frame image

Note — There is no img_animation_* API and no playback clock — you pick the frame each redraw. `ui_get_frame(gfx) >> n` is the usual source; bigger `n` is slower.

Draw an image shrunk by an integer factor

Warning — Shrinks only — see gfx_draw_xbm_scaled(), which this wraps.

Render a pre-encoded QR code

Warning — The encoder is not part of the TAPP API: only this renderer is exported, so you have to produce the qrcodegen buffer yourself (bundle the encoder in your tapp) or bake it in as a constant.

Draw an indexed duration row — "3 1m 24s", or "3 <1s"

Move a position half-way toward a target — one step of an ease-out

Returns — true once `*pos` has arrived (and nothing was changed)

if(!ui_ease_position(&m->scroll_y, m->scroll_target)) m->dirty = true;

Note — Call it once per frame and redraw while it returns false. Integer halving, so it lands exactly rather than creeping.

ui_ease_position() with an adjustable step

Returns — true once `*pos` has arrived

Vertical scrollbar with a proportional thumb

Draw a dot positioned around a circle — a knob indicator

Rounded outline, with a double ring when selected

Button-hint row: a label with a press/hold marker to its left

ui_draw_action() that can render selected, and reports its width

Returns — Width of the label text in pixels — use it to lay the next action out

Fill a region with random pixels — TV static

Warning — Currently draws nothing: the firmware offsets x by the display width, putting every pixel outside the clip window. Build static out of gfx_draw_pixel() until that is fixed.

Plot a float buffer as a dotted waveform

Copy a string to upper case

Copy a string to lower case

ui_draw_frame() over a cleared background — an opaque panel

Note — Use this for anything floating over other content; ui_draw_frame() alone leaves whatever was underneath showing through.

Horizontal bar meter over an integer range

Slim float bar meter, drawn in the lower half of its box

Rounded box with a black / white / black border stack

Note — Leaves the draw colour at 1.

Draw an icon offset by half its own size

Note — The offset is added, not subtracted: the icon lands with its top-left half a width/height *past* (x, y). Pass the top-left of the box you want it centred in.

Draw a string centred on the screen, nudged right if it has an icon

Returns — X the text was drawn at — draw the icon relative to it

Output style for ui_format_time() */ typedef enum { TIME_FORMAT_COMPACT, /**< "MM:SS.ss" or "HH:MM:SS.ss" — timeline readouts */ TIME_FORMAT_VERBOSE, /**< "Xh Ym Zs" — menu labels */ } TimeFormatStyle; /**

Note — Compact output drops leading zero fields — a sub-minute value comes out "SS.ss".

Fill a rectangle with a line/dot texture instead of a dither pattern

Note — Distinct from the dithered fills: this is a geometric texture at your chosen spacing, not a grey level. Clipped to the screen internally.

Single horizontal level bar

Two stacked level bars, left over right

Draw word-wrapped text

Returns — Baseline y of the last line drawn

Note — Wraps on character count, not pixel width, so pick the limit for the font you have selected.

Warning — `max_chr_per_line` must stay at or below 100 — the firmware assembles each line in a 101-byte stack buffer and does not bounds-check the limit you pass.

Count the lines ui_draw_str_multi_line() would produce

Returns — Number of lines

Note — Use it to size a panel before you draw the text into it.

Word-wrapped text revealed a character at a time — the typewriter effect

Draw an empty speech bubble — rounded panel plus a tail below it

Note — Draws the container only. Follow it with ui_draw_dialogue_multiline_string() for the text.

Filled button, 24px tall, with centred text or an icon

ui_draw_button() with the fill and outline swapped

On/off toggle