rstk 0.3.0

A Rust binding for the Tk graphics toolkit. Tk is suitable for creating simple GUI programs or interactive graphical displays. This library supports a large portion of the Tk API, in a generally rust-like style.
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

//! Bar chart - choice of display with vertical or horizontal bars.
//!

use crate::chart::plotchart;
use crate::canvas;
use crate::font;
use crate::wish;

/// Refers to a bar chart
#[derive(Clone, Debug, PartialEq)]
pub struct TkBarChart {
    pub id: String,
}

/// Refers to a bar chart plotted with horizontal bars
#[derive(Clone, Debug, PartialEq)]
pub struct TkHorizontalBarChart {
    pub id: String,
}

/// Creates an instance of a bar chart in given canvas.
pub fn make_bar_chart(
    canvas: &canvas::TkCanvas,
    x_labels: &[&str],
    y_axis: (f64, f64, f64),
    num_series: plotchart::BarSeries,
    x_label_angle: f64
) -> TkBarChart {
    let mut labels_str = String::new();
    for label in x_labels {
        labels_str.push('{');
        labels_str.push_str(label);
        labels_str.push('}');
        labels_str.push(' ');
    }
    let id = wish::next_var();
    let msg = format!(
        "global {}; set {} [::Plotchart::createBarchart {} {{{}}} {{ {} {} {} }} {}  -xlabelangle {}]",
        id, id, &canvas.id, labels_str, y_axis.0, y_axis.1, y_axis.2, num_series, x_label_angle
    );
    wish::tell_wish(&msg);

    TkBarChart { id }
}

/// Creates an instance of a horizontal bar chart in given canvas.
pub fn make_horizontal_bar_chart(
    canvas: &canvas::TkCanvas,
    x_axis: (f64, f64, f64),
    y_labels: &[&str],
    num_series: plotchart::BarSeries,
) -> TkHorizontalBarChart {
    let mut labels_str = String::new();
    for label in y_labels {
        labels_str.push('{');
        labels_str.push_str(label);
        labels_str.push('}');
        labels_str.push(' ');
    }

    let id = wish::next_var();
    let msg = format!(
        "global {}; set {} [::Plotchart::createHorizontalBarchart {} {{ {} {} {} }} {{{}}} {}]",
        id, id, &canvas.id, x_axis.0, x_axis.1, x_axis.2, labels_str, num_series
        );
    wish::tell_wish(&msg);

    TkHorizontalBarChart { id }
}

impl plotchart::TkPlotchart for TkBarChart {
    /// Returns the widget's id reference - used within tk
    fn id(&self) -> &str {
        &self.id
    }
}

impl plotchart::TkPlotchart for TkHorizontalBarChart {
    /// Returns the widget's id reference - used within tk
    fn id(&self) -> &str {
        &self.id
    }
}

pub trait BarChartMethods : plotchart::TkPlotchart {
    /// Plot given data.
    fn plot(&self, series: &str, data: &[f64], colour: &str) {
        let mut data_str = String::new();
        for datum in data {
            data_str.push_str(&format!("{} ", datum));
        }

        let msg = format!("global {}; ${} plot {} {{{}}} {}",
                          self.id(), self.id(), series,
                          data_str, colour);
        wish::tell_wish(&msg);
    }

    /// Plot given data with a colour gradient.
    fn plot_gradient(&self, series: &str, data: &[f64], colour: &str, 
                     direction: plotchart::GradientDirection, 
                     brightness: plotchart::Brightness) {
        let mut data_str = String::new();
        for datum in data {
            data_str.push_str(&format!("{} ", datum));
        }

        let msg = format!("global {}; ${} plot {} {{{}}} {} {} {}",
                          self.id(), self.id(), series,
                          data_str, colour, direction, brightness);
        wish::tell_wish(&msg);
    }

    /// Set to true to show values on top of bar.
    fn show_values(&self, value: bool) {
        let msg = format!("global {}; ${} config -showvalues {}",
                          self.id(), self.id(),
                          if value { "1" } else { "0" });
        wish::tell_wish(&msg);
    }
    
    /// Colour to use when showing values.
    fn value_colour(&self, colour: &str) {
        let msg = format!("global {}; ${} config -valuecolour {}",
                          self.id(), self.id(), colour);
        wish::tell_wish(&msg);
    } 

    /// Font to use when showing values.
    fn value_font(&self, font: &font::TkFont) {
        let msg = format!("global {}; ${} config -valuefont {{{}}}",
                          self.id(), self.id(), font);
        wish::tell_wish(&msg);
    }

    /// Format to use when showing values, in Tk format:
    ///
    /// * see Tk [manual](https://www.tcl.tk/man/tcl8.5/TclCmd/format.htm)
    fn value_format(&self, format: &str) {
        let msg = format!("global {}; ${} config -valueformat {{{}}}",
                          self.id(), self.id(), format);
        wish::tell_wish(&msg);
    } 
}

impl BarChartMethods for TkBarChart {}
 
impl BarChartMethods for TkHorizontalBarChart {}