use cairo::{Context as CairoContext, FontSlant, FontWeight};
use plotters_backend::text_anchor::{HPos, VPos};
#[allow(unused_imports)]
use plotters_backend::{
BackendColor, BackendCoord, BackendStyle, BackendTextStyle, DrawingBackend, DrawingErrorKind,
FontStyle, FontTransform,
};
pub struct CairoBackend<'a> {
context: &'a CairoContext,
width: u32,
height: u32,
init_flag: bool,
}
#[derive(Debug)]
pub struct CairoError;
impl std::fmt::Display for CairoError {
fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
write!(fmt, "{:?}", self)
}
}
impl std::error::Error for CairoError {}
impl<'a> CairoBackend<'a> {
fn set_color(&self, color: &BackendColor) {
self.context.set_source_rgba(
f64::from(color.rgb.0) / 255.0,
f64::from(color.rgb.1) / 255.0,
f64::from(color.rgb.2) / 255.0,
color.alpha,
);
}
fn set_stroke_width(&self, width: u32) {
self.context.set_line_width(f64::from(width));
}
fn set_font<S: BackendTextStyle>(&self, font: &S) {
match font.style() {
FontStyle::Normal => self.context.select_font_face(
font.family().as_str(),
FontSlant::Normal,
FontWeight::Normal,
),
FontStyle::Bold => self.context.select_font_face(
font.family().as_str(),
FontSlant::Normal,
FontWeight::Bold,
),
FontStyle::Oblique => self.context.select_font_face(
font.family().as_str(),
FontSlant::Oblique,
FontWeight::Normal,
),
FontStyle::Italic => self.context.select_font_face(
font.family().as_str(),
FontSlant::Italic,
FontWeight::Normal,
),
};
self.context.set_font_size(font.size());
}
pub fn new(context: &'a CairoContext, (w, h): (u32, u32)) -> Result<Self, CairoError> {
Ok(Self {
context,
width: w,
height: h,
init_flag: false,
})
}
}
impl<'a> DrawingBackend for CairoBackend<'a> {
type ErrorType = cairo::Error;
fn get_size(&self) -> (u32, u32) {
(self.width, self.height)
}
fn ensure_prepared(&mut self) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
if !self.init_flag {
let (x0, y0, x1, y1) = self
.context
.clip_extents()
.map_err(DrawingErrorKind::DrawingError)?;
self.context.scale(
(x1 - x0) / f64::from(self.width),
(y1 - y0) / f64::from(self.height),
);
self.init_flag = true;
}
Ok(())
}
fn present(&mut self) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
Ok(())
}
fn draw_pixel(
&mut self,
point: BackendCoord,
color: BackendColor,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.context
.rectangle(f64::from(point.0), f64::from(point.1), 1.0, 1.0);
self.context.set_source_rgba(
f64::from(color.rgb.0) / 255.0,
f64::from(color.rgb.1) / 255.0,
f64::from(color.rgb.2) / 255.0,
color.alpha,
);
self.context
.fill()
.map_err(DrawingErrorKind::DrawingError)?;
Ok(())
}
fn draw_line<S: BackendStyle>(
&mut self,
from: BackendCoord,
to: BackendCoord,
style: &S,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.set_color(&style.color());
self.set_stroke_width(style.stroke_width());
self.context.move_to(f64::from(from.0), f64::from(from.1));
self.context.line_to(f64::from(to.0), f64::from(to.1));
self.context
.stroke()
.map_err(DrawingErrorKind::DrawingError)?;
Ok(())
}
fn draw_rect<S: BackendStyle>(
&mut self,
upper_left: BackendCoord,
bottom_right: BackendCoord,
style: &S,
fill: bool,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.set_color(&style.color());
self.set_stroke_width(style.stroke_width());
self.context.rectangle(
f64::from(upper_left.0),
f64::from(upper_left.1),
f64::from(bottom_right.0 - upper_left.0),
f64::from(bottom_right.1 - upper_left.1),
);
if fill {
self.context
.fill()
.map_err(DrawingErrorKind::DrawingError)?;
} else {
self.context
.stroke()
.map_err(DrawingErrorKind::DrawingError)?;
}
Ok(())
}
fn draw_path<S: BackendStyle, I: IntoIterator<Item = BackendCoord>>(
&mut self,
path: I,
style: &S,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.set_color(&style.color());
self.set_stroke_width(style.stroke_width());
let mut path = path.into_iter();
if let Some((x, y)) = path.next() {
self.context.move_to(f64::from(x), f64::from(y));
}
for (x, y) in path {
self.context.line_to(f64::from(x), f64::from(y));
}
self.context
.stroke()
.map_err(DrawingErrorKind::DrawingError)?;
Ok(())
}
fn fill_polygon<S: BackendStyle, I: IntoIterator<Item = BackendCoord>>(
&mut self,
path: I,
style: &S,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.set_color(&style.color());
self.set_stroke_width(style.stroke_width());
let mut path = path.into_iter();
if let Some((x, y)) = path.next() {
self.context.move_to(f64::from(x), f64::from(y));
for (x, y) in path {
self.context.line_to(f64::from(x), f64::from(y));
}
self.context.close_path();
self.context
.fill()
.map_err(DrawingErrorKind::DrawingError)?;
}
Ok(())
}
fn draw_circle<S: BackendStyle>(
&mut self,
center: BackendCoord,
radius: u32,
style: &S,
fill: bool,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
self.set_color(&style.color());
self.set_stroke_width(style.stroke_width());
self.context.new_sub_path();
self.context.arc(
f64::from(center.0),
f64::from(center.1),
f64::from(radius),
0.0,
std::f64::consts::PI * 2.0,
);
if fill {
self.context
.fill()
.map_err(DrawingErrorKind::DrawingError)?;
} else {
self.context
.stroke()
.map_err(DrawingErrorKind::DrawingError)?;
}
Ok(())
}
fn estimate_text_size<S: BackendTextStyle>(
&self,
text: &str,
font: &S,
) -> Result<(u32, u32), DrawingErrorKind<Self::ErrorType>> {
self.set_font(font);
let extents = self
.context
.text_extents(text)
.map_err(DrawingErrorKind::DrawingError)?;
Ok((extents.width() as u32, extents.height() as u32))
}
fn draw_text<S: BackendTextStyle>(
&mut self,
text: &str,
style: &S,
pos: BackendCoord,
) -> Result<(), DrawingErrorKind<Self::ErrorType>> {
let color = style.color();
let (mut x, mut y) = (pos.0, pos.1);
let degree = match style.transform() {
FontTransform::None => 0.0,
FontTransform::Rotate90 => 90.0,
FontTransform::Rotate180 => 180.0,
FontTransform::Rotate270 => 270.0,
} / 180.0
* std::f64::consts::PI;
if degree != 0.0 {
self.context
.save()
.map_err(DrawingErrorKind::DrawingError)?;
self.context.translate(f64::from(x), f64::from(y));
self.context.rotate(degree);
x = 0;
y = 0;
}
self.set_font(style);
self.set_color(&color);
let extents = self
.context
.text_extents(text)
.map_err(DrawingErrorKind::DrawingError)?;
let dx = match style.anchor().h_pos {
HPos::Left => 0.0,
HPos::Right => -extents.width(),
HPos::Center => -extents.width() / 2.0,
};
let dy = match style.anchor().v_pos {
VPos::Top => extents.height(),
VPos::Center => extents.height() / 2.0,
VPos::Bottom => 0.0,
};
self.context.move_to(
f64::from(x) + dx - extents.x_bearing(),
f64::from(y) + dy - extents.y_bearing() - extents.height(),
);
self.context
.show_text(text)
.map_err(DrawingErrorKind::DrawingError)?;
if degree != 0.0 {
self.context
.restore()
.map_err(DrawingErrorKind::DrawingError)?;
}
Ok(())
}
}
#[cfg(test)]
mod test {
use super::*;
use plotters::prelude::*;
use plotters_backend::text_anchor::{HPos, Pos, VPos};
use std::fs;
use std::path::Path;
static DST_DIR: &str = "target/test/cairo";
fn checked_save_file(name: &str, content: &str) {
assert!(!content.is_empty());
fs::create_dir_all(DST_DIR).unwrap();
let file_name = format!("{}.ps", name);
let file_path = Path::new(DST_DIR).join(file_name);
println!("{:?} created", file_path);
fs::write(file_path, &content).unwrap();
}
fn draw_mesh_with_custom_ticks(tick_size: i32, test_name: &str) {
let buffer: Vec<u8> = vec![];
let surface = cairo::PsSurface::for_stream(500.0, 500.0, buffer).unwrap();
let cr = CairoContext::new(&surface).unwrap();
let root = CairoBackend::new(&cr, (500, 500))
.unwrap()
.into_drawing_area();
let mut chart = ChartBuilder::on(&root)
.caption("this-is-a-test", ("sans-serif", 20))
.set_all_label_area_size(40)
.build_cartesian_2d(0..10, 0..10)
.unwrap();
chart
.configure_mesh()
.set_all_tick_mark_size(tick_size)
.draw()
.unwrap();
let buffer = *surface.finish_output_stream().unwrap().downcast().unwrap();
let content = String::from_utf8(buffer).unwrap();
checked_save_file(test_name, &content);
assert!(content.contains("this-is-a-test"));
}
#[test]
fn test_draw_mesh_no_ticks() {
draw_mesh_with_custom_ticks(0, "test_draw_mesh_no_ticks");
}
#[test]
fn test_draw_mesh_negative_ticks() {
draw_mesh_with_custom_ticks(-10, "test_draw_mesh_negative_ticks");
}
#[test]
fn test_text_draw() {
let buffer: Vec<u8> = vec![];
let (width, height) = (1500, 800);
let surface = cairo::PsSurface::for_stream(width.into(), height.into(), buffer).unwrap();
let cr = CairoContext::new(&surface).unwrap();
let root = CairoBackend::new(&cr, (width, height))
.unwrap()
.into_drawing_area();
let root = root
.titled("Image Title", ("sans-serif", 60).into_font())
.unwrap();
let mut chart = ChartBuilder::on(&root)
.caption("All anchor point positions", ("sans-serif", 20))
.set_all_label_area_size(40)
.build_cartesian_2d(0..100, 0..50)
.unwrap();
chart
.configure_mesh()
.disable_x_mesh()
.disable_y_mesh()
.x_desc("X Axis")
.y_desc("Y Axis")
.draw()
.unwrap();
let ((x1, y1), (x2, y2), (x3, y3)) = ((-30, 30), (0, -30), (30, 30));
for (dy, trans) in [
FontTransform::None,
FontTransform::Rotate90,
FontTransform::Rotate180,
FontTransform::Rotate270,
]
.iter()
.enumerate()
{
for (dx1, h_pos) in [HPos::Left, HPos::Right, HPos::Center].iter().enumerate() {
for (dx2, v_pos) in [VPos::Top, VPos::Center, VPos::Bottom].iter().enumerate() {
let x = 150_i32 + (dx1 as i32 * 3 + dx2 as i32) * 150;
let y = 120 + dy as i32 * 150;
let draw = |x, y, text| {
root.draw(&Circle::new((x, y), 3, &BLACK.mix(0.5))).unwrap();
let style = TextStyle::from(("sans-serif", 20).into_font())
.pos(Pos::new(*h_pos, *v_pos))
.transform(trans.clone());
root.draw_text(text, &style, (x, y)).unwrap();
};
draw(x + x1, y + y1, "dood");
draw(x + x2, y + y2, "dog");
draw(x + x3, y + y3, "goog");
}
}
}
let buffer = *surface.finish_output_stream().unwrap().downcast().unwrap();
let content = String::from_utf8(buffer).unwrap();
checked_save_file("test_text_draw", &content);
assert_eq!(content.matches("dog").count(), 36);
assert_eq!(content.matches("dood").count(), 36);
assert_eq!(content.matches("goog").count(), 36);
}
#[test]
fn test_text_clipping() {
let buffer: Vec<u8> = vec![];
let (width, height) = (500_i32, 500_i32);
let surface = cairo::PsSurface::for_stream(width.into(), height.into(), buffer).unwrap();
let cr = CairoContext::new(&surface).unwrap();
let root = CairoBackend::new(&cr, (width as u32, height as u32))
.unwrap()
.into_drawing_area();
let style = TextStyle::from(("sans-serif", 20).into_font())
.pos(Pos::new(HPos::Center, VPos::Center));
root.draw_text("TOP LEFT", &style, (0, 0)).unwrap();
root.draw_text("TOP CENTER", &style, (width / 2, 0))
.unwrap();
root.draw_text("TOP RIGHT", &style, (width, 0)).unwrap();
root.draw_text("MIDDLE LEFT", &style, (0, height / 2))
.unwrap();
root.draw_text("MIDDLE RIGHT", &style, (width, height / 2))
.unwrap();
root.draw_text("BOTTOM LEFT", &style, (0, height)).unwrap();
root.draw_text("BOTTOM CENTER", &style, (width / 2, height))
.unwrap();
root.draw_text("BOTTOM RIGHT", &style, (width, height))
.unwrap();
let buffer = *surface.finish_output_stream().unwrap().downcast().unwrap();
let content = String::from_utf8(buffer).unwrap();
checked_save_file("test_text_clipping", &content);
}
#[test]
fn test_series_labels() {
let buffer: Vec<u8> = vec![];
let (width, height) = (500, 500);
let surface = cairo::PsSurface::for_stream(width.into(), height.into(), buffer).unwrap();
let cr = CairoContext::new(&surface).unwrap();
let root = CairoBackend::new(&cr, (width, height))
.unwrap()
.into_drawing_area();
let mut chart = ChartBuilder::on(&root)
.caption("All series label positions", ("sans-serif", 20))
.set_all_label_area_size(40)
.build_cartesian_2d(0..50, 0..50)
.unwrap();
chart
.configure_mesh()
.disable_x_mesh()
.disable_y_mesh()
.draw()
.unwrap();
chart
.draw_series(std::iter::once(Circle::new((5, 15), 5, &RED)))
.expect("Drawing error")
.label("Series 1")
.legend(|(x, y)| Circle::new((x, y), 3, RED.filled()));
chart
.draw_series(std::iter::once(Circle::new((5, 15), 10, &BLUE)))
.expect("Drawing error")
.label("Series 2")
.legend(|(x, y)| Circle::new((x, y), 3, BLUE.filled()));
for pos in vec![
SeriesLabelPosition::UpperLeft,
SeriesLabelPosition::MiddleLeft,
SeriesLabelPosition::LowerLeft,
SeriesLabelPosition::UpperMiddle,
SeriesLabelPosition::MiddleMiddle,
SeriesLabelPosition::LowerMiddle,
SeriesLabelPosition::UpperRight,
SeriesLabelPosition::MiddleRight,
SeriesLabelPosition::LowerRight,
SeriesLabelPosition::Coordinate(70, 70),
]
.into_iter()
{
chart
.configure_series_labels()
.border_style(&BLACK.mix(0.5))
.position(pos)
.draw()
.expect("Drawing error");
}
let buffer = *surface.finish_output_stream().unwrap().downcast().unwrap();
let content = String::from_utf8(buffer).unwrap();
checked_save_file("test_series_labels", &content);
}
#[test]
fn test_draw_pixel_alphas() {
let buffer: Vec<u8> = vec![];
let (width, height) = (100_i32, 100_i32);
let surface = cairo::PsSurface::for_stream(width.into(), height.into(), buffer).unwrap();
let cr = CairoContext::new(&surface).unwrap();
let root = CairoBackend::new(&cr, (width as u32, height as u32))
.unwrap()
.into_drawing_area();
for i in -20..20 {
let alpha = i as f64 * 0.1;
root.draw_pixel((50 + i, 50 + i), &BLACK.mix(alpha))
.unwrap();
}
let buffer = *surface.finish_output_stream().unwrap().downcast().unwrap();
let content = String::from_utf8(buffer).unwrap();
checked_save_file("test_draw_pixel_alphas", &content);
}
}