On this page

charts.h

Charts, rich text spans, animated images, image buttons and app textures, reached through isolenui/kit/kit.h. The gif, lottie and anim declarations here are not implemented yet.

The charts group of the kit, drawn by isolenThe charts group of the kit, drawn by isolen

#include "isolenui/kit/charts.h". The guide starts at Charts.

Chart kinds and flags

Explained in Charts.

ui::chart_kindui::chart_lineui::chart_areaui::chart_barui::chart_scatterui::chart_pieui::chart_donutui::chart_flagui::chart_stackedui::chart_smoothui::chart_pointsui::chart_no_gridui::chart_no_legendui::chart_no_x_axisui::chart_no_y_axisui::chart_no_tooltipui::chart_no_crosshair

Series, axes and the spec

Explained in Charts.

ui::chart_seriesui::chart_axisui::chart_specui::chart_ofui::chartui::chart_hitui::chart_frameui::chart_px_xui::chart_px_yui::chart_paint_fnui::chart_color

Live data and helpers

Explained in Charts.

ui::chart_ringui::chart_ring_initui::chart_ring_pushui::chart_ring_seriesui::chart_ticksui::chart_decimalsui::chart_decimateui::chart_gapui::chart_range

Rich text

Explained in Rich text and images.

ui::spangroupui::text_spanui::span_flagui::span_boldui::span_underlineui::span_strikeui::span_linkui::span_monoui::span_styleui::span_style_ofui::span_hit

GIF and animation runtime

Explained in GIF and animations.

ui::anim_infoui::anim_decoderui::anim_registerui::anim_cacheui::anim_streamui::anim_prerenderui::anim_minimalui::anim_autoui::anim_descui::anim_srcui::anim_openui::anim_closeui::anim_info_ofui::anim_playui::anim_play_ofui::gifui::anim_decodeui::anim_decode_autoui::anim_decode_inlineui::anim_decode_aheadui::anim_repeat_fileui::anim_repeat_foreverui::gif_loadui::gif_loadingui::gif_readyui::gif_failedui::gif_urlui::gif_url_openui::gif_url_closeui::gif_url_pollui::gif_url_srcui::gif_url_whyui::gif_url_bytes

Lottie

Explained in Lottie.

ui::lottie

3D model viewer

Explained in 3D model viewer.

ui::model_view_cameraui::model_view_bgui::model_view_clearui::model_view_themeui::model_view_specui::model_view_infoui::model_view_ofui::model_view

Images

Explained in Rich text and images.

ui::animimgui::animimg_specui::imagebtnui::imagebtn_imagesui::imagebtn_specui::texture3dui::texture3d_specui::texture3d_of

Example

stats_panel.cpp
#include "isolenui/ui/ui.h"
#include "isolenui/kit/kit.h"

struct stats_panel {
    float cpu_store[600];
    ui::chart_ring cpu;
    uint32_t hidden = 0;
};

static void setup(stats_panel* s)
{
    ui::chart_ring_init(&s->cpu, s->cpu_store, 600u);
}

// called once per sample from the app, push moves the ring version
static void sample(stats_panel* s, float load)
{
    ui::chart_ring_push(&s->cpu, &load, 1u);
}

static void panel(ui::ctx* u, stats_panel* s)
{
    // a live line over the last 600 samples, the y axis held at 0 to 100
    const ui::chart_series cpu = ui::chart_ring_series(&s->cpu, "cpu", 0u);
    ui::chart_spec live = ui::chart_of(ui::chart_area, &cpu, 1u);
    live.flags = ui::chart_smooth | ui::chart_no_legend;
    live.y.lo = 0.0f;
    live.y.hi = 100.0f;
    live.y.fmt = "%.0f%%";
    ui::chart(u, "cpu load", live);

    // two series as grouped bars, named categories along x
    static const float sent[4] = { 12.0f, 18.0f, 9.0f, 22.0f };
    static const float read[4] = { 8.0f, 14.0f, 11.0f, 16.0f };
    static const char* const quarters[4] = { "q1", "q2", "q3", "q4" };
    static const ui::chart_series io[2] = {
        { "sent", sent, nullptr, 4u, 0u, 0u, 1u, 0u },
        { "read", read, nullptr, 4u, 0u, 0u, 1u, 0u },
    };
    ui::chart_spec bars = ui::chart_of(ui::chart_bar, io, 2u);
    bars.x.labels = quarters;
    bars.x.label_count = 4u;
    // the legend flips a bit here for each series it hides
    bars.hidden = &s->hidden;
    const ui::chart_hit h = ui::chart(u, "traffic", bars,
                                      ui::col().grow().height(200.0f));
    if (h.clicked && h.series >= 0) {
        // open the detail for quarters[h.index] here
    }
}

Last updated 23 October 2026