1 /* PSPP - a program for statistical analysis.
2 Copyright (C) 2009, 2011 Free Software Foundation, Inc.
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
17 #ifndef OUTPUT_CAIRO_CHART_H
18 #define OUTPUT_CAIRO_CHART_H 1
20 #include <cairo/cairo.h>
23 #include "libpspp/compiler.h"
44 /* The geometry of a chart. */
45 struct xrchart_geometry
58 /* Default font size for the plot. */
61 struct xrchart_colour fill_colour;
63 /* Stuff particular to cartesians and boxplots. */
64 struct xrchart_axis axis[2];
66 /* True iff a path is currently being drawn */
70 void xrchart_geometry_init (cairo_t *, struct xrchart_geometry *,
71 double width, double length);
72 void xrchart_geometry_free (cairo_t *, struct xrchart_geometry *);
74 #define XRCHART_N_COLOURS 9
75 extern const struct xrchart_colour data_colour[];
85 XRMARKER_CIRCLE, /* Hollow circle. */
86 XRMARKER_ASTERISK, /* Asterisk (*). */
87 XRMARKER_SQUARE /* Hollow square. */
90 void xrchart_draw_marker (cairo_t *, double x, double y, enum xrmarker_type,
93 void xrchart_label (cairo_t *, int horz_justify, int vert_justify,
94 double font_size, const char *);
96 /* Draw a tick mark at position
97 If label is non zero, then print it at the tick mark
99 void draw_tick (cairo_t *, const struct xrchart_geometry *,
100 enum tick_orientation orientation, double position,
101 const char *label, ...)
102 PRINTF_FORMAT (5, 6);
105 /* Write the title on a chart*/
106 void xrchart_write_title (cairo_t *, const struct xrchart_geometry *,
107 const char *title, ...)
108 PRINTF_FORMAT (3, 4);
110 /* Set the scale for the abscissa */
111 void xrchart_write_xscale (cairo_t *, struct xrchart_geometry *,
112 double min, double max, int ticks);
115 /* Set the scale for the ordinate */
116 void xrchart_write_yscale (cairo_t *, struct xrchart_geometry *,
117 double smin, double smax, int ticks);
119 void xrchart_write_xlabel (cairo_t *, const struct xrchart_geometry *,
122 /* Write the ordinate label */
123 void xrchart_write_ylabel (cairo_t *, const struct xrchart_geometry *,
126 void xrchart_write_legend (cairo_t *, const struct xrchart_geometry *);
134 void xrchart_vector_start (cairo_t *, struct xrchart_geometry *,
136 void xrchart_vector_end (cairo_t *, struct xrchart_geometry *);
137 void xrchart_vector (cairo_t *, struct xrchart_geometry *, double x, double y);
139 /* Plot a data point */
140 void xrchart_datum (cairo_t *, const struct xrchart_geometry *,
141 int dataset UNUSED, double x, double y);
143 /* Draw a line with slope SLOPE and intercept INTERCEPT.
144 between the points limit1 and limit2.
145 If lim_dim is XRCHART_DIM_Y then the limit{1,2} are on the
146 y axis otherwise the x axis
148 void xrchart_line (cairo_t *, const struct xrchart_geometry *,
149 double slope, double intercept,
150 double limit1, double limit2, enum xrchart_dim lim_dim);
152 /* Drawing various kinds of charts. */
153 void xrchart_draw_boxplot (const struct chart_item *, cairo_t *,
154 struct xrchart_geometry *);
155 void xrchart_draw_roc (const struct chart_item *, cairo_t *,
156 struct xrchart_geometry *);
157 void xrchart_draw_piechart (const struct chart_item *, cairo_t *,
158 struct xrchart_geometry *);
159 void xrchart_draw_histogram (const struct chart_item *, cairo_t *,
160 struct xrchart_geometry *);
161 void xrchart_draw_np_plot (const struct chart_item *, cairo_t *,
162 struct xrchart_geometry *);
163 void xrchart_draw_scree (const struct chart_item *, cairo_t *,
164 struct xrchart_geometry *);
166 #endif /* output/cairo-chart.h */