Struct BarChart 

pub struct BarChart { /* private fields */ }

A horizontal bar chart.

Build it from (label, value) pairs and render it through the Renderable pipeline. Bars are scaled to the largest value (or to an explicit with_max); each bar fills proportionally using full blocks plus a fractional partial block for sub-cell precision.

Implementations

impl BarChart

pub fn new() -> Self

Create a new, empty bar chart.

pub fn from_pairs<S: Into<String>>( pairs: impl IntoIterator<Item = (S, f64)>, ) -> Self

Build a chart from an iterator of (label, value) pairs.

pub fn push(&mut self, label: impl Into<String>, value: f64) -> &mut Self

Append a bar, returning &mut Self for fluent calls on an owned value.

pub fn with_bar(self, label: impl Into<String>, value: f64) -> Self

Append a bar (chainable, consuming builder form).

pub fn with_width(self, width: usize) -> Self

Set the total row width in cells (builder pattern).

When unset, the chart fills ConsoleOptions::max_width.

pub fn with_max(self, max: f64) -> Self

Set an explicit scale maximum (builder pattern).

Values are scaled against this instead of the data maximum. A zero or negative maximum is guarded: every bar renders empty.

pub fn with_bar_style(self, style: Style) -> Self

Set the style applied to the bar glyphs (builder pattern).

pub fn with_label_style(self, style: Style) -> Self

Set the style applied to the labels (builder pattern).

pub fn with_value_style(self, style: Style) -> Self

Set the style applied to the formatted values (builder pattern).

pub fn with_show_values(self, show: bool) -> Self

Set whether formatted values are shown (builder pattern; default true).

pub fn len(&self) -> usize

Number of bars in the chart.

pub fn is_empty(&self) -> bool

Whether the chart has no bars.

Trait Implementations

impl Clone for BarChart

fn clone(&self) -> BarChart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BarChart

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

Formats the value using the given formatter.

impl Default for BarChart

fn default() -> Self

Returns the “default value” for a type.

impl Display for BarChart

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

Formats the value using the given formatter.

impl Renderable for BarChart

fn gilt_console( &self, _console: &Console, options: &ConsoleOptions, ) -> Vec<Segment>

Produce segments for rendering on the given console with given options.

fn gilt_measure( &self, _console: &Console, options: &ConsoleOptions, ) -> Measurement

Return the minimum and maximum cell widths required to render this object.

fn content_hash(&self) -> Option<u64>

Return a cheap hash of this widget’s content for per-region dirty tracking.