* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
*/
+#define _ISOC99_SOURCE /* for round() */
+#define _XOPEN_SOURCE 500
+
#include "acre.h"
#include "xmalloc.h"
unsigned int num_points;
};
+typedef struct _acre_axis {
+ char *label;
+ double min;
+ double max;
+} acre_axis_t;
+
struct _acre {
char *title;
- char *x_axis_label;
- char *y_axis_label;
+ acre_axis_t x_axis;
+ acre_axis_t y_axis;
acre_data_t **data;
unsigned int data_size;
unsigned int num_data;
+
+ /* Data for drawing. */
+ cairo_t *cr;
+
+ /* Total size including labels. */
+ int width;
+ int height;
+
+ /* Position and size of chart alone. */
+ PangoRectangle chart;
};
/* Create a new, empty plot. */
acre = xmalloc (sizeof (acre_t));
acre->title = NULL;
- acre->x_axis_label = NULL;
- acre->y_axis_label = NULL;
+
+ acre->x_axis.label = NULL;
+ acre->x_axis.min = 0.0;
+ acre->x_axis.max = 0.0;
+
+ acre->y_axis.label = NULL;
+ acre->y_axis.min = 0.0;
+ acre->y_axis.max = 0.0;
acre->data = NULL;
acre->data_size = 0;
unsigned int i;
free (acre->title);
- free (acre->x_axis_label);
- free (acre->y_axis_label);
+ free (acre->x_axis.label);
+ free (acre->y_axis.label);
for (i = 0; i < acre->num_data; i++)
acre_data_destroy (acre->data[i]);
void
acre_set_x_axis_label (acre_t *acre, const char *label)
{
- free (acre->x_axis_label);
+ free (acre->x_axis.label);
- acre->x_axis_label = strdup (label);
+ acre->x_axis.label = strdup (label);
}
void
acre_set_y_axis_label (acre_t *acre, const char *label)
{
- free (acre->y_axis_label);
+ free (acre->y_axis.label);
- acre->y_axis_label = strdup (label);
+ acre->y_axis.label = strdup (label);
}
/* Add a dataset to the plot. The plot assumes ownership of the
#define ACRE_FONT_SIZE 12
#define ACRE_TITLE_FONT_SIZE 32
#define ACRE_PAD (ACRE_FONT_SIZE)
-#define ACRE_TICK_SIZE 4
+#define ACRE_TICK_SIZE 6
-/* Draw the plot to the given cairo context within a user-space
- * rectangle from (0, 0) to (width, height). This size includes all
- * space for extra-plot elements (such as the title, the axis labels,
- * etc.)
- */
-void
-acre_draw (acre_t *acre, cairo_t *cr, double width, double height)
+static void
+_draw_title_and_labels (acre_t *acre)
{
+ cairo_t *cr = acre->cr;
PangoFontDescription *acre_font, *title_font;
PangoLayout *title_layout, *x_axis_layout, *y_axis_layout;
int title_width, title_height;
int x_axis_width, x_axis_height;
int y_axis_width, y_axis_height;
- PangoRectangle chart, new_chart;
+ PangoRectangle new_chart;
cairo_save (cr);
- cairo_set_source_rgb (cr, 1, 1, 1);
-
- cairo_paint (cr);
-
acre_font = pango_font_description_new ();
pango_font_description_set_family (acre_font, ACRE_FONT_FAMILY);
pango_font_description_set_absolute_size (acre_font,
x_axis_layout = pango_cairo_create_layout (cr);
pango_layout_set_font_description (x_axis_layout, acre_font);
- pango_layout_set_text (x_axis_layout, acre->x_axis_label, -1);
+ pango_layout_set_text (x_axis_layout, acre->x_axis.label, -1);
pango_layout_set_alignment (x_axis_layout, PANGO_ALIGN_CENTER);
y_axis_layout = pango_cairo_create_layout (cr);
pango_layout_set_font_description (y_axis_layout, acre_font);
- pango_layout_set_text (y_axis_layout, acre->y_axis_label, -1);
+ pango_layout_set_text (y_axis_layout, acre->y_axis.label, -1);
pango_layout_set_alignment (y_axis_layout, PANGO_ALIGN_CENTER);
/* Iterate with the layout of the title and axis labels until they
* are stable, (this requires iteration since we don't know what
* to set their widths to in advance due to the wrapping of the
* other elements). */
- chart.x = 0;
- chart.y = 0;
- chart.width = width;
- chart.height = height;
+ acre->chart.x = 0;
+ acre->chart.y = 0;
+ acre->chart.width = acre->width;
+ acre->chart.height = acre->height;
while (1) {
- pango_layout_set_width (title_layout, chart.width * PANGO_SCALE);
- pango_layout_set_width (x_axis_layout, chart.width * PANGO_SCALE);
- pango_layout_set_width (y_axis_layout, chart.height * PANGO_SCALE);
+ pango_layout_set_width (title_layout, acre->chart.width * PANGO_SCALE);
+ pango_layout_set_width (x_axis_layout, acre->chart.width * PANGO_SCALE);
+ pango_layout_set_width (y_axis_layout, acre->chart.height * PANGO_SCALE);
pango_layout_get_pixel_size (title_layout, &title_width, &title_height);
pango_layout_get_pixel_size (x_axis_layout, &x_axis_width, &x_axis_height);
new_chart.x = ACRE_PAD + y_axis_height +
ACRE_PAD + ACRE_FONT_SIZE;
- new_chart.width = width - chart.x - ACRE_PAD;
+ new_chart.width = acre->width - acre->chart.x - ACRE_PAD;
new_chart.y = ACRE_PAD + title_height + ACRE_PAD;
- new_chart.height = height - chart.y - (ACRE_FONT_SIZE + ACRE_PAD + x_axis_height + ACRE_PAD);
+ new_chart.height = acre->height - acre->chart.y - (ACRE_FONT_SIZE + ACRE_PAD + x_axis_height + ACRE_PAD);
- if (new_chart.x == chart.x &&
- new_chart.y == chart.y &&
- new_chart.width == chart.width &&
- new_chart.height == chart.height)
+ if (new_chart.x == acre->chart.x &&
+ new_chart.y == acre->chart.y &&
+ new_chart.width == acre->chart.width &&
+ new_chart.height == acre->chart.height)
{
break;
}
- chart.x = new_chart.x;
- chart.y = new_chart.y;
- chart.width = new_chart.width;
- chart.height = new_chart.height;
+ acre->chart.x = new_chart.x;
+ acre->chart.y = new_chart.y;
+ acre->chart.width = new_chart.width;
+ acre->chart.height = new_chart.height;
}
cairo_set_source_rgb (cr, 0, 0, 0);
- cairo_move_to (cr, chart.x, ACRE_PAD);
+ cairo_move_to (cr, acre->chart.x, ACRE_PAD);
pango_cairo_show_layout (cr, title_layout);
cairo_save (cr);
{
- cairo_translate (cr, ACRE_PAD, chart.y + chart.height);
+ cairo_translate (cr, ACRE_PAD, acre->chart.y + acre->chart.height);
cairo_rotate (cr, - M_PI / 2.0);
cairo_move_to (cr, 0, 0);
pango_cairo_show_layout (cr, y_axis_layout);
}
cairo_restore (cr);
- cairo_move_to (cr, chart.x,
- chart.y + chart.height + ACRE_FONT_SIZE + ACRE_PAD);
+ cairo_move_to (cr, acre->chart.x,
+ acre->chart.y + acre->chart.height +
+ ACRE_FONT_SIZE + ACRE_PAD);
pango_cairo_show_layout (cr, x_axis_layout);
+ cairo_restore (cr);
+}
+
+/* For a given axis range, compute a step size (in data space) to
+ * generate a suitable number of ticks (5 or so). */
+static double
+_step_for_range (double range)
+{
+ double step, scale_factor;
+
+ /* We want roughly 5 major ticks for the chart. */
+ step = range / 5;
+
+ /* Normalize the step so we can easily snap it to a desirable
+ * value. */
+ scale_factor = pow (10.0, floor (log10 (step)));
+ step /= scale_factor;
+
+ /* We want increments of 1, 2.5, 5, or 10 (times some power of
+ * 10). The threshold values between these are computed
+ * logarithmically. */
+ if (step < 3.535533905932738) {
+ if (step < 1.58113883008419)
+ step = 1.0;
+ else
+ step = 2.5;
+ } else {
+ if (step < 7.071067811865475)
+ step = 5.0;
+ else
+ step = 10.0;
+ }
+
+ /* Un-normalize and we now have the data value that we want to
+ * step at. */
+ return step * scale_factor;
+}
+
+/* Given an axis range, we can compute a desired data-space step
+ * amount for the major ticks (see _step_for_range). To get
+ * nice-looking pixel-snapped ticks we want to expand the range
+ * slightly. */
+static void
+_expand_range_for_width (double *axis_min, double *axis_max, int pixel_size)
+{
+ double range, new_range, step, pixel_step;
+
+ range = *axis_max - *axis_min;
+
+ step = _step_for_range (range);
+ pixel_step = step * pixel_size / range;
+
+ /* We expand the range by the ratio of the pixel step to the floor
+ * of the pixel_step.
+ */
+ new_range = range * pixel_step / floor (pixel_step);
+
+ /* And spread the increase out on either side of the range. */
+ *axis_min -= (new_range - range) / 2.0;
+ *axis_max += (new_range - range) / 2.0;
+}
+
+/* Setup a transformation in acre->cr such that data values plotted
+ * will appear where they should within the chart.
+ */
+static void
+_set_transform_to_data_space (acre_t *acre)
+{
+ cairo_t *cr = acre->cr;
+
+ cairo_translate (cr,
+ acre->chart.x,
+ acre->chart.y + acre->chart.height);
+ cairo_scale (cr,
+ acre->chart.width / (acre->x_axis.max - acre->x_axis.min),
+ - acre->chart.height /(acre->y_axis.max - acre->y_axis.min));
+ cairo_translate (cr, -acre->x_axis.min, -acre->y_axis.min);
+}
+
+static void
+_compute_axis_ranges (acre_t *acre)
+{
+ unsigned int d, i;
+ acre_data_t *data;
+ double x_adjust, y_adjust;
+ cairo_t *cr = acre->cr;
+
+ /* First, simply find the extrema of the data. */
+ for (d = 0; d < acre->num_data; d++) {
+ data = acre->data[d];
+ for (i = 0; i < data->num_points; i++) {
+ if (data->points[i].x < acre->x_axis.min)
+ acre->x_axis.min = data->points[i].x;
+ if (data->points[i].x > acre->x_axis.max)
+ acre->x_axis.max = data->points[i].x;
+
+ if (data->points[i].y < acre->y_axis.min)
+ acre->y_axis.min = data->points[i].y;
+ if (data->points[i].y > acre->y_axis.max)
+ acre->y_axis.max = data->points[i].y;
+ }
+ }
+
+ /* Next, increase the axis ranges just enough so that the step
+ * sizes for the ticks will be integers.
+ */
+ _expand_range_for_width (&acre->x_axis.min,
+ &acre->x_axis.max,
+ acre->chart.width);
+
+ _expand_range_for_width (&acre->y_axis.min,
+ &acre->y_axis.max,
+ acre->chart.height);
+
+ /* Finally, we also translate the axis ranges slightly so that the
+ * ticks land on half-integer device-pixel positions.
+ */
+ cairo_save (cr);
+ {
+ _set_transform_to_data_space (acre);
+
+ x_adjust = 0.0;
+ y_adjust = 0.0;
+ cairo_user_to_device (cr, &x_adjust, &y_adjust);
+ x_adjust = (round (x_adjust + 0.5) - 0.5) - x_adjust;
+ y_adjust = (round (y_adjust + 0.5) - 0.5) - y_adjust;
+ cairo_device_to_user_distance (cr, &x_adjust, &y_adjust);
+
+ acre->x_axis.min -= x_adjust;
+ acre->x_axis.max -= x_adjust;
+
+ acre->y_axis.min -= y_adjust;
+ acre->y_axis.max -= y_adjust;
+ }
+ cairo_restore (cr);
+}
+
+static void
+_draw_data (acre_t *acre)
+{
+ cairo_t *cr = acre->cr;
+ unsigned int d, i;
+ acre_data_t *data;
+
+ cairo_save (cr);
+
+ cairo_set_source_rgb (cr, 0, 0, 0);
+
+ _set_transform_to_data_space (acre);
+
+ for (d = 0; d < acre->num_data; d++) {
+ data = acre->data[d];
+ cairo_new_path (cr);
+ for (i = 0; i < data->num_points; i++) {
+ cairo_line_to (cr,
+ data->points[i].x,
+ data->points[i].y);
+ }
+ cairo_save (cr);
+ {
+ cairo_identity_matrix (cr);
+ cairo_set_line_width (cr, 1.0);
+ cairo_stroke (cr);
+ }
+ cairo_restore (cr);
+ }
+
+ cairo_restore (cr);
+}
+
+static void
+_draw_frame_and_ticks (acre_t *acre)
+{
+ cairo_t *cr = acre->cr;
+ double step, x, y;
+
+ cairo_save (cr);
+
+ cairo_set_source_rgb (cr, 0, 0, 0); /* black */
+
+ /* First the ticks within data space. */
+ cairo_save (cr);
+ {
+ _set_transform_to_data_space (acre);
+
+ step = _step_for_range (acre->x_axis.max -acre->x_axis.min);
+ x = (floor (acre->x_axis.min / step) + 1) * step;
+ while (x <= acre->x_axis.max) {
+ cairo_move_to (cr, x, acre->y_axis.min);
+ cairo_save (cr);
+ {
+ cairo_identity_matrix (cr);
+ cairo_rel_line_to (cr, 0, 0.5);
+ cairo_rel_line_to (cr, 0, -ACRE_TICK_SIZE-0.5);
+ cairo_set_line_width (cr, 1.0);
+ cairo_stroke (cr);
+ }
+ cairo_restore (cr);
+ x += step;
+ }
+
+ step = _step_for_range (acre->y_axis.max -acre->y_axis.min);
+ y = (floor (acre->y_axis.min / step) + 1) * step;
+ while (y <= acre->y_axis.max) {
+ cairo_move_to (cr, acre->x_axis.min, y);
+ cairo_save (cr);
+ {
+ cairo_identity_matrix (cr);
+ cairo_rel_line_to (cr, -0.5, 0);
+ cairo_rel_line_to (cr, ACRE_TICK_SIZE+0.5, 0);
+ cairo_set_line_width (cr, 1.0);
+ cairo_stroke (cr);
+ }
+ cairo_restore (cr);
+ y += step;
+ }
+ }
+ cairo_restore (cr);
+
+ /* Then the frame drawn in pixel space. */
cairo_rectangle (cr,
- chart.x - 0.5, chart.y - 0.5,
- chart.width + 1.0, chart.height + 1.0);
+ acre->chart.x - 0.5, acre->chart.y - 0.5,
+ acre->chart.width + 1.0, acre->chart.height + 1.0);
cairo_set_line_width (cr, 1.0);
cairo_stroke (cr);
+
+ cairo_restore (cr);
+}
+
+/* Draw the plot to the given cairo context within a user-space
+ * rectangle from (0, 0) to (width, height). This size includes all
+ * space for extra-plot elements (such as the title, the axis labels,
+ * etc.)
+ */
+void
+acre_draw (acre_t *acre, cairo_t *cr, int width, int height)
+{
+ acre->cr = cr;
+ acre->width = width;
+ acre->height = height;
+
+ cairo_save (cr);
+
+ cairo_set_source_rgb (cr, 1, 1, 1);
+
+ cairo_paint (cr);
+
+ _draw_title_and_labels (acre);
+
+ _compute_axis_ranges (acre);
+
+ _draw_data (acre);
+
+ _draw_frame_and_ticks (acre);
}
/* Create a new dataset---a collection of (x, y) datapoints. A single