src/sp-item.cpp

   1 #define __SP_ITEM_C__
   2
   3 /** \file
   4  * Base class for visual SVG elements
   5  */
   6 /*
   7  * Authors:
   8  *   Lauris Kaplinski <lauris@kaplinski.com>
   9  *   bulia byak <buliabyak@users.sf.net>
  10  *
  11  * Copyright (C) 2001-2005 authors
  12  * Copyright (C) 2001 Ximian, Inc.
  13  *
  14  * Released under GNU GPL, read the file 'COPYING' for more information
  15  */
  16
  17 /** \class SPItem
  18  *
  19  * SPItem is an abstract base class for all graphic (visible) SVG nodes. It
  20  * is a subclass of SPObject, with great deal of specific functionality.
  21  */
  22
  23 #ifdef HAVE_CONFIG_H
  24 # include "config.h"
  25 #endif
  26
  27
  28
  29 #include "svg/svg.h"
  30 #include "print.h"
  31 #include "display/nr-arena.h"
  32 #include "display/nr-arena-item.h"
  33 #include "attributes.h"
  34 #include "document.h"
  35 #include "uri.h"
  36
  37 #include "style.h"
  38 #include <glibmm/i18n.h>
  39 #include "sp-root.h"
  40 #include "sp-clippath.h"
  41 #include "sp-mask.h"
  42 #include "sp-rect.h"
  43 #include "sp-use.h"
  44 #include "sp-text.h"
  45 #include "sp-item-rm-unsatisfied-cns.h"
  46 #include "sp-pattern.h"
  47 #include "gradient-chemistry.h"
  48 #include "prefs-utils.h"
  49 #include "conn-avoid-ref.h"
  50
  51 #include "libnr/nr-matrix-div.h"
  52 #include "libnr/nr-matrix-fns.h"
  53 #include "libnr/nr-matrix-scale-ops.h"
  54 #include "libnr/nr-matrix-translate-ops.h"
  55 #include "libnr/nr-scale-translate-ops.h"
  56 #include "libnr/nr-translate-scale-ops.h"
  57 #include "algorithms/find-last-if.h"
  58 #include "util/reverse-list.h"
  59
  60 #include "xml/repr.h"
  61
  62 #define noSP_ITEM_DEBUG_IDLE
  63
  64 static void sp_item_class_init(SPItemClass *klass);
  65 static void sp_item_init(SPItem *item);
  66
  67 static void sp_item_build(SPObject *object, SPDocument *document, Inkscape::XML::Node *repr);
  68 static void sp_item_release(SPObject *object);
  69 static void sp_item_set(SPObject *object, unsigned key, gchar const *value);
  70 static void sp_item_update(SPObject *object, SPCtx *ctx, guint flags);
  71 static Inkscape::XML::Node *sp_item_write(SPObject *object, Inkscape::XML::Node *repr, guint flags);
  72
  73 static gchar *sp_item_private_description(SPItem *item);
  74 static void sp_item_private_snappoints(SPItem const *item, SnapPointsIter p);
  75
  76 static SPItemView *sp_item_view_new_prepend(SPItemView *list, SPItem *item, unsigned flags, unsigned key, NRArenaItem *arenaitem);
  77 static SPItemView *sp_item_view_list_remove(SPItemView *list, SPItemView *view);
  78
  79 static SPObjectClass *parent_class;
  80
  81 static void clip_ref_changed(SPObject *old_clip, SPObject *clip, SPItem *item);
  82 static void mask_ref_changed(SPObject *old_clip, SPObject *clip, SPItem *item);
  83
  84 /**
  85  * Registers SPItem class and returns its type number.
  86  */
  87 GType
  88 sp_item_get_type(void)
  89 {
  90     static GType type = 0;
  91     if (!type) {
  92         GTypeInfo info = {
  93             sizeof(SPItemClass),
  94             NULL, NULL,
  95             (GClassInitFunc) sp_item_class_init,
  96             NULL, NULL,
  97             sizeof(SPItem),
  98             16,
  99             (GInstanceInitFunc) sp_item_init,
 100             NULL,   /* value_table */
 101         };
 102         type = g_type_register_static(SP_TYPE_OBJECT, "SPItem", &info, (GTypeFlags)0);
 103     }
 104     return type;
 105 }
 106
 107 /**
 108  * SPItem vtable initialization.
 109  */
 110 static void
 111 sp_item_class_init(SPItemClass *klass)
 112 {
 113     SPObjectClass *sp_object_class = (SPObjectClass *) klass;
 114
 115     parent_class = (SPObjectClass *)g_type_class_ref(SP_TYPE_OBJECT);
 116
 117     sp_object_class->build = sp_item_build;
 118     sp_object_class->release = sp_item_release;
 119     sp_object_class->set = sp_item_set;
 120     sp_object_class->update = sp_item_update;
 121     sp_object_class->write = sp_item_write;
 122
 123     klass->description = sp_item_private_description;
 124     klass->snappoints = sp_item_private_snappoints;
 125 }
 126
 127 /**
 128  * Callback for SPItem object initialization.
 129  */
 130 static void
 131 sp_item_init(SPItem *item)
 132 {
 133     SPObject *object = SP_OBJECT(item);
 134
 135     item->sensitive = TRUE;
 136
 137     item->transform_center_x = 0;
 138     item->transform_center_y = 0;
 139
 140     item->transform = NR::identity();
 141
 142     item->display = NULL;
 143
 144     item->clip_ref = new SPClipPathReference(SP_OBJECT(item));
 145                 {
 146                         sigc::signal<void, SPObject *, SPObject *> cs1=item->clip_ref->changedSignal();
 147                         sigc::slot2<void,SPObject*, SPObject *> sl1=sigc::bind(sigc::ptr_fun(clip_ref_changed), item);
 148                         cs1.connect(sl1);
 149                 }
 150
 151     item->mask_ref = new SPMaskReference(SP_OBJECT(item));
 152                 sigc::signal<void, SPObject *, SPObject *> cs2=item->mask_ref->changedSignal();
 153                 sigc::slot2<void,SPObject*, SPObject *> sl2=sigc::bind(sigc::ptr_fun(mask_ref_changed), item);
 154     cs2.connect(sl2);
 155
 156     if (!object->style) object->style = sp_style_new_from_object(SP_OBJECT(item));
 157
 158     item->avoidRef = new SPAvoidRef(item);
 159
 160     new (&item->_transformed_signal) sigc::signal<void, NR::Matrix const *, SPItem *>();
 161 }
 162
 163 bool SPItem::isVisibleAndUnlocked() const {
 164     return (!isHidden() && !isLocked());
 165 }
 166
 167 bool SPItem::isVisibleAndUnlocked(unsigned display_key) const {
 168     return (!isHidden(display_key) && !isLocked());
 169 }
 170
 171 bool SPItem::isLocked() const {
 172     for (SPObject *o = SP_OBJECT(this); o != NULL; o = SP_OBJECT_PARENT(o)) {
 173         if (SP_IS_ITEM(o) && !(SP_ITEM(o)->sensitive))
 174             return true;
 175     }
 176     return false;
 177 }
 178
 179 void SPItem::setLocked(bool locked) {
 180     SP_OBJECT_REPR(this)->setAttribute("sodipodi:insensitive",
 181                      ( locked ? "1" : NULL ));
 182     updateRepr();
 183 }
 184
 185 bool SPItem::isHidden() const {
 186     return style->display.computed == SP_CSS_DISPLAY_NONE;
 187 }
 188
 189 void SPItem::setHidden(bool hide) {
 190     style->display.set = TRUE;
 191     style->display.value = ( hide ? SP_CSS_DISPLAY_NONE : SP_CSS_DISPLAY_INLINE );
 192     style->display.computed = style->display.value;
 193     style->display.inherit = FALSE;
 194     updateRepr();
 195 }
 196
 197 bool SPItem::isHidden(unsigned display_key) const {
 198     for ( SPItemView *view(display) ; view ; view = view->next ) {
 199         if ( view->key == display_key ) {
 200             g_assert(view->arenaitem != NULL);
 201             for ( NRArenaItem *arenaitem = view->arenaitem ;
 202                   arenaitem ; arenaitem = arenaitem->parent )
 203             {
 204                 if (!arenaitem->visible) {
 205                     return true;
 206                 }
 207             }
 208             return false;
 209         }
 210     }
 211     return true;
 212 }
 213
 214 /**
 215  * Returns something suitable for the `Hide' checkbox in the Object Properties dialog box.
 216  *  Corresponds to setExplicitlyHidden.
 217  */
 218 bool
 219 SPItem::isExplicitlyHidden() const
 220 {
 221     return (this->style->display.set
 222             && this->style->display.value == SP_CSS_DISPLAY_NONE);
 223 }
 224
 225 /**
 226  * Sets the display CSS property to `hidden' if \a val is true,
 227  * otherwise makes it unset
 228  */
 229 void
 230 SPItem::setExplicitlyHidden(bool const val) {
 231     this->style->display.set = val;
 232     this->style->display.value = ( val ? SP_CSS_DISPLAY_NONE : SP_CSS_DISPLAY_INLINE );
 233     this->style->display.computed = this->style->display.value;
 234     this->updateRepr();
 235 }
 236
 237 /**
 238  * Sets the transform_center_x and transform_center_y properties to retain the rotation centre
 239  */
 240 void
 241 SPItem::setCenter(NR::Point object_centre) {
 242     NR::Rect bbox = invokeBbox(sp_item_i2d_affine(this));
 243     if (!bbox.isEmpty()) {
 244         transform_center_x = object_centre[NR::X] - bbox.midpoint()[NR::X];
 245         if (fabs(transform_center_x) < 1e-5) // rounding error
 246             transform_center_x = 0;
 247         transform_center_y = object_centre[NR::Y] - bbox.midpoint()[NR::Y];
 248         if (fabs(transform_center_y) < 1e-5) // rounding error
 249             transform_center_y = 0;
 250     }
 251 }
 252
 253 void
 254 SPItem::unsetCenter() {
 255     transform_center_x = 0;
 256     transform_center_y = 0;
 257 }
 258
 259 bool SPItem::isCenterSet() {
 260     return (transform_center_x != 0 || transform_center_y != 0);
 261 }
 262
 263 NR::Point SPItem::getCenter() {
 264     NR::Rect bbox = invokeBbox(sp_item_i2d_affine(this));
 265     if (!bbox.isEmpty()) {
 266         return bbox.midpoint() + NR::Point (this->transform_center_x, this->transform_center_y);
 267     } else {
 268         return NR::Point (0, 0); // something's wrong!
 269     }
 270 }
 271
 272
 273 namespace {
 274
 275 bool is_item(SPObject const &object) {
 276     return SP_IS_ITEM(&object);
 277 }
 278
 279 }
 280
 281 void SPItem::raiseToTop() {
 282     using Inkscape::Algorithms::find_last_if;
 283
 284     SPObject *topmost=find_last_if<SPObject::SiblingIterator>(
 285         SP_OBJECT_NEXT(this), NULL, &is_item
 286     );
 287     if (topmost) {
 288         Inkscape::XML::Node *repr=SP_OBJECT_REPR(this);
 289         sp_repr_parent(repr)->changeOrder(repr, SP_OBJECT_REPR(topmost));
 290     }
 291 }
 292
 293 void SPItem::raiseOne() {
 294     SPObject *next_higher=std::find_if<SPObject::SiblingIterator>(
 295         SP_OBJECT_NEXT(this), NULL, &is_item
 296     );
 297     if (next_higher) {
 298         Inkscape::XML::Node *repr=SP_OBJECT_REPR(this);
 299         Inkscape::XML::Node *ref=SP_OBJECT_REPR(next_higher);
 300         sp_repr_parent(repr)->changeOrder(repr, ref);
 301     }
 302 }
 303
 304 void SPItem::lowerOne() {
 305     using Inkscape::Util::MutableList;
 306     using Inkscape::Util::reverse_list;
 307
 308     MutableList<SPObject &> next_lower=std::find_if(
 309         reverse_list<SPObject::SiblingIterator>(
 310             SP_OBJECT_PARENT(this)->firstChild(), this
 311         ),
 312         MutableList<SPObject &>(),
 313         &is_item
 314     );
 315     if (next_lower) {
 316         ++next_lower;
 317         Inkscape::XML::Node *repr=SP_OBJECT_REPR(this);
 318         Inkscape::XML::Node *ref=( next_lower ? SP_OBJECT_REPR(&*next_lower) : NULL );
 319         sp_repr_parent(repr)->changeOrder(repr, ref);
 320     }
 321 }
 322
 323 void SPItem::lowerToBottom() {
 324     using Inkscape::Algorithms::find_last_if;
 325     using Inkscape::Util::MutableList;
 326     using Inkscape::Util::reverse_list;
 327
 328     MutableList<SPObject &> bottom=find_last_if(
 329         reverse_list<SPObject::SiblingIterator>(
 330             SP_OBJECT_PARENT(this)->firstChild(), this
 331         ),
 332         MutableList<SPObject &>(),
 333         &is_item
 334     );
 335     if (bottom) {
 336         ++bottom;
 337         Inkscape::XML::Node *repr=SP_OBJECT_REPR(this);
 338         Inkscape::XML::Node *ref=( bottom ? SP_OBJECT_REPR(&*bottom) : NULL );
 339         sp_repr_parent(repr)->changeOrder(repr, ref);
 340     }
 341 }
 342
 343 static void
 344 sp_item_build(SPObject *object, SPDocument *document, Inkscape::XML::Node *repr)
 345 {
 346     sp_object_read_attr(object, "style");
 347     sp_object_read_attr(object, "transform");
 348     sp_object_read_attr(object, "clip-path");
 349     sp_object_read_attr(object, "mask");
 350     sp_object_read_attr(object, "sodipodi:insensitive");
 351     sp_object_read_attr(object, "sodipodi:nonprintable");
 352     sp_object_read_attr(object, "inkscape:transform-center-x");
 353     sp_object_read_attr(object, "inkscape:transform-center-y");
 354     sp_object_read_attr(object, "inkscape:connector-avoid");
 355
 356     if (((SPObjectClass *) (parent_class))->build) {
 357         (* ((SPObjectClass *) (parent_class))->build)(object, document, repr);
 358     }
 359 }
 360
 361 static void
 362 sp_item_release(SPObject *object)
 363 {
 364     SPItem *item = (SPItem *) object;
 365
 366     if (item->clip_ref) {
 367         item->clip_ref->detach();
 368         delete item->clip_ref;
 369         item->clip_ref = NULL;
 370     }
 371
 372     if (item->mask_ref) {
 373         item->mask_ref->detach();
 374         delete item->mask_ref;
 375         item->mask_ref = NULL;
 376     }
 377
 378     if (item->avoidRef) {
 379         delete item->avoidRef;
 380         item->avoidRef = NULL;
 381     }
 382
 383     if (((SPObjectClass *) (parent_class))->release) {
 384         ((SPObjectClass *) parent_class)->release(object);
 385     }
 386
 387     while (item->display) {
 388         nr_arena_item_unparent(item->display->arenaitem);
 389         item->display = sp_item_view_list_remove(item->display, item->display);
 390     }
 391
 392     item->_transformed_signal.~signal();
 393 }
 394
 395 static void
 396 sp_item_set(SPObject *object, unsigned key, gchar const *value)
 397 {
 398     SPItem *item = (SPItem *) object;
 399
 400     switch (key) {
 401         case SP_ATTR_TRANSFORM: {
 402             NR::Matrix t;
 403             if (value && sp_svg_transform_read(value, &t)) {
 404                 sp_item_set_item_transform(item, t);
 405             } else {
 406                 sp_item_set_item_transform(item, NR::identity());
 407             }
 408             break;
 409         }
 410         case SP_PROP_CLIP_PATH: {
 411             gchar *uri = Inkscape::parse_css_url(value);
 412             if (uri) {
 413                 try {
 414                     item->clip_ref->attach(Inkscape::URI(uri));
 415                 } catch (Inkscape::BadURIException &e) {
 416                     g_warning("%s", e.what());
 417                     item->clip_ref->detach();
 418                 }
 419                 g_free(uri);
 420             } else {
 421                 item->clip_ref->detach();
 422             }
 423
 424             break;
 425         }
 426         case SP_PROP_MASK: {
 427             gchar *uri=Inkscape::parse_css_url(value);
 428             if (uri) {
 429                 try {
 430                     item->mask_ref->attach(Inkscape::URI(uri));
 431                 } catch (Inkscape::BadURIException &e) {
 432                     g_warning("%s", e.what());
 433                     item->mask_ref->detach();
 434                 }
 435                 g_free(uri);
 436             } else {
 437                 item->mask_ref->detach();
 438             }
 439
 440             break;
 441         }
 442         case SP_ATTR_SODIPODI_INSENSITIVE:
 443             item->sensitive = !value;
 444             for (SPItemView *v = item->display; v != NULL; v = v->next) {
 445                 nr_arena_item_set_sensitive(v->arenaitem, item->sensitive);
 446             }
 447             break;
 448         case SP_ATTR_STYLE:
 449             sp_style_read_from_object(object->style, object);
 450             object->requestDisplayUpdate(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
 451             break;
 452         case SP_ATTR_CONNECTOR_AVOID:
 453             item->avoidRef->setAvoid(value);
 454             break;
 455         case SP_ATTR_TRANSFORM_CENTER_X:
 456             if (value) {
 457                 item->transform_center_x = g_strtod(value, NULL);
 458             } else {
 459                 item->transform_center_x = 0;
 460             }
 461             break;
 462         case SP_ATTR_TRANSFORM_CENTER_Y:
 463             if (value) {
 464                 item->transform_center_y = g_strtod(value, NULL);
 465             } else {
 466                 item->transform_center_y = 0;
 467             }
 468             break;
 469         default:
 470             if (SP_ATTRIBUTE_IS_CSS(key)) {
 471                 sp_style_read_from_object(object->style, object);
 472                 object->requestDisplayUpdate(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
 473             } else {
 474                 if (((SPObjectClass *) (parent_class))->set) {
 475                     (* ((SPObjectClass *) (parent_class))->set)(object, key, value);
 476                 }
 477             }
 478             break;
 479     }
 480 }
 481
 482 static void
 483 clip_ref_changed(SPObject *old_clip, SPObject *clip, SPItem *item)
 484 {
 485     if (old_clip) {
 486         SPItemView *v;
 487         /* Hide clippath */
 488         for (v = item->display; v != NULL; v = v->next) {
 489             sp_clippath_hide(SP_CLIPPATH(old_clip), NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 490             nr_arena_item_set_clip(v->arenaitem, NULL);
 491         }
 492     }
 493     if (SP_IS_CLIPPATH(clip)) {
 494         NRRect bbox;
 495         sp_item_invoke_bbox(item, &bbox, NR::identity(), TRUE);
 496         for (SPItemView *v = item->display; v != NULL; v = v->next) {
 497             if (!v->arenaitem->key) {
 498                 NR_ARENA_ITEM_SET_KEY(v->arenaitem, sp_item_display_key_new(3));
 499             }
 500             NRArenaItem *ai = sp_clippath_show(SP_CLIPPATH(clip),
 501                                                NR_ARENA_ITEM_ARENA(v->arenaitem),
 502                                                NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 503             nr_arena_item_set_clip(v->arenaitem, ai);
 504             nr_arena_item_unref(ai);
 505             sp_clippath_set_bbox(SP_CLIPPATH(clip), NR_ARENA_ITEM_GET_KEY(v->arenaitem), &bbox);
 506         }
 507     }
 508 }
 509
 510 static void
 511 mask_ref_changed(SPObject *old_mask, SPObject *mask, SPItem *item)
 512 {
 513     if (old_mask) {
 514         /* Hide mask */
 515         for (SPItemView *v = item->display; v != NULL; v = v->next) {
 516             sp_mask_hide(SP_MASK(old_mask), NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 517             nr_arena_item_set_mask(v->arenaitem, NULL);
 518         }
 519     }
 520     if (SP_IS_MASK(mask)) {
 521         NRRect bbox;
 522         sp_item_invoke_bbox(item, &bbox, NR::identity(), TRUE);
 523         for (SPItemView *v = item->display; v != NULL; v = v->next) {
 524             if (!v->arenaitem->key) {
 525                 NR_ARENA_ITEM_SET_KEY(v->arenaitem, sp_item_display_key_new(3));
 526             }
 527             NRArenaItem *ai = sp_mask_show(SP_MASK(mask),
 528                                            NR_ARENA_ITEM_ARENA(v->arenaitem),
 529                                            NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 530             nr_arena_item_set_mask(v->arenaitem, ai);
 531             nr_arena_item_unref(ai);
 532             sp_mask_set_bbox(SP_MASK(mask), NR_ARENA_ITEM_GET_KEY(v->arenaitem), &bbox);
 533         }
 534     }
 535 }
 536
 537 static void
 538 sp_item_update(SPObject *object, SPCtx *ctx, guint flags)
 539 {
 540     SPItem *item = SP_ITEM(object);
 541
 542     if (((SPObjectClass *) (parent_class))->update)
 543         (* ((SPObjectClass *) (parent_class))->update)(object, ctx, flags);
 544
 545     if (flags & (SP_OBJECT_CHILD_MODIFIED_FLAG | SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG)) {
 546         if (flags & SP_OBJECT_MODIFIED_FLAG) {
 547             for (SPItemView *v = item->display; v != NULL; v = v->next) {
 548                 nr_arena_item_set_transform(v->arenaitem, item->transform);
 549             }
 550         }
 551
 552         SPClipPath *clip_path = item->clip_ref->getObject();
 553         SPMask *mask = item->mask_ref->getObject();
 554
 555         if ( clip_path || mask ) {
 556             NRRect bbox;
 557             sp_item_invoke_bbox(item, &bbox, NR::identity(), TRUE);
 558             if (clip_path) {
 559                 for (SPItemView *v = item->display; v != NULL; v = v->next) {
 560                     sp_clippath_set_bbox(clip_path, NR_ARENA_ITEM_GET_KEY(v->arenaitem), &bbox);
 561                 }
 562             }
 563             if (mask) {
 564                 for (SPItemView *v = item->display; v != NULL; v = v->next) {
 565                     sp_mask_set_bbox(mask, NR_ARENA_ITEM_GET_KEY(v->arenaitem), &bbox);
 566                 }
 567             }
 568         }
 569
 570         if (flags & SP_OBJECT_STYLE_MODIFIED_FLAG) {
 571             for (SPItemView *v = item->display; v != NULL; v = v->next) {
 572                 nr_arena_item_set_opacity(v->arenaitem, SP_SCALE24_TO_FLOAT(object->style->opacity.value));
 573                 nr_arena_item_set_visible(v->arenaitem, !item->isHidden());
 574             }
 575         }
 576     }
 577
 578     // Update libavoid with item geometry (for connector routing).
 579     item->avoidRef->handleSettingChange();
 580 }
 581
 582 static Inkscape::XML::Node *
 583 sp_item_write(SPObject *const object, Inkscape::XML::Node *repr, guint flags)
 584 {
 585     SPItem *item = SP_ITEM(object);
 586
 587     gchar c[256];
 588     if (sp_svg_transform_write(c, 256, item->transform)) {
 589         repr->setAttribute("transform", c);
 590     } else {
 591         repr->setAttribute("transform", NULL);
 592     }
 593
 594     SPObject const *const parent = SP_OBJECT_PARENT(object);
 595     /** \todo Can someone please document why this is conditional on having
 596      * a parent? The only parentless thing I can think of is the top-level
 597      * <svg> element (SPRoot). SPRoot is derived from SPGroup, and can have
 598      * style.  I haven't looked at callers.
 599      */
 600     if (parent) {
 601         SPStyle const *const obj_style = SP_OBJECT_STYLE(object);
 602         if (obj_style) {
 603             gchar *s = sp_style_write_string(obj_style, SP_STYLE_FLAG_IFSET);
 604             repr->setAttribute("style", ( *s ? s : NULL ));
 605             g_free(s);
 606         } else {
 607             /** \todo I'm not sure what to do in this case.  Bug #1165868
 608              * suggests that it can arise, but the submitter doesn't know
 609              * how to do so reliably.  The main two options are either
 610              * leave repr's style attribute unchanged, or explicitly clear it.
 611              * Must also consider what to do with property attributes for
 612              * the element; see below.
 613              */
 614             char const *style_str = repr->attribute("style");
 615             if (!style_str) {
 616                 style_str = "NULL";
 617             }
 618             g_warning("Item's style is NULL; repr style attribute is %s", style_str);
 619         }
 620
 621         /** \note We treat object->style as authoritative.  Its effects have
 622          * been written to the style attribute above; any properties that are
 623          * unset we take to be deliberately unset (e.g. so that clones can
 624          * override the property).
 625          *
 626          * Note that the below has an undesirable consequence of changing the
 627          * appearance on renderers that lack CSS support (e.g. SVG tiny);
 628          * possibly we should write property attributes instead of a style
 629          * attribute.
 630          */
 631         sp_style_unset_property_attrs (object);
 632     }
 633
 634     if (flags & SP_OBJECT_WRITE_EXT) {
 635         repr->setAttribute("sodipodi:insensitive", ( item->sensitive ? NULL : "true" ));
 636         if (item->transform_center_x != 0)
 637             sp_repr_set_svg_double (repr, "inkscape:transform-center-x", item->transform_center_x);
 638         else
 639             repr->setAttribute ("inkscape:transform-center-x", NULL);
 640         if (item->transform_center_y != 0)
 641             sp_repr_set_svg_double (repr, "inkscape:transform-center-y", item->transform_center_y);
 642         else
 643             repr->setAttribute ("inkscape:transform-center-y", NULL);
 644     }
 645
 646     if (((SPObjectClass *) (parent_class))->write) {
 647         ((SPObjectClass *) (parent_class))->write(object, repr, flags);
 648     }
 649
 650     return repr;
 651 }
 652
 653 NR::Rect SPItem::invokeBbox(NR::Matrix const &transform) const
 654 {
 655     NRRect r;
 656     sp_item_invoke_bbox_full(this, &r, transform, 0, TRUE);
 657     return NR::Rect(r);
 658 }
 659
 660 void
 661 sp_item_invoke_bbox(SPItem const *item, NRRect *bbox, NR::Matrix const &transform, unsigned const clear)
 662 {
 663     sp_item_invoke_bbox_full(item, bbox, transform, 0, clear);
 664 }
 665
 666 void
 667 sp_item_invoke_bbox_full(SPItem const *item, NRRect *bbox, NR::Matrix const &transform, unsigned const flags, unsigned const clear)
 668 {
 669     g_assert(item != NULL);
 670     g_assert(SP_IS_ITEM(item));
 671     g_assert(bbox != NULL);
 672
 673     if (clear) {
 674         bbox->x0 = bbox->y0 = 1e18;
 675         bbox->x1 = bbox->y1 = -1e18;
 676     }
 677
 678     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->bbox) {
 679         ((SPItemClass *) G_OBJECT_GET_CLASS(item))->bbox(item, bbox, transform, flags);
 680     }
 681 }
 682
 683 unsigned sp_item_pos_in_parent(SPItem *item)
 684 {
 685     g_assert(item != NULL);
 686     g_assert(SP_IS_ITEM(item));
 687
 688     SPObject *parent = SP_OBJECT_PARENT(item);
 689     g_assert(parent != NULL);
 690     g_assert(SP_IS_OBJECT(parent));
 691
 692     SPObject *object = SP_OBJECT(item);
 693
 694     unsigned pos=0;
 695     for ( SPObject *iter = sp_object_first_child(parent) ; iter ; iter = SP_OBJECT_NEXT(iter)) {
 696         if ( iter == object ) {
 697             return pos;
 698         }
 699         if (SP_IS_ITEM(iter)) {
 700             pos++;
 701         }
 702     }
 703
 704     g_assert_not_reached();
 705     return 0;
 706 }
 707
 708 void
 709 sp_item_bbox_desktop(SPItem *item, NRRect *bbox)
 710 {
 711     g_assert(item != NULL);
 712     g_assert(SP_IS_ITEM(item));
 713     g_assert(bbox != NULL);
 714
 715     sp_item_invoke_bbox(item, bbox, sp_item_i2d_affine(item), TRUE);
 716 }
 717
 718 NR::Rect sp_item_bbox_desktop(SPItem *item)
 719 {
 720     NRRect ret;
 721     sp_item_bbox_desktop(item, &ret);
 722     return NR::Rect(ret);
 723 }
 724
 725 static void sp_item_private_snappoints(SPItem const *item, SnapPointsIter p)
 726 {
 727     NR::Rect const bbox = item->invokeBbox(sp_item_i2d_affine(item));
 728     /* Just a pair of opposite corners of the bounding box suffices given that we don't yet
 729        support angled guide lines. */
 730
 731     *p = bbox.min();
 732     *p = bbox.max();
 733 }
 734
 735 void sp_item_snappoints(SPItem const *item, SnapPointsIter p)
 736 {
 737     g_assert (item != NULL);
 738     g_assert (SP_IS_ITEM(item));
 739
 740     SPItemClass const &item_class = *(SPItemClass const *) G_OBJECT_GET_CLASS(item);
 741     if (item_class.snappoints) {
 742         item_class.snappoints(item, p);
 743     }
 744 }
 745
 746 void
 747 sp_item_invoke_print(SPItem *item, SPPrintContext *ctx)
 748 {
 749     if (!item->isHidden()) {
 750         if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->print) {
 751             if (!item->transform.test_identity()
 752                 || SP_OBJECT_STYLE(item)->opacity.value != SP_SCALE24_MAX)
 753             {
 754                 sp_print_bind(ctx, item->transform, SP_SCALE24_TO_FLOAT(SP_OBJECT_STYLE(item)->opacity.value));
 755                 ((SPItemClass *) G_OBJECT_GET_CLASS(item))->print(item, ctx);
 756                 sp_print_release(ctx);
 757             } else {
 758                 ((SPItemClass *) G_OBJECT_GET_CLASS(item))->print(item, ctx);
 759             }
 760         }
 761     }
 762 }
 763
 764 static gchar *
 765 sp_item_private_description(SPItem *item)
 766 {
 767     return g_strdup(_("Object"));
 768 }
 769
 770 /**
 771  * Returns a string suitable for status bar, formatted in pango markup language.
 772  *
 773  * Must be freed by caller.
 774  */
 775 gchar *
 776 sp_item_description(SPItem *item)
 777 {
 778     g_assert(item != NULL);
 779     g_assert(SP_IS_ITEM(item));
 780
 781     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->description) {
 782         return ((SPItemClass *) G_OBJECT_GET_CLASS(item))->description(item);
 783     }
 784
 785     g_assert_not_reached();
 786     return NULL;
 787 }
 788
 789 /**
 790  * Allocates unique integer keys.
 791  * \param numkeys Number of keys required.
 792  * \return First allocated key; hence if the returned key is n
 793  * you can use n, n + 1, ..., n + (numkeys - 1)
 794  */
 795 unsigned
 796 sp_item_display_key_new(unsigned numkeys)
 797 {
 798     static unsigned dkey = 0;
 799
 800     dkey += numkeys;
 801
 802     return dkey - numkeys;
 803 }
 804
 805 NRArenaItem *
 806 sp_item_invoke_show(SPItem *item, NRArena *arena, unsigned key, unsigned flags)
 807 {
 808     g_assert(item != NULL);
 809     g_assert(SP_IS_ITEM(item));
 810     g_assert(arena != NULL);
 811     g_assert(NR_IS_ARENA(arena));
 812
 813     NRArenaItem *ai = NULL;
 814     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->show) {
 815         ai = ((SPItemClass *) G_OBJECT_GET_CLASS(item))->show(item, arena, key, flags);
 816     }
 817
 818     if (ai != NULL) {
 819         item->display = sp_item_view_new_prepend(item->display, item, flags, key, ai);
 820         nr_arena_item_set_transform(ai, item->transform);
 821         nr_arena_item_set_opacity(ai, SP_SCALE24_TO_FLOAT(SP_OBJECT_STYLE(item)->opacity.value));
 822         nr_arena_item_set_visible(ai, !item->isHidden());
 823         nr_arena_item_set_sensitive(ai, item->sensitive);
 824         if (item->clip_ref->getObject()) {
 825             NRArenaItem *ac;
 826             if (!item->display->arenaitem->key) NR_ARENA_ITEM_SET_KEY(item->display->arenaitem, sp_item_display_key_new(3));
 827             ac = sp_clippath_show(item->clip_ref->getObject(), arena, NR_ARENA_ITEM_GET_KEY(item->display->arenaitem));
 828             nr_arena_item_set_clip(ai, ac);
 829             nr_arena_item_unref(ac);
 830         }
 831         if (item->mask_ref->getObject()) {
 832             NRArenaItem *ac;
 833             if (!item->display->arenaitem->key) NR_ARENA_ITEM_SET_KEY(item->display->arenaitem, sp_item_display_key_new(3));
 834             ac = sp_mask_show(item->mask_ref->getObject(), arena, NR_ARENA_ITEM_GET_KEY(item->display->arenaitem));
 835             nr_arena_item_set_mask(ai, ac);
 836             nr_arena_item_unref(ac);
 837         }
 838         NR_ARENA_ITEM_SET_DATA(ai, item);
 839     }
 840
 841     return ai;
 842 }
 843
 844 void
 845 sp_item_invoke_hide(SPItem *item, unsigned key)
 846 {
 847     g_assert(item != NULL);
 848     g_assert(SP_IS_ITEM(item));
 849
 850     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->hide) {
 851         ((SPItemClass *) G_OBJECT_GET_CLASS(item))->hide(item, key);
 852     }
 853
 854     SPItemView *ref = NULL;
 855     SPItemView *v = item->display;
 856     while (v != NULL) {
 857         SPItemView *next = v->next;
 858         if (v->key == key) {
 859             if (item->clip_ref->getObject()) {
 860                 sp_clippath_hide(item->clip_ref->getObject(), NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 861                 nr_arena_item_set_clip(v->arenaitem, NULL);
 862             }
 863             if (item->mask_ref->getObject()) {
 864                 sp_mask_hide(item->mask_ref->getObject(), NR_ARENA_ITEM_GET_KEY(v->arenaitem));
 865                 nr_arena_item_set_mask(v->arenaitem, NULL);
 866             }
 867             if (!ref) {
 868                 item->display = v->next;
 869             } else {
 870                 ref->next = v->next;
 871             }
 872             nr_arena_item_unparent(v->arenaitem);
 873             nr_arena_item_unref(v->arenaitem);
 874             g_free(v);
 875         } else {
 876             ref = v;
 877         }
 878         v = next;
 879     }
 880 }
 881
 882 // Adjusters
 883
 884 void
 885 sp_item_adjust_pattern (SPItem *item, NR::Matrix const &postmul, bool set)
 886 {
 887     SPStyle *style = SP_OBJECT_STYLE (item);
 888
 889     if (style && (style->fill.type == SP_PAINT_TYPE_PAINTSERVER)) {
 890         SPObject *server = SP_OBJECT_STYLE_FILL_SERVER (item);
 891         if (SP_IS_PATTERN (server)) {
 892             SPPattern *pattern = sp_pattern_clone_if_necessary (item, SP_PATTERN (server), "fill");
 893             sp_pattern_transform_multiply (pattern, postmul, set);
 894         }
 895     }
 896
 897     if (style && (style->stroke.type == SP_PAINT_TYPE_PAINTSERVER)) {
 898         SPObject *server = SP_OBJECT_STYLE_STROKE_SERVER (item);
 899         if (SP_IS_PATTERN (server)) {
 900             SPPattern *pattern = sp_pattern_clone_if_necessary (item, SP_PATTERN (server), "stroke");
 901             sp_pattern_transform_multiply (pattern, postmul, set);
 902         }
 903     }
 904
 905 }
 906
 907 void
 908 sp_item_adjust_gradient (SPItem *item, NR::Matrix const &postmul, bool set)
 909 {
 910     SPStyle *style = SP_OBJECT_STYLE (item);
 911
 912     if (style && (style->fill.type == SP_PAINT_TYPE_PAINTSERVER)) {
 913         SPObject *server = SP_OBJECT_STYLE_FILL_SERVER(item);
 914         if (SP_IS_GRADIENT (server)) {
 915
 916             /**
 917              * \note Bbox units for a gradient are generally a bad idea because
 918              * with them, you cannot preserve the relative position of the
 919              * object and its gradient after rotation or skew. So now we
 920              * convert them to userspace units which are easy to keep in sync
 921              * just by adding the object's transform to gradientTransform.
 922              * \todo FIXME: convert back to bbox units after transforming with
 923              * the item, so as to preserve the original units.
 924              */
 925             SPGradient *gradient = sp_gradient_convert_to_userspace (SP_GRADIENT (server), item, "fill");
 926
 927             sp_gradient_transform_multiply (gradient, postmul, set);
 928         }
 929     }
 930
 931     if (style && (style->stroke.type == SP_PAINT_TYPE_PAINTSERVER)) {
 932         SPObject *server = SP_OBJECT_STYLE_STROKE_SERVER(item);
 933         if (SP_IS_GRADIENT (server)) {
 934             SPGradient *gradient = sp_gradient_convert_to_userspace (SP_GRADIENT (server), item, "stroke");
 935             sp_gradient_transform_multiply (gradient, postmul, set);
 936         }
 937     }
 938 }
 939
 940 void
 941 sp_item_adjust_stroke (SPItem *item, gdouble ex)
 942 {
 943     SPStyle *style = SP_OBJECT_STYLE (item);
 944
 945     if (style && style->stroke.type != SP_PAINT_TYPE_NONE && !NR_DF_TEST_CLOSE (ex, 1.0, NR_EPSILON)) {
 946
 947         style->stroke_width.computed *= ex;
 948         style->stroke_width.set = TRUE;
 949
 950         if (style->stroke_dash.n_dash != 0) {
 951             int i;
 952             for (i = 0; i < style->stroke_dash.n_dash; i++) {
 953                 style->stroke_dash.dash[i] *= ex;
 954             }
 955             style->stroke_dash.offset *= ex;
 956         }
 957
 958         SP_OBJECT(item)->updateRepr();
 959     }
 960 }
 961
 962 /**
 963  * Find out the inverse of previous transform of an item (from its repr)
 964  */
 965 NR::Matrix
 966 sp_item_transform_repr (SPItem *item)
 967 {
 968     NR::Matrix t_old(NR::identity());
 969     gchar const *t_attr = SP_OBJECT_REPR(item)->attribute("transform");
 970     if (t_attr) {
 971         NR::Matrix t;
 972         if (sp_svg_transform_read(t_attr, &t)) {
 973             t_old = t;
 974         }
 975     }
 976
 977     return t_old;
 978 }
 979
 980
 981 /**
 982  * Recursively scale stroke width in \a item and its children by \a expansion.
 983  */
 984 void
 985 sp_item_adjust_stroke_width_recursive(SPItem *item, double expansion)
 986 {
 987     sp_item_adjust_stroke (item, expansion);
 988
 989     for (SPObject *o = SP_OBJECT(item)->children; o != NULL; o = o->next) {
 990         if (SP_IS_ITEM(o))
 991             sp_item_adjust_stroke_width_recursive(SP_ITEM(o), expansion);
 992     }
 993 }
 994
 995 /**
 996  * Recursively adjust rx and ry of rects.
 997  */
 998 void
 999 sp_item_adjust_rects_recursive(SPItem *item, NR::Matrix advertized_transform)
1000 {
1001     if (SP_IS_RECT (item)) {
1002         sp_rect_compensate_rxry (SP_RECT(item), advertized_transform);
1003     }
1004
1005     for (SPObject *o = SP_OBJECT(item)->children; o != NULL; o = o->next) {
1006         if (SP_IS_ITEM(o))
1007             sp_item_adjust_rects_recursive(SP_ITEM(o), advertized_transform);
1008     }
1009 }
1010
1011 /**
1012  * Recursively compensate pattern or gradient transform.
1013  */
1014 void
1015 sp_item_adjust_paint_recursive (SPItem *item, NR::Matrix advertized_transform, NR::Matrix t_ancestors, bool is_pattern)
1016 {
1017 // A clone must not touch the style (it's that of its parent!) and has no children, so quit now
1018     if (item && SP_IS_USE(item))
1019         return;
1020
1021 // _Before_ full pattern/gradient transform: t_paint * t_item * t_ancestors
1022 // _After_ full pattern/gradient transform: t_paint_new * t_item * t_ancestors * advertised_transform
1023 // By equating these two expressions we get t_paint_new = t_paint * paint_delta, where:
1024     NR::Matrix t_item = sp_item_transform_repr (item);
1025     NR::Matrix paint_delta = t_item * t_ancestors * advertized_transform * t_ancestors.inverse() * t_item.inverse();
1026
1027     if (is_pattern)
1028         sp_item_adjust_pattern (item, paint_delta);
1029     else
1030         sp_item_adjust_gradient (item, paint_delta);
1031
1032 // Within text, we do not fork gradients, and so must not recurse to avoid double compensation
1033     if (item && SP_IS_TEXT(item))
1034         return;
1035
1036     for (SPObject *o = SP_OBJECT(item)->children; o != NULL; o = o->next) {
1037         if (SP_IS_ITEM(o)) {
1038 // At the level of the transformed item, t_ancestors is identity;
1039 // below it, it is the accmmulated chain of transforms from this level to the top level
1040             sp_item_adjust_paint_recursive (SP_ITEM(o), advertized_transform, t_item * t_ancestors, is_pattern);
1041         }
1042     }
1043 }
1044
1045 /**
1046  * A temporary wrapper for the next function accepting the NRMatrix
1047  * instead of NR::Matrix
1048  */
1049 void
1050 sp_item_write_transform(SPItem *item, Inkscape::XML::Node *repr, NRMatrix const *transform, NR::Matrix const *adv)
1051 {
1052     if (transform == NULL)
1053         sp_item_write_transform(item, repr, NR::identity(), adv);
1054     else
1055         sp_item_write_transform(item, repr, NR::Matrix (transform), adv);
1056 }
1057
1058 /**
1059  * Set a new transform on an object.
1060  *
1061  * Compensate for stroke scaling and gradient/pattern fill transform, if
1062  * necessary. Call the object's set_transform method if transforms are
1063  * stored optimized. Send _transformed_signal. Invoke _write method so that
1064  * the repr is updated with the new transform.
1065  */
1066 void
1067 sp_item_write_transform(SPItem *item, Inkscape::XML::Node *repr, NR::Matrix const &transform, NR::Matrix const *adv)
1068 {
1069     g_return_if_fail(item != NULL);
1070     g_return_if_fail(SP_IS_ITEM(item));
1071     g_return_if_fail(repr != NULL);
1072
1073     // calculate the relative transform, if not given by the adv attribute
1074     NR::Matrix advertized_transform;
1075     if (adv != NULL) {
1076         advertized_transform = *adv;
1077     } else {
1078         advertized_transform = sp_item_transform_repr (item).inverse() * transform;
1079     }
1080
1081      // recursively compensate for stroke scaling, depending on user preference
1082     if (prefs_get_int_attribute("options.transform", "stroke", 1) == 0) {
1083         double const expansion = 1. / NR::expansion(advertized_transform);
1084         sp_item_adjust_stroke_width_recursive(item, expansion);
1085     }
1086
1087     // recursively compensate rx/ry of a rect if requested
1088     if (prefs_get_int_attribute("options.transform", "rectcorners", 1) == 0) {
1089         sp_item_adjust_rects_recursive(item, advertized_transform);
1090     }
1091
1092     // recursively compensate pattern fill if it's not to be transformed
1093     if (prefs_get_int_attribute("options.transform", "pattern", 1) == 0) {
1094         sp_item_adjust_paint_recursive (item, advertized_transform.inverse(), NR::identity(), true);
1095     }
1096     /// \todo FIXME: add the same else branch as for gradients below, to convert patterns to userSpaceOnUse as well
1097     /// recursively compensate gradient fill if it's not to be transformed
1098     if (prefs_get_int_attribute("options.transform", "gradient", 1) == 0) {
1099         sp_item_adjust_paint_recursive (item, advertized_transform.inverse(), NR::identity(), false);
1100     } else {
1101         // this converts the gradient/pattern fill/stroke, if any, to userSpaceOnUse; we need to do
1102         // it here _before_ the new transform is set, so as to use the pre-transform bbox
1103         sp_item_adjust_paint_recursive (item, NR::identity(), NR::identity(), false);
1104     }
1105
1106     // run the object's set_transform if transforms are stored optimized
1107     gint preserve = prefs_get_int_attribute("options.preservetransform", "value", 0);
1108     NR::Matrix transform_attr (transform);
1109     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->set_transform && !preserve) {
1110         transform_attr = ((SPItemClass *) G_OBJECT_GET_CLASS(item))->set_transform(item, transform);
1111     }
1112     sp_item_set_item_transform(item, transform_attr);
1113
1114     // Note: updateRepr comes before emitting the transformed signal since
1115     // it causes clone SPUse's copy of the original object to brought up to
1116     // date with the original.  Otherwise, sp_use_bbox returns incorrect
1117     // values if called in code handling the transformed signal.
1118     SP_OBJECT(item)->updateRepr();
1119
1120     // send the relative transform with a _transformed_signal
1121     item->_transformed_signal.emit(&advertized_transform, item);
1122 }
1123
1124 gint
1125 sp_item_event(SPItem *item, SPEvent *event)
1126 {
1127     g_return_val_if_fail(item != NULL, FALSE);
1128     g_return_val_if_fail(SP_IS_ITEM(item), FALSE);
1129     g_return_val_if_fail(event != NULL, FALSE);
1130
1131     if (((SPItemClass *) G_OBJECT_GET_CLASS(item))->event)
1132         return ((SPItemClass *) G_OBJECT_GET_CLASS(item))->event(item, event);
1133
1134     return FALSE;
1135 }
1136
1137 /**
1138  * Sets item private transform (not propagated to repr), without compensating stroke widths,
1139  * gradients, patterns as sp_item_write_transform does.
1140  */
1141 void
1142 sp_item_set_item_transform(SPItem *item, NR::Matrix const &transform)
1143 {
1144     g_return_if_fail(item != NULL);
1145     g_return_if_fail(SP_IS_ITEM(item));
1146
1147     if (!matrix_equalp(transform, item->transform, NR_EPSILON)) {
1148         item->transform = transform;
1149         /* The SP_OBJECT_USER_MODIFIED_FLAG_B is used to mark the fact that it's only a
1150            transformation.  It's apparently not used anywhere else. */
1151         item->requestDisplayUpdate(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_USER_MODIFIED_FLAG_B);
1152         sp_item_rm_unsatisfied_cns(*item);
1153     }
1154 }
1155
1156
1157 /**
1158  * \pre \a ancestor really is an ancestor (\>=) of \a object, or NULL.
1159  *   ("Ancestor (\>=)" here includes as far as \a object itself.)
1160  */
1161 NR::Matrix
1162 i2anc_affine(SPObject const *object, SPObject const *const ancestor) {
1163     NR::Matrix ret(NR::identity());
1164     g_return_val_if_fail(object != NULL, ret);
1165
1166     /* stop at first non-renderable ancestor */
1167     while ( object != ancestor && SP_IS_ITEM(object) ) {
1168         if (SP_IS_ROOT(object)) {
1169             ret *= SP_ROOT(object)->c2p;
1170         }
1171         ret *= SP_ITEM(object)->transform;
1172         object = SP_OBJECT_PARENT(object);
1173     }
1174     return ret;
1175 }
1176
1177 NR::Matrix
1178 i2i_affine(SPObject const *src, SPObject const *dest) {
1179     g_return_val_if_fail(src != NULL && dest != NULL, NR::identity());
1180     SPObject const *ancestor = src->nearestCommonAncestor(dest);
1181     return i2anc_affine(src, ancestor) / i2anc_affine(dest, ancestor);
1182 }
1183
1184 NR::Matrix SPItem::getRelativeTransform(SPObject const *dest) const {
1185     return i2i_affine(this, dest);
1186 }
1187
1188 /**
1189  * Returns the accumulated transformation of the item and all its ancestors, including root's viewport.
1190  * \pre (item != NULL) and SP_IS_ITEM(item).
1191  */
1192 NR::Matrix sp_item_i2doc_affine(SPItem const *item)
1193 {
1194     return i2anc_affine(item, NULL);
1195 }
1196
1197 /**
1198  * Returns the accumulated transformation of the item and all its ancestors, but excluding root's viewport.
1199  * Used in path operations mostly.
1200  * \pre (item != NULL) and SP_IS_ITEM(item).
1201  */
1202 NR::Matrix sp_item_i2root_affine(SPItem const *item)
1203 {
1204     g_assert(item != NULL);
1205     g_assert(SP_IS_ITEM(item));
1206
1207     NR::Matrix ret(NR::identity());
1208     g_assert(ret.test_identity());
1209     while ( NULL != SP_OBJECT_PARENT(item) ) {
1210         ret *= item->transform;
1211         item = SP_ITEM(SP_OBJECT_PARENT(item));
1212     }
1213     g_assert(SP_IS_ROOT(item));
1214
1215     ret *= item->transform;
1216
1217     return ret;
1218 }
1219
1220 /* fixme: This is EVIL!!! */
1221
1222 NR::Matrix sp_item_i2d_affine(SPItem const *item)
1223 {
1224     g_assert(item != NULL);
1225     g_assert(SP_IS_ITEM(item));
1226
1227     NR::Matrix const ret( sp_item_i2doc_affine(item)
1228                           * NR::scale(1, -1)
1229                           * NR::translate(0, sp_document_height(SP_OBJECT_DOCUMENT(item))) );
1230     return ret;
1231 }
1232
1233 // same as i2d but with i2root instead of i2doc
1234 NR::Matrix sp_item_i2r_affine(SPItem const *item)
1235 {
1236     g_assert(item != NULL);
1237     g_assert(SP_IS_ITEM(item));
1238
1239     NR::Matrix const ret( sp_item_i2root_affine(item)
1240                           * NR::scale(1, -1)
1241                           * NR::translate(0, sp_document_height(SP_OBJECT_DOCUMENT(item))) );
1242     return ret;
1243 }
1244
1245 /**
1246  * Converts a matrix \a m into the desktop coords of the \a item.
1247  * Will become a noop when we eliminate the coordinate flipping.
1248  */
1249 NR::Matrix matrix_to_desktop(NR::Matrix const m, SPItem const *item)
1250 {
1251     NR::Matrix const ret(m
1252                          * NR::translate(0, -sp_document_height(SP_OBJECT_DOCUMENT(item)))
1253                          * NR::scale(1, -1));
1254     return ret;
1255 }
1256
1257 /**
1258  * Converts a matrix \a m from the desktop coords of the \a item.
1259  * Will become a noop when we eliminate the coordinate flipping.
1260  */
1261 NR::Matrix matrix_from_desktop(NR::Matrix const m, SPItem const *item)
1262 {
1263     NR::Matrix const ret(NR::scale(1, -1)
1264                          * NR::translate(0, sp_document_height(SP_OBJECT_DOCUMENT(item)))
1265                          * m);
1266     return ret;
1267 }
1268
1269 void sp_item_set_i2d_affine(SPItem *item, NR::Matrix const &i2dt)
1270 {
1271     g_return_if_fail( item != NULL );
1272     g_return_if_fail( SP_IS_ITEM(item) );
1273
1274     NR::Matrix dt2p; /* desktop to item parent transform */
1275     if (SP_OBJECT_PARENT(item)) {
1276         dt2p = sp_item_i2d_affine((SPItem *) SP_OBJECT_PARENT(item)).inverse();
1277     } else {
1278         dt2p = ( NR::translate(0, -sp_document_height(SP_OBJECT_DOCUMENT(item)))
1279                  * NR::scale(1, -1) );
1280     }
1281
1282     NR::Matrix const i2p( i2dt * dt2p );
1283     sp_item_set_item_transform(item, i2p);
1284 }
1285
1286
1287 NR::Matrix
1288 sp_item_dt2i_affine(SPItem const *item)
1289 {
1290     /* fixme: Implement the right way (Lauris) */
1291     return sp_item_i2d_affine(item).inverse();
1292 }
1293
1294 /* Item views */
1295
1296 static SPItemView *
1297 sp_item_view_new_prepend(SPItemView *list, SPItem *item, unsigned flags, unsigned key, NRArenaItem *arenaitem)
1298 {
1299     SPItemView *new_view;
1300
1301     g_assert(item != NULL);
1302     g_assert(SP_IS_ITEM(item));
1303     g_assert(arenaitem != NULL);
1304     g_assert(NR_IS_ARENA_ITEM(arenaitem));
1305
1306     new_view = g_new(SPItemView, 1);
1307
1308     new_view->next = list;
1309     new_view->flags = flags;
1310     new_view->key = key;
1311     new_view->arenaitem = nr_arena_item_ref(arenaitem);
1312
1313     return new_view;
1314 }
1315
1316 static SPItemView *
1317 sp_item_view_list_remove(SPItemView *list, SPItemView *view)
1318 {
1319     if (view == list) {
1320         list = list->next;
1321     } else {
1322         SPItemView *prev;
1323         prev = list;
1324         while (prev->next != view) prev = prev->next;
1325         prev->next = view->next;
1326     }
1327
1328     nr_arena_item_unref(view->arenaitem);
1329     g_free(view);
1330
1331     return list;
1332 }
1333
1334 /**
1335  * Return the arenaitem corresponding to the given item in the display
1336  * with the given key
1337  */
1338 NRArenaItem *
1339 sp_item_get_arenaitem(SPItem *item, unsigned key)
1340 {
1341     for ( SPItemView *iv = item->display ; iv ; iv = iv->next ) {
1342         if ( iv->key == key ) {
1343             return iv->arenaitem;
1344         }
1345     }
1346
1347     return NULL;
1348 }
1349
1350 int
1351 sp_item_repr_compare_position(SPItem *first, SPItem *second)
1352 {
1353     return sp_repr_compare_position(SP_OBJECT_REPR(first),
1354                                     SP_OBJECT_REPR(second));
1355 }
1356
1357 SPItem *
1358 sp_item_first_item_child (SPObject *obj)
1359 {
1360     for ( SPObject *iter = sp_object_first_child(obj) ; iter ; iter = SP_OBJECT_NEXT(iter)) {
1361         if (SP_IS_ITEM (iter))
1362             return SP_ITEM (iter);
1363     }
1364     return NULL;
1365 }
1366
1367
1368 /*
1369   Local Variables:
1370   mode:c++
1371   c-file-style:"stroustrup"
1372   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
1373   indent-tabs-mode:nil
1374   fill-column:99
1375   End:
1376 */
1377 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :