oxidize-pdf 2.5.0

A pure Rust PDF generation and manipulation library with zero external dependencies
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

//! Chart Generation System for PDF Reports
//!
//! This module provides a comprehensive chart system for creating professional
//! visual representations of data in PDF documents. It includes support for
//! bar charts, pie charts, line graphs, and other common chart types.
//!
//! # Features
//! - Bar charts (horizontal and vertical)
//! - Pie charts with customizable segments
//! - Progress bars and statistics bars
//! - Line graphs with multiple series
//! - Customizable colors, fonts, and styling
//! - Automatic legends and labels
//! - Professional chart layouts
//!
//! # Example
//! ```rust
//! use oxidize_pdf::charts::{BarChartBuilder, ChartData};
//! use oxidize_pdf::graphics::Color;
//!
//! let data = vec![
//!     ChartData::new("Q1", 25.0),
//!     ChartData::new("Q2", 35.0),
//!     ChartData::new("Q3", 20.0),
//!     ChartData::new("Q4", 45.0),
//! ];
//!
//! let chart = BarChartBuilder::new()
//!     .title("Quarterly Sales")
//!     .data(data)
//!     .colors(vec![Color::blue(), Color::green(), Color::yellow(), Color::red()])
//!     .build();
//! ```

mod bar_chart;
mod chart_builder;
mod chart_renderer;
mod dashboard_integration;
mod line_chart;
mod pie_chart;

pub use bar_chart::{BarChart, BarChartBuilder, BarOrientation};
pub use chart_builder::{Chart, ChartBuilder, ChartData, ChartType, LegendPosition};
pub use chart_renderer::ChartRenderer;
pub use dashboard_integration::{DashboardBarChart, DashboardLineChart, DashboardPieChart};
pub use line_chart::{DataSeries, LineChart, LineChartBuilder};
pub use pie_chart::{PieChart, PieChartBuilder, PieSegment};

use crate::error::PdfError;
use crate::page::Page;

/// Extension trait to add chart capabilities to PDF pages
pub trait ChartExt {
    /// Add a chart to the page at the specified position
    fn add_chart(
        &mut self,
        chart: &Chart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError>;

    /// Add a bar chart with automatic sizing
    fn add_bar_chart(
        &mut self,
        chart: &BarChart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError>;

    /// Add a pie chart with automatic sizing
    fn add_pie_chart(
        &mut self,
        chart: &PieChart,
        x: f64,
        y: f64,
        radius: f64,
    ) -> Result<(), PdfError>;

    /// Add a line chart with automatic sizing
    fn add_line_chart(
        &mut self,
        chart: &LineChart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError>;
}

impl ChartExt for Page {
    fn add_chart(
        &mut self,
        chart: &Chart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError> {
        let renderer = ChartRenderer::with_coordinate_system(self.coordinate_system());
        renderer.render_chart(self, chart, x, y, width, height)
    }

    fn add_bar_chart(
        &mut self,
        chart: &BarChart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError> {
        let renderer = ChartRenderer::with_coordinate_system(self.coordinate_system());
        renderer.render_bar_chart(self, chart, x, y, width, height)
    }

    fn add_pie_chart(
        &mut self,
        chart: &PieChart,
        x: f64,
        y: f64,
        radius: f64,
    ) -> Result<(), PdfError> {
        let renderer = ChartRenderer::with_coordinate_system(self.coordinate_system());
        renderer.render_pie_chart(self, chart, x, y, radius)
    }

    fn add_line_chart(
        &mut self,
        chart: &LineChart,
        x: f64,
        y: f64,
        width: f64,
        height: f64,
    ) -> Result<(), PdfError> {
        let renderer = ChartRenderer::with_coordinate_system(self.coordinate_system());
        renderer.render_line_chart(self, chart, x, y, width, height)
    }
}