Struct GroupBarChart

pub struct GroupBarChart {
    pub datasets: Vec<BarDataset>,
    pub title: String,
    pub x_label: String,
    pub y_label: String,
    pub orientation: Orientation,
    pub config: FigureConfig,
}

A grouped bar chart representation, supporting horizontal and vertical orientations.

Fields

datasets: Vec<BarDataset>

A collection of datasets to be visualized in the grouped bar chart.

title: String

Title of the bar chart.

x_label: String

Label for the X-axis.

y_label: String

Label for the Y-axis.

orientation: Orientation

Orientation of the bar chart (Horizontal or Vertical).

config: FigureConfig

Configuration settings for rendering the chart (e.g., colors, fonts, grid).

Implementations

impl GroupBarChart

pub fn new( title: &str, x_label: &str, y_label: &str, orientation: Orientation, config: FigureConfig, ) -> Self

Creates a new GroupBarChart instance with the specified title, labels, orientation, and configuration.

Parameters

• title: The title of the bar chart.
• x_label: The label for the X-axis.
• y_label: The label for the Y-axis.
• orientation: The orientation of the bar chart (Horizontal or Vertical).
• config: The FigureConfig containing appearance and behavior settings for the chart.

Returns

A new GroupBarChart instance with an empty dataset.

Example

use crate::figure::configuration::figureconfig::FigureConfig;
use crate::figure::groupbarchart::GroupBarChart;
use crate::figure::utilities::orientation::Orientation;

let config = FigureConfig::default();
let bar_chart = GroupBarChart::new("Sales Chart", "Year", "Revenue", Orientation::Vertical, config);

pub fn add_dataset(&mut self, dataset: BarDataset)

Adds a dataset to the grouped bar chart.

Parameters

• dataset: The BarDataset to be added to the chart.

Example

use crate::figure::datasets::bardataset::BarDataset;

let dataset = BarDataset::new("Company A", [255, 0, 0]);
bar_chart.add_dataset(dataset);

pub fn draw_horizontal(&self, canvas: &mut PixelCanvas)

Draws a horizontal grouped bar chart.

Parameters

• canvas: The PixelCanvas to render the bar chart on.

Details

This method draws a horizontally oriented bar chart with grouped bars. It uses the FigureConfig settings for appearance and adjusts the canvas accordingly.

Example

bar_chart.draw_horizontal(&mut canvas);

pub fn draw_vertical(&self, canvas: &mut PixelCanvas)

Draws a vertical grouped bar chart.

Parameters

• canvas: The PixelCanvas to render the bar chart on.

Details

This method draws a vertically oriented bar chart with grouped bars. It uses the FigureConfig settings for appearance and adjusts the canvas accordingly.

Example

bar_chart.draw_vertical(&mut canvas);

Trait Implementations

impl Drawer for GroupBarChart

fn draw_svg(&mut self, svg_canvas: &mut SvgCanvas)

Draws the plot content on an SvgCanvas.

fn draw(&mut self, canvas: &mut PixelCanvas)

Draws the main content of the plot on a PixelCanvas.

fn draw_legend(&self, canvas: &mut PixelCanvas)

Draws the legend for the plot on a PixelCanvas.

fn draw_grid(&self, canvas: &mut PixelCanvas, config: &FigureConfig)

Draws the grid for the plot based on the provided configuration.

fn draw_axis( &self, canvas: &mut PixelCanvas, config: &FigureConfig, x1: i32, y1: i32, x2: i32, y2: i32, )

Draws an axis line on the canvas.

fn draw_label( &self, canvas: &mut PixelCanvas, config: &FigureConfig, x: u32, y: u32, text: &str, )

Draws a text label on the canvas.

fn draw_title( &self, canvas: &mut PixelCanvas, config: &FigureConfig, x: u32, y: u32, text: &str, )

Draws the plot title on the canvas.

fn draw_axis_value( &self, canvas: &mut PixelCanvas, config: &FigureConfig, x: u32, y: u32, text: &str, axis: AxisType, )

Draws a value on the axis (tick label) based on its type.

impl Hover for GroupBarChart

fn handle_hover( &self, mouse_x: u32, mouse_y: u32, canvas: &PixelCanvas, ) -> Option<Vec<u32>>

Handles hover functionality and returns an updated buffer if applicable.

fn find_closest_point( &self, mouse_x: u32, mouse_y: u32, canvas: &PixelCanvas, ) -> Option<((f64, f64), f64)>

Finds the closest point to the mouse position on the plot.

fn to_canvas_coordinates( &self, x: f64, y: f64, canvas: &PixelCanvas, ) -> (u32, u32)

Converts plot coordinates into canvas pixel coordinates.

fn get_font<'a>(&self, font_data: &'a [u8]) -> FontRef<'a>

Retrieves the font used for hover text rendering.