bonbon 0.2.0

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

• High Performance: Optimized rendering with parallel processing via Rayon
• Flexible Units: Support for mg/dL, mmol/L, or dual-unit display
• Treatment Visualization: Insulin boluses, carbohydrate entries, and manual BG readings
• Customizable Themes: Built-in dark & light themes 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

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.

Installation

Add Bonbon to your Cargo.toml:

[dependencies]

bonbon = "0.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.