adg/adg-dim.c

   1 /* ADG - Automatic Drawing Generation
   2  * Copyright (C) 2007,2008,2009 Nicola Fontana <ntd at entidi.it>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library 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 GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17  * Boston, MA  02110-1301, USA.
  18  */
  19
  20
  21 /**
  22  * SECTION:adg-dim
  23  * @short_description: Root abstract class for all dimension entities
  24  *
  25  * The #AdgDim class is the base stub of all the dimension entities.
  26  **/
  27
  28 /**
  29  * AdgDim:
  30  *
  31  * All fields are private and should not be used directly.
  32  * Use its public methods instead.
  33  **/
  34
  35
  36 #include "adg-dim.h"
  37 #include "adg-dim-private.h"
  38 #include "adg-dim-style.h"
  39 #include "adg-dress-builtins.h"
  40 #include "adg-toy-text.h"
  41 #include "adg-type-builtins.h"
  42 #include "adg-intl.h"
  43
  44 #define PARENT_OBJECT_CLASS  ((GObjectClass *) adg_dim_parent_class)
  45 #define PARENT_ENTITY_CLASS  ((AdgEntityClass *) adg_dim_parent_class)
  46
  47
  48 enum {
  49     PROP_0,
  50     PROP_DIM_DRESS,
  51     PROP_REF1,
  52     PROP_REF2,
  53     PROP_POS,
  54     PROP_LEVEL,
  55     PROP_OUTSIDE,
  56     PROP_CENTERED,
  57     PROP_VALUE,
  58     PROP_MIN,
  59     PROP_MAX
  60 };
  61
  62
  63 static void     dispose                 (GObject        *object);
  64 static void     finalize                (GObject        *object);
  65 static void     get_property            (GObject        *object,
  66                                          guint           param_id,
  67                                          GValue         *value,
  68                                          GParamSpec     *pspec);
  69 static void     set_property            (GObject        *object,
  70                                          guint           param_id,
  71                                          const GValue   *value,
  72                                          GParamSpec     *pspec);
  73 static void     global_changed          (AdgEntity      *entity);
  74 static void     local_changed           (AdgEntity      *entity);
  75 static void     invalidate              (AdgEntity      *entity);
  76 static void     arrange                 (AdgEntity      *entity);
  77 static gchar *  default_value           (AdgDim         *dim);
  78 static gdouble  quote_angle             (gdouble         angle);
  79 static gboolean set_dim_dress           (AdgDim         *dim,
  80                                          AdgDress        dress);
  81 static gboolean set_value               (AdgDim         *dim,
  82                                          const gchar    *value);
  83 static gboolean set_min                 (AdgDim         *dim,
  84                                          const gchar    *min);
  85 static gboolean set_max                 (AdgDim         *dim,
  86                                          const gchar    *max);
  87
  88
  89 G_DEFINE_ABSTRACT_TYPE(AdgDim, adg_dim, ADG_TYPE_ENTITY);
  90
  91
  92 static void
  93 adg_dim_class_init(AdgDimClass *klass)
  94 {
  95     GObjectClass *gobject_class;
  96     AdgEntityClass *entity_class;
  97     GParamSpec *param;
  98
  99     gobject_class = (GObjectClass *) klass;
 100     entity_class = (AdgEntityClass *) klass;
 101
 102     g_type_class_add_private(klass, sizeof(AdgDimPrivate));
 103
 104     gobject_class->dispose = dispose;
 105     gobject_class->finalize = finalize;
 106     gobject_class->get_property = get_property;
 107     gobject_class->set_property = set_property;
 108
 109     entity_class->global_changed = global_changed;
 110     entity_class->local_changed = local_changed;
 111     entity_class->invalidate = invalidate;
 112     entity_class->arrange = arrange;
 113
 114     klass->quote_angle = quote_angle;
 115     klass->default_value = default_value;
 116
 117     param = adg_param_spec_dress("dim-dress",
 118                                  P_("Dimension Dress"),
 119                                  P_("The dress to use for rendering this dimension"),
 120                                  ADG_DRESS_DIMENSION,
 121                                  G_PARAM_READWRITE);
 122     g_object_class_install_property(gobject_class, PROP_DIM_DRESS, param);
 123
 124     param = g_param_spec_boxed("ref1",
 125                                P_("Reference 1"),
 126                                P_("First reference point of the dimension"),
 127                                ADG_TYPE_POINT,
 128                                G_PARAM_READWRITE);
 129     g_object_class_install_property(gobject_class, PROP_REF1, param);
 130
 131     param = g_param_spec_boxed("ref2",
 132                                P_("Reference 2"),
 133                                P_("Second reference point of the dimension"),
 134                                ADG_TYPE_POINT,
 135                                G_PARAM_READWRITE);
 136     g_object_class_install_property(gobject_class, PROP_REF2, param);
 137
 138     param = g_param_spec_boxed("pos",
 139                                P_("Position"),
 140                                P_("The reference position in local space of the quote: it will be combined with \"level\" to get the real quote position"),
 141                                ADG_TYPE_POINT,
 142                                G_PARAM_READWRITE);
 143     g_object_class_install_property(gobject_class, PROP_POS, param);
 144
 145     param = g_param_spec_double("level",
 146                                 P_("Level"),
 147                                 P_("The dimension level, that is the factor to multiply the baseline spacing (defined in the dimension style) to get the offset from pos where the quote should be rendered"),
 148                                 -G_MAXDOUBLE, G_MAXDOUBLE, 1.0,
 149                                 G_PARAM_READWRITE);
 150     g_object_class_install_property(gobject_class, PROP_LEVEL, param);
 151
 152     param = g_param_spec_enum("outside",
 153                               P_("Outside"),
 154                               P_("Whether the arrows must be inside the extension lines (ADG_THREE_STATE_OFF), must be extended outside the extension lines (ADG_THREE_STATE_ON) or should be automatically handled depending on the available space"),
 155                               ADG_TYPE_THREE_STATE, ADG_THREE_STATE_UNKNOWN,
 156                               G_PARAM_READWRITE);
 157     g_object_class_install_property(gobject_class, PROP_OUTSIDE, param);
 158
 159     param = g_param_spec_enum("centered",
 160                               P_("Centered"),
 161                               P_("Where the quote must be positioned: in the middle of the base line (ADG_THREE_STATE_ON), near the pos point (ADG_THREE_STATE_OFF) or should be automatically deducted depending on the available space"),
 162                               ADG_TYPE_THREE_STATE, ADG_THREE_STATE_UNKNOWN,
 163                               G_PARAM_READWRITE);
 164     g_object_class_install_property(gobject_class, PROP_CENTERED, param);
 165
 166     param = g_param_spec_string("value",
 167                                 P_("Basic Value"),
 168                                 P_("The theoretically exact value for this quote: set to NULL to automatically get the default value"),
 169                                 NULL,
 170                                 G_PARAM_READWRITE);
 171     g_object_class_install_property(gobject_class, PROP_VALUE, param);
 172
 173     param = g_param_spec_string("value-min",
 174                                 P_("Minimum Value or Low Tolerance"),
 175                                 P_("The minimum value allowed or the lowest tolerance from value (depending of the dimension style): set to NULL to suppress"),
 176                                 NULL,
 177                                 G_PARAM_READWRITE);
 178     g_object_class_install_property(gobject_class, PROP_MIN, param);
 179
 180     param = g_param_spec_string("value-max",
 181                                 P_("Maximum Value or High Tolerance"),
 182                                 P_("The maximum value allowed or the highest tolerance from value (depending of the dimension style): set to NULL to suppress"),
 183                                 NULL,
 184                                 G_PARAM_READWRITE);
 185     g_object_class_install_property(gobject_class, PROP_MAX, param);
 186 }
 187
 188 static void
 189 adg_dim_init(AdgDim *dim)
 190 {
 191     AdgDimPrivate *data = G_TYPE_INSTANCE_GET_PRIVATE(dim, ADG_TYPE_DIM,
 192                                                       AdgDimPrivate);
 193
 194     data->dim_dress = ADG_DRESS_DIMENSION;
 195     data->ref1 = NULL;
 196     data->ref2 = NULL;
 197     data->pos = NULL;
 198     data->level = 1;
 199     data->outside = ADG_THREE_STATE_UNKNOWN;
 200     data->centered = ADG_THREE_STATE_UNKNOWN;
 201     data->value = NULL;
 202     data->min = NULL;
 203     data->max = NULL;
 204
 205     dim->data = data;
 206 }
 207
 208 static void
 209 dispose(GObject *object)
 210 {
 211     AdgDimPrivate *data = ((AdgDim *) object)->data;
 212
 213     if (data->quote.entity != NULL) {
 214         g_object_unref(data->quote.entity);
 215         data->quote.entity = NULL;
 216     }
 217     if (data->ref1 != NULL) {
 218         adg_point_destroy(data->ref1);
 219         data->ref1 = NULL;
 220     }
 221     if (data->ref2 != NULL) {
 222         adg_point_destroy(data->ref2);
 223         data->ref2 = NULL;
 224     }
 225     if (data->pos != NULL) {
 226         adg_point_destroy(data->pos);
 227         data->pos = NULL;
 228     }
 229
 230     if (PARENT_OBJECT_CLASS->dispose)
 231         PARENT_OBJECT_CLASS->dispose(object);
 232 }
 233
 234 static void
 235 finalize(GObject *object)
 236 {
 237     AdgDimPrivate *data = ((AdgDim *) object)->data;
 238
 239     g_free(data->value);
 240     g_free(data->min);
 241     g_free(data->max);
 242
 243     if (PARENT_OBJECT_CLASS->finalize)
 244         PARENT_OBJECT_CLASS->finalize(object);
 245 }
 246
 247 static void
 248 get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
 249 {
 250     AdgDimPrivate *data = ((AdgDim *) object)->data;
 251
 252     switch (prop_id) {
 253     case PROP_DIM_DRESS:
 254         g_value_set_int(value, data->dim_dress);
 255         break;
 256     case PROP_REF1:
 257         g_value_set_boxed(value, data->ref1);
 258         break;
 259     case PROP_REF2:
 260         g_value_set_boxed(value, data->ref2);
 261         break;
 262     case PROP_POS:
 263         g_value_set_boxed(value, data->pos);
 264         break;
 265     case PROP_LEVEL:
 266         g_value_set_double(value, data->level);
 267         break;
 268     case PROP_OUTSIDE:
 269         g_value_set_enum(value, data->outside);
 270         break;
 271     case PROP_CENTERED:
 272         g_value_set_enum(value, data->centered);
 273         break;
 274     case PROP_VALUE:
 275         g_value_set_string(value, data->value);
 276         break;
 277     case PROP_MIN:
 278         g_value_set_string(value, data->min);
 279         break;
 280     case PROP_MAX:
 281         g_value_set_string(value, data->max);
 282         break;
 283     default:
 284         G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
 285         break;
 286     }
 287 }
 288
 289 static void
 290 set_property(GObject *object, guint prop_id,
 291              const GValue *value, GParamSpec *pspec)
 292 {
 293     AdgDim *dim;
 294     AdgDimPrivate *data;
 295
 296     dim = (AdgDim *) object;
 297     data = dim->data;
 298
 299     switch (prop_id) {
 300     case PROP_DIM_DRESS:
 301         set_dim_dress(dim, g_value_get_int(value));
 302         break;
 303     case PROP_REF1:
 304         if (data->ref1 != NULL)
 305             adg_point_destroy(data->ref1);
 306         data->ref1 = g_value_dup_boxed(value);
 307         break;
 308     case PROP_REF2:
 309         if (data->ref2 != NULL)
 310             adg_point_destroy(data->ref2);
 311         data->ref2 = g_value_dup_boxed(value);
 312         break;
 313     case PROP_POS:
 314         if (data->pos != NULL)
 315             adg_point_destroy(data->pos);
 316         data->pos = g_value_dup_boxed(value);
 317         break;
 318     case PROP_LEVEL:
 319         data->level = g_value_get_double(value);
 320         break;
 321     case PROP_OUTSIDE:
 322         data->outside = g_value_get_enum(value);
 323         break;
 324     case PROP_CENTERED:
 325         data->centered = g_value_get_enum(value);
 326         break;
 327     case PROP_VALUE:
 328         set_value(dim, g_value_get_string(value));
 329         break;
 330     case PROP_MIN:
 331         set_min(dim, g_value_get_string(value));
 332         break;
 333     case PROP_MAX:
 334         set_max(dim, g_value_get_string(value));
 335         break;
 336     default:
 337         G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
 338         break;
 339     }
 340 }
 341
 342
 343 /**
 344  * adg_dim_set_dim_dress:
 345  * @dim: an #AdgDim
 346  * @dress: the new #AdgDress to use
 347  *
 348  * Sets a new dimension dress to @dim. The new dress must be
 349  * related to the original dress for this property: you cannot
 350  * set a dress used for line styles to a dress managing fonts.
 351  *
 352  * The check is done by calling adg_dress_are_related() with
 353  * @dress and the previous dress as arguments. Check out its
 354  * documentation for details on what is a related dress.
 355  **/
 356 void
 357 adg_dim_set_dim_dress(AdgDim *dim, AdgDress dress)
 358 {
 359     g_return_if_fail(ADG_IS_DIM(dim));
 360
 361     if (set_dim_dress(dim, dress))
 362         g_object_notify((GObject *) dim, "dim-dress");
 363 }
 364
 365 /**
 366  * adg_dim_get_dim_dress:
 367  * @dim: an #AdgDim
 368  *
 369  * Gets the dimension dress to be used in rendering @dim.
 370  *
 371  * Returns: the current dimension dress
 372  **/
 373 AdgDress
 374 adg_dim_get_dim_dress(AdgDim *dim)
 375 {
 376     AdgDimPrivate *data;
 377
 378     g_return_val_if_fail(ADG_IS_DIM(dim), ADG_DRESS_UNDEFINED);
 379
 380     data = dim->data;
 381
 382     return data->dim_dress;
 383 }
 384
 385 /**
 386  * adg_dim_set_ref:
 387  * @dim: an #AdgDim
 388  * @ref1: the ref1 coordinates
 389  * @ref2: the ref2 coordinates
 390  *
 391  * Sets the #AdgDim:ref1 and #AdgDim:ref2 reference points
 392  * using @ref1 and @ref2 pairs.  @ref1 or @ref2 could be
 393  * %NULL (but not both), in which case only the non-null
 394  * reference point is changed.
 395  **/
 396 void
 397 adg_dim_set_ref(AdgDim *dim, const AdgPair *ref1, const AdgPair *ref2)
 398 {
 399     GObject *object;
 400     AdgDimPrivate *data;
 401
 402     g_return_if_fail(ADG_IS_DIM(dim));
 403     g_return_if_fail(ref1 != NULL || ref2 != NULL);
 404
 405     data = dim->data;
 406     object = (GObject *) dim;
 407
 408     g_object_freeze_notify(object);
 409
 410     if (ref1 != NULL) {
 411         if (data->ref1 == NULL)
 412             data->ref1 = adg_point_new();
 413
 414         adg_point_set(data->ref1, ref1);
 415
 416         g_object_notify(object, "ref1");
 417     }
 418
 419     if (ref2 != NULL) {
 420         if (data->ref2 == NULL)
 421             data->ref2 = adg_point_new();
 422
 423         adg_point_set(data->ref2, ref2);
 424
 425         g_object_notify(object, "ref2");
 426     }
 427
 428     g_object_thaw_notify(object);
 429 }
 430
 431 /**
 432  * adg_dim_set_ref_explicit:
 433  * @dim: an #AdgDim
 434  * @ref1_x: x coordinate of ref1
 435  * @ref1_y: y coordinate of ref1
 436  * @ref2_x: x coordinate of ref2
 437  * @ref2_y: y coordinate of ref2
 438  *
 439  * Works in the same way as adg_dim_set_ref() but using
 440  * explicit coordinates instead of #AdgPair args. The
 441  * notable difference is that, by using gdouble values,
 442  * you can't set only a single reference point.
 443  **/
 444 void
 445 adg_dim_set_ref_explicit(AdgDim *dim,
 446                          gdouble ref1_x, gdouble ref1_y,
 447                          gdouble ref2_x, gdouble ref2_y)
 448 {
 449     AdgPair ref1, ref2;
 450
 451     ref1.x = ref1_x;
 452     ref1.y = ref1_y;
 453     ref2.x = ref2_x;
 454     ref2.y = ref2_y;
 455
 456     adg_dim_set_ref(dim, &ref1, &ref2);
 457 }
 458
 459 /**
 460  * adg_dim_set_ref_from_model:
 461  * @dim: an #AdgDim
 462  * @model: the source #AdgModel
 463  * @ref1: name of the pair in @model to use as ref1
 464  * @ref2: name of the pair in @model to use as ref2
 465  *
 466  * Sets #AdgDim:ref1 and #AdgDim:ref2 properties by linking
 467  * them to the @ref1 and @ref2 named pairs in @model. @ref1
 468  * or @ref2 could be %NULL (but not both), in which case
 469  * only the non-null reference point is changed.
 470  *
 471  * Using this function twice you can also link the reference
 472  * points to named pairs taken from different models:
 473  *
 474  * |[
 475  * adg_dim_set_ref_from_model(dim, model1, ref1, NULL);
 476  * adg_dim_set_ref_from_model(dim, model2, NULL, ref2);
 477  * ]|
 478  **/
 479 void
 480 adg_dim_set_ref_from_model(AdgDim *dim, AdgModel *model,
 481                            const gchar *ref1, const gchar *ref2)
 482 {
 483     GObject *object;
 484     AdgDimPrivate *data;
 485
 486     g_return_if_fail(ADG_IS_DIM(dim));
 487     g_return_if_fail(ADG_IS_MODEL(model));
 488     g_return_if_fail(ref1 != NULL || ref2 != NULL);
 489
 490     object = (GObject *) dim;
 491     data = dim->data;
 492
 493     g_object_freeze_notify(object);
 494
 495     if (ref1 != NULL) {
 496         if (data->ref1 == NULL)
 497             data->ref1 = adg_point_new();
 498
 499         adg_point_set_from_model(data->ref1, model, ref1);
 500
 501         g_object_notify(object, "ref1");
 502     }
 503
 504     if (ref2 != NULL) {
 505         if (data->ref2 == NULL)
 506             data->ref2 = adg_point_new();
 507
 508         adg_point_set_from_model(data->ref2, model, ref2);
 509
 510         g_object_notify(object, "ref2");
 511     }
 512
 513     g_object_thaw_notify(object);
 514 }
 515
 516 /**
 517  * adg_dim_get_ref1:
 518  * @dim: an #AdgDim
 519  *
 520  * Gets the ref1 coordinates. The returned pair is internally owned
 521  * and must not be freed or modified.
 522  *
 523  * Returns: the ref1 coordinates
 524  **/
 525 const AdgPair *
 526 adg_dim_get_ref1(AdgDim *dim)
 527 {
 528     AdgDimPrivate *data;
 529
 530     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 531
 532     data = dim->data;
 533
 534     return adg_point_pair(data->ref1);
 535 }
 536
 537 /**
 538  * adg_dim_get_ref2:
 539  * @dim: an #AdgDim
 540  *
 541  * Gets the ref2 coordinates. The returned pair is internally owned
 542  * and must not be freed or modified.
 543  *
 544  * Returns: the ref2 coordinates
 545  **/
 546 const AdgPair *
 547 adg_dim_get_ref2(AdgDim *dim)
 548 {
 549     AdgDimPrivate *data;
 550
 551     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 552
 553     data = dim->data;
 554
 555     return adg_point_pair(data->ref2);
 556 }
 557
 558 /**
 559  * adg_dim_set_pos:
 560  * @dim: an #AdgDim
 561  * @pos: the pos coordinates
 562  *
 563  * Sets a new #AdgDim:pos position.
 564  **/
 565 void
 566 adg_dim_set_pos(AdgDim *dim, const AdgPair *pos)
 567 {
 568     AdgDimPrivate *data;
 569
 570     g_return_if_fail(ADG_IS_DIM(dim));
 571     g_return_if_fail(pos != NULL);
 572
 573     data = dim->data;
 574
 575     if (data->pos == NULL)
 576         data->pos = adg_point_new();
 577
 578     adg_point_set(data->pos, pos);
 579
 580     g_object_notify((GObject *) dim, "pos");
 581 }
 582
 583 /**
 584  * adg_dim_set_pos_explicit:
 585  * @dim: an #AdgDim
 586  * @pos_x: x coordinate of pos
 587  * @pos_y: y coordinate of pos
 588  *
 589  * Shortcut to set #AdgDim:pos using explicit coordinates.
 590  **/
 591 void
 592 adg_dim_set_pos_explicit(AdgDim *dim, gdouble x, gdouble y)
 593 {
 594     AdgPair pos;
 595
 596     pos.x = x;
 597     pos.y = y;
 598
 599     adg_dim_set_pos(dim, &pos);
 600 }
 601
 602 /**
 603  * adg_dim_set_pos_from_model:
 604  * @dim: an #AdgDim
 605  * @model: the source #AdgModel
 606  * @ref1: name of the pair in @model to use as pos
 607  *
 608  * Sets #AdgDim:pos by linking it to the @pos named pair
 609  * in @model.
 610  **/
 611 void
 612 adg_dim_set_pos_from_model(AdgDim *dim, AdgModel *model, const gchar *pos)
 613 {
 614     AdgDimPrivate *data;
 615
 616     g_return_if_fail(ADG_IS_DIM(dim));
 617     g_return_if_fail(ADG_IS_MODEL(model));
 618     g_return_if_fail(pos != NULL);
 619
 620     data = dim->data;
 621
 622     if (data->pos == NULL)
 623         data->pos = adg_point_new();
 624
 625     adg_point_set_from_model(data->pos, model, pos);
 626
 627     g_object_notify((GObject *) dim, "pos");
 628 }
 629
 630 /**
 631  * adg_dim_get_pos:
 632  * @dim: an #AdgDim
 633  *
 634  * Gets the position coordinates. The returned pair is internally owned
 635  * and must not be freed or modified.
 636  *
 637  * Returns: the pos coordinates
 638  **/
 639 const AdgPair *
 640 adg_dim_get_pos(AdgDim *dim)
 641 {
 642     AdgDimPrivate *data;
 643
 644     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 645
 646     data = dim->data;
 647
 648     return adg_point_pair(data->pos);
 649 }
 650
 651 /**
 652  * adg_dim_set_level:
 653  * @dim: an #AdgDim
 654  * @level: the new level
 655  *
 656  * Sets a new level for this dimension. The level is used to
 657  * stack the quotes using a spacing value from dim_style
 658  * (specified in global space).
 659  **/
 660 void
 661 adg_dim_set_level(AdgDim *dim, gdouble level)
 662 {
 663     AdgDimPrivate *data;
 664
 665     g_return_if_fail(ADG_IS_DIM(dim));
 666
 667     data = dim->data;
 668     data->level = level;
 669
 670     g_object_notify((GObject *) dim, "level");
 671 }
 672
 673 /**
 674  * adg_dim_get_level:
 675  * @dim: an #AdgDim
 676  *
 677  * Gets the level of this dimension.
 678  *
 679  * Returns: the level value
 680  **/
 681 gdouble
 682 adg_dim_get_level(AdgDim *dim)
 683 {
 684     AdgDimPrivate *data;
 685
 686     g_return_val_if_fail(ADG_IS_DIM(dim), 0);
 687
 688     data = dim->data;
 689
 690     return data->level;
 691 }
 692
 693 /**
 694  * adg_dim_set_outside:
 695  * @dim: an #AdgDim
 696  * @outside: the new outside state
 697  *
 698  * Sets a new state for the #AdgDim:outside flag: check the property
 699  * documentation for further details.
 700  **/
 701 void
 702 adg_dim_set_outside(AdgDim *dim, AdgThreeState outside)
 703 {
 704     AdgDimPrivate *data;
 705
 706     g_return_if_fail(ADG_IS_DIM(dim));
 707
 708     data = dim->data;
 709     data->outside = outside;
 710
 711     g_object_notify((GObject *) dim, "outside");
 712 }
 713
 714 /**
 715  * adg_dim_get_outside:
 716  * @dim: an #AdgDim
 717  *
 718  * Gets the state of the #AdgDim:outside property: check the property
 719  * documentation for further details.
 720  *
 721  * Returns: the current flag state
 722  **/
 723 AdgThreeState
 724 adg_dim_get_outside(AdgDim *dim)
 725 {
 726     AdgDimPrivate *data;
 727
 728     g_return_val_if_fail(ADG_IS_DIM(dim), ADG_THREE_STATE_UNKNOWN);
 729
 730     data = dim->data;
 731
 732     return data->outside;
 733 }
 734
 735 /**
 736  * adg_dim_set_centered:
 737  * @dim: an #AdgDim
 738  * @centered: the new centered state
 739  *
 740  * Sets a new state for the #AdgDim:centered flag: check the property
 741  * documentation for further details.
 742  *
 743  * This is used by dimensions where the centering of the quote is
 744  * applicable. In the other cases (such as with #AdgRDim dimensions)
 745  * the property is not used.
 746  **/
 747 void
 748 adg_dim_set_centered(AdgDim *dim, AdgThreeState centered)
 749 {
 750     AdgDimPrivate *data;
 751
 752     g_return_if_fail(ADG_IS_DIM(dim));
 753
 754     data = dim->data;
 755     data->centered = centered;
 756
 757     g_object_notify((GObject *) dim, "centered");
 758 }
 759
 760 /**
 761  * adg_dim_get_centered:
 762  * @dim: an #AdgDim
 763  *
 764  * Gets the state of the #AdgDim:centered property: check the property
 765  * documentation for further details.
 766  *
 767  * Returns: the current flag state
 768  **/
 769 AdgThreeState
 770 adg_dim_get_centered(AdgDim *dim)
 771 {
 772     AdgDimPrivate *data;
 773
 774     g_return_val_if_fail(ADG_IS_DIM(dim), ADG_THREE_STATE_UNKNOWN);
 775
 776     data = dim->data;
 777
 778     return data->centered;
 779 }
 780
 781 /**
 782  * adg_dim_set_value:
 783  * @dim: an #AdgDim
 784  * @value: the value text
 785  *
 786  * Explicitely sets the text to use as value. If @value is %NULL or
 787  * was never set, an automatic text is calculated using the format
 788  * specified in the current #AdgDimStyle and getting its value by
 789  * calling the default_value() virtual method.
 790  **/
 791 void
 792 adg_dim_set_value(AdgDim *dim, const gchar *value)
 793 {
 794     g_return_if_fail(ADG_IS_DIM(dim));
 795
 796     if (set_value(dim, value))
 797         g_object_notify((GObject *) dim, "value");
 798 }
 799
 800 /**
 801  * adg_dim_get_value:
 802  * @dim: an #AdgDim
 803  *
 804  * Gets the value text. The string is internally owned and
 805  * must not be freed or modified.
 806  *
 807  * Returns: the value text
 808  **/
 809 const gchar *
 810 adg_dim_get_value(AdgDim *dim)
 811 {
 812     AdgDimPrivate *data;
 813
 814     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 815
 816     data = dim->data;
 817
 818     return data->value;
 819 }
 820
 821 /**
 822  * adg_dim_set_limits:
 823  * @dim: an #AdgDim
 824  * @min: the new minumum value
 825  * @max: the new maximum value
 826  *
 827  * Shortcut to set both the limits at once.
 828  **/
 829 void
 830 adg_dim_set_limits(AdgDim *dim, const gchar *min, const gchar *max)
 831 {
 832     g_return_if_fail(ADG_IS_DIM(dim));
 833
 834     g_object_freeze_notify((GObject *) dim);
 835     adg_dim_set_min(dim, min);
 836     adg_dim_set_max(dim, max);
 837     g_object_thaw_notify((GObject *) dim);
 838 }
 839
 840 /**
 841  * adg_dim_set_min:
 842  * @dim: an #AdgDim
 843  * @min: the new minimum limit
 844  *
 845  * Sets the minimum value. Use %NULL as @min to disable it.
 846  **/
 847 void
 848 adg_dim_set_min(AdgDim *dim, const gchar *min)
 849 {
 850     g_return_if_fail(ADG_IS_DIM(dim));
 851
 852     if (set_min(dim, min))
 853         g_object_notify((GObject *) dim, "value-min");
 854 }
 855
 856 /**
 857  * adg_dim_get_min:
 858  * @dim: an #AdgDim
 859  *
 860  * Gets the minimum value text or %NULL on minimum value disabled.
 861  * The string is internally owned and must not be freed or modified.
 862  *
 863  * Returns: the mimimum value text
 864  **/
 865 const gchar *
 866 adg_dim_get_min(AdgDim *dim)
 867 {
 868     AdgDimPrivate *data;
 869
 870     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 871
 872     data = dim->data;
 873
 874     return data->min;
 875 }
 876
 877 /**
 878  * adg_dim_set_max:
 879  * @dim: an #AdgDim
 880  * @max: the new maximum value
 881  *
 882  * Sets the maximum value. Use %NULL as @max to disable it.
 883  **/
 884 void
 885 adg_dim_set_max(AdgDim *dim, const gchar *max)
 886 {
 887     g_return_if_fail(ADG_IS_DIM(dim));
 888
 889     if (set_max(dim, max))
 890         g_object_notify((GObject *) dim, "value-max");
 891 }
 892
 893 /**
 894  * adg_dim_get_max:
 895  * @dim: an #AdgDim
 896  *
 897  * Gets the maximum value text or %NULL on maximum value disabled.
 898  * The string is internally owned and must not be freed or modified.
 899  *
 900  * Returns: the maximum value text
 901  **/
 902 const gchar *
 903 adg_dim_get_max(AdgDim *dim)
 904 {
 905     AdgDimPrivate *data;
 906
 907     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 908
 909     data = dim->data;
 910
 911     return data->max;
 912 }
 913
 914 /**
 915  * adg_dim_get_quote:
 916  * @dim: an #AdgDim
 917  *
 918  * <note><para>
 919  * This function is only useful in new dimension implementations.
 920  * </para></note>
 921  *
 922  * Gets the quote entity, if any. This function is valid only after
 923  * the #AdgDim implementation of the arrange() virtual method has
 924  * been called.
 925  *
 926  * Returns: the quote entity
 927  **/
 928 AdgAlignment *
 929 adg_dim_get_quote(AdgDim *dim)
 930 {
 931     AdgDimPrivate *data;
 932
 933     g_return_val_if_fail(ADG_IS_DIM(dim), NULL);
 934
 935     data = dim->data;
 936
 937     return data->quote.entity;
 938 }
 939
 940 /**
 941  * adg_dim_quote_angle:
 942  * @dim: an #AdgDim
 943  * @angle: an angle (in radians)
 944  *
 945  * <note><para>
 946  * This function is only useful in new dimension implementations.
 947  * </para></note>
 948  *
 949  * Converts @angle accordling to the style of @dim. Any quote angle
 950  * should be validated by this method because every dimensioning
 951  * style has its own convention regardling the text rotation.
 952  *
 953  * Returns: the angle to use (always in radians)
 954  **/
 955 gdouble
 956 adg_dim_quote_angle(AdgDim *dim, gdouble angle)
 957 {
 958     AdgDimClass *klass;
 959
 960     g_return_val_if_fail(ADG_IS_DIM(dim), angle);
 961
 962     klass = ADG_DIM_GET_CLASS(dim);
 963
 964     if (klass->quote_angle == NULL)
 965         return angle;
 966
 967     return klass->quote_angle(angle);
 968 }
 969
 970
 971 static void
 972 global_changed(AdgEntity *entity)
 973 {
 974     AdgDimPrivate *data = ((AdgDim *) entity)->data;
 975
 976     if (PARENT_ENTITY_CLASS->global_changed)
 977         PARENT_ENTITY_CLASS->global_changed(entity);
 978
 979     if (data->quote.entity != NULL)
 980         adg_entity_global_changed((AdgEntity *) data->quote.entity);
 981 }
 982
 983 static void
 984 local_changed(AdgEntity *entity)
 985 {
 986     AdgDimPrivate *data = ((AdgDim *) entity)->data;
 987
 988     if (PARENT_ENTITY_CLASS->local_changed)
 989         PARENT_ENTITY_CLASS->local_changed(entity);
 990
 991     if (data->quote.entity != NULL)
 992         adg_entity_local_changed((AdgEntity *) data->quote.entity);
 993 }
 994
 995 static void
 996 invalidate(AdgEntity *entity)
 997 {
 998     AdgDimPrivate *data = ((AdgDim *) entity)->data;
 999
1000     if (PARENT_ENTITY_CLASS->invalidate)
1001         PARENT_ENTITY_CLASS->invalidate(entity);
1002
1003     if (data->quote.entity != NULL)
1004         adg_entity_invalidate((AdgEntity *) data->quote.entity);
1005
1006     adg_point_invalidate(data->ref1);
1007     adg_point_invalidate(data->ref2);
1008     adg_point_invalidate(data->pos);
1009 }
1010
1011 static void
1012 arrange(AdgEntity *entity)
1013 {
1014     AdgDim *dim;
1015     AdgDimPrivate *data;
1016     AdgEntity *quote_entity;
1017     AdgContainer *quote_container;
1018     AdgEntity *value_entity;
1019     AdgEntity *min_entity;
1020     AdgEntity *max_entity;
1021     const AdgPair *shift;
1022     AdgMatrix map;
1023
1024     dim = (AdgDim *) entity;
1025     data = dim->data;
1026
1027     /* Resolve the dim style */
1028     if (data->dim_style == NULL)
1029         data->dim_style = (AdgDimStyle *)
1030             adg_entity_style(entity, data->dim_dress);
1031
1032     if (data->quote.entity == NULL) {
1033         AdgPair factor = { 0.5, 0 };
1034         data->quote.entity = g_object_new(ADG_TYPE_ALIGNMENT,
1035                                           "local-method", ADG_MIX_NONE,
1036                                           "factor", &factor,
1037                                           "parent", dim, NULL);
1038     }
1039
1040     quote_entity = (AdgEntity *) data->quote.entity;
1041     quote_container = (AdgContainer *) data->quote.entity;
1042
1043     if (data->quote.value == NULL) {
1044         AdgDress dress = adg_dim_style_get_value_dress(data->dim_style);
1045
1046         data->quote.value = g_object_new(ADG_TYPE_TOY_TEXT,
1047                                          "local-method", ADG_MIX_PARENT,
1048                                          "font-dress", dress, NULL);
1049
1050         adg_container_add(quote_container, (AdgEntity *) data->quote.value);
1051
1052         if (data->value) {
1053             adg_toy_text_set_label(data->quote.value, data->value);
1054         } else {
1055             AdgDimClass *klass = ADG_DIM_GET_CLASS(dim);
1056
1057             if (klass->default_value) {
1058                 /* Automatically generate the value text */
1059                 gchar *text = klass->default_value(dim);
1060                 adg_toy_text_set_label(data->quote.value, text);
1061                 g_free(text);
1062             }
1063         }
1064     }
1065
1066     if (data->quote.min == NULL && data->min != NULL) {
1067         AdgDress dress = adg_dim_style_get_min_dress(data->dim_style);
1068
1069         data->quote.min = g_object_new(ADG_TYPE_TOY_TEXT,
1070                                        "local-method", ADG_MIX_PARENT,
1071                                        "font-dress", dress, NULL);
1072
1073         adg_container_add(quote_container, (AdgEntity *) data->quote.min);
1074         adg_toy_text_set_label(data->quote.min, data->min);
1075     }
1076
1077     if (data->quote.max == NULL && data->max != NULL) {
1078         AdgDress dress = adg_dim_style_get_max_dress(data->dim_style);
1079
1080         data->quote.max = g_object_new(ADG_TYPE_TOY_TEXT,
1081                                        "local-method", ADG_MIX_PARENT,
1082                                        "font-dress", dress, NULL);
1083
1084         adg_container_add(quote_container, (AdgEntity *) data->quote.max);
1085         adg_toy_text_set_label(data->quote.max, data->max);
1086     }
1087
1088     value_entity = (AdgEntity *) data->quote.value;
1089     min_entity = (AdgEntity *) data->quote.min;
1090     max_entity = (AdgEntity *) data->quote.max;
1091     shift = adg_dim_style_get_quote_shift(data->dim_style);
1092
1093     adg_entity_set_global_map(quote_entity, adg_matrix_identity());
1094     adg_entity_global_changed(quote_entity);
1095
1096     cairo_matrix_init_translate(&map, shift->x, shift->y);
1097     adg_entity_set_global_map(value_entity, &map);
1098     adg_entity_arrange(value_entity);
1099
1100     /* Limit values (min and max) */
1101     if (min_entity != NULL || max_entity != NULL) {
1102         const CpmlExtents *extents = adg_entity_get_extents(value_entity);
1103         //CpmlExtents min_extents = { 0 };
1104         //CpmlExtents max_extents = { 0 };
1105         const AdgPair *limits_shift = adg_dim_style_get_limits_shift(data->dim_style);
1106
1107 #if 0
1108         if (min_entity != NULL)
1109             cpml_extents_copy(&min_extents, adg_entity_get_extents(min_entity));
1110
1111         if (max_entity != NULL)
1112             cpml_extents_copy(&max_extents, adg_entity_get_extents(max_entity));
1113
1114         if (min_entity != NULL && max_entity != NULL)
1115             spacing = adg_dim_style_get_limits_spacing(data->dim_style);
1116
1117         cairo_matrix_init_translate(&map,
1118                                     extents->size.x +
1119                                      shift->x + limit_shift->x,
1120                                     (spacing + min_extents.size.y +
1121                                      max_extents.size.y - extents->size.y) / 2 +
1122                                      shift->y + limit_shift->y);
1123 #endif
1124         cairo_matrix_init_translate(&map, extents->size.x + limits_shift->x,
1125                                     -extents->size.y / 2 + limits_shift->y);
1126
1127         if (min_entity != NULL) {
1128             adg_entity_set_global_map(min_entity, &map);
1129             adg_entity_arrange(min_entity);
1130             extents = adg_entity_get_extents(min_entity);
1131             map.y0 -= extents->size.y +
1132                 adg_dim_style_get_limits_spacing(data->dim_style);
1133         }
1134
1135         if (max_entity != NULL) {
1136             adg_entity_set_global_map(max_entity, &map);
1137             adg_entity_arrange(max_entity);
1138         }
1139     }
1140
1141     adg_entity_arrange(quote_entity);
1142 }
1143
1144 static gchar *
1145 default_value(AdgDim *dim)
1146 {
1147     g_warning("AdgDim::default_value not implemented for `%s'",
1148               g_type_name(G_TYPE_FROM_INSTANCE(dim)));
1149     return g_strdup("undef");
1150 }
1151
1152 static gdouble
1153 quote_angle(gdouble angle)
1154 {
1155     angle = cpml_angle(angle);
1156
1157     if (angle > G_PI_4 * 4 / 3 || angle <= -G_PI_4 * 3)
1158         angle = cpml_angle(angle + G_PI);
1159
1160     return angle;
1161 }
1162
1163 static gboolean
1164 set_dim_dress(AdgDim *dim, AdgDress dress)
1165 {
1166     AdgDimPrivate *data = dim->data;
1167
1168     if (adg_dress_set(&data->dim_dress, dress)) {
1169         data->dim_style = NULL;
1170         return TRUE;
1171     }
1172
1173     return FALSE;
1174 }
1175
1176 static gboolean
1177 set_value(AdgDim *dim, const gchar *value)
1178 {
1179     AdgDimPrivate *data;
1180
1181     data = dim->data;
1182
1183     if (adg_strcmp(value, data->value) == 0)
1184         return FALSE;
1185
1186     g_free(data->value);
1187     data->value = g_strdup(value);
1188
1189     if (data->quote.value != NULL) {
1190         g_object_unref(data->quote.value);
1191         data->quote.value = NULL;
1192     }
1193
1194     return TRUE;
1195 }
1196
1197 static gboolean
1198 set_min(AdgDim *dim, const gchar *min)
1199 {
1200     AdgDimPrivate *data = dim->data;
1201
1202     if (adg_strcmp(min, data->min) == 0)
1203         return FALSE;
1204
1205     g_free(data->min);
1206     data->min = g_strdup(min);
1207
1208     if (data->quote.min != NULL) {
1209         g_object_unref(data->quote.min);
1210         data->quote.min = NULL;
1211     }
1212
1213     return TRUE;
1214 }
1215
1216 static gboolean
1217 set_max(AdgDim *dim, const gchar *max)
1218 {
1219     AdgDimPrivate *data = dim->data;
1220
1221     if (adg_strcmp(max, data->max) == 0)
1222         return FALSE;
1223
1224     g_free(data->max);
1225     data->max = g_strdup(max);
1226
1227     if (data->quote.max != NULL) {
1228         g_object_unref(data->quote.max);
1229         data->quote.max = NULL;
1230     }
1231
1232     return TRUE;
1233 }