Code

Remove the misfeature of retracting handles when the cusp node button
[inkscape.git] / src / ui / tool / node.cpp
1 /** @file
2  * Editable node - implementation
3  */
4 /* Authors:
5  *   Krzysztof Kosiński <tweenk.pl@gmail.com>
6  *
7  * Copyright (C) 2009 Authors
8  * Released under GNU GPL, read the file 'COPYING' for more information
9  */
11 #include <iostream>
12 #include <stdexcept>
13 #include <boost/utility.hpp>
14 #include <glib.h>
15 #include <glib/gi18n.h>
16 #include <2geom/bezier-utils.h>
17 #include <2geom/transforms.h>
19 #include "display/sp-ctrlline.h"
20 #include "display/sp-canvas.h"
21 #include "display/sp-canvas-util.h"
22 #include "desktop.h"
23 #include "desktop-handles.h"
24 #include "preferences.h"
25 #include "snap.h"
26 #include "snap-preferences.h"
27 #include "sp-metrics.h"
28 #include "sp-namedview.h"
29 #include "ui/tool/control-point-selection.h"
30 #include "ui/tool/event-utils.h"
31 #include "ui/tool/multi-path-manipulator.h"
32 #include "ui/tool/node.h"
33 #include "ui/tool/path-manipulator.h"
35 namespace Inkscape {
36 namespace UI {
38 static SelectableControlPoint::ColorSet node_colors = {
39     {
40         {0xbfbfbf00, 0x000000ff}, // normal fill, stroke
41         {0xff000000, 0x000000ff}, // mouseover fill, stroke
42         {0xff000000, 0x000000ff}  // clicked fill, stroke
43     },
44     {0x0000ffff, 0x000000ff}, // normal fill, stroke when selected
45     {0xff000000, 0x000000ff}, // mouseover fill, stroke when selected
46     {0xff000000, 0x000000ff}  // clicked fill, stroke when selected
47 };
49 static ControlPoint::ColorSet handle_colors = {
50     {0xffffffff, 0x000000ff}, // normal fill, stroke
51     {0xff000000, 0x000000ff}, // mouseover fill, stroke
52     {0xff000000, 0x000000ff}  // clicked fill, stroke
53 };
55 std::ostream &operator<<(std::ostream &out, NodeType type)
56 {
57     switch(type) {
58     case NODE_CUSP: out << 'c'; break;
59     case NODE_SMOOTH: out << 's'; break;
60     case NODE_AUTO: out << 'a'; break;
61     case NODE_SYMMETRIC: out << 'z'; break;
62     default: out << 'b'; break;
63     }
64     return out;
65 }
67 /** Computes an unit vector of the direction from first to second control point */
68 static Geom::Point direction(Geom::Point const &first, Geom::Point const &second) {
69     return Geom::unit_vector(second - first);
70 }
72 /**
73  * @class Handle
74  * @brief Control point of a cubic Bezier curve in a path.
75  *
76  * Handle keeps the node type invariant only for the opposite handle of the same node.
77  * Keeping the invariant on node moves is left to the %Node class.
78  */
80 Geom::Point Handle::_saved_other_pos(0, 0);
81 double Handle::_saved_length = 0.0;
82 bool Handle::_drag_out = false;
84 Handle::Handle(NodeSharedData const &data, Geom::Point const &initial_pos, Node *parent)
85     : ControlPoint(data.desktop, initial_pos, Gtk::ANCHOR_CENTER, SP_CTRL_SHAPE_CIRCLE, 7.0,
86         &handle_colors, data.handle_group)
87     , _parent(parent)
88     , _degenerate(true)
89 {
90     _cset = &handle_colors;
91     _handle_line = sp_canvas_item_new(data.handle_line_group, SP_TYPE_CTRLLINE, NULL);
92     setVisible(false);
93 }
94 Handle::~Handle()
95 {
96     //sp_canvas_item_hide(_handle_line);
97     gtk_object_destroy(GTK_OBJECT(_handle_line));
98 }
100 void Handle::setVisible(bool v)
102     ControlPoint::setVisible(v);
103     if (v) sp_canvas_item_show(_handle_line);
104     else sp_canvas_item_hide(_handle_line);
107 void Handle::move(Geom::Point const &new_pos)
109     Handle *other = this->other();
110     Node *node_towards = _parent->nodeToward(this); // node in direction of this handle
111     Node *node_away = _parent->nodeAwayFrom(this); // node in the opposite direction
112     Handle *towards = node_towards ? node_towards->handleAwayFrom(_parent) : NULL;
113     Handle *towards_second = node_towards ? node_towards->handleToward(_parent) : NULL;
115     if (Geom::are_near(new_pos, _parent->position())) {
116         // The handle becomes degenerate. If the segment between it and the node
117         // in its direction becomes linear and there are smooth nodes
118         // at its ends, make their handles colinear with the segment
119         if (towards && towards->isDegenerate()) {
120             if (node_towards->type() == NODE_SMOOTH) {
121                 towards_second->setDirection(*_parent, *node_towards);
122             }
123             if (_parent->type() == NODE_SMOOTH) {
124                 other->setDirection(*node_towards, *_parent);
125             }
126         }
127         setPosition(new_pos);
128         return;
129     }
131     if (_parent->type() == NODE_SMOOTH && Node::_is_line_segment(_parent, node_away)) {
132         // restrict movement to the line joining the nodes
133         Geom::Point direction = _parent->position() - node_away->position();
134         Geom::Point delta = new_pos - _parent->position();
135         // project the relative position on the direction line
136         Geom::Point new_delta = (Geom::dot(delta, direction)
137             / Geom::L2sq(direction)) * direction;
138         setRelativePos(new_delta);
139         return;
140     }
142     switch (_parent->type()) {
143     case NODE_AUTO:
144         _parent->setType(NODE_SMOOTH, false);
145         // fall through - auto nodes degrade into smooth nodes
146     case NODE_SMOOTH: {
147         /* for smooth nodes, we need to rotate the other handle so that it's colinear
148          * with the dragged one while conserving length. */
149         other->setDirection(new_pos, *_parent);
150         } break;
151     case NODE_SYMMETRIC:
152         // for symmetric nodes, place the other handle on the opposite side
153         other->setRelativePos(-(new_pos - _parent->position()));
154         break;
155     default: break;
156     }
158     setPosition(new_pos);
161 void Handle::setPosition(Geom::Point const &p)
163     ControlPoint::setPosition(p);
164     sp_ctrlline_set_coords(SP_CTRLLINE(_handle_line), _parent->position(), position());
166     // update degeneration info and visibility
167     if (Geom::are_near(position(), _parent->position()))
168         _degenerate = true;
169     else _degenerate = false;
170     if (_parent->_handles_shown && _parent->visible() && !_degenerate) {
171         setVisible(true);
172     } else {
173         setVisible(false);
174     }
175     // If both handles become degenerate, convert to parent cusp node
176     if (_parent->isDegenerate()) {
177         _parent->setType(NODE_CUSP, false);
178     }
181 void Handle::setLength(double len)
183     if (isDegenerate()) return;
184     Geom::Point dir = Geom::unit_vector(relativePos());
185     setRelativePos(dir * len);
188 void Handle::retract()
190     setPosition(_parent->position());
193 void Handle::setDirection(Geom::Point const &from, Geom::Point const &to)
195     setDirection(to - from);
198 void Handle::setDirection(Geom::Point const &dir)
200     Geom::Point unitdir = Geom::unit_vector(dir);
201     setRelativePos(unitdir * length());
204 char const *Handle::handle_type_to_localized_string(NodeType type)
206     switch(type) {
207     case NODE_CUSP: return _("Cusp node handle");
208     case NODE_SMOOTH: return _("Smooth node handle");
209     case NODE_SYMMETRIC: return _("Symmetric node handle");
210     case NODE_AUTO: return _("Auto-smooth node handle");
211     default: return "";
212     }
215 bool Handle::grabbed(GdkEventMotion *)
217     _saved_other_pos = other()->position();
218     _saved_length = _drag_out ? 0 : length();
219     _pm()._handleGrabbed();
220     return false;
223 void Handle::dragged(Geom::Point &new_pos, GdkEventMotion *event)
225     Geom::Point parent_pos = _parent->position();
226     Geom::Point origin = _last_drag_origin();
227     SnapManager &sm = _desktop->namedview->snap_manager;
228     bool snap = sm.someSnapperMightSnap();
230     // with Alt, preserve length
231     if (held_alt(*event)) {
232         new_pos = parent_pos + Geom::unit_vector(new_pos - parent_pos) * _saved_length;
233         snap = false;
234     }
235     // with Ctrl, constrain to M_PI/rotationsnapsperpi increments from vertical
236     // and the original position.
237     if (held_control(*event)) {
238         Inkscape::Preferences *prefs = Inkscape::Preferences::get();
239         int snaps = 2 * prefs->getIntLimited("/options/rotationsnapsperpi/value", 12, 1, 1000);
241         // note: if snapping to the original position is only desired in the original
242         // direction of the handle, change to Ray instead of Line
243         Geom::Line original_line(parent_pos, origin);
244         Geom::Point snap_pos = parent_pos + Geom::constrain_angle(
245             Geom::Point(0,0), new_pos - parent_pos, snaps, Geom::Point(1,0));
246         Geom::Point orig_pos = original_line.pointAt(original_line.nearestPoint(new_pos));
248         if (Geom::distance(snap_pos, new_pos) < Geom::distance(orig_pos, new_pos)) {
249             new_pos = snap_pos;
250         } else {
251             new_pos = orig_pos;
252         }
253         snap = false;
254     }
256     std::vector<Inkscape::SnapCandidatePoint> unselected;
257     if (snap) {
258         typedef ControlPointSelection::Set Set;
259         Set &nodes = _parent->_selection.allPoints();
260         for (Set::iterator i = nodes.begin(); i != nodes.end(); ++i) {
261             Node *n = static_cast<Node*>(*i);
262             Inkscape::SnapCandidatePoint p(n->position(), n->_snapSourceType(), n->_snapTargetType());
263             unselected.push_back(p);
264         }
265         sm.setupIgnoreSelection(_desktop, true, &unselected);
267         Node *node_away = (this == &_parent->_front ? _parent->_prev() : _parent->_next());
268         if (_parent->type() == NODE_SMOOTH && Node::_is_line_segment(_parent, node_away)) {
269             Inkscape::Snapper::SnapConstraint cl(_parent->position(),
270                 _parent->position() - node_away->position());
271             Inkscape::SnappedPoint p;
272             p = sm.constrainedSnap(Inkscape::SnapCandidatePoint(new_pos, SNAPSOURCE_NODE_HANDLE), cl);
273             new_pos = p.getPoint();
274         } else {
275             sm.freeSnapReturnByRef(new_pos, SNAPSOURCE_NODE_HANDLE);
276         }
277         sm.unSetup();
278     }
281     // with Shift, if the node is cusp, rotate the other handle as well
282     if (_parent->type() == NODE_CUSP && !_drag_out) {
283         if (held_shift(*event)) {
284             Geom::Point other_relpos = _saved_other_pos - parent_pos;
285             other_relpos *= Geom::Rotate(Geom::angle_between(origin - parent_pos, new_pos - parent_pos));
286             other()->setRelativePos(other_relpos);
287         } else {
288             // restore the position
289             other()->setPosition(_saved_other_pos);
290         }
291     }
292     move(new_pos); // needed for correct update, even though it's redundant
293     _pm().update();
296 void Handle::ungrabbed(GdkEventButton *event)
298     // hide the handle if it's less than dragtolerance away from the node
299     // TODO is this actually desired?
300     Inkscape::Preferences *prefs = Inkscape::Preferences::get();
301     int drag_tolerance = prefs->getIntLimited("/options/dragtolerance/value", 0, 0, 100);
303     Geom::Point dist = _desktop->d2w(_parent->position()) - _desktop->d2w(position());
304     if (dist.length() <= drag_tolerance) {
305         move(_parent->position());
306     }
308     // HACK: If the handle was dragged out, call parent's ungrabbed handler,
309     // so that transform handles reappear
310     if (_drag_out) {
311         _parent->ungrabbed(event);
312     }
313     _drag_out = false;
315     _pm()._handleUngrabbed();
318 bool Handle::clicked(GdkEventButton *event)
320     _pm()._handleClicked(this, event);
321     return true;
324 Handle *Handle::other()
326     if (this == &_parent->_front) return &_parent->_back;
327     return &_parent->_front;
330 static double snap_increment_degrees() {
331     Inkscape::Preferences *prefs = Inkscape::Preferences::get();
332     int snaps = prefs->getIntLimited("/options/rotationsnapsperpi/value", 12, 1, 1000);
333     return 180.0 / snaps;
336 Glib::ustring Handle::_getTip(unsigned state)
338     char const *more;
339     bool can_shift_rotate = _parent->type() == NODE_CUSP && !other()->isDegenerate();
340     if (can_shift_rotate) {
341         more = C_("Path handle tip", "more: Shift, Ctrl, Alt");
342     } else {
343         more = C_("Path handle tip", "more: Ctrl, Alt");
344     }
345     if (state_held_alt(state)) {
346         if (state_held_control(state)) {
347             if (state_held_shift(state) && can_shift_rotate) {
348                 return format_tip(C_("Path handle tip",
349                     "<b>Shift+Ctrl+Alt</b>: preserve length and snap rotation angle to %g° "
350                     "increments while rotating both handles"),
351                     snap_increment_degrees());
352             } else {
353                 return format_tip(C_("Path handle tip",
354                     "<b>Ctrl+Alt</b>: preserve length and snap rotation angle to %g° increments"),
355                     snap_increment_degrees());
356             }
357         } else {
358             if (state_held_shift(state) && can_shift_rotate) {
359                 return C_("Path handle tip",
360                     "<b>Shift+Alt</b>: preserve handle length and rotate both handles");
361             } else {
362                 return C_("Path handle tip",
363                     "<b>Alt</b>: preserve handle length while dragging");
364             }
365         }
366     } else {
367         if (state_held_control(state)) {
368             if (state_held_shift(state) && can_shift_rotate) {
369                 return format_tip(C_("Path handle tip",
370                     "<b>Shift+Ctrl</b>: snap rotation angle to %g° increments and rotate both handles"),
371                     snap_increment_degrees());
372             } else {
373                 return format_tip(C_("Path handle tip",
374                     "<b>Ctrl</b>: snap rotation angle to %g° increments, click to retract"),
375                     snap_increment_degrees());
376             }
377         } else if (state_held_shift(state) && can_shift_rotate) {
378             return C_("Path hande tip",
379                 "<b>Shift</b>: rotate both handles by the same angle");
380         }
381     }
383     switch (_parent->type()) {
384     case NODE_AUTO:
385         return format_tip(C_("Path handle tip",
386             "<b>Auto node handle</b>: drag to convert to smooth node (%s)"), more);
387     default:
388         return format_tip(C_("Path handle tip",
389             "<b>%s</b>: drag to shape the segment (%s)"),
390             handle_type_to_localized_string(_parent->type()), more);
391     }
394 Glib::ustring Handle::_getDragTip(GdkEventMotion */*event*/)
396     Geom::Point dist = position() - _last_drag_origin();
397     // report angle in mathematical convention
398     double angle = Geom::angle_between(Geom::Point(-1,0), position() - _parent->position());
399     angle += M_PI; // angle is (-M_PI...M_PI] - offset by +pi and scale to 0...360
400     angle *= 360.0 / (2 * M_PI);
401     GString *x = SP_PX_TO_METRIC_STRING(dist[Geom::X], _desktop->namedview->getDefaultMetric());
402     GString *y = SP_PX_TO_METRIC_STRING(dist[Geom::Y], _desktop->namedview->getDefaultMetric());
403     GString *len = SP_PX_TO_METRIC_STRING(length(), _desktop->namedview->getDefaultMetric());
404     Glib::ustring ret = format_tip(C_("Path handle tip",
405         "Move handle by %s, %s; angle %.2f°, length %s"), x->str, y->str, angle, len->str);
406     g_string_free(x, TRUE);
407     g_string_free(y, TRUE);
408     g_string_free(len, TRUE);
409     return ret;
412 /**
413  * @class Node
414  * @brief Curve endpoint in an editable path.
415  *
416  * The method move() keeps node type invariants during translations.
417  */
419 Node::Node(NodeSharedData const &data, Geom::Point const &initial_pos)
420     : SelectableControlPoint(data.desktop, initial_pos, Gtk::ANCHOR_CENTER,
421         SP_CTRL_SHAPE_DIAMOND, 9.0, *data.selection, &node_colors, data.node_group)
422     , _front(data, initial_pos, this)
423     , _back(data, initial_pos, this)
424     , _type(NODE_CUSP)
425     , _handles_shown(false)
427     // NOTE we do not set type here, because the handles are still degenerate
430 // NOTE: not using iterators won't make this much quicker because iterators can be 100% inlined.
431 Node *Node::_next()
433     NodeList::iterator n = NodeList::get_iterator(this).next();
434     if (n) return n.ptr();
435     return NULL;
437 Node *Node::_prev()
439     NodeList::iterator p = NodeList::get_iterator(this).prev();
440     if (p) return p.ptr();
441     return NULL;
444 void Node::move(Geom::Point const &new_pos)
446     // move handles when the node moves.
447     Geom::Point old_pos = position();
448     Geom::Point delta = new_pos - position();
449     setPosition(new_pos);
450     _front.setPosition(_front.position() + delta);
451     _back.setPosition(_back.position() + delta);
453     // if the node has a smooth handle after a line segment, it should be kept colinear
454     // with the segment
455     _fixNeighbors(old_pos, new_pos);
458 void Node::transform(Geom::Matrix const &m)
460     Geom::Point old_pos = position();
461     setPosition(position() * m);
462     _front.setPosition(_front.position() * m);
463     _back.setPosition(_back.position() * m);
465     /* Affine transforms keep handle invariants for smooth and symmetric nodes,
466      * but smooth nodes at ends of linear segments and auto nodes need special treatment */
467     _fixNeighbors(old_pos, position());
470 Geom::Rect Node::bounds()
472     Geom::Rect b(position(), position());
473     b.expandTo(_front.position());
474     b.expandTo(_back.position());
475     return b;
478 void Node::_fixNeighbors(Geom::Point const &old_pos, Geom::Point const &new_pos)
480     /* This method restores handle invariants for neighboring nodes,
481      * and invariants that are based on positions of those nodes for this one. */
483     /* Fix auto handles */
484     if (_type == NODE_AUTO) _updateAutoHandles();
485     if (old_pos != new_pos) {
486         if (_next() && _next()->_type == NODE_AUTO) _next()->_updateAutoHandles();
487         if (_prev() && _prev()->_type == NODE_AUTO) _prev()->_updateAutoHandles();
488     }
490     /* Fix smooth handles at the ends of linear segments.
491      * Rotate the appropriate handle to be colinear with the segment.
492      * If there is a smooth node at the other end of the segment, rotate it too. */
493     Handle *handle, *other_handle;
494     Node *other;
495     if (_is_line_segment(this, _next())) {
496         handle = &_back;
497         other = _next();
498         other_handle = &_next()->_front;
499     } else if (_is_line_segment(_prev(), this)) {
500         handle = &_front;
501         other = _prev();
502         other_handle = &_prev()->_back;
503     } else return;
505     if (_type == NODE_SMOOTH && !handle->isDegenerate()) {
506         handle->setDirection(other->position(), new_pos);
507     }
508     // also update the handle on the other end of the segment
509     if (other->_type == NODE_SMOOTH && !other_handle->isDegenerate()) {
510         other_handle->setDirection(new_pos, other->position());
511     }
514 void Node::_updateAutoHandles()
516     // Recompute the position of automatic handles.
517     // For endnodes, retract both handles. (It's only possible to create an end auto node
518     // through the XML editor.)
519     if (isEndNode()) {
520         _front.retract();
521         _back.retract();
522         return;
523     }
525     // Auto nodes automaticaly adjust their handles to give an appearance of smoothness,
526     // no matter what their surroundings are.
527     Geom::Point vec_next = _next()->position() - position();
528     Geom::Point vec_prev = _prev()->position() - position();
529     double len_next = vec_next.length(), len_prev = vec_prev.length();
530     if (len_next > 0 && len_prev > 0) {
531         // "dir" is an unit vector perpendicular to the bisector of the angle created
532         // by the previous node, this auto node and the next node.
533         Geom::Point dir = Geom::unit_vector((len_prev / len_next) * vec_next - vec_prev);
534         // Handle lengths are equal to 1/3 of the distance from the adjacent node.
535         _back.setRelativePos(-dir * (len_prev / 3));
536         _front.setRelativePos(dir * (len_next / 3));
537     } else {
538         // If any of the adjacent nodes coincides, retract both handles.
539         _front.retract();
540         _back.retract();
541     }
544 void Node::showHandles(bool v)
546     _handles_shown = v;
547     if (!_front.isDegenerate()) _front.setVisible(v);
548     if (!_back.isDegenerate()) _back.setVisible(v);
551 /** Sets the node type and optionally restores the invariants associated with the given type.
552  * @param type The type to set
553  * @param update_handles Whether to restore invariants associated with the given type.
554  *                       Passing false is useful e.g. wen initially creating the path,
555  *                       and when making cusp nodes during some node algorithms.
556  *                       Pass true when used in response to an UI node type button.
557  */
558 void Node::setType(NodeType type, bool update_handles)
560     if (type == NODE_PICK_BEST) {
561         pickBestType();
562         updateState(); // The size of the control might have changed
563         return;
564     }
566     // if update_handles is true, adjust handle positions to match the node type
567     // handle degenerate handles appropriately
568     if (update_handles) {
569         switch (type) {
570         case NODE_CUSP:
571             // if the existing type is also NODE_CUSP, retract handles
572             // NOTE: This misfeature is very annoying when you have both cusp and smooth
573             //       nodes in a selection, so I have removed it. Use segment commands
574             //       or Ctrl+click to retract handles.
575             //if (_type == NODE_CUSP) {
576             //    _front.retract();
577             //    _back.retract();
578             //}
579             break;
580         case NODE_AUTO:
581             // auto handles make no sense for endnodes
582             if (isEndNode()) return;
583             _updateAutoHandles();
584             break;
585         case NODE_SMOOTH: {
586             // ignore attempts to make smooth endnodes.
587             if (isEndNode()) return;
588             // rotate handles to be colinear
589             // for degenerate nodes set positions like auto handles
590             bool prev_line = _is_line_segment(_prev(), this);
591             bool next_line = _is_line_segment(this, _next());
592             if (_type == NODE_SMOOTH) {
593                 // For a node that is already smooth and has a degenerate handle,
594                 // drag out the second handle without changing the direction of the first one.
595                 if (_front.isDegenerate()) {
596                     double dist = Geom::distance(_next()->position(), position());
597                     _front.setRelativePos(Geom::unit_vector(-_back.relativePos()) * dist / 3);
598                 }
599                 if (_back.isDegenerate()) {
600                     double dist = Geom::distance(_prev()->position(), position());
601                     _back.setRelativePos(Geom::unit_vector(-_front.relativePos()) * dist / 3);
602                 }
603             } else if (isDegenerate()) {
604                 _updateAutoHandles();
605             } else if (_front.isDegenerate()) {
606                 // if the front handle is degenerate and this...next is a line segment,
607                 // make back colinear; otherwise pull out the other handle
608                 // to 1/3 of distance to prev
609                 if (next_line) {
610                     _back.setDirection(*_next(), *this);
611                 } else if (_prev()) {
612                     Geom::Point dir = direction(_back, *this);
613                     _front.setRelativePos(Geom::distance(_prev()->position(), position()) / 3 * dir);
614                 }
615             } else if (_back.isDegenerate()) {
616                 if (prev_line) {
617                     _front.setDirection(*_prev(), *this);
618                 } else if (_next()) {
619                     Geom::Point dir = direction(_front, *this);
620                     _back.setRelativePos(Geom::distance(_next()->position(), position()) / 3 * dir);
621                 }
622             } else {
623                 // both handles are extended. make colinear while keeping length
624                 // first make back colinear with the vector front ---> back,
625                 // then make front colinear with back ---> node
626                 // (not back ---> front because back's position was changed in the first call)
627                 _back.setDirection(_front, _back);
628                 _front.setDirection(_back, *this);
629             }
630             } break;
631         case NODE_SYMMETRIC:
632             if (isEndNode()) return; // symmetric handles make no sense for endnodes
633             if (isDegenerate()) {
634                 // similar to auto handles but set the same length for both
635                 Geom::Point vec_next = _next()->position() - position();
636                 Geom::Point vec_prev = _prev()->position() - position();
637                 double len_next = vec_next.length(), len_prev = vec_prev.length();
638                 double len = (len_next + len_prev) / 6; // take 1/3 of average
639                 if (len == 0) return;
641                 Geom::Point dir = Geom::unit_vector((len_prev / len_next) * vec_next - vec_prev);
642                 _back.setRelativePos(-dir * len);
643                 _front.setRelativePos(dir * len);
644             } else {
645                 // Both handles are extended. Compute average length, use direction from
646                 // back handle to front handle. This also works correctly for degenerates
647                 double len = (_front.length() + _back.length()) / 2;
648                 Geom::Point dir = direction(_back, _front);
649                 _front.setRelativePos(dir * len);
650                 _back.setRelativePos(-dir * len);
651             }
652             break;
653         default: break;
654         }
655     }
656     _type = type;
657     _setShape(_node_type_to_shape(type));
658     updateState();
661 /** Pick the best type for this node, based on the position of its handles.
662  * This is what assigns types to nodes created using the pen tool. */
663 void Node::pickBestType()
665     _type = NODE_CUSP;
666     bool front_degen = _front.isDegenerate();
667     bool back_degen = _back.isDegenerate();
668     bool both_degen = front_degen && back_degen;
669     bool neither_degen = !front_degen && !back_degen;
670     do {
671         // if both handles are degenerate, do nothing
672         if (both_degen) break;
673         // if neither are degenerate, check their respective positions
674         if (neither_degen) {
675             Geom::Point front_delta = _front.position() - position();
676             Geom::Point back_delta = _back.position() - position();
677             // for now do not automatically make nodes symmetric, it can be annoying
678             /*if (Geom::are_near(front_delta, -back_delta)) {
679                 _type = NODE_SYMMETRIC;
680                 break;
681             }*/
682             if (Geom::are_near(Geom::unit_vector(front_delta),
683                 Geom::unit_vector(-back_delta)))
684             {
685                 _type = NODE_SMOOTH;
686                 break;
687             }
688         }
689         // check whether the handle aligns with the previous line segment.
690         // we know that if front is degenerate, back isn't, because
691         // both_degen was false
692         if (front_degen && _next() && _next()->_back.isDegenerate()) {
693             Geom::Point segment_delta = Geom::unit_vector(_next()->position() - position());
694             Geom::Point handle_delta = Geom::unit_vector(_back.position() - position());
695             if (Geom::are_near(segment_delta, -handle_delta)) {
696                 _type = NODE_SMOOTH;
697                 break;
698             }
699         } else if (back_degen && _prev() && _prev()->_front.isDegenerate()) {
700             Geom::Point segment_delta = Geom::unit_vector(_prev()->position() - position());
701             Geom::Point handle_delta = Geom::unit_vector(_front.position() - position());
702             if (Geom::are_near(segment_delta, -handle_delta)) {
703                 _type = NODE_SMOOTH;
704                 break;
705             }
706         }
707     } while (false);
708     _setShape(_node_type_to_shape(_type));
709     updateState();
712 bool Node::isEndNode()
714     return !_prev() || !_next();
717 /** Move the node to the bottom of its canvas group. Useful for node break, to ensure that
718  * the selected nodes are above the unselected ones. */
719 void Node::sink()
721     sp_canvas_item_move_to_z(_canvas_item, 0);
724 NodeType Node::parse_nodetype(char x)
726     switch (x) {
727     case 'a': return NODE_AUTO;
728     case 'c': return NODE_CUSP;
729     case 's': return NODE_SMOOTH;
730     case 'z': return NODE_SYMMETRIC;
731     default: return NODE_PICK_BEST;
732     }
735 /** Customized event handler to catch scroll events needed for selection grow/shrink. */
736 bool Node::_eventHandler(GdkEvent *event)
738     static NodeList::iterator origin;
739     static int dir;
741     switch (event->type)
742     {
743     case GDK_SCROLL:
744         if (event->scroll.direction == GDK_SCROLL_UP) {
745             dir = 1;
746         } else if (event->scroll.direction == GDK_SCROLL_DOWN) {
747             dir = -1;
748         } else break;
749         if (held_control(event->scroll)) {
750             _selection.spatialGrow(this, dir);
751         } else {
752             _linearGrow(dir);
753         }
754         return true;
755     default:
756         break;
757     }
758     return ControlPoint::_eventHandler(event);
761 // TODO Move this to 2Geom!
762 static double bezier_length (Geom::Point a0, Geom::Point a1, Geom::Point a2, Geom::Point a3)
764     double lower = Geom::distance(a0, a3);
765     double upper = Geom::distance(a0, a1) + Geom::distance(a1, a2) + Geom::distance(a2, a3);
767     if (upper - lower < Geom::EPSILON) return (lower + upper)/2;
769     Geom::Point // Casteljau subdivision
770         b0 = a0,
771         c0 = a3,
772         b1 = 0.5*(a0 + a1),
773         t0 = 0.5*(a1 + a2),
774         c1 = 0.5*(a2 + a3),
775         b2 = 0.5*(b1 + t0),
776         c2 = 0.5*(t0 + c1),
777         b3 = 0.5*(b2 + c2); // == c3
778     return bezier_length(b0, b1, b2, b3) + bezier_length(b3, c2, c1, c0);
781 /** Select or deselect a node in this node's subpath based on its path distance from this node.
782  * @param dir If negative, shrink selection by one node; if positive, grow by one node */
783 void Node::_linearGrow(int dir)
785     // Interestingly, we do not need any help from PathManipulator when doing linear grow.
786     // First handle the trivial case of growing over an unselected node.
787     if (!selected() && dir > 0) {
788         _selection.insert(this);
789         return;
790     }
792     NodeList::iterator this_iter = NodeList::get_iterator(this);
793     NodeList::iterator fwd = this_iter, rev = this_iter;
794     double distance_back = 0, distance_front = 0;
796     // Linear grow is simple. We find the first unselected nodes in each direction
797     // and compare the linear distances to them.
798     if (dir > 0) {
799         if (!selected()) {
800             _selection.insert(this);
801             return;
802         }
804         // find first unselected nodes on both sides
805         while (fwd && fwd->selected()) {
806             NodeList::iterator n = fwd.next();
807             distance_front += bezier_length(*fwd, fwd->_front, n->_back, *n);
808             fwd = n;
809             if (fwd == this_iter)
810                 // there is no unselected node in this cyclic subpath
811                 return;
812         }
813         // do the same for the second direction. Do not check for equality with
814         // this node, because there is at least one unselected node in the subpath,
815         // so we are guaranteed to stop.
816         while (rev && rev->selected()) {
817             NodeList::iterator p = rev.prev();
818             distance_back += bezier_length(*rev, rev->_back, p->_front, *p);
819             rev = p;
820         }
822         NodeList::iterator t; // node to select
823         if (fwd && rev) {
824             if (distance_front <= distance_back) t = fwd;
825             else t = rev;
826         } else {
827             if (fwd) t = fwd;
828             if (rev) t = rev;
829         }
830         if (t) _selection.insert(t.ptr());
832     // Linear shrink is more complicated. We need to find the farthest selected node.
833     // This means we have to check the entire subpath. We go in the direction in which
834     // the distance we traveled is lower. We do this until we run out of nodes (ends of path)
835     // or the two iterators meet. On the way, we store the last selected node and its distance
836     // in each direction (if any). At the end, we choose the one that is farther and deselect it.
837     } else {
838         // both iterators that store last selected nodes are initially empty
839         NodeList::iterator last_fwd, last_rev;
840         double last_distance_back = 0, last_distance_front = 0;
842         while (rev || fwd) {
843             if (fwd && (!rev || distance_front <= distance_back)) {
844                 if (fwd->selected()) {
845                     last_fwd = fwd;
846                     last_distance_front = distance_front;
847                 }
848                 NodeList::iterator n = fwd.next();
849                 if (n) distance_front += bezier_length(*fwd, fwd->_front, n->_back, *n);
850                 fwd = n;
851             } else if (rev && (!fwd || distance_front > distance_back)) {
852                 if (rev->selected()) {
853                     last_rev = rev;
854                     last_distance_back = distance_back;
855                 }
856                 NodeList::iterator p = rev.prev();
857                 if (p) distance_back += bezier_length(*rev, rev->_back, p->_front, *p);
858                 rev = p;
859             }
860             // Check whether we walked the entire cyclic subpath.
861             // This is initially true because both iterators start from this node,
862             // so this check cannot go in the while condition.
863             // When this happens, we need to check the last node, pointed to by the iterators.
864             if (fwd && fwd == rev) {
865                 if (!fwd->selected()) break;
866                 NodeList::iterator fwdp = fwd.prev(), revn = rev.next();
867                 double df = distance_front + bezier_length(*fwdp, fwdp->_front, fwd->_back, *fwd);
868                 double db = distance_back + bezier_length(*revn, revn->_back, rev->_front, *rev);
869                 if (df > db) {
870                     last_fwd = fwd;
871                     last_distance_front = df;
872                 } else {
873                     last_rev = rev;
874                     last_distance_back = db;
875                 }
876                 break;
877             }
878         }
880         NodeList::iterator t;
881         if (last_fwd && last_rev) {
882             if (last_distance_front >= last_distance_back) t = last_fwd;
883             else t = last_rev;
884         } else {
885             if (last_fwd) t = last_fwd;
886             if (last_rev) t = last_rev;
887         }
888         if (t) _selection.erase(t.ptr());
889     }
892 void Node::_setState(State state)
894     // change node size to match type and selection state
895     switch (_type) {
896     case NODE_AUTO:
897     case NODE_CUSP:
898         if (selected()) _setSize(11);
899         else _setSize(9);
900         break;
901     default:
902         if(selected()) _setSize(9);
903         else _setSize(7);
904         break;
905     }
906     SelectableControlPoint::_setState(state);
909 bool Node::grabbed(GdkEventMotion *event)
911     if (SelectableControlPoint::grabbed(event))
912         return true;
914     // Dragging out handles with Shift + drag on a node.
915     if (!held_shift(*event)) return false;
917     Handle *h;
918     Geom::Point evp = event_point(*event);
919     Geom::Point rel_evp = evp - _last_click_event_point();
921     // This should work even if dragtolerance is zero and evp coincides with node position.
922     double angle_next = HUGE_VAL;
923     double angle_prev = HUGE_VAL;
924     bool has_degenerate = false;
925     // determine which handle to drag out based on degeneration and the direction of drag
926     if (_front.isDegenerate() && _next()) {
927         Geom::Point next_relpos = _desktop->d2w(_next()->position())
928             - _desktop->d2w(position());
929         angle_next = fabs(Geom::angle_between(rel_evp, next_relpos));
930         has_degenerate = true;
931     }
932     if (_back.isDegenerate() && _prev()) {
933         Geom::Point prev_relpos = _desktop->d2w(_prev()->position())
934             - _desktop->d2w(position());
935         angle_prev = fabs(Geom::angle_between(rel_evp, prev_relpos));
936         has_degenerate = true;
937     }
938     if (!has_degenerate) return false;
939     h = angle_next < angle_prev ? &_front : &_back;
941     h->setPosition(_desktop->w2d(evp));
942     h->setVisible(true);
943     h->transferGrab(this, event);
944     Handle::_drag_out = true;
945     return true;
948 void Node::dragged(Geom::Point &new_pos, GdkEventMotion *event)
950     // For a note on how snapping is implemented in Inkscape, see snap.h.
951     SnapManager &sm = _desktop->namedview->snap_manager;
952     // even if we won't really snap, we might still call the one of the
953     // constrainedSnap() methods to enforce the constraints, so we need
954     // to setup the snapmanager anyway; this is also required for someSnapperMightSnap()
955     sm.setup(_desktop);
956     bool snap = sm.someSnapperMightSnap();
958     Inkscape::SnappedPoint sp;
959     std::vector<Inkscape::SnapCandidatePoint> unselected;
960     if (snap) {
961         /* setup
962          * TODO We are doing this every time a snap happens. It should once be done only once
963          *      per drag - maybe in the grabbed handler?
964          * TODO Unselected nodes vector must be valid during the snap run, because it is not
965          *      copied. Fix this in snap.h and snap.cpp, then the above.
966          * TODO Snapping to unselected segments of selected paths doesn't work yet. */
968         // Build the list of unselected nodes.
969         typedef ControlPointSelection::Set Set;
970         Set &nodes = _selection.allPoints();
971         for (Set::iterator i = nodes.begin(); i != nodes.end(); ++i) {
972             if (!(*i)->selected()) {
973                 Node *n = static_cast<Node*>(*i);
974                 Inkscape::SnapCandidatePoint p(n->position(), n->_snapSourceType(), n->_snapTargetType());
975                 unselected.push_back(p);
976             }
977         }
978         sm.unSetup();
979         sm.setupIgnoreSelection(_desktop, true, &unselected);
980     }
982     if (held_control(*event)) {
983         Geom::Point origin = _last_drag_origin();
984         std::vector<Inkscape::Snapper::SnapConstraint> constraints;
985         if (held_alt(*event)) {
986             // with Ctrl+Alt, constrain to handle lines
987             // project the new position onto a handle line that is closer;
988             // also snap to perpendiculars of handle lines
990             Inkscape::Preferences *prefs = Inkscape::Preferences::get();
991             int snaps = prefs->getIntLimited("/options/rotationsnapsperpi/value", 12, 1, 1000);
992             double min_angle = M_PI / snaps;
994             boost::optional<Geom::Point> front_point, back_point, fperp_point, bperp_point;
995             if (_front.isDegenerate()) {
996                 if (_is_line_segment(this, _next()))
997                     front_point = _next()->position() - origin;
998             } else {
999                 front_point = _front.relativePos();
1000             }
1001             if (_back.isDegenerate()) {
1002                 if (_is_line_segment(_prev(), this))
1003                     back_point = _prev()->position() - origin;
1004             } else {
1005                 back_point = _back.relativePos();
1006             }
1007             if (front_point) {
1008                 constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, *front_point));
1009                 fperp_point = Geom::rot90(*front_point);
1010             }
1011             if (back_point) {
1012                 constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, *back_point));
1013                 bperp_point = Geom::rot90(*back_point);
1014             }
1015             // perpendiculars only snap when they are further than snap increment away
1016             // from the second handle constraint
1017             if (fperp_point && (!back_point ||
1018                 (fabs(Geom::angle_between(*fperp_point, *back_point)) > min_angle &&
1019                  fabs(Geom::angle_between(*fperp_point, *back_point)) < M_PI - min_angle)))
1020             {
1021                 constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, *fperp_point));
1022             }
1023             if (bperp_point && (!front_point ||
1024                 (fabs(Geom::angle_between(*bperp_point, *front_point)) > min_angle &&
1025                  fabs(Geom::angle_between(*bperp_point, *front_point)) < M_PI - min_angle)))
1026             {
1027                 constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, *bperp_point));
1028             }
1030             sp = sm.multipleConstrainedSnaps(Inkscape::SnapCandidatePoint(new_pos, _snapSourceType()), constraints);
1031         } else {
1032             // with Ctrl, constrain to axes
1033             constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, Geom::Point(1, 0)));
1034             constraints.push_back(Inkscape::Snapper::SnapConstraint(origin, Geom::Point(0, 1)));
1035             sp = sm.multipleConstrainedSnaps(Inkscape::SnapCandidatePoint(new_pos, _snapSourceType()), constraints);
1036         }
1037         new_pos = sp.getPoint();
1038     } else if (snap) {
1039         sp = sm.freeSnap(Inkscape::SnapCandidatePoint(new_pos, _snapSourceType()));
1040         new_pos = sp.getPoint();
1041     }
1043     sm.unSetup();
1045     SelectableControlPoint::dragged(new_pos, event);
1048 bool Node::clicked(GdkEventButton *event)
1050     if(_pm()._nodeClicked(this, event))
1051         return true;
1052     return SelectableControlPoint::clicked(event);
1055 Inkscape::SnapSourceType Node::_snapSourceType()
1057     if (_type == NODE_SMOOTH || _type == NODE_AUTO)
1058         return SNAPSOURCE_NODE_SMOOTH;
1059     return SNAPSOURCE_NODE_CUSP;
1061 Inkscape::SnapTargetType Node::_snapTargetType()
1063     if (_type == NODE_SMOOTH || _type == NODE_AUTO)
1064         return SNAPTARGET_NODE_SMOOTH;
1065     return SNAPTARGET_NODE_CUSP;
1068 /** @brief Gets the handle that faces the given adjacent node.
1069  * Will abort with error if the given node is not adjacent. */
1070 Handle *Node::handleToward(Node *to)
1072     if (_next() == to) {
1073         return front();
1074     }
1075     if (_prev() == to) {
1076         return back();
1077     }
1078     g_error("Node::handleToward(): second node is not adjacent!");
1081 /** @brief Gets the node in the direction of the given handle.
1082  * Will abort with error if the handle doesn't belong to this node. */
1083 Node *Node::nodeToward(Handle *dir)
1085     if (front() == dir) {
1086         return _next();
1087     }
1088     if (back() == dir) {
1089         return _prev();
1090     }
1091     g_error("Node::nodeToward(): handle is not a child of this node!");
1094 /** @brief Gets the handle that goes in the direction opposite to the given adjacent node.
1095  * Will abort with error if the given node is not adjacent. */
1096 Handle *Node::handleAwayFrom(Node *to)
1098     if (_next() == to) {
1099         return back();
1100     }
1101     if (_prev() == to) {
1102         return front();
1103     }
1104     g_error("Node::handleAwayFrom(): second node is not adjacent!");
1107 /** @brief Gets the node in the direction opposite to the given handle.
1108  * Will abort with error if the handle doesn't belong to this node. */
1109 Node *Node::nodeAwayFrom(Handle *h)
1111     if (front() == h) {
1112         return _prev();
1113     }
1114     if (back() == h) {
1115         return _next();
1116     }
1117     g_error("Node::nodeAwayFrom(): handle is not a child of this node!");
1120 Glib::ustring Node::_getTip(unsigned state)
1122     if (state_held_shift(state)) {
1123         bool can_drag_out = (_next() && _front.isDegenerate()) || (_prev() && _back.isDegenerate());
1124         if (can_drag_out) {
1125             /*if (state_held_control(state)) {
1126                 return format_tip(C_("Path node tip",
1127                     "<b>Shift+Ctrl:</b> drag out a handle and snap its angle "
1128                     "to %f° increments"), snap_increment_degrees());
1129             }*/
1130             return C_("Path node tip",
1131                 "<b>Shift</b>: drag out a handle, click to toggle selection");
1132         }
1133         return C_("Path node tip", "<b>Shift</b>: click to toggle selection");
1134     }
1136     if (state_held_control(state)) {
1137         if (state_held_alt(state)) {
1138             return C_("Path node tip", "<b>Ctrl+Alt</b>: move along handle lines, click to delete node");
1139         }
1140         return C_("Path node tip",
1141             "<b>Ctrl</b>: move along axes, click to change node type");
1142     }
1144     if (state_held_alt(state)) {
1145         return C_("Path node tip", "<b>Alt</b>: sculpt nodes");
1146     }
1148     // No modifiers: assemble tip from node type
1149     char const *nodetype = node_type_to_localized_string(_type);
1150     if (_selection.transformHandlesEnabled() && selected()) {
1151         if (_selection.size() == 1) {
1152             return format_tip(C_("Path node tip",
1153                 "<b>%s</b>: drag to shape the path (more: Shift, Ctrl, Alt)"), nodetype);
1154         }
1155         return format_tip(C_("Path node tip",
1156             "<b>%s</b>: drag to shape the path, click to toggle scale/rotation handles (more: Shift, Ctrl, Alt)"), nodetype);
1157     }
1158     return format_tip(C_("Path node tip",
1159         "<b>%s</b>: drag to shape the path, click to select only this node (more: Shift, Ctrl, Alt)"), nodetype);
1162 Glib::ustring Node::_getDragTip(GdkEventMotion */*event*/)
1164     Geom::Point dist = position() - _last_drag_origin();
1165     GString *x = SP_PX_TO_METRIC_STRING(dist[Geom::X], _desktop->namedview->getDefaultMetric());
1166     GString *y = SP_PX_TO_METRIC_STRING(dist[Geom::Y], _desktop->namedview->getDefaultMetric());
1167     Glib::ustring ret = format_tip(C_("Path node tip", "Move node by %s, %s"),
1168         x->str, y->str);
1169     g_string_free(x, TRUE);
1170     g_string_free(y, TRUE);
1171     return ret;
1174 char const *Node::node_type_to_localized_string(NodeType type)
1176     switch (type) {
1177     case NODE_CUSP: return _("Cusp node");
1178     case NODE_SMOOTH: return _("Smooth node");
1179     case NODE_SYMMETRIC: return _("Symmetric node");
1180     case NODE_AUTO: return _("Auto-smooth node");
1181     default: return "";
1182     }
1185 /** Determine whether two nodes are joined by a linear segment. */
1186 bool Node::_is_line_segment(Node *first, Node *second)
1188     if (!first || !second) return false;
1189     if (first->_next() == second)
1190         return first->_front.isDegenerate() && second->_back.isDegenerate();
1191     if (second->_next() == first)
1192         return second->_front.isDegenerate() && first->_back.isDegenerate();
1193     return false;
1196 SPCtrlShapeType Node::_node_type_to_shape(NodeType type)
1198     switch(type) {
1199     case NODE_CUSP: return SP_CTRL_SHAPE_DIAMOND;
1200     case NODE_SMOOTH: return SP_CTRL_SHAPE_SQUARE;
1201     case NODE_AUTO: return SP_CTRL_SHAPE_CIRCLE;
1202     case NODE_SYMMETRIC: return SP_CTRL_SHAPE_SQUARE;
1203     default: return SP_CTRL_SHAPE_DIAMOND;
1204     }
1208 /**
1209  * @class NodeList
1210  * @brief An editable list of nodes representing a subpath.
1211  *
1212  * It can optionally be cyclic to represent a closed path.
1213  * The list has iterators that act like plain node iterators, but can also be used
1214  * to obtain shared pointers to nodes.
1215  */
1217 NodeList::NodeList(SubpathList &splist)
1218     : _list(splist)
1219     , _closed(false)
1221     this->ln_list = this;
1222     this->ln_next = this;
1223     this->ln_prev = this;
1226 NodeList::~NodeList()
1228     clear();
1231 bool NodeList::empty()
1233     return ln_next == this;
1236 NodeList::size_type NodeList::size()
1238     size_type sz = 0;
1239     for (ListNode *ln = ln_next; ln != this; ln = ln->ln_next) ++sz;
1240     return sz;
1243 bool NodeList::closed()
1245     return _closed;
1248 /** A subpath is degenerate if it has no segments - either one node in an open path
1249  * or no nodes in a closed path */
1250 bool NodeList::degenerate()
1252     return closed() ? empty() : ++begin() == end();
1255 NodeList::iterator NodeList::before(double t, double *fracpart)
1257     double intpart;
1258     *fracpart = std::modf(t, &intpart);
1259     int index = intpart;
1261     iterator ret = begin();
1262     std::advance(ret, index);
1263     return ret;
1266 // insert a node before i
1267 NodeList::iterator NodeList::insert(iterator i, Node *x)
1269     ListNode *ins = i._node;
1270     x->ln_next = ins;
1271     x->ln_prev = ins->ln_prev;
1272     ins->ln_prev->ln_next = x;
1273     ins->ln_prev = x;
1274     x->ln_list = this;
1275     return iterator(x);
1278 void NodeList::splice(iterator pos, NodeList &list)
1280     splice(pos, list, list.begin(), list.end());
1283 void NodeList::splice(iterator pos, NodeList &list, iterator i)
1285     NodeList::iterator j = i;
1286     ++j;
1287     splice(pos, list, i, j);
1290 void NodeList::splice(iterator pos, NodeList &/*list*/, iterator first, iterator last)
1292     ListNode *ins_beg = first._node, *ins_end = last._node, *at = pos._node;
1293     for (ListNode *ln = ins_beg; ln != ins_end; ln = ln->ln_next) {
1294         ln->ln_list = this;
1295     }
1296     ins_beg->ln_prev->ln_next = ins_end;
1297     ins_end->ln_prev->ln_next = at;
1298     at->ln_prev->ln_next = ins_beg;
1300     ListNode *atprev = at->ln_prev;
1301     at->ln_prev = ins_end->ln_prev;
1302     ins_end->ln_prev = ins_beg->ln_prev;
1303     ins_beg->ln_prev = atprev;
1306 void NodeList::shift(int n)
1308     // 1. make the list perfectly cyclic
1309     ln_next->ln_prev = ln_prev;
1310     ln_prev->ln_next = ln_next;
1311     // 2. find new begin
1312     ListNode *new_begin = ln_next;
1313     if (n > 0) {
1314         for (; n > 0; --n) new_begin = new_begin->ln_next;
1315     } else {
1316         for (; n < 0; ++n) new_begin = new_begin->ln_prev;
1317     }
1318     // 3. relink begin to list
1319     ln_next = new_begin;
1320     ln_prev = new_begin->ln_prev;
1321     new_begin->ln_prev->ln_next = this;
1322     new_begin->ln_prev = this;
1325 void NodeList::reverse()
1327     for (ListNode *ln = ln_next; ln != this; ln = ln->ln_prev) {
1328         std::swap(ln->ln_next, ln->ln_prev);
1329         Node *node = static_cast<Node*>(ln);
1330         Geom::Point save_pos = node->front()->position();
1331         node->front()->setPosition(node->back()->position());
1332         node->back()->setPosition(save_pos);
1333     }
1334     std::swap(ln_next, ln_prev);
1337 void NodeList::clear()
1339     for (iterator i = begin(); i != end();) erase (i++);
1342 NodeList::iterator NodeList::erase(iterator i)
1344     // some gymnastics are required to ensure that the node is valid when deleted;
1345     // otherwise the code that updates handle visibility will break
1346     Node *rm = static_cast<Node*>(i._node);
1347     ListNode *rmnext = rm->ln_next, *rmprev = rm->ln_prev;
1348     ++i;
1349     delete rm;
1350     rmprev->ln_next = rmnext;
1351     rmnext->ln_prev = rmprev;
1352     return i;
1355 // TODO this method is very ugly!
1356 // converting SubpathList to an intrusive list might allow us to get rid of it
1357 void NodeList::kill()
1359     for (SubpathList::iterator i = _list.begin(); i != _list.end(); ++i) {
1360         if (i->get() == this) {
1361             _list.erase(i);
1362             return;
1363         }
1364     }
1367 NodeList &NodeList::get(Node *n) {
1368     return n->nodeList();
1370 NodeList &NodeList::get(iterator const &i) {
1371     return *(i._node->ln_list);
1375 /**
1376  * @class SubpathList
1377  * @brief Editable path composed of one or more subpaths
1378  */
1380 } // namespace UI
1381 } // namespace Inkscape
1383 /*
1384   Local Variables:
1385   mode:c++
1386   c-file-style:"stroustrup"
1387   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
1388   indent-tabs-mode:nil
1389   fill-column:99
1390   End:
1391 */
1392 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :