charton 0.5.0

A high-performance, layered charting system for Rust, featuring a flexible data core and multi-backend rendering.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

/// Represents a text encoding specification.
///
/// The `Text` struct defines how data values should be mapped to textual content
/// in a chart. It is primarily used by `Text` marks to display labels,
/// annotations, or categorical information directly on the visualization.
///
/// ### Architecture Note:
/// Unlike positional or visual encodings, `Text` is often a direct mapping
/// of data values to strings. However, it still holds a `resolved_scale` to
/// allow for potential future features like data formatting (e.g., date
/// formatting or number rounding) before the text is rendered.
#[derive(Clone, Debug)]
pub struct Text {
    // --- User Configuration (Intent/Inputs) ---
    /// The name of the data column to be used for text content.
    pub(crate) field: String,
    // --- System Resolution (Result/Outputs) ---

    // Stores the resolved scale instance. Using RwLock to support
    // back-filling updates across multiple render calls.
    //pub(crate) resolved_scale: RwLock<Option<Arc<dyn ScaleTrait>>>,
}

impl Text {
    /// Creates a new text encoding for a specific data field.
    pub fn new(field: &str) -> Self {
        Self {
            field: field.to_string(),
            //resolved_scale: RwLock::new(None),
        }
    }
}

/// Convenience builder function to create a new Text encoding.
///
pub fn text(field: &str) -> Text {
    Text::new(field)
}