Struct BarChart 

pub struct BarChart<C: PixelColor> { /* private fields */ }

Bar chart implementation for displaying categorical data.

A bar chart displays data using rectangular bars with lengths proportional to the values they represent. This implementation supports both vertical and horizontal orientations, making it suitable for various data visualization needs on embedded displays.

Features

• Configurable bar orientation (vertical/horizontal)
• Flexible bar width options (fixed, proportional, automatic)
• Multi-color support with automatic color cycling
• Customizable spacing and borders
• Support for stacked bars (feature-gated)
• Memory-efficient static allocation

Memory Usage

The bar chart uses static allocation with:

• Up to 16 bar colors stored in a heapless vector
• Screen coordinate calculations for bar positioning
• Efficient rendering with minimal temporary storage

Examples

Basic vertical bar chart:

use embedded_charts::prelude::*;
use embedded_graphics::pixelcolor::Rgb565;

let chart: BarChart<Rgb565> = BarChart::new();
let mut data: StaticDataSeries<Point2D, 256> = StaticDataSeries::new();
data.push(Point2D::new(0.0, 10.0))?;
data.push(Point2D::new(1.0, 20.0))?;

Horizontal bar chart with custom styling:

use embedded_charts::prelude::*;
use embedded_graphics::pixelcolor::Rgb565;

let chart = BarChart::builder()
    .orientation(BarOrientation::Horizontal)
    .bar_width(BarWidth::Fixed(25))
    .spacing(3)
    .colors(&[Rgb565::GREEN])
    .build()?;

Implementations

impl<C> BarChart<C>

where C: From<Rgb565> + PixelColor,

pub fn new() -> Self

Create a new bar chart with default styling.

This creates a bar chart with:

• Vertical orientation
• Single blue bar color
• Automatic bar width
• 5-pixel spacing between bars
• No borders
• Default margins (10 pixels on all sides)

Examples

use embedded_charts::prelude::*;
use embedded_graphics::pixelcolor::Rgb565;

let chart: BarChart<Rgb565> = BarChart::new();

pub fn builder() -> BarChartBuilder<C>

Create a builder for configuring the bar chart.

The builder pattern provides a fluent interface for configuring all aspects of the bar chart before creation.

Examples

use embedded_charts::prelude::*;
use embedded_graphics::pixelcolor::Rgb565;

let chart = BarChart::builder()
    .orientation(BarOrientation::Horizontal)
    .bar_width(BarWidth::Fixed(30))
    .spacing(8)
    .colors(&[Rgb565::GREEN])
    .build()?;

pub fn set_style(&mut self, style: BarChartStyle<C>)

Set the bar chart style configuration.

This replaces the entire style configuration with the provided one. Use the builder pattern for more granular control.

Arguments

• style - The new bar chart style configuration

Examples

use embedded_charts::prelude::*;
use embedded_graphics::pixelcolor::Rgb565;

let mut chart: BarChart<Rgb565> = BarChart::new();
let mut colors = heapless::Vec::new();
colors.push(Rgb565::BLUE).unwrap();
colors.push(Rgb565::RED).unwrap();

let style = BarChartStyle {
    bar_colors: colors,
    bar_width: BarWidth::Fixed(25),
    spacing: 3,
    border: None,
    stacked: false,
};
chart.set_style(style);

pub fn style(&self) -> &BarChartStyle<C>

Get the current bar chart style configuration.

Returns a reference to the current style configuration, allowing inspection of current settings.

Returns

A reference to the current BarChartStyle

pub fn set_config(&mut self, config: ChartConfig<C>)

Set the chart configuration.

This includes general chart settings like title, background color, margins, and grid visibility.

Arguments

• config - The new chart configuration

pub fn config(&self) -> &ChartConfig<C>

Get the chart configuration

pub fn set_orientation(&mut self, orientation: BarOrientation)

Set the bar orientation

pub fn orientation(&self) -> BarOrientation

Get the bar orientation

Trait Implementations

impl<C> Chart<C> for BarChart<C>

where C: From<Rgb565> + PixelColor,

type Data = StaticDataSeries<Point2D, 256>

The type of data this chart can render

type Config = ChartConfig<C>

Configuration type for this chart

fn draw<D>( &self, data: &Self::Data, config: &Self::Config, viewport: Rectangle, target: &mut D, ) -> ChartResult<()>

where D: DrawTarget<Color = C>, Self::Data: DataSeries, <Self::Data as DataSeries>::Item: DataPoint, <<Self::Data as DataSeries>::Item as DataPoint>::X: Into<f32> + Copy + PartialOrd, <<Self::Data as DataSeries>::Item as DataPoint>::Y: Into<f32> + Copy + PartialOrd,

Draw the chart to the target display

fn data_bounds(&self, _data: &Self::Data) -> ChartResult<()>

Get the data bounds for this chart

impl<C: Clone + PixelColor> Clone for BarChart<C>

fn clone(&self) -> BarChart<C>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug + PixelColor> Debug for BarChart<C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<C> Default for BarChart<C>

where C: From<Rgb565> + PixelColor,

fn default() -> Self

Returns the “default value” for a type.