bonbon 0.4.1

Overview

Bonbon is a fast, customizable graph rendering library designed for diabetes related data visualization. It supports glucose entries, insulin doses, carbohydrate intake, and manual blood glucose readings with configurable themes, units, and layout options.

Features

• Flexible Units: Support for mg/dL, mmol/L, or dual-unit display
• Treatment Visualization: Insulin boluses, carbohydrate entries, and manual BG readings
• Customizable Themes: 6 built-in themes. (See Theme::builtins()) with full customization support
• Dynamic Scaling: Automatic Y-axis scaling based on glucose values
• Timezone Support: Accurate time axis labels for any timezone
• Microbolus Filtering: Configurable threshold to simplify SMB visualization
• BG Card: Compact status card showing current glucose, trend, delta, IOB/COB, and a 3 hour sparkline
• Time in Range Card: TIR summary with a stacked band bar, per-band durations and counts, plus average, SD, CV and GMI statistics

Glucose Graph

The Glucose Graph is a full-resolution chart rendering glucose entries over time, with optional treatment markers (insulin boluses, carbs, manual BG readings), configurable Y-axis scaling, timezone-aware time axis, and dual-unit support.

BG Card

The BG Card is a compact 640×320 status card (scalable via with_scale) that renders current glucose, trend arrow, delta, age, IOB/COB, and a color-coded 3-hour sparkline with an ambient gradient fill.

Time in Range Card

The Time in Range Card is a 640×400 summary (scalable via with_scale) of how much time was spent in each glycemic band (very low, low, in range, high, very high) rendered as a stacked bar with per-band percentages, durations and reading counts, and a statistics footer (average, SD, CV, GMI, target range). Band thresholds, units, theme and the 3-band/5-band layout are configurable, and the computed numbers are available without rendering through TirStats::compute.

Installation

Add Bonbon to your Cargo.toml:

[dependencies]

bonbon = "0.4.1"

Examples & Docs

Some usage examples can be found in the bonbon/examples directory.

Additional documentation can be found on the docs.rs website.

Performance Tips

To achieve the best possible rendering speed, it is highly recommended to compile with native CPU optimizations. This enables modern SIMD instructions (AVX2, NEON, etc.), which accelerates the pixel blending and sprite rendering operations.

You can enable this by setting the RUSTFLAGS environment variable:

RUSTFLAGS="-C target-cpu=native" cargo build --release

Or by adding a .cargo/config.toml to your project:

[build]

rustflags = ["-C", "target-cpu=native"]

Benchmarks

BG Card build time at 4× scale (2560×1280)

Averaged across 8 rendering scenarios (InRange, High, Low, multi-status, mmol/L, flat sparkline, single point, no sparkline).

Graph build time (using native CPU compilation optimizations)

License

This project is licensed under the MPL-2.0 License. See the LICENSE file for details.

This project uses Material Icons by Google, licensed under the Apache License 2.0. https://github.com/google/material-design-icons