Struct Text 

pub struct Text {
    pub content: String,
    pub font: String,
    pub size: usize,
    pub color: Rgb,
    pub x: f64,
    pub y: f64,
}

A structure representing text with customizable content, font, size, and color.

Example

use polars::prelude::*;
use plotlars::{Axis, BarPlot, Plot, Text, Rgb};

let dataset = df![
        "label" => &[""],
        "value" => &[0],
    ]
    .unwrap();

let axis = Axis::new()
    .tick_values(vec![]);

BarPlot::builder()
    .data(&dataset)
    .labels("label")
    .values("value")
    .plot_title(
        Text::from("Title")
            .x(0.1)
            .color(Rgb(178, 34, 34))
            .size(30)
            .font("Zapfino")
    )
    .x_title(
        Text::from("X")
            .color(Rgb(65, 105, 225))
            .size(20)
            .font("Marker Felt")
    )
    .y_title(
        Text::from("Y")
            .color(Rgb(255, 140, 0))
            .size(20)
            .font("Arial Black")
    )
    .x_axis(&axis)
    .y_axis(&axis)
    .build()
    .plot();

Fields

content: String

font: String

size: usize

color: Rgb

x: f64

y: f64

Implementations

impl Text

pub fn from(content: impl Into<String>) -> Self

Creates a new Text instance from the given content.

Argument

• content - A value that can be converted into a String, representing the textual content.

pub fn font(self, font: impl Into<String>) -> Self

Sets the font of the text.

Argument

• font - A value that can be converted into a String, representing the font name.

pub fn size(self, size: usize) -> Self

Sets the size of the text.

Argument

• size - A usize value specifying the font size.

pub fn color(self, color: Rgb) -> Self

Sets the color of the text.

Argument

• color - An Rgb value specifying the color of the text.

pub fn x(self, x: f64) -> Self

Sets the x-coordinate position of the text.

Argument

• x - A f64 value specifying the horizontal position.

pub fn y(self, y: f64) -> Self

Sets the y-coordinate position of the text.

Argument

• y - A f64 value specifying the vertical position.

pub fn has_custom_position(&self) -> bool

pub fn with_plot_title_defaults(self) -> Self

Apply default positioning for plot titles (x=0.5, y=0.95 - centered above)

pub fn with_subplot_title_defaults(self) -> Self

Apply default positioning for subplot titles (x=0.5, y=1.1 - centered above, higher than overall)

pub fn with_x_title_defaults(self) -> Self

Apply default positioning for x-axis titles (x=0.5, y=-0.15 - centered below)

pub fn with_y_title_defaults(self) -> Self

Apply default positioning for y-axis titles (x=-0.08, y=0.5 - left side, vertically centered)

pub fn with_x_title_defaults_for_annotation(self) -> Self

Apply default positioning for x-axis title annotations Used when user sets custom position and annotation mode is triggered Ensures unset coordinates get appropriate axis defaults

pub fn with_y_title_defaults_for_annotation(self) -> Self

Apply default positioning for y-axis title annotations Used when user sets custom position and annotation mode is triggered Ensures unset coordinates get appropriate axis defaults

Trait Implementations

impl Clone for Text

fn clone(&self) -> Text

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Text

fn default() -> Self

Provides default values for the Text struct.

• content: An empty string.
• font: An empty string.
• size: 12 (reasonable default for visibility).
• color: Default Rgb value.
• x: 0.5.
• y: 0.9.

impl From<&String> for Text

fn from(content: &String) -> Self

Converts to this type from the input type.

impl From<&str> for Text

fn from(content: &str) -> Self

Converts to this type from the input type.

impl From<String> for Text

fn from(content: String) -> Self

Converts to this type from the input type.