pintos-os.org Git - pspp/blob - src/output/cairo-chart.c

   1 /* PSPP - a program for statistical analysis.
   2    Copyright (C) 2004, 2009, 2010, 2011 Free Software Foundation, Inc.
   3
   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.
   8
   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.
  13
  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/>. */
  16
  17 #include <config.h>
  18
  19 #include "output/cairo-chart.h"
  20
  21 #include <assert.h>
  22 #include <cairo/cairo.h>
  23 #include <pango/pango.h>
  24 #include <pango/pangocairo.h>
  25 #include <errno.h>
  26 #include <float.h>
  27 #include <math.h>
  28 #include <stdarg.h>
  29 #include <stdio.h>
  30 #include <stdlib.h>
  31 #include <string.h>
  32
  33 #include "libpspp/assertion.h"
  34 #include "math/chart-geometry.h"
  35 #include "output/cairo.h"
  36 #include "output/chart-item.h"
  37
  38 #include "gl/error.h"
  39 #include "gl/xalloc.h"
  40 #include "gl/xvasprintf.h"
  41
  42 #include "gettext.h"
  43 #define _(msgid) gettext (msgid)
  44
  45 void
  46 xrchart_geometry_init (cairo_t *cr, struct xrchart_geometry *geom,
  47                        double width, double length)
  48 {
  49   /* Set default chart geometry. */
  50   geom->axis[SCALE_ORDINATE].data_max = 0.900 * length;
  51   geom->axis[SCALE_ORDINATE].data_min = 0.120 * length;
  52
  53   geom->axis[SCALE_ABSCISSA].data_min = 0.150 * width;
  54   geom->axis[SCALE_ABSCISSA].data_max = 0.800 * width;
  55   geom->abscissa_bottom = 0.070 * length;
  56   geom->ordinate_left = 0.050 * width;
  57   geom->title_bottom = 0.920 * length;
  58   geom->legend_left = 0.810 * width;
  59   geom->legend_right = width;
  60   geom->font_size = 15.0;
  61   geom->in_path = false;
  62   geom->dataset = NULL;
  63   geom->n_datasets = 0;
  64
  65   geom->fill_colour.red = 255;
  66   geom->fill_colour.green = 0;
  67   geom->fill_colour.blue = 0;
  68
  69   cairo_set_line_width (cr, 1.0);
  70
  71   cairo_rectangle (cr, geom->axis[SCALE_ABSCISSA].data_min, geom->axis[SCALE_ORDINATE].data_min,
  72                    geom->axis[SCALE_ABSCISSA].data_max - geom->axis[SCALE_ABSCISSA].data_min,
  73                    geom->axis[SCALE_ORDINATE].data_max - geom->axis[SCALE_ORDINATE].data_min);
  74   cairo_stroke (cr);
  75 }
  76
  77 void
  78 xrchart_geometry_free (cairo_t *cr UNUSED, struct xrchart_geometry *geom)
  79 {
  80   int i;
  81
  82   for (i = 0 ; i < geom->n_datasets; ++i)
  83     free (geom->dataset[i]);
  84   free (geom->dataset);
  85 }
  86
  87 #if ! PANGO_VERSION_CHECK (1, 22, 0)
  88 int pango_layout_get_baseline (PangoLayout    *layout);
  89
  90 /* Shamelessly copied from the pango source */
  91 int
  92 pango_layout_get_baseline (PangoLayout    *layout)
  93 {
  94   int baseline;
  95
  96   /* XXX this is so inefficient */
  97   PangoLayoutIter *iter = pango_layout_get_iter (layout);
  98   baseline = pango_layout_iter_get_baseline (iter);
  99   pango_layout_iter_free (iter);
 100
 101   return baseline;
 102 }
 103 #endif
 104
 105
 106
 107 const struct xrchart_colour data_colour[XRCHART_N_COLOURS] =
 108   {
 109     { 165, 42, 42 },            /* brown */
 110     { 255, 0, 0 },              /* red */
 111     { 255, 165, 0 },            /* orange */
 112     { 255, 255, 0 },            /* yellow */
 113     { 0, 255, 0 },              /* green */
 114     { 0, 0, 255 },              /* blue */
 115     { 238, 130, 238 },          /* violet */
 116     { 190, 190, 190 },          /* grey */
 117     { 255, 192, 203 },          /* pink */
 118   };
 119
 120 void
 121 xrchart_draw_marker (cairo_t *cr, double x, double y,
 122                      enum xrmarker_type marker, double size)
 123 {
 124   cairo_save (cr);
 125   cairo_translate (cr, x, y);
 126   cairo_scale (cr, size / 2.0, size / 2.0);
 127   cairo_set_line_width (cr, cairo_get_line_width (cr) / (size / 2.0));
 128   switch (marker)
 129     {
 130     case XRMARKER_CIRCLE:
 131       cairo_arc (cr, 0, 0, 1.0, 0, 2 * M_PI);
 132       cairo_stroke (cr);
 133       break;
 134
 135     case XRMARKER_ASTERISK:
 136       cairo_move_to (cr, 0, -1.0); /* | */
 137       cairo_line_to (cr, 0, 1.0);
 138       cairo_move_to (cr, -M_SQRT1_2, -M_SQRT1_2); /* / */
 139       cairo_line_to (cr, M_SQRT1_2, M_SQRT1_2);
 140       cairo_move_to (cr, -M_SQRT1_2, M_SQRT1_2); /* \ */
 141       cairo_line_to (cr, M_SQRT1_2, -M_SQRT1_2);
 142       cairo_stroke (cr);
 143       break;
 144
 145     case XRMARKER_SQUARE:
 146       cairo_rectangle (cr, -1.0, -1.0, 2.0, 2.0);
 147       cairo_stroke (cr);
 148       break;
 149     }
 150   cairo_restore (cr);
 151 }
 152
 153 void
 154 xrchart_label (cairo_t *cr, int horz_justify, int vert_justify,
 155                double font_size, const char *string)
 156 {
 157   PangoFontDescription *desc;
 158   PangoLayout *layout;
 159   double x, y;
 160
 161   desc = pango_font_description_from_string ("sans serif");
 162   if (desc == NULL)
 163     {
 164       cairo_new_path (cr);
 165       return;
 166     }
 167   pango_font_description_set_absolute_size (desc, font_size * PANGO_SCALE);
 168
 169   cairo_save (cr);
 170   cairo_get_current_point (cr, &x, &y);
 171   cairo_translate (cr, x, y);
 172   cairo_move_to (cr, 0, 0);
 173   cairo_scale (cr, 1.0, -1.0);
 174
 175   layout = pango_cairo_create_layout (cr);
 176   pango_layout_set_font_description (layout, desc);
 177   pango_layout_set_text (layout, string, -1);
 178   if (horz_justify != 'l')
 179     {
 180       int width_pango;
 181       double width;
 182
 183       pango_layout_get_size (layout, &width_pango, NULL);
 184       width = (double) width_pango / PANGO_SCALE;
 185       if (horz_justify == 'r')
 186         cairo_rel_move_to (cr, -width, 0);
 187       else
 188         cairo_rel_move_to (cr, -width / 2.0, 0);
 189     }
 190   if (vert_justify == 'x')
 191     {
 192       int baseline_pango = pango_layout_get_baseline (layout);
 193       double baseline = (double) baseline_pango / PANGO_SCALE;
 194       cairo_rel_move_to (cr, 0, -baseline);
 195     }
 196   else if (vert_justify != 't')
 197     {
 198       int height_pango;
 199       double height;
 200
 201       pango_layout_get_size (layout, NULL, &height_pango);
 202       height = (double) height_pango / PANGO_SCALE;
 203       if (vert_justify == 'b')
 204         cairo_rel_move_to (cr, 0, -height);
 205       else if (vert_justify == 'c')
 206         cairo_rel_move_to (cr, 0, -height / 2.0);
 207     }
 208   pango_cairo_show_layout (cr, layout);
 209   g_object_unref (layout);
 210
 211   cairo_restore (cr);
 212
 213   cairo_new_path (cr);
 214
 215   pango_font_description_free (desc);
 216 }
 217
 218 /* Draw a tick mark at position
 219    If label is non null, then print it at the tick mark
 220 */
 221 static void
 222 draw_tick_internal (cairo_t *cr, const struct xrchart_geometry *geom,
 223                     enum tick_orientation orientation,
 224                     double position,
 225                     const char *s);
 226
 227 void
 228 draw_tick (cairo_t *cr, const struct xrchart_geometry *geom,
 229            enum tick_orientation orientation,
 230            double position,
 231            const char *label, ...)
 232 {
 233   va_list ap;
 234   char *s;
 235   va_start (ap, label);
 236   s = xvasprintf (label, ap);
 237
 238   if (fabs (position) < DBL_EPSILON)
 239     position = 0;
 240
 241   draw_tick_internal (cr, geom, orientation, position, s);
 242   free (s);
 243   va_end (ap);
 244 }
 245
 246
 247 static void
 248 draw_tick_internal (cairo_t *cr, const struct xrchart_geometry *geom,
 249                     enum tick_orientation orientation,
 250                     double position,
 251                     const char *s)
 252 {
 253   const int tickSize = 10;
 254   double x, y;
 255
 256   cairo_move_to (cr, geom->axis[SCALE_ABSCISSA].data_min, geom->axis[SCALE_ORDINATE].data_min);
 257
 258   if (orientation == SCALE_ABSCISSA)
 259     {
 260       cairo_rel_move_to (cr, position, 0);
 261       cairo_rel_line_to (cr, 0, -tickSize);
 262     }
 263   else if (orientation == SCALE_ORDINATE)
 264     {
 265       cairo_rel_move_to (cr, 0, position);
 266       cairo_rel_line_to (cr, -tickSize, 0);
 267     }
 268   else
 269     NOT_REACHED ();
 270   cairo_get_current_point (cr, &x, &y);
 271
 272   cairo_stroke (cr);
 273
 274   if (s != NULL)
 275     {
 276       cairo_move_to (cr, x, y);
 277
 278       if (orientation == SCALE_ABSCISSA)
 279         xrchart_label (cr, 'c', 't', geom->font_size, s);
 280       else if (orientation == SCALE_ORDINATE)
 281         {
 282           if (fabs (position) < DBL_EPSILON)
 283             cairo_rel_move_to (cr, 0, 10);
 284           xrchart_label (cr, 'r', 'c', geom->font_size, s);
 285         }
 286     }
 287 }
 288
 289
 290 /* Write the title on a chart*/
 291 void
 292 xrchart_write_title (cairo_t *cr, const struct xrchart_geometry *geom,
 293                    const char *title, ...)
 294 {
 295   va_list ap;
 296   char *s;
 297
 298   cairo_save (cr);
 299   cairo_move_to (cr, geom->axis[SCALE_ABSCISSA].data_min, geom->title_bottom);
 300
 301   va_start(ap, title);
 302   s = xvasprintf (title, ap);
 303   xrchart_label (cr, 'l', 'x', geom->font_size * 1.5, s);
 304   free (s);
 305   va_end (ap);
 306
 307   cairo_restore (cr);
 308 }
 309
 310
 311
 312 static void
 313 xrchart_write_scale (cairo_t *cr, struct xrchart_geometry *geom,
 314                      double smin, double smax, int ticks, enum tick_orientation orient)
 315 {
 316   int s;
 317
 318   const double tick_interval =
 319     chart_rounded_tick ((smax - smin) / (double) ticks);
 320
 321   int upper = ceil (smax / tick_interval);
 322   int lower = floor (smin / tick_interval);
 323
 324   geom->axis[orient].max = tick_interval * upper;
 325   geom->axis[orient].min = tick_interval * lower;
 326
 327   geom->axis[orient].scale = (fabs (geom->axis[orient].data_max - geom->axis[orient].data_min)
 328      / fabs (geom->axis[orient].max - geom->axis[orient].min));
 329
 330   for (s = 0 ; s < upper - lower; ++s)
 331     {
 332       double pos = (s + lower) * tick_interval;
 333       draw_tick (cr, geom, orient,
 334                  s * tick_interval * geom->axis[orient].scale, "%g", pos);
 335     }
 336 }
 337
 338 /* Set the scale for the ordinate */
 339 void
 340 xrchart_write_yscale (cairo_t *cr, struct xrchart_geometry *geom,
 341                     double smin, double smax, int ticks)
 342 {
 343   xrchart_write_scale (cr, geom, smin, smax, ticks, SCALE_ORDINATE);
 344 }
 345
 346 /* Set the scale for the abscissa */
 347 void
 348 xrchart_write_xscale (cairo_t *cr, struct xrchart_geometry *geom,
 349                     double smin, double smax, int ticks)
 350 {
 351   xrchart_write_scale (cr, geom, smin, smax, ticks, SCALE_ABSCISSA);
 352 }
 353
 354
 355 /* Write the abscissa label */
 356 void
 357 xrchart_write_xlabel (cairo_t *cr, const struct xrchart_geometry *geom,
 358                     const char *label)
 359 {
 360   cairo_move_to (cr, geom->axis[SCALE_ABSCISSA].data_min, geom->abscissa_bottom);
 361   xrchart_label (cr, 'l', 't', geom->font_size, label);
 362 }
 363
 364 /* Write the ordinate label */
 365 void
 366 xrchart_write_ylabel (cairo_t *cr, const struct xrchart_geometry *geom,
 367                     const char *label)
 368 {
 369   cairo_save (cr);
 370   cairo_translate (cr, geom->ordinate_left,   geom->axis[SCALE_ORDINATE].data_min);
 371   cairo_rotate (cr, M_PI / 2.0);
 372
 373   xrchart_label (cr, 'l', 'x', geom->font_size, label);
 374   cairo_restore (cr);
 375 }
 376
 377
 378 void
 379 xrchart_write_legend (cairo_t *cr, const struct xrchart_geometry *geom)
 380 {
 381   int i;
 382   const int vstep = geom->font_size * 2;
 383   const int xpad = 10;
 384   const int ypad = 10;
 385   const int swatch = 20;
 386   const int legend_top = geom->axis[SCALE_ORDINATE].data_max;
 387   const int legend_bottom = legend_top -
 388     (vstep * geom->n_datasets + 2 * ypad );
 389
 390   cairo_save (cr);
 391
 392   cairo_rectangle (cr, geom->legend_left, legend_top,
 393                    geom->legend_right - xpad - geom->legend_left,
 394                    legend_bottom - legend_top);
 395   cairo_stroke (cr);
 396
 397   for (i = 0 ; i < geom->n_datasets ; ++i )
 398     {
 399       const int ypos = legend_top - vstep * (i + 1);
 400       const int xpos = geom->legend_left + xpad;
 401       const struct xrchart_colour *colour;
 402
 403       cairo_move_to (cr, xpos, ypos);
 404
 405       cairo_save (cr);
 406       colour = &data_colour [ i % XRCHART_N_COLOURS];
 407       cairo_set_source_rgb (cr,
 408                             colour->red / 255.0,
 409                             colour->green / 255.0,
 410                             colour->blue / 255.0);
 411       cairo_rectangle (cr, xpos, ypos, swatch, swatch);
 412       cairo_fill_preserve (cr);
 413       cairo_stroke (cr);
 414       cairo_restore (cr);
 415
 416       cairo_move_to (cr, xpos + swatch * 1.5, ypos);
 417       xrchart_label (cr, 'l', 'x', geom->font_size, geom->dataset[i]);
 418     }
 419
 420   cairo_restore (cr);
 421 }
 422
 423 /* Start a new vector called NAME */
 424 void
 425 xrchart_vector_start (cairo_t *cr, struct xrchart_geometry *geom, const char *name)
 426 {
 427   const struct xrchart_colour *colour;
 428
 429   cairo_save (cr);
 430
 431   colour = &data_colour[geom->n_datasets % XRCHART_N_COLOURS];
 432   cairo_set_source_rgb (cr,
 433                         colour->red / 255.0,
 434                         colour->green / 255.0,
 435                         colour->blue / 255.0);
 436
 437   geom->n_datasets++;
 438   geom->dataset = xrealloc (geom->dataset,
 439                             geom->n_datasets * sizeof (*geom->dataset));
 440
 441   geom->dataset[geom->n_datasets - 1] = strdup (name);
 442 }
 443
 444 /* Plot a data point */
 445 void
 446 xrchart_datum (cairo_t *cr, const struct xrchart_geometry *geom,
 447              int dataset UNUSED, double x, double y)
 448 {
 449   double x_pos = (x - geom->axis[SCALE_ABSCISSA].min) * geom->axis[SCALE_ABSCISSA].scale + geom->axis[SCALE_ABSCISSA].data_min;
 450   double y_pos = (y - geom->axis[SCALE_ORDINATE].min) * geom->axis[SCALE_ORDINATE].scale + geom->axis[SCALE_ORDINATE].data_min;
 451
 452   xrchart_draw_marker (cr, x_pos, y_pos, XRMARKER_SQUARE, 15);
 453 }
 454
 455 void
 456 xrchart_vector_end (cairo_t *cr, struct xrchart_geometry *geom)
 457 {
 458   cairo_stroke (cr);
 459   cairo_restore (cr);
 460   geom->in_path = false;
 461 }
 462
 463 /* Plot a data point */
 464 void
 465 xrchart_vector (cairo_t *cr, struct xrchart_geometry *geom, double x, double y)
 466 {
 467   const double x_pos =
 468     (x - geom->axis[SCALE_ABSCISSA].min) * geom->axis[SCALE_ABSCISSA].scale + geom->axis[SCALE_ABSCISSA].data_min ;
 469
 470   const double y_pos =
 471     (y - geom->axis[SCALE_ORDINATE].min) * geom->axis[SCALE_ORDINATE].scale + geom->axis[SCALE_ORDINATE].data_min ;
 472
 473   if (geom->in_path)
 474     cairo_line_to (cr, x_pos, y_pos);
 475   else
 476     {
 477       cairo_move_to (cr, x_pos, y_pos);
 478       geom->in_path = true;
 479     }
 480 }
 481
 482
 483
 484 /* Draw a line with slope SLOPE and intercept INTERCEPT.
 485    between the points limit1 and limit2.
 486    If lim_dim is XRCHART_DIM_Y then the limit{1,2} are on the
 487    y axis otherwise the x axis
 488 */
 489 void
 490 xrchart_line(cairo_t *cr, const struct xrchart_geometry *geom,
 491            double slope, double intercept,
 492            double limit1, double limit2, enum xrchart_dim lim_dim)
 493 {
 494   double x1, y1;
 495   double x2, y2;
 496
 497   if ( lim_dim == XRCHART_DIM_Y )
 498     {
 499       x1 = ( limit1 - intercept ) / slope;
 500       x2 = ( limit2 - intercept ) / slope;
 501       y1 = limit1;
 502       y2 = limit2;
 503     }
 504   else
 505     {
 506       x1 = limit1;
 507       x2 = limit2;
 508       y1 = slope * x1 + intercept;
 509       y2 = slope * x2 + intercept;
 510     }
 511
 512   y1 = (y1 - geom->axis[SCALE_ORDINATE].min) * geom->axis[SCALE_ORDINATE].scale + geom->axis[SCALE_ORDINATE].data_min;
 513   y2 = (y2 - geom->axis[SCALE_ORDINATE].min) * geom->axis[SCALE_ORDINATE].scale + geom->axis[SCALE_ORDINATE].data_min;
 514   x1 = (x1 - geom->axis[SCALE_ABSCISSA].min) * geom->axis[SCALE_ABSCISSA].scale + geom->axis[SCALE_ABSCISSA].data_min;
 515   x2 = (x2 - geom->axis[SCALE_ABSCISSA].min) * geom->axis[SCALE_ABSCISSA].scale + geom->axis[SCALE_ABSCISSA].data_min;
 516
 517   cairo_move_to (cr, x1, y1);
 518   cairo_line_to (cr, x2, y2);
 519   cairo_stroke (cr);
 520 }