src/gradient-chemistry.cpp

   1 #define __SP_GRADIENT_CHEMISTRY_C__
   2
   3 /*
   4  * Various utility methods for gradients
   5  *
   6  * Authors:
   7  *   Lauris Kaplinski <lauris@kaplinski.com>
   8  *   bulia byak
   9  *   Johan Engelen <j.b.c.engelen@ewi.utwente.nl>
  10  *
  11  * Copyright (C) 2007 Johan Engelen
  12  * Copyright (C) 2001-2005 authors
  13  * Copyright (C) 2001 Ximian, Inc.
  14  *
  15  * Released under GNU GPL, read the file 'COPYING' for more information
  16  */
  17
  18
  19 #include "style.h"
  20 #include "document-private.h"
  21 #include "desktop-style.h"
  22
  23 #include "sp-gradient-reference.h"
  24 #include "sp-gradient-vector.h"
  25 #include "sp-linear-gradient.h"
  26 #include "sp-radial-gradient.h"
  27 #include "sp-stop.h"
  28 #include "widgets/gradient-vector.h"
  29
  30 #include "sp-text.h"
  31 #include "sp-tspan.h"
  32 #include <libnr/nr-matrix-fns.h>
  33 #include "xml/repr.h"
  34 #include "svg/svg.h"
  35 #include "svg/svg-color.h"
  36
  37
  38 // Terminology:
  39 //
  40 // "vector" is a gradient that has stops but not position coords. It can be referenced by one or
  41 // more privates. Objects should not refer to it directly. It has no radial/linear distinction.
  42 //
  43 // "private" is a gradient that has no stops but has position coords (e.g. center, radius etc for a
  44 // radial). It references a vector for the actual colors. Each private is only used by one
  45 // object. It is either linear or radial.
  46
  47 static void sp_gradient_repr_set_link(Inkscape::XML::Node *repr, SPGradient *gr);
  48
  49 SPGradient *
  50 sp_gradient_ensure_vector_normalized(SPGradient *gr)
  51 {
  52     g_return_val_if_fail(gr != NULL, NULL);
  53     g_return_val_if_fail(SP_IS_GRADIENT(gr), NULL);
  54
  55     /* If we are already normalized vector, just return */
  56     if (gr->state == SP_GRADIENT_STATE_VECTOR) return gr;
  57     /* Fail, if we have wrong state set */
  58     if (gr->state != SP_GRADIENT_STATE_UNKNOWN) {
  59         g_warning("file %s: line %d: Cannot normalize private gradient to vector (%s)", __FILE__, __LINE__, SP_OBJECT_ID(gr));
  60         return NULL;
  61     }
  62
  63     /* First make sure we have vector directly defined (i.e. gr has its own stops) */
  64     if (!gr->has_stops) {
  65         /* We do not have stops ourselves, so flatten stops as well */
  66         sp_gradient_ensure_vector(gr);
  67         g_assert(gr->vector.built);
  68         // this adds stops from gr->vector as children to gr
  69         sp_gradient_repr_write_vector (gr);
  70     }
  71
  72     /* If gr hrefs some other gradient, remove the href */
  73     if (gr->ref->getObject()) {
  74         /* We are hrefing someone, so require flattening */
  75         SP_OBJECT(gr)->updateRepr(((SPObject *) gr)->repr, SP_OBJECT_WRITE_EXT | SP_OBJECT_WRITE_ALL);
  76         sp_gradient_repr_set_link(SP_OBJECT_REPR(gr), NULL);
  77     }
  78
  79     /* Everything is OK, set state flag */
  80     gr->state = SP_GRADIENT_STATE_VECTOR;
  81     return gr;
  82 }
  83
  84 /**
  85  * Creates new private gradient for the given vector
  86  */
  87
  88 static SPGradient *
  89 sp_gradient_get_private_normalized(SPDocument *document, SPGradient *vector, SPGradientType type)
  90 {
  91     g_return_val_if_fail(document != NULL, NULL);
  92     g_return_val_if_fail(vector != NULL, NULL);
  93     g_return_val_if_fail(SP_IS_GRADIENT(vector), NULL);
  94     g_return_val_if_fail(SP_GRADIENT_HAS_STOPS(vector), NULL);
  95
  96     SPDefs *defs = (SPDefs *) SP_DOCUMENT_DEFS(document);
  97
  98     Inkscape::XML::Document *xml_doc = sp_document_repr_doc(document);
  99     // create a new private gradient of the requested type
 100     Inkscape::XML::Node *repr;
 101     if (type == SP_GRADIENT_TYPE_LINEAR) {
 102         repr = xml_doc->createElement("svg:linearGradient");
 103     } else {
 104         repr = xml_doc->createElement("svg:radialGradient");
 105     }
 106
 107     // privates are garbage-collectable
 108     repr->setAttribute("inkscape:collect", "always");
 109
 110     // link to vector
 111     sp_gradient_repr_set_link(repr, vector);
 112
 113     /* Append the new private gradient to defs */
 114     SP_OBJECT_REPR(defs)->appendChild(repr);
 115     Inkscape::GC::release(repr);
 116
 117     // get corresponding object
 118     SPGradient *gr = (SPGradient *) document->getObjectByRepr(repr);
 119     g_assert(gr != NULL);
 120     g_assert(SP_IS_GRADIENT(gr));
 121
 122     return gr;
 123 }
 124
 125 /**
 126 Count how many times gr is used by the styles of o and its descendants
 127 */
 128 guint
 129 count_gradient_hrefs(SPObject *o, SPGradient *gr)
 130 {
 131     if (!o)
 132         return 1;
 133
 134     guint i = 0;
 135
 136     SPStyle *style = SP_OBJECT_STYLE(o);
 137     if (style
 138         && style->fill.type == SP_PAINT_TYPE_PAINTSERVER
 139         && SP_IS_GRADIENT(SP_STYLE_FILL_SERVER(style))
 140         && SP_GRADIENT(SP_STYLE_FILL_SERVER(style)) == gr)
 141     {
 142         i ++;
 143     }
 144     if (style
 145         && style->stroke.type == SP_PAINT_TYPE_PAINTSERVER
 146         && SP_IS_GRADIENT(SP_STYLE_STROKE_SERVER(style))
 147         && SP_GRADIENT(SP_STYLE_STROKE_SERVER(style)) == gr)
 148     {
 149         i ++;
 150     }
 151
 152     for (SPObject *child = sp_object_first_child(o);
 153          child != NULL; child = SP_OBJECT_NEXT(child)) {
 154         i += count_gradient_hrefs(child, gr);
 155     }
 156
 157     return i;
 158 }
 159
 160
 161 /**
 162  * If gr has other users, create a new private; also check if gr links to vector, relink if not
 163  */
 164 SPGradient *
 165 sp_gradient_fork_private_if_necessary(SPGradient *gr, SPGradient *vector,
 166                                       SPGradientType type, SPObject *o)
 167 {
 168     g_return_val_if_fail(gr != NULL, NULL);
 169     g_return_val_if_fail(SP_IS_GRADIENT(gr), NULL);
 170
 171     // Orphaned gradient, no vector with stops at the end of the line; this used to be an assert
 172     // but i think we should not abort on this - maybe just write a validity warning into some sort
 173     // of log
 174     if (!vector || !SP_GRADIENT_HAS_STOPS(vector))
 175         return (gr);
 176
 177     // user is the object that uses this gradient; normally it's item but for tspans, we
 178     // check its ancestor text so that tspans don't get different gradients from their
 179     // texts.
 180     SPObject *user = o;
 181     while (SP_IS_TSPAN(user)) {
 182         user = SP_OBJECT_PARENT(user);
 183     }
 184
 185     // Check the number of uses of the gradient within this object;
 186     // if we are private and there are no other users,
 187     if (SP_OBJECT_HREFCOUNT(gr) <= count_gradient_hrefs(user, gr)) {
 188         // check vector
 189         if ( gr != vector && gr->ref->getObject() != vector ) {
 190             /* our href is not the vector, and vector is different from gr; relink */
 191             sp_gradient_repr_set_link(SP_OBJECT_REPR(gr), vector);
 192         }
 193         return gr;
 194     }
 195
 196     SPDocument *doc = SP_OBJECT_DOCUMENT(gr);
 197     SPObject *defs = SP_DOCUMENT_DEFS(doc);
 198
 199     if ((gr->has_stops) ||
 200         (gr->state != SP_GRADIENT_STATE_UNKNOWN) ||
 201         (SP_OBJECT_PARENT(gr) != SP_OBJECT(defs)) ||
 202         (SP_OBJECT_HREFCOUNT(gr) > 1)) {
 203         // we have to clone a fresh new private gradient for the given vector
 204
 205         // create an empty one
 206         SPGradient *gr_new = sp_gradient_get_private_normalized(doc, vector, type);
 207
 208         // copy all the attributes to it
 209         Inkscape::XML::Node *repr_new = SP_OBJECT_REPR(gr_new);
 210         Inkscape::XML::Node *repr = SP_OBJECT_REPR(gr);
 211         repr_new->setAttribute("gradientUnits", repr->attribute("gradientUnits"));
 212         repr_new->setAttribute("gradientTransform", repr->attribute("gradientTransform"));
 213         repr_new->setAttribute("spreadMethod", repr->attribute("spreadMethod"));
 214         if (SP_IS_RADIALGRADIENT(gr)) {
 215             repr_new->setAttribute("cx", repr->attribute("cx"));
 216             repr_new->setAttribute("cy", repr->attribute("cy"));
 217             repr_new->setAttribute("fx", repr->attribute("fx"));
 218             repr_new->setAttribute("fy", repr->attribute("fy"));
 219             repr_new->setAttribute("r", repr->attribute("r"));
 220         } else {
 221             repr_new->setAttribute("x1", repr->attribute("x1"));
 222             repr_new->setAttribute("y1", repr->attribute("y1"));
 223             repr_new->setAttribute("x2", repr->attribute("x2"));
 224             repr_new->setAttribute("y2", repr->attribute("y2"));
 225         }
 226
 227         return gr_new;
 228     } else {
 229         return gr;
 230     }
 231 }
 232
 233 SPGradient *
 234 sp_gradient_fork_vector_if_necessary (SPGradient *gr)
 235 {
 236     if (SP_OBJECT_HREFCOUNT(gr) > 1) {
 237         SPDocument *document = SP_OBJECT_DOCUMENT(gr);
 238
 239         Inkscape::XML::Node *repr = SP_OBJECT_REPR (gr)->duplicate();
 240         SP_OBJECT_REPR (SP_DOCUMENT_DEFS (document))->addChild(repr, NULL);
 241         SPGradient *gr_new = (SPGradient *) document->getObjectByRepr(repr);
 242         gr_new = sp_gradient_ensure_vector_normalized (gr_new);
 243         Inkscape::GC::release(repr);
 244         return gr_new;
 245     }
 246     return gr;
 247 }
 248
 249 /**
 250  * Convert an item's gradient to userspace _without_ preserving coords, setting them to defaults
 251  * instead. No forking or reapplying is done because this is only called for newly created privates.
 252  * @return The new gradient.
 253  */
 254 SPGradient *
 255 sp_gradient_reset_to_userspace (SPGradient *gr, SPItem *item)
 256 {
 257     Inkscape::XML::Node *repr = SP_OBJECT_REPR(gr);
 258
 259     // calculate the bbox of the item
 260     sp_document_ensure_up_to_date(SP_OBJECT_DOCUMENT(item));
 261     NR::Maybe<NR::Rect> bbox = item->getBounds(NR::identity()); // we need "true" bbox without item_i2d_affine
 262
 263     g_assert( bbox );
 264     NR::Coord const width = bbox->dimensions()[NR::X];
 265     NR::Coord const height = bbox->dimensions()[NR::Y];
 266
 267     NR::Point const center = bbox->midpoint();
 268
 269     if (SP_IS_RADIALGRADIENT(gr)) {
 270         sp_repr_set_svg_double(repr, "cx", center[NR::X]);
 271         sp_repr_set_svg_double(repr, "cy", center[NR::Y]);
 272         sp_repr_set_svg_double(repr, "fx", center[NR::X]);
 273         sp_repr_set_svg_double(repr, "fy", center[NR::Y]);
 274         sp_repr_set_svg_double(repr, "r", width/2);
 275
 276         // we want it to be elliptic, not circular
 277         NR::Matrix squeeze = NR::Matrix (NR::translate (-center)) *
 278             NR::Matrix (NR::scale(1, height/width)) *
 279             NR::Matrix (NR::translate (center));
 280
 281         gr->gradientTransform = squeeze;
 282         {
 283             gchar *c=sp_svg_transform_write(gr->gradientTransform);
 284             SP_OBJECT_REPR(gr)->setAttribute("gradientTransform", c);
 285             g_free(c);
 286         }
 287     } else {
 288         sp_repr_set_svg_double(repr, "x1", (center - NR::Point(width/2, 0))[NR::X]);
 289         sp_repr_set_svg_double(repr, "y1", (center - NR::Point(width/2, 0))[NR::Y]);
 290         sp_repr_set_svg_double(repr, "x2", (center + NR::Point(width/2, 0))[NR::X]);
 291         sp_repr_set_svg_double(repr, "y2", (center + NR::Point(width/2, 0))[NR::Y]);
 292     }
 293
 294     // set the gradientUnits
 295     repr->setAttribute("gradientUnits", "userSpaceOnUse");
 296
 297     return gr;
 298 }
 299
 300 /**
 301  * Convert an item's gradient to userspace if necessary, also fork it if necessary.
 302  * @return The new gradient.
 303  */
 304 SPGradient *
 305 sp_gradient_convert_to_userspace(SPGradient *gr, SPItem *item, gchar const *property)
 306 {
 307     g_return_val_if_fail(SP_IS_GRADIENT(gr), NULL);
 308
 309     // First, fork it if it is shared
 310     gr = sp_gradient_fork_private_if_necessary(gr, sp_gradient_get_vector(gr, FALSE),
 311                                                SP_IS_RADIALGRADIENT(gr) ? SP_GRADIENT_TYPE_RADIAL : SP_GRADIENT_TYPE_LINEAR, SP_OBJECT(item));
 312
 313     if (gr->units == SP_GRADIENT_UNITS_OBJECTBOUNDINGBOX) {
 314
 315         Inkscape::XML::Node *repr = SP_OBJECT_REPR(gr);
 316
 317         // calculate the bbox of the item
 318         sp_document_ensure_up_to_date(SP_OBJECT_DOCUMENT(item));
 319         NR::Matrix bbox2user;
 320         NR::Maybe<NR::Rect> bbox = item->getBounds(NR::identity()); // we need "true" bbox without item_i2d_affine
 321         if ( bbox ) {
 322             bbox2user = NR::Matrix(bbox->dimensions()[NR::X], 0,
 323                                    0, bbox->dimensions()[NR::Y],
 324                                    bbox->min()[NR::X], bbox->min()[NR::Y]);
 325         } else {
 326             // would be degenerate otherwise
 327             bbox2user = NR::identity();
 328         }
 329
 330         /* skew is the additional transform, defined by the proportions of the item, that we need
 331          * to apply to the gradient in order to work around this weird bit from SVG 1.1
 332          * (http://www.w3.org/TR/SVG11/pservers.html#LinearGradients):
 333          *
 334          *   When gradientUnits="objectBoundingBox" and gradientTransform is the identity
 335          *   matrix, the stripes of the linear gradient are perpendicular to the gradient
 336          *   vector in object bounding box space (i.e., the abstract coordinate system where
 337          *   (0,0) is at the top/left of the object bounding box and (1,1) is at the
 338          *   bottom/right of the object bounding box). When the object's bounding box is not
 339          *   square, the stripes that are conceptually perpendicular to the gradient vector
 340          *   within object bounding box space will render non-perpendicular relative to the
 341          *   gradient vector in user space due to application of the non-uniform scaling
 342          *   transformation from bounding box space to user space.
 343          */
 344         NR::Matrix skew = bbox2user;
 345         double exp = skew.expansion();
 346         skew[0] /= exp;
 347         skew[1] /= exp;
 348         skew[2] /= exp;
 349         skew[3] /= exp;
 350         skew[4] = 0;
 351         skew[5] = 0;
 352
 353         // apply skew to the gradient
 354         gr->gradientTransform = skew;
 355         {
 356             gchar *c=sp_svg_transform_write(gr->gradientTransform);
 357             SP_OBJECT_REPR(gr)->setAttribute("gradientTransform", c);
 358             g_free(c);
 359         }
 360
 361         // Matrix to convert points to userspace coords; postmultiply by inverse of skew so
 362         // as to cancel it out when it's applied to the gradient during rendering
 363         NR::Matrix point_convert = bbox2user * skew.inverse();
 364
 365         if (SP_IS_RADIALGRADIENT(gr)) {
 366             SPRadialGradient *rg = SP_RADIALGRADIENT(gr);
 367
 368             // original points in the bbox coords
 369             NR::Point c_b = NR::Point(rg->cx.computed, rg->cy.computed);
 370             NR::Point f_b = NR::Point(rg->fx.computed, rg->fy.computed);
 371             double r_b = rg->r.computed;
 372
 373             // converted points in userspace coords
 374             NR::Point c_u = c_b * point_convert;
 375             NR::Point f_u = f_b * point_convert;
 376             double r_u = r_b * point_convert.expansion();
 377
 378             sp_repr_set_svg_double(repr, "cx", c_u[NR::X]);
 379             sp_repr_set_svg_double(repr, "cy", c_u[NR::Y]);
 380             sp_repr_set_svg_double(repr, "fx", f_u[NR::X]);
 381             sp_repr_set_svg_double(repr, "fy", f_u[NR::Y]);
 382             sp_repr_set_svg_double(repr, "r", r_u);
 383
 384         } else {
 385             SPLinearGradient *lg = SP_LINEARGRADIENT(gr);
 386
 387             NR::Point p1_b = NR::Point(lg->x1.computed, lg->y1.computed);
 388             NR::Point p2_b = NR::Point(lg->x2.computed, lg->y2.computed);
 389
 390             NR::Point p1_u = p1_b * point_convert;
 391             NR::Point p2_u = p2_b * point_convert;
 392
 393             sp_repr_set_svg_double(repr, "x1", p1_u[NR::X]);
 394             sp_repr_set_svg_double(repr, "y1", p1_u[NR::Y]);
 395             sp_repr_set_svg_double(repr, "x2", p2_u[NR::X]);
 396             sp_repr_set_svg_double(repr, "y2", p2_u[NR::Y]);
 397         }
 398
 399         // set the gradientUnits
 400         repr->setAttribute("gradientUnits", "userSpaceOnUse");
 401     }
 402
 403     // apply the gradient to the item (may be necessary if we forked it); not recursive
 404     // generally because grouped items will be taken care of later (we're being called
 405     // from sp_item_adjust_paint_recursive); however text and all its children should all
 406     // refer to one gradient, hence the recursive call for text (because we can't/don't
 407     // want to access tspans and set gradients on them separately)
 408     if (SP_IS_TEXT(item))
 409         sp_style_set_property_url(SP_OBJECT(item), property, SP_OBJECT(gr), true);
 410     else
 411         sp_style_set_property_url(SP_OBJECT(item), property, SP_OBJECT(gr), false);
 412
 413     return gr;
 414 }
 415
 416 void
 417 sp_gradient_transform_multiply(SPGradient *gradient, NR::Matrix postmul, bool set)
 418 {
 419     if (set) {
 420         gradient->gradientTransform = postmul;
 421     } else {
 422         gradient->gradientTransform *= postmul; // fixme: get gradient transform by climbing to hrefs?
 423     }
 424     gradient->gradientTransform_set = TRUE;
 425
 426     gchar *c=sp_svg_transform_write(gradient->gradientTransform);
 427     SP_OBJECT_REPR(gradient)->setAttribute("gradientTransform", c);
 428     g_free(c);
 429 }
 430
 431 SPGradient *
 432 sp_item_gradient (SPItem *item, bool fill_or_stroke)
 433 {
 434     SPStyle *style = SP_OBJECT_STYLE (item);
 435     SPGradient *gradient = NULL;
 436
 437     if (fill_or_stroke) {
 438         if (style && (style->fill.type == SP_PAINT_TYPE_PAINTSERVER)) {
 439             SPObject *server = SP_OBJECT_STYLE_FILL_SERVER(item);
 440             if (SP_IS_GRADIENT (server)) {
 441                 gradient = SP_GRADIENT (server);
 442             }
 443         }
 444     } else {
 445         if (style && (style->stroke.type == SP_PAINT_TYPE_PAINTSERVER)) {
 446             SPObject *server = SP_OBJECT_STYLE_STROKE_SERVER(item);
 447             if (SP_IS_GRADIENT (server)) {
 448                 gradient = SP_GRADIENT (server);
 449             }
 450         }
 451     }
 452
 453    return gradient;
 454 }
 455
 456
 457 SPStop*
 458 sp_first_stop(SPGradient *gradient)
 459 {
 460   for (SPObject *ochild = sp_object_first_child(gradient); ochild != NULL; ochild = SP_OBJECT_NEXT(ochild)) {
 461         if (SP_IS_STOP (ochild))
 462                 return SP_STOP(ochild);
 463   }
 464   return NULL;
 465 }
 466
 467 SPStop*
 468 sp_prev_stop(SPStop *stop, SPGradient *gradient)
 469 {
 470         if (sp_object_first_child(SP_OBJECT(gradient)) == SP_OBJECT(stop))
 471                 return NULL;
 472         SPObject *found = NULL;
 473         for ( SPObject *ochild = sp_object_first_child(SP_OBJECT(gradient)) ; ochild != NULL ; ochild = SP_OBJECT_NEXT(ochild) ) {
 474                 if (SP_IS_STOP (ochild)) {
 475                         found = ochild;
 476                 }
 477                 if (SP_OBJECT_NEXT(ochild) == SP_OBJECT(stop) || SP_OBJECT(ochild) == SP_OBJECT(stop)) {
 478                         break;
 479                 }
 480         }
 481         return SP_STOP(found);
 482 }
 483
 484 SPStop*
 485 sp_next_stop(SPStop *stop)
 486 {
 487   for (SPObject *ochild = SP_OBJECT_NEXT(stop); ochild != NULL; ochild = SP_OBJECT_NEXT(ochild)) {
 488         if (SP_IS_STOP (ochild))
 489                 return SP_STOP(ochild);
 490   }
 491   return NULL;
 492 }
 493
 494 SPStop*
 495 sp_last_stop(SPGradient *gradient)
 496 {
 497     for (SPStop *stop = sp_first_stop (gradient); stop != NULL; stop = sp_next_stop (stop)) {
 498         if (sp_next_stop (stop) == NULL)
 499                 return stop;
 500   }
 501   return NULL;
 502 }
 503
 504 SPStop*
 505 sp_get_stop_i(SPGradient *gradient, guint stop_i)
 506 {
 507   SPStop *stop = sp_first_stop (gradient);
 508
 509   for (guint i=0; i < stop_i; i++) {
 510     if (!stop) return NULL;
 511     stop = sp_next_stop (stop);
 512   }
 513
 514   return stop;
 515 }
 516
 517
 518 void
 519 sp_item_gradient_edit_stop (SPItem *item, guint point_type, guint point_i, bool fill_or_stroke)
 520 {
 521     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 522
 523     if (!gradient || !SP_IS_GRADIENT(gradient))
 524         return;
 525
 526     SPGradient *vector = sp_gradient_get_vector (gradient, false);
 527     switch (point_type) {
 528         case POINT_LG_BEGIN:
 529         case POINT_RG_CENTER:
 530         case POINT_RG_FOCUS:
 531         {
 532             GtkWidget *dialog = sp_gradient_vector_editor_new (vector, sp_first_stop (vector));
 533             gtk_widget_show (dialog);
 534         }
 535         break;
 536
 537         case POINT_LG_END:
 538         case POINT_RG_R1:
 539         case POINT_RG_R2:
 540         {
 541             GtkWidget *dialog = sp_gradient_vector_editor_new (vector, sp_last_stop (vector));
 542             gtk_widget_show (dialog);
 543         }
 544         break;
 545
 546         case POINT_LG_MID:
 547         case POINT_RG_MID1:
 548         case POINT_RG_MID2:
 549         {
 550             GtkWidget *dialog = sp_gradient_vector_editor_new (vector, sp_get_stop_i (vector, point_i));
 551             gtk_widget_show (dialog);
 552         }
 553         break;
 554         default:
 555             break;
 556     }
 557 }
 558
 559 guint32
 560 sp_item_gradient_stop_query_style (SPItem *item, guint point_type, guint point_i, bool fill_or_stroke)
 561 {
 562     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 563
 564     if (!gradient || !SP_IS_GRADIENT(gradient))
 565         return 0;
 566
 567     SPGradient *vector = sp_gradient_get_vector (gradient, false);
 568
 569     if (!vector) // orphan!
 570         return 0; // what else to do?
 571
 572     switch (point_type) {
 573         case POINT_LG_BEGIN:
 574         case POINT_RG_CENTER:
 575         case POINT_RG_FOCUS:
 576         {
 577             SPStop *first = sp_first_stop (vector);
 578             if (first) {
 579                 return sp_stop_get_rgba32(first);
 580             }
 581         }
 582         break;
 583
 584         case POINT_LG_END:
 585         case POINT_RG_R1:
 586         case POINT_RG_R2:
 587         {
 588             SPStop *last = sp_last_stop (vector);
 589             if (last) {
 590                 return sp_stop_get_rgba32(last);
 591             }
 592         }
 593         break;
 594
 595         case POINT_LG_MID:
 596         case POINT_RG_MID1:
 597         case POINT_RG_MID2:
 598         {
 599             SPStop *stopi = sp_get_stop_i (vector, point_i);
 600             if (stopi) {
 601                 return sp_stop_get_rgba32(stopi);
 602             }
 603         }
 604         break;
 605
 606         default:
 607             break;
 608     }
 609     return 0;
 610 }
 611
 612 void
 613 sp_item_gradient_stop_set_style (SPItem *item, guint point_type, guint point_i, bool fill_or_stroke, SPCSSAttr *stop)
 614 {
 615     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 616
 617     if (!gradient || !SP_IS_GRADIENT(gradient))
 618         return;
 619
 620     SPGradient *vector = sp_gradient_get_vector (gradient, false);
 621
 622     if (!vector) // orphan!
 623         return;
 624
 625     vector = sp_gradient_fork_vector_if_necessary (vector);
 626     if ( gradient != vector && gradient->ref->getObject() != vector ) {
 627         sp_gradient_repr_set_link(SP_OBJECT_REPR(gradient), vector);
 628     }
 629
 630     switch (point_type) {
 631         case POINT_LG_BEGIN:
 632         case POINT_RG_CENTER:
 633         case POINT_RG_FOCUS:
 634         {
 635             SPStop *first = sp_first_stop (vector);
 636             if (first) {
 637                 sp_repr_css_change (SP_OBJECT_REPR (first), stop, "style");
 638             }
 639         }
 640         break;
 641
 642         case POINT_LG_END:
 643         case POINT_RG_R1:
 644         case POINT_RG_R2:
 645         {
 646             SPStop *last = sp_last_stop (vector);
 647             if (last) {
 648                 sp_repr_css_change (SP_OBJECT_REPR (last), stop, "style");
 649             }
 650         }
 651         break;
 652
 653         case POINT_LG_MID:
 654         case POINT_RG_MID1:
 655         case POINT_RG_MID2:
 656         {
 657             SPStop *stopi = sp_get_stop_i (vector, point_i);
 658             if (stopi) {
 659                 sp_repr_css_change (SP_OBJECT_REPR (stopi), stop, "style");
 660             }
 661         }
 662         break;
 663
 664         default:
 665             break;
 666     }
 667 }
 668
 669 void
 670 sp_item_gradient_reverse_vector (SPItem *item, bool fill_or_stroke)
 671 {
 672     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 673     if (!gradient || !SP_IS_GRADIENT(gradient))
 674         return;
 675
 676     SPGradient *vector = sp_gradient_get_vector (gradient, false);
 677     if (!vector) // orphan!
 678         return;
 679
 680     vector = sp_gradient_fork_vector_if_necessary (vector);
 681     if ( gradient != vector && gradient->ref->getObject() != vector ) {
 682         sp_gradient_repr_set_link(SP_OBJECT_REPR(gradient), vector);
 683     }
 684
 685     GSList *child_reprs = NULL;
 686     GSList *child_objects = NULL;
 687     std::vector<double> offsets;
 688     for (SPObject *child = sp_object_first_child(vector);
 689          child != NULL; child = SP_OBJECT_NEXT(child)) {
 690         child_reprs = g_slist_prepend (child_reprs, SP_OBJECT_REPR(child));
 691         child_objects = g_slist_prepend (child_objects, child);
 692         offsets.push_back(sp_repr_get_double_attribute(SP_OBJECT_REPR(child), "offset", 0));
 693     }
 694
 695     GSList *child_copies = NULL;
 696     for (GSList *i = child_reprs; i != NULL; i = i->next) {
 697         Inkscape::XML::Node *repr = (Inkscape::XML::Node *) i->data;
 698         child_copies = g_slist_append (child_copies, repr->duplicate());
 699     }
 700
 701
 702     for (GSList *i = child_objects; i != NULL; i = i->next) {
 703         SPObject *child = SP_OBJECT (i->data);
 704         child->deleteObject();
 705     }
 706
 707     std::vector<double>::iterator iter = offsets.end() - 1;
 708     for (GSList *i = child_copies; i != NULL; i = i->next) {
 709         Inkscape::XML::Node *copy = (Inkscape::XML::Node *) i->data;
 710         vector->appendChildRepr(copy);
 711         sp_repr_set_svg_double (copy, "offset", 1 - *iter);
 712         iter --;
 713         Inkscape::GC::release(copy);
 714     }
 715
 716     g_slist_free (child_reprs);
 717     g_slist_free (child_copies);
 718     g_slist_free (child_objects);
 719 }
 720
 721
 722 // FIXME: make general global function
 723 static double
 724 get_offset_between_points (NR::Point p, NR::Point begin, NR::Point end)
 725 {
 726     double length = NR::L2(end - begin);
 727     NR::Point be = (end - begin) / length;
 728     double r = NR::dot(p - begin, be);
 729
 730     if (r < 0.0) return 0.0;
 731     if (r > length) return 1.0;
 732
 733     return (r / length);
 734 }
 735
 736
 737 /**
 738 Set the position of point point_type of the gradient applied to item (either fill_or_stroke) to
 739 p_w (in desktop coordinates). Write_repr if you want the change to become permanent.
 740 */
 741 void
 742 sp_item_gradient_set_coords (SPItem *item, guint point_type, guint point_i, NR::Point p_w, bool fill_or_stroke, bool write_repr, bool scale)
 743 {
 744     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 745
 746     if (!gradient || !SP_IS_GRADIENT(gradient))
 747         return;
 748
 749     gradient = sp_gradient_convert_to_userspace (gradient, item, fill_or_stroke? "fill" : "stroke");
 750
 751     NR::Matrix i2d = sp_item_i2d_affine (item);
 752     NR::Point p = p_w * i2d.inverse();
 753     p *= (gradient->gradientTransform).inverse();
 754     // now p is in gradient's original coordinates
 755
 756     Inkscape::XML::Node *repr = SP_OBJECT_REPR(gradient);
 757
 758     if (SP_IS_LINEARGRADIENT(gradient)) {
 759         SPLinearGradient *lg = SP_LINEARGRADIENT(gradient);
 760         switch (point_type) {
 761             case POINT_LG_BEGIN:
 762                 if (scale) {
 763                     lg->x2.computed += (lg->x1.computed - p[NR::X]);
 764                     lg->y2.computed += (lg->y1.computed - p[NR::Y]);
 765                 }
 766                 lg->x1.computed = p[NR::X];
 767                 lg->y1.computed = p[NR::Y];
 768                 if (write_repr) {
 769                     if (scale) {
 770                         sp_repr_set_svg_double(repr, "x2", lg->x2.computed);
 771                         sp_repr_set_svg_double(repr, "y2", lg->y2.computed);
 772                     }
 773                     sp_repr_set_svg_double(repr, "x1", lg->x1.computed);
 774                     sp_repr_set_svg_double(repr, "y1", lg->y1.computed);
 775                 } else {
 776                     SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG);
 777                 }
 778                 break;
 779             case POINT_LG_END:
 780                 if (scale) {
 781                     lg->x1.computed += (lg->x2.computed - p[NR::X]);
 782                     lg->y1.computed += (lg->y2.computed - p[NR::Y]);
 783                 }
 784                 lg->x2.computed = p[NR::X];
 785                 lg->y2.computed = p[NR::Y];
 786                 if (write_repr) {
 787                     if (scale) {
 788                         sp_repr_set_svg_double(repr, "x1", lg->x1.computed);
 789                         sp_repr_set_svg_double(repr, "y1", lg->y1.computed);
 790                     }
 791                     sp_repr_set_svg_double(repr, "x2", lg->x2.computed);
 792                     sp_repr_set_svg_double(repr, "y2", lg->y2.computed);
 793                 } else {
 794                     SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG);
 795                 }
 796                         break;
 797             case POINT_LG_MID:
 798             {
 799                 // using X-coordinates only to determine the offset, assuming p has been snapped to the vector from begin to end.
 800                 double offset = get_offset_between_points (p, NR::Point(lg->x1.computed, lg->y1.computed), NR::Point(lg->x2.computed, lg->y2.computed));
 801                 SPGradient *vector = sp_gradient_get_vector (lg, false);
 802                 lg->vector.stops.at(point_i).offset = offset;
 803                 SPStop* stopi = sp_get_stop_i(vector, point_i);
 804                 stopi->offset = offset;
 805                 if (write_repr) {
 806                     sp_repr_set_css_double(SP_OBJECT_REPR(stopi), "offset", stopi->offset);
 807                 } else {
 808                     SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
 809                 }
 810             }
 811             break;
 812                 default:
 813                         break;
 814                 }
 815         } else if (SP_IS_RADIALGRADIENT(gradient)) {
 816
 817                 SPRadialGradient *rg = SP_RADIALGRADIENT(gradient);
 818                 NR::Point c (rg->cx.computed, rg->cy.computed);
 819                 NR::Point c_w = c * gradient->gradientTransform * i2d; // now in desktop coords
 820            if ((point_type == POINT_RG_R1 || point_type == POINT_RG_R2) && NR::L2 (p_w - c_w) < 1e-3) {
 821                // prevent setting a radius too close to the center
 822                return;
 823            }
 824                 NR::Matrix new_transform;
 825                 bool transform_set = false;
 826
 827                 switch (point_type) {
 828                 case POINT_RG_CENTER:
 829                         rg->fx.computed = p[NR::X] + (rg->fx.computed - rg->cx.computed);
 830                         rg->fy.computed = p[NR::Y] + (rg->fy.computed - rg->cy.computed);
 831                         rg->cx.computed = p[NR::X];
 832                         rg->cy.computed = p[NR::Y];
 833                         if (write_repr) {
 834                                 sp_repr_set_svg_double(repr, "fx", rg->fx.computed);
 835                                 sp_repr_set_svg_double(repr, "fy", rg->fy.computed);
 836                                 sp_repr_set_svg_double(repr, "cx", rg->cx.computed);
 837                                 sp_repr_set_svg_double(repr, "cy", rg->cy.computed);
 838                         } else {
 839                                 SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG);
 840                         }
 841                         break;
 842                 case POINT_RG_FOCUS:
 843                         rg->fx.computed = p[NR::X];
 844                         rg->fy.computed = p[NR::Y];
 845                         if (write_repr) {
 846                                 sp_repr_set_svg_double(repr, "fx", rg->fx.computed);
 847                                 sp_repr_set_svg_double(repr, "fy", rg->fy.computed);
 848                         } else {
 849                                 SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG);
 850                         }
 851                         break;
 852                 case POINT_RG_R1:
 853                         {
 854                                 NR::Point r1_w = (c + NR::Point(rg->r.computed, 0)) * gradient->gradientTransform * i2d;
 855                                 double r1_angle = NR::atan2(r1_w - c_w);
 856                                 double move_angle = NR::atan2(p_w - c_w) - r1_angle;
 857                                 double move_stretch = NR::L2(p_w - c_w) / NR::L2(r1_w - c_w);
 858
 859                                 NR::Matrix move = NR::Matrix (NR::translate (-c_w)) *
 860                                                                                                  NR::Matrix (NR::rotate(-r1_angle)) *
 861                                                                                                  NR::Matrix (NR::scale(move_stretch, scale? move_stretch : 1)) *
 862                                                                                                  NR::Matrix (NR::rotate(r1_angle)) *
 863                                                                                                  NR::Matrix (NR::rotate(move_angle)) *
 864                                                                                                  NR::Matrix (NR::translate (c_w));
 865
 866                                 new_transform = gradient->gradientTransform * i2d * move * i2d.inverse();
 867                                 transform_set = true;
 868
 869                                 break;
 870                         }
 871                 case POINT_RG_R2:
 872                         {
 873                                 NR::Point r2_w = (c + NR::Point(0, -rg->r.computed)) * gradient->gradientTransform * i2d;
 874                                 double r2_angle = NR::atan2(r2_w - c_w);
 875                                 double move_angle = NR::atan2(p_w - c_w) - r2_angle;
 876                                 double move_stretch = NR::L2(p_w - c_w) / NR::L2(r2_w - c_w);
 877
 878                                 NR::Matrix move = NR::Matrix (NR::translate (-c_w)) *
 879                                                                                                  NR::Matrix (NR::rotate(-r2_angle)) *
 880                                                                                                  NR::Matrix (NR::scale(move_stretch, scale? move_stretch : 1)) *
 881                                                                                                  NR::Matrix (NR::rotate(r2_angle)) *
 882                                                                                                  NR::Matrix (NR::rotate(move_angle)) *
 883                                                                                                  NR::Matrix (NR::translate (c_w));
 884
 885                                 new_transform = gradient->gradientTransform * i2d * move * i2d.inverse();
 886                                 transform_set = true;
 887
 888                 break;
 889             }
 890         case POINT_RG_MID1:
 891             {
 892                 NR::Point start = NR::Point (rg->cx.computed, rg->cy.computed);
 893                 NR::Point end   = NR::Point (rg->cx.computed + rg->r.computed, rg->cy.computed);
 894                 double offset = get_offset_between_points (p, start, end);
 895                 SPGradient *vector = sp_gradient_get_vector (rg, false);
 896                 rg->vector.stops.at(point_i).offset = offset;
 897                 SPStop* stopi = sp_get_stop_i(vector, point_i);
 898                 stopi->offset = offset;
 899                 if (write_repr) {
 900                     sp_repr_set_css_double(SP_OBJECT_REPR(stopi), "offset", stopi->offset);
 901                 } else {
 902                     SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
 903                 }
 904                 break;
 905             }
 906         case POINT_RG_MID2:
 907                 NR::Point start = NR::Point (rg->cx.computed, rg->cy.computed);
 908                 NR::Point end   = NR::Point (rg->cx.computed, rg->cy.computed - rg->r.computed);
 909                 double offset = get_offset_between_points (p, start, end);
 910                 SPGradient *vector = sp_gradient_get_vector (rg, false);
 911                 rg->vector.stops.at(point_i).offset = offset;
 912                 SPStop* stopi = sp_get_stop_i(vector, point_i);
 913                 stopi->offset = offset;
 914                 if (write_repr) {
 915                     sp_repr_set_css_double(SP_OBJECT_REPR(stopi), "offset", stopi->offset);
 916                 } else {
 917                     SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
 918                 }
 919                 break;
 920             }
 921                 if (transform_set) {
 922                                 gradient->gradientTransform = new_transform;
 923                                 gradient->gradientTransform_set = TRUE;
 924                                 if (write_repr) {
 925                                         gchar *s=sp_svg_transform_write(gradient->gradientTransform);
 926                                         SP_OBJECT_REPR(gradient)->setAttribute("gradientTransform", s);
 927                                         g_free(s);
 928                                 } else {
 929                                         SP_OBJECT (gradient)->requestModified(SP_OBJECT_MODIFIED_FLAG);
 930                                 }
 931                 }
 932         }
 933 }
 934
 935 SPGradient *
 936 sp_item_gradient_get_vector (SPItem *item, bool fill_or_stroke)
 937 {
 938     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 939
 940     if (gradient)
 941         return sp_gradient_get_vector (gradient, false);
 942     return NULL;
 943 }
 944
 945 SPGradientSpread
 946 sp_item_gradient_get_spread (SPItem *item, bool fill_or_stroke)
 947 {
 948     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 949
 950     if (gradient)
 951         return sp_gradient_get_spread (gradient);
 952     return SP_GRADIENT_SPREAD_PAD;
 953 }
 954
 955
 956 /**
 957 Returns the position of point point_type of the gradient applied to item (either fill_or_stroke),
 958 in desktop coordinates.
 959 */
 960
 961 NR::Point
 962 sp_item_gradient_get_coords (SPItem *item, guint point_type, guint point_i, bool fill_or_stroke)
 963 {
 964     SPGradient *gradient = sp_item_gradient (item, fill_or_stroke);
 965
 966     NR::Point p (0, 0);
 967
 968     if (!gradient)
 969         return p;
 970
 971     if (SP_IS_LINEARGRADIENT(gradient)) {
 972         SPLinearGradient *lg = SP_LINEARGRADIENT(gradient);
 973         switch (point_type) {
 974             case POINT_LG_BEGIN:
 975                 p = NR::Point (lg->x1.computed, lg->y1.computed);
 976                 break;
 977             case POINT_LG_END:
 978                 p = NR::Point (lg->x2.computed, lg->y2.computed);
 979                 break;
 980             case POINT_LG_MID:
 981                 {
 982                     gdouble offset = lg->vector.stops.at(point_i).offset;
 983                     p = (1-offset) * NR::Point(lg->x1.computed, lg->y1.computed) + offset * NR::Point(lg->x2.computed, lg->y2.computed);
 984                 }
 985                 break;
 986         }
 987     } else     if (SP_IS_RADIALGRADIENT(gradient)) {
 988         SPRadialGradient *rg = SP_RADIALGRADIENT(gradient);
 989         switch (point_type) {
 990             case POINT_RG_CENTER:
 991                 p = NR::Point (rg->cx.computed, rg->cy.computed);
 992                 break;
 993             case POINT_RG_FOCUS:
 994                 p = NR::Point (rg->fx.computed, rg->fy.computed);
 995                 break;
 996             case POINT_RG_R1:
 997                 p = NR::Point (rg->cx.computed + rg->r.computed, rg->cy.computed);
 998                 break;
 999             case POINT_RG_R2:
1000                 p = NR::Point (rg->cx.computed, rg->cy.computed - rg->r.computed);
1001                 break;
1002             case POINT_RG_MID1:
1003                 {
1004                     gdouble offset = rg->vector.stops.at(point_i).offset;
1005                     p = (1-offset) * NR::Point (rg->cx.computed, rg->cy.computed) + offset * NR::Point(rg->cx.computed + rg->r.computed, rg->cy.computed);
1006                 }
1007                 break;
1008             case POINT_RG_MID2:
1009                 {
1010                     gdouble offset = rg->vector.stops.at(point_i).offset;
1011                     p = (1-offset) * NR::Point (rg->cx.computed, rg->cy.computed) + offset * NR::Point(rg->cx.computed, rg->cy.computed - rg->r.computed);
1012                 }
1013                 break;
1014         }
1015     }
1016
1017     if (SP_GRADIENT(gradient)->units == SP_GRADIENT_UNITS_OBJECTBOUNDINGBOX) {
1018         sp_document_ensure_up_to_date(SP_OBJECT_DOCUMENT(item));
1019         NR::Maybe<NR::Rect> bbox = item->getBounds(NR::identity()); // we need "true" bbox without item_i2d_affine
1020         if (bbox) {
1021             p *= NR::Matrix(bbox->dimensions()[NR::X], 0,
1022                             0, bbox->dimensions()[NR::Y],
1023                             bbox->min()[NR::X], bbox->min()[NR::Y]);
1024         }
1025     }
1026     p *= NR::Matrix(gradient->gradientTransform) * sp_item_i2d_affine(item);
1027     return p;
1028 }
1029
1030
1031 /**
1032  * Sets item fill or stroke to the gradient of the specified type with given vector, creating
1033  * new private gradient, if needed.
1034  * gr has to be a normalized vector.
1035  */
1036
1037 SPGradient *
1038 sp_item_set_gradient(SPItem *item, SPGradient *gr, SPGradientType type, bool is_fill)
1039 {
1040     g_return_val_if_fail(item != NULL, NULL);
1041     g_return_val_if_fail(SP_IS_ITEM(item), NULL);
1042     g_return_val_if_fail(gr != NULL, NULL);
1043     g_return_val_if_fail(SP_IS_GRADIENT(gr), NULL);
1044     g_return_val_if_fail(gr->state == SP_GRADIENT_STATE_VECTOR, NULL);
1045
1046     SPStyle *style = SP_OBJECT_STYLE(item);
1047     g_assert(style != NULL);
1048
1049     guint style_type = is_fill? style->fill.type : style->stroke.type;
1050     SPPaintServer *ps = NULL;
1051     if (style_type == SP_PAINT_TYPE_PAINTSERVER)
1052         ps = is_fill? SP_STYLE_FILL_SERVER(style) : SP_STYLE_STROKE_SERVER(style);
1053
1054     if (ps
1055         && ( (type == SP_GRADIENT_TYPE_LINEAR && SP_IS_LINEARGRADIENT(ps)) ||
1056              (type == SP_GRADIENT_TYPE_RADIAL && SP_IS_RADIALGRADIENT(ps))   ) )
1057     {
1058
1059         /* Current fill style is the gradient of the required type */
1060         SPGradient *current = SP_GRADIENT(ps);
1061
1062         //g_print("hrefcount %d   count %d\n", SP_OBJECT_HREFCOUNT(ig), count_gradient_hrefs(SP_OBJECT(item), ig));
1063
1064         if (SP_OBJECT_HREFCOUNT(current) == 1 ||
1065             SP_OBJECT_HREFCOUNT(current) == count_gradient_hrefs(SP_OBJECT(item), current)) {
1066
1067             // current is private and it's either used once, or all its uses are by children of item;
1068             // so just change its href to vector
1069
1070             if ( current != gr && sp_gradient_get_vector(current, false) != gr ) {
1071                 /* href is not the vector */
1072                 sp_gradient_repr_set_link(SP_OBJECT_REPR(current), gr);
1073             }
1074             SP_OBJECT(item)->requestDisplayUpdate(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
1075             return current;
1076
1077         } else {
1078
1079             // the gradient is not private, or it is shared with someone else;
1080             // normalize it (this includes creating new private if necessary)
1081             SPGradient *normalized = sp_gradient_fork_private_if_necessary(current, gr, type, item);
1082
1083             g_return_val_if_fail(normalized != NULL, NULL);
1084
1085             if (normalized != current) {
1086
1087                 /* We have to change object style here; recursive because this is used from
1088                  * fill&stroke and must work for groups etc. */
1089                 sp_style_set_property_url(SP_OBJECT(item), is_fill? "fill" : "stroke", SP_OBJECT(normalized), true);
1090             }
1091             SP_OBJECT(item)->requestDisplayUpdate(SP_OBJECT_MODIFIED_FLAG | SP_OBJECT_STYLE_MODIFIED_FLAG);
1092             return normalized;
1093         }
1094
1095     } else {
1096         /* Current fill style is not a gradient or wrong type, so construct everything */
1097         SPGradient *constructed = sp_gradient_get_private_normalized(SP_OBJECT_DOCUMENT(item), gr, type);
1098         constructed = sp_gradient_reset_to_userspace(constructed, item);
1099         sp_style_set_property_url(SP_OBJECT(item), ( is_fill ? "fill" : "stroke" ), SP_OBJECT(constructed), true);
1100         SP_OBJECT(item)->requestDisplayUpdate(( SP_OBJECT_MODIFIED_FLAG |
1101                                                 SP_OBJECT_STYLE_MODIFIED_FLAG ));
1102         return constructed;
1103     }
1104 }
1105
1106 static void
1107 sp_gradient_repr_set_link(Inkscape::XML::Node *repr, SPGradient *link)
1108 {
1109     g_return_if_fail(repr != NULL);
1110     g_return_if_fail(link != NULL);
1111     g_return_if_fail(SP_IS_GRADIENT(link));
1112
1113     gchar *ref;
1114     if (link) {
1115         gchar const *id = SP_OBJECT_ID(link);
1116         size_t const len = strlen(id);
1117         ref = (gchar*) alloca(len + 2);
1118         *ref = '#';
1119         memcpy(ref + 1, id, len + 1);
1120     } else {
1121         ref = NULL;
1122     }
1123
1124     repr->setAttribute("xlink:href", ref);
1125 }
1126
1127 /*
1128  * Get default normalized gradient vector of document, create if there is none
1129  */
1130
1131 SPGradient *
1132 sp_document_default_gradient_vector(SPDocument *document, guint32 color)
1133 {
1134     SPDefs *defs = (SPDefs *) SP_DOCUMENT_DEFS(document);
1135     Inkscape::XML::Document *xml_doc = sp_document_repr_doc(document);
1136
1137     Inkscape::XML::Node *repr = xml_doc->createElement("svg:linearGradient");
1138
1139     repr->setAttribute("inkscape:collect", "always");
1140     // set here, but removed when it's edited in the gradient editor
1141     // to further reduce clutter, we could
1142     // (1) here, search gradients by color and return what is found without duplication
1143     // (2) in fill & stroke, show only one copy of each gradient in list
1144
1145     Inkscape::XML::Node *stop = xml_doc->createElement("svg:stop");
1146
1147     gchar b[64];
1148     sp_svg_write_color(b, 64, color);
1149
1150     {
1151         gchar *t = g_strdup_printf("stop-color:%s;stop-opacity:1;", b);
1152         stop->setAttribute("style", t);
1153         g_free(t);
1154     }
1155
1156     stop->setAttribute("offset", "0");
1157
1158     repr->appendChild(stop);
1159     Inkscape::GC::release(stop);
1160
1161     stop = xml_doc->createElement("svg:stop");
1162
1163     {
1164         gchar *t = g_strdup_printf("stop-color:%s;stop-opacity:0;", b);
1165         stop->setAttribute("style", t);
1166         g_free(t);
1167     }
1168
1169     stop->setAttribute("offset", "1");
1170
1171     repr->appendChild(stop);
1172     Inkscape::GC::release(stop);
1173
1174     SP_OBJECT_REPR(defs)->addChild(repr, NULL);
1175     Inkscape::GC::release(repr);
1176
1177     /* fixme: This does not look like nice */
1178     SPGradient *gr;
1179     gr = (SPGradient *) document->getObjectByRepr(repr);
1180     g_assert(gr != NULL);
1181     g_assert(SP_IS_GRADIENT(gr));
1182     /* fixme: Maybe add extra sanity check here */
1183     gr->state = SP_GRADIENT_STATE_VECTOR;
1184
1185     return gr;
1186 }
1187
1188 /**
1189 Return the preferred vector for \a o, made from (in order of preference) its current vector,
1190 current fill or stroke color, or from desktop style if \a o is NULL or doesn't have style.
1191 */
1192 SPGradient *
1193 sp_gradient_vector_for_object(SPDocument *const doc, SPDesktop *const desktop,
1194                               SPObject *const o, bool const is_fill)
1195 {
1196     guint32 rgba = 0;
1197     if (o == NULL || SP_OBJECT_STYLE(o) == NULL) {
1198         rgba = sp_desktop_get_color(desktop, is_fill);
1199     } else {
1200         // take the color of the object
1201         SPStyle const &style = *SP_OBJECT_STYLE(o);
1202         SPIPaint const &paint = ( is_fill
1203                                   ? style.fill
1204                                   : style.stroke );
1205         if (paint.type == SP_PAINT_TYPE_COLOR) {
1206             rgba = sp_color_get_rgba32_ualpha(&paint.value.color, 0xff);
1207         } else if (paint.type == SP_PAINT_TYPE_PAINTSERVER) {
1208             SPObject *server = is_fill? SP_OBJECT_STYLE_FILL_SERVER(o) : SP_OBJECT_STYLE_STROKE_SERVER(o);
1209             if (SP_IS_GRADIENT (server)) {
1210                 return sp_gradient_get_vector(SP_GRADIENT (server), TRUE);
1211             } else {
1212                 rgba = sp_desktop_get_color(desktop, is_fill);
1213             }
1214         } else {
1215             // if o doesn't use flat color, then take current color of the desktop.
1216             rgba = sp_desktop_get_color(desktop, is_fill);
1217         }
1218     }
1219
1220     return sp_document_default_gradient_vector(doc, rgba);
1221 }
1222
1223
1224 SPGradient *
1225 sp_gradient_get_forked_vector_if_necessary(SPGradient *gradient, bool force_vector)
1226 {
1227     SPGradient *vector = sp_gradient_get_vector (gradient, force_vector);
1228     vector = sp_gradient_fork_vector_if_necessary (vector);
1229     if ( gradient != vector && gradient->ref->getObject() != vector ) {
1230         sp_gradient_repr_set_link(SP_OBJECT_REPR(gradient), vector);
1231     }
1232     return vector;
1233 }
1234
1235 /*
1236   Local Variables:
1237   mode:c++
1238   c-file-style:"stroustrup"
1239   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
1240   indent-tabs-mode:nil
1241   fill-column:99
1242   End:
1243 */
1244 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :