Inkscape: Inkscape::UI::Node Class Reference

Searching...

No Matches

#include <node.h>

Inheritance diagram for Inkscape::UI::Node:

Public Member Functions
	Node (NodeSharedData const &data, Geom::Point const &pos)
	Curve endpoint in an editable path.

	Node (Node const &)=delete

void	move (Geom::Point const &p) override
	Move the control point to new position with side effects.

void	transform (Geom::Affine const &m) override
	Apply an arbitrary affine transformation to a control point.

void	fixNeighbors () override
	Affine transforms keep handle invariants for smooth and symmetric nodes, but smooth nodes at ends of linear segments and auto nodes need special treatment.

Geom::Rect	bounds () const override

NodeType	type () const

void	setType (NodeType type, bool update_handles=true)
	Sets the node type and optionally restores the invariants associated with the given type.

void	showHandles (bool v)

void	updateHandles ()

void	pickBestType ()
	Pick the best type for this node, based on the position of its handles.

bool	isDegenerate () const

bool	isEndNode () const

Handle *	front ()

Handle *	back ()

Handle *	handleToward (Node *to)
	Gets the handle that faces the given adjacent node.

Node *	nodeToward (Handle *h)
	Gets the node in the direction of the given handle.

Handle *	handleAwayFrom (Node *to)
	Gets the handle that goes in the direction opposite to the given adjacent node.

Node *	nodeAwayFrom (Handle *h)
	Gets the node in the direction opposite to the given handle.

NodeList &	nodeList ()

NodeList &	nodeList () const

void	sink ()
	Move the node to the bottom of its canvas group.

bool	_eventHandler (Inkscape::UI::Tools::ToolBase *event_context, CanvasEvent const &event) override
	Customized event handler to catch scroll events needed for selection grow/shrink.

Inkscape::SnapCandidatePoint	snapCandidatePoint ()

Public Member Functions inherited from Inkscape::UI::SelectableControlPoint
	~SelectableControlPoint () override

bool	selected () const

void	updateState ()

virtual void	select (bool toselect)

Public Member Functions inherited from Inkscape::UI::ControlPoint
virtual	~ControlPoint ()

	ControlPoint (ControlPoint const &other)=delete

void	operator= (ControlPoint const &other)=delete

bool	doubleClicked () const

void	set_selected_appearance (bool selected)

Geom::Point const &	position () const
	Current position of the control point.

virtual void	setPosition (Geom::Point const &pos)
	Relocate the control point without side effects.

bool	visible () const

virtual void	setVisible (bool v)
	Set the visibility of the control point.

void	transferGrab (ControlPoint *from, MotionEvent const &event)
	Transfer the grab to another point.

State	state () const

bool	mouseovered () const

Static Public Member Functions
static NodeType	parse_nodetype (char x)

static char const *	node_type_to_localized_string (NodeType type)
	See also: Handle::handle_type_to_localized_string(NodeType type)

Static Public Member Functions inherited from Inkscape::UI::ControlPoint
static Glib::ustring	format_tip (char const *format,...) G_GNUC_PRINTF(1

Protected Member Functions
void	dragged (Geom::Point &new_pos, MotionEvent const &event) override
	Called while dragging, but before moving the knot to new position.

bool	grabbed (MotionEvent const &event) override
	Called when the user moves the point beyond the drag tolerance with the first button held down.

bool	clicked (ButtonReleaseEvent const &event) override
	Called when the control point is clicked, at mouse button release.

void	_setState (State state) override
	Change the state of the knot.

Glib::ustring	_getTip (unsigned state) const override

Glib::ustring	_getDragTip (MotionEvent const &event) const override

bool	_hasDragTips () const override

Protected Member Functions inherited from Inkscape::UI::SelectableControlPoint
	SelectableControlPoint (SPDesktop d, Geom::Point const &initial_pos, SPAnchorType anchor, Inkscape::CanvasItemCtrlType type, ControlPointSelection &sel, Inkscape::CanvasItemGroup group=nullptr)

void	_setState (State state) override
	Change the state of the knot.

void	dragged (Geom::Point &new_pos, MotionEvent const &event) override
	Called while dragging, but before moving the knot to new position.

bool	grabbed (MotionEvent const &event) override
	Called when the user moves the point beyond the drag tolerance with the first button held down.

void	ungrabbed (ButtonReleaseEvent const *event) override
	Called when the control point finishes a drag.

bool	clicked (ButtonReleaseEvent const &event) override
	Called when the control point is clicked, at mouse button release.

Protected Member Functions inherited from Inkscape::UI::ControlPoint
	ControlPoint (SPDesktop d, Geom::Point const &initial_pos, SPAnchorType anchor, Inkscape::CanvasItemCtrlType type, Inkscape::CanvasItemGroup group=nullptr)
	Create a regular control point.

virtual bool	doubleclicked (ButtonReleaseEvent const &event)
	Called when the control point is doubleclicked, at mouse button release.

void	_handleControlStyling ()

void	_setSize (unsigned int size)

void	_setControlType (Inkscape::CanvasItemCtrlType type)

void	_setAnchor (SPAnchorType anchor)

Private Member Functions
void	_updateAutoHandles ()

void	_linearGrow (int dir)
	Select or deselect a node in this node's subpath based on its path distance from this node.

Node *	_next ()

Node const *	_next () const

Node *	_prev ()

Node const *	_prev () const

Inkscape::SnapSourceType	_snapSourceType () const

Inkscape::SnapTargetType	_snapTargetType () const

PathManipulator &	_pm ()

PathManipulator &	_pm () const

Static Private Member Functions
static bool	_is_line_segment (Node first, Node second)
	Determine whether two nodes are joined by a linear segment.

Private Attributes
Handle	_front
	Node handle in the backward direction of the path.

Handle	_back
	Node handle in the forward direction of the path.

NodeType	_type
	Type of node - cusp, smooth...

bool	_handles_shown

std::optional< Geom::Point >	_unfixed_pos

Private Attributes inherited from Inkscape::UI::ListNode
ListNode *	ln_next

ListNode *	ln_prev

NodeList *	ln_list

Friends
class	Handle

class	NodeList

class	NodeIterator< Node >

class	NodeIterator< Node const >

Additional Inherited Members
Public Types inherited from Inkscape::UI::ControlPoint
enum	State { STATE_NORMAL , STATE_MOUSEOVER , STATE_CLICKED }
	Enumeration representing the possible states of the control point, used to determine its appearance. More...

Public Attributes inherited from Inkscape::UI::ControlPoint
SPDesktop *const	_desktop
	The desktop this control point resides on.

Static Public Attributes inherited from Inkscape::UI::ControlPoint
static ControlPoint *	mouseovered_point = nullptr
	Holds the currently mouseovered control point.

static sigc::signal< void(ControlPoint *)>	signal_mouseover_change
	Emitted when the mouseovered point changes.

Static Protected Member Functions inherited from Inkscape::UI::ControlPoint
static Geom::Point const &	_last_click_event_point ()

static Geom::Point const &	_last_drag_origin ()

static bool	_is_drag_cancelled (MotionEvent const &event)

Protected Attributes inherited from Inkscape::UI::SelectableControlPoint
ControlPointSelection &	_selection

Protected Attributes inherited from Inkscape::UI::ControlPoint
CanvasItemPtr< Inkscape::CanvasItemCtrl >	_canvas_item_ctrl
	Visual representation of the control point.

State	_state = STATE_NORMAL

Static Protected Attributes inherited from Inkscape::UI::ControlPoint
static bool	_drag_initiated = false

Detailed Description

Definition at line 121 of file node.h.

Constructor & Destructor Documentation

◆ Node() [1/2]

Inkscape::UI::Node::Node	(	NodeSharedData const &	data,
		Geom::Point const &	pos
	)

Curve endpoint in an editable path.

The method move() keeps node type invariants during translations.

Definition at line 751 of file node.cpp.

References Inkscape::UI::ControlPoint::_canvas_item_ctrl.

◆ Node() [2/2]

Inkscape::UI::Node::Node ( Node const & )

delete

Member Function Documentation

◆ _eventHandler()

bool Inkscape::UI::Node::_eventHandler	(	Inkscape::UI::Tools::ToolBase *	event_context,
		CanvasEvent const &	event
	)

overridevirtual

Customized event handler to catch scroll events needed for selection grow/shrink.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1171 of file node.cpp.

References Inkscape::UI::ControlPoint::_eventHandler(), _linearGrow(), Inkscape::UI::SelectableControlPoint::_selection, Inkscape::inspect_event(), Inkscape::CanvasEvent::modifiers, Inkscape::Modifiers::NODE_GROW_LINEAR, Inkscape::Modifiers::NODE_GROW_SPATIAL, Geom::sgn(), Inkscape::UI::ControlPointSelection::spatialGrow(), and Inkscape::UI::ControlPoint::state().

◆ _getDragTip()

Glib::ustring Inkscape::UI::Node::_getDragTip ( MotionEvent const & event ) const

overrideprotectedvirtual

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1694 of file node.cpp.

References Inkscape::UI::ControlPoint::_desktop, Inkscape::UI::ControlPoint::_last_drag_origin(), SPNamedView::display_units, Inkscape::UI::ControlPoint::format_tip(), SPDesktop::getNamedView(), Inkscape::UI::ControlPoint::position(), Inkscape::Util::Quantity::string(), Geom::X, and Geom::Y.

◆ _getTip()

Glib::ustring Inkscape::UI::Node::_getTip ( unsigned state ) const

overrideprotectedvirtual

◆ _hasDragTips()

bool Inkscape::UI::Node::_hasDragTips ( ) const

inlineoverrideprotectedvirtual

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 217 of file node.h.

◆ _is_line_segment()

bool Inkscape::UI::Node::_is_line_segment	(	Node *	first,
		Node *	second
	)

staticprivate

Determine whether two nodes are joined by a linear segment.

Definition at line 1725 of file node.cpp.

References _back, _front, _next(), and Inkscape::UI::Handle::isDegenerate().

Referenced by dragged(), fixNeighbors(), Inkscape::UI::Handle::move(), and setType().

◆ _linearGrow()

void Inkscape::UI::Node::_linearGrow ( int dir )

private

Select or deselect a node in this node's subpath based on its path distance from this node.

Parameters

dir	If negative, shrink selection by one node; if positive, grow by one node.

Definition at line 1213 of file node.cpp.

References Inkscape::UI::SelectableControlPoint::_selection, Geom::bezier_length(), Inkscape::UI::ControlPointSelection::erase(), Inkscape::UI::NodeList::get_iterator(), Inkscape::UI::ControlPointSelection::insert(), Inkscape::UI::NodeIterator< N >::next(), Inkscape::UI::NodeIterator< N >::prev(), Inkscape::UI::NodeIterator< N >::ptr(), and Inkscape::UI::SelectableControlPoint::selected().

Referenced by _eventHandler().

◆ _next() [1/2]

Node * Inkscape::UI::Node::_next ( )

private

Definition at line 769 of file node.cpp.

References Inkscape::UI::NodeList::get_iterator(), and Inkscape::UI::NodeIterator< N >::next().

Referenced by _getTip(), _is_line_segment(), _next(), _updateAutoHandles(), dragged(), fixNeighbors(), grabbed(), handleAwayFrom(), handleToward(), isEndNode(), nodeAwayFrom(), nodeToward(), pickBestType(), and setType().

◆ _next() [2/2]

Node const * Inkscape::UI::Node::_next ( ) const

private

Definition at line 763 of file node.cpp.

References _next().

◆ _pm() [1/2]

PathManipulator & Inkscape::UI::Node::_pm ( )

inlineprivate

Definition at line 475 of file node.h.

References nodeList(), Inkscape::UI::SubpathList::pm(), and Inkscape::UI::NodeList::subpathList().

Referenced by Inkscape::UI::Handle::_eventHandler(), _getTip(), Inkscape::UI::Handle::_pm(), Inkscape::UI::Handle::_pm(), _setState(), clicked(), move(), setType(), and transform().

◆ _pm() [2/2]

PathManipulator & Inkscape::UI::Node::_pm ( ) const

inlineprivate

Definition at line 479 of file node.h.

References nodeList(), Inkscape::UI::SubpathList::pm(), and Inkscape::UI::NodeList::subpathList().

◆ _prev() [1/2]

Node * Inkscape::UI::Node::_prev ( )

private

Definition at line 784 of file node.cpp.

References Inkscape::UI::NodeList::get_iterator(), Inkscape::UI::NodeIterator< N >::prev(), and Inkscape::UI::NodeIterator< N >::ptr().

Referenced by _getTip(), _prev(), _updateAutoHandles(), dragged(), fixNeighbors(), grabbed(), handleAwayFrom(), handleToward(), isEndNode(), nodeAwayFrom(), nodeToward(), pickBestType(), and setType().

◆ _prev() [2/2]

Node const * Inkscape::UI::Node::_prev ( ) const

private

Definition at line 779 of file node.cpp.

References _prev().

◆ _setState()

void Inkscape::UI::Node::_setState ( State state )

overrideprotectedvirtual

Change the state of the knot.

Alters the appearance of the knot to match one of the states: normal, mouseover or clicked.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1341 of file node.cpp.

References Inkscape::UI::ControlPoint::_canvas_item_ctrl, Inkscape::UI::PathManipulator::_isBSpline(), _pm(), Inkscape::UI::SelectableControlPoint::_setState(), back(), front(), Inkscape::LARGE, Inkscape::NORMAL, Inkscape::UI::SelectableControlPoint::selected(), Inkscape::UI::Handle::setPosition(), Inkscape::UI::ControlPoint::state(), Inkscape::UI::ControlPoint::STATE_CLICKED, Inkscape::UI::ControlPoint::STATE_MOUSEOVER, and Inkscape::UI::ControlPoint::STATE_NORMAL.

◆ _snapSourceType()

Inkscape::SnapSourceType Inkscape::UI::Node::_snapSourceType ( ) const

private

Definition at line 1543 of file node.cpp.

References _type, Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_SMOOTH, Inkscape::SNAPSOURCE_NODE_CUSP, and Inkscape::SNAPSOURCE_NODE_SMOOTH.

Referenced by dragged(), and snapCandidatePoint().

◆ _snapTargetType()

Inkscape::SnapTargetType Inkscape::UI::Node::_snapTargetType ( ) const

private

Definition at line 1550 of file node.cpp.

References _type, Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_SMOOTH, Inkscape::SNAPTARGET_NODE_CUSP, and Inkscape::SNAPTARGET_NODE_SMOOTH.

Referenced by snapCandidatePoint().

◆ _updateAutoHandles()

void Inkscape::UI::Node::_updateAutoHandles ( )

private

Definition at line 934 of file node.cpp.

References _back, _front, _next(), _prev(), isEndNode(), Geom::Point::length(), Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::retract(), Inkscape::UI::Handle::setRelativePos(), and Geom::unit_vector().

Referenced by fixNeighbors(), and setType().

◆ back()

Handle * Inkscape::UI::Node::back ( )

inline

Definition at line 165 of file node.h.

References _back.

Referenced by Inkscape::UI::PathManipulator::_createControlPointsFromGeometry(), _setState(), Inkscape::UI::PathManipulator::build_segment(), handleAwayFrom(), handleToward(), Inkscape::UI::MultiPathManipulator::joinNodes(), move(), nodeAwayFrom(), nodeToward(), setType(), and transform().

◆ bounds()

Geom::Rect Inkscape::UI::Node::bounds ( ) const

overridevirtual

Reimplemented from Inkscape::UI::SelectableControlPoint.

Definition at line 872 of file node.cpp.

References _back, _front, Geom::GenericRect< C >::expandTo(), and Inkscape::UI::ControlPoint::position().

◆ clicked()

bool Inkscape::UI::Node::clicked ( ButtonReleaseEvent const & event )

overrideprotectedvirtual

Called when the control point is clicked, at mouse button release.

Improperly implementing this method can cause the default context menu not to appear when a control point is right-clicked.

Parameters

event Button release event

Returns: true if the click had some effect, false if it did nothing.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1535 of file node.cpp.

References _pm(), and Inkscape::UI::SelectableControlPoint::clicked().

◆ dragged()

void Inkscape::UI::Node::dragged	(	Geom::Point &	new_pos,
		MotionEvent const &	event
	)

overrideprotectedvirtual

Called while dragging, but before moving the knot to new position.

Parameters

pos	Old position, always equal to position()
new_pos	New position (after drag). This is passed as a non-const reference, so you can change it from the handler - that's how constrained dragging is implemented.
event	Motion event.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1403 of file node.cpp.

References _back, Inkscape::UI::ControlPoint::_desktop, _front, _is_line_segment(), Inkscape::UI::ControlPoint::_last_drag_origin(), _next(), _prev(), Inkscape::UI::SelectableControlPoint::_selection, _snapSourceType(), _type, Inkscape::SnapCandidatePoint::addOrigin(), Inkscape::SnapCandidatePoint::addVector(), Inkscape::UI::ControlPointSelection::allPoints(), Geom::angle_between(), Inkscape::UI::SelectableControlPoint::dragged(), Inkscape::Preferences::get(), Inkscape::Preferences::getIntLimited(), SPDesktop::getNamedView(), Inkscape::SnappedPoint::getPoint(), Inkscape::UI::Handle::isDegenerate(), Inkscape::mod_alt(), Inkscape::mod_ctrl(), Inkscape::mod_shift(), node, Inkscape::UI::NODE_CUSP, origin, Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::relativePos(), Geom::rot90(), Inkscape::UI::SelectableControlPoint::selected(), SnapManager::setup(), and SPNamedView::snap_manager.

◆ fixNeighbors()

void Inkscape::UI::Node::fixNeighbors ( )

overridevirtual

Affine transforms keep handle invariants for smooth and symmetric nodes, but smooth nodes at ends of linear segments and auto nodes need special treatment.

Call this function once you have finished called move or transform on ALL nodes that are being transformed in that one operation to avoid problematic bugs.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 887 of file node.cpp.

References _back, _front, _is_line_segment(), _next(), _prev(), _type, _unfixed_pos, _updateAutoHandles(), Inkscape::UI::Handle::isDegenerate(), Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_SMOOTH, Inkscape::UI::ControlPoint::position(), and Inkscape::UI::Handle::setDirection().

◆ front()

Handle * Inkscape::UI::Node::front ( )

inline

Definition at line 164 of file node.h.

References _front.

Referenced by _setState(), Inkscape::UI::PathManipulator::build_segment(), Inkscape::UI::PathManipulator::copySelectedPath(), handleAwayFrom(), handleToward(), Inkscape::UI::MultiPathManipulator::joinNodes(), move(), nodeAwayFrom(), nodeToward(), setType(), and transform().

◆ grabbed()

bool Inkscape::UI::Node::grabbed ( MotionEvent const & event )

overrideprotectedvirtual

Called when the user moves the point beyond the drag tolerance with the first button held down.

Parameters

event Motion event when drag tolerance was exceeded.

Returns: true if you called transferGrab() during this method.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 1361 of file node.cpp.

References _back, Inkscape::UI::ControlPoint::_desktop, Inkscape::UI::Handle::_drag_out, _front, Inkscape::UI::ControlPoint::_last_click_event_point(), _next(), _prev(), Geom::angle_between(), SPDesktop::d2w(), Inkscape::UI::SelectableControlPoint::grabbed(), Inkscape::UI::Handle::isDegenerate(), Inkscape::mod_shift(), Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::setPosition(), Inkscape::UI::Handle::setVisible(), Inkscape::UI::ControlPoint::transferGrab(), and SPDesktop::w2d().

◆ handleAwayFrom()

Handle * Inkscape::UI::Node::handleAwayFrom ( Node * to )

Gets the handle that goes in the direction opposite to the given adjacent node.

Will abort with error if the given node is not adjacent.

Definition at line 1586 of file node.cpp.

References _next(), _prev(), back(), and front().

Referenced by Inkscape::UI::Handle::move().

◆ handleToward()

Handle * Inkscape::UI::Node::handleToward ( Node * to )

Gets the handle that faces the given adjacent node.

Will abort with error if the given node is not adjacent.

Definition at line 1562 of file node.cpp.

References _next(), _prev(), back(), and front().

Referenced by Inkscape::UI::Handle::move().

◆ isDegenerate()

bool Inkscape::UI::Node::isDegenerate ( ) const

inline

Definition at line 162 of file node.h.

References _back, _front, and Inkscape::UI::Handle::isDegenerate().

Referenced by setType().

◆ isEndNode()

bool Inkscape::UI::Node::isEndNode ( ) const

Definition at line 1145 of file node.cpp.

References _next(), and _prev().

Referenced by _updateAutoHandles(), and setType().

◆ move()

void Inkscape::UI::Node::move ( Geom::Point const & pos )

overridevirtual

Move the control point to new position with side effects.

This is called after each drag. Override this method if only some positions make sense for a control point (like a point that must always be on a path and can't modify it), or when moving a control point changes the positions of other points.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 794 of file node.cpp.

References _back, Inkscape::UI::PathManipulator::_bsplineHandlePosition(), Inkscape::UI::ControlPoint::_desktop, _front, _pm(), _unfixed_pos, back(), delta, front(), Inkscape::UI::NO_POWER, Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::setPosition(), Inkscape::UI::ControlPoint::setPosition(), and Inkscape::UI::Tools::sp_update_helperpath().

◆ node_type_to_localized_string()

char const * Inkscape::UI::Node::node_type_to_localized_string ( NodeType type )

static

Definition at line 1709 of file node.cpp.

References Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_CUSP, Inkscape::UI::NODE_SMOOTH, Inkscape::UI::NODE_SYMMETRIC, and type().

Referenced by _getTip().

◆ nodeAwayFrom()

Node * Inkscape::UI::Node::nodeAwayFrom ( Handle * h )

Gets the node in the direction opposite to the given handle.

Will abort with error if the handle doesn't belong to this node.

Definition at line 1598 of file node.cpp.

References _next(), _prev(), back(), and front().

Referenced by Inkscape::UI::Handle::dragged(), and Inkscape::UI::Handle::move().

◆ nodeList() [1/2]

NodeList & Inkscape::UI::Node::nodeList ( )

inline

Definition at line 191 of file node.h.

References Inkscape::UI::ListNode::ln_list.

Referenced by _pm(), and _pm().

◆ nodeList() [2/2]

NodeList & Inkscape::UI::Node::nodeList ( ) const

inline

Definition at line 192 of file node.h.

References Inkscape::UI::ListNode::ln_list.

◆ nodeToward()

Node * Inkscape::UI::Node::nodeToward ( Handle * h )

Gets the node in the direction of the given handle.

Will abort with error if the handle doesn't belong to this node.

Definition at line 1574 of file node.cpp.

References _next(), _prev(), back(), and front().

Referenced by Inkscape::UI::Handle::move().

◆ parse_nodetype()

NodeType Inkscape::UI::Node::parse_nodetype ( char x )

static

Definition at line 1155 of file node.cpp.

References Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_CUSP, Inkscape::UI::NODE_PICK_BEST, Inkscape::UI::NODE_SMOOTH, and Inkscape::UI::NODE_SYMMETRIC.

Referenced by Inkscape::UI::PathManipulator::_createControlPointsFromGeometry().

◆ pickBestType()

void Inkscape::UI::Node::pickBestType ( )

Pick the best type for this node, based on the position of its handles.

This is what assigns types to nodes created using the pen tool.

Definition at line 1103 of file node.cpp.

References _back, _front, _next(), _prev(), Inkscape::UI::ControlPoint::_setControlType(), _type, Inkscape::UI::Handle::isDegenerate(), Inkscape::UI::NODE_CUSP, Inkscape::UI::NODE_SMOOTH, Inkscape::UI::ControlPoint::position(), and Inkscape::UI::SelectableControlPoint::updateState().

Referenced by setType().

◆ setType()

void Inkscape::UI::Node::setType	(	NodeType	type,
		bool	update_handles = `true`
	)

Sets the node type and optionally restores the invariants associated with the given type.

Parameters

type	The type to set.
update_handles	Whether to restore invariants associated with the given type. Passing false is useful e.g. when initially creating the path, and when making cusp nodes during some node algorithms. Pass true when used in response to an UI node type button.

Definition at line 982 of file node.cpp.

References _back, _front, _is_line_segment(), _next(), _pm(), _prev(), Inkscape::UI::ControlPoint::_setControlType(), _type, _updateAutoHandles(), Geom::are_near(), back(), Inkscape::UI::BSPLINE_TOL, Inkscape::UI::DEFAULT_START_POWER, Inkscape::UI::direction(), Geom::distance(), front(), Inkscape::UI::Handle::isDegenerate(), isDegenerate(), isEndNode(), len, Geom::Point::length(), Inkscape::UI::Handle::length(), Inkscape::UI::NO_POWER, Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_CUSP, Inkscape::UI::NODE_PICK_BEST, Inkscape::UI::NODE_SMOOTH, Inkscape::UI::NODE_SYMMETRIC, pickBestType(), Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::relativePos(), Inkscape::UI::Handle::setDirection(), Inkscape::UI::Handle::setPosition(), Inkscape::UI::Handle::setRelativePos(), type(), Geom::unit_vector(), Inkscape::UI::SelectableControlPoint::updateState(), and weight.

Referenced by Inkscape::UI::Handle::_eventHandler(), and Inkscape::UI::Handle::move().

◆ showHandles()

void Inkscape::UI::Node::showHandles ( bool v )

Definition at line 963 of file node.cpp.

References _back, _front, _handles_shown, Inkscape::UI::Handle::isDegenerate(), and Inkscape::UI::Handle::setVisible().

◆ sink()

void Inkscape::UI::Node::sink ( )

Move the node to the bottom of its canvas group.

Useful for node break, to ensure that the selected nodes are above the unselected ones.

Definition at line 1150 of file node.cpp.

References Inkscape::UI::ControlPoint::_canvas_item_ctrl.

◆ snapCandidatePoint()

Inkscape::SnapCandidatePoint Inkscape::UI::Node::snapCandidatePoint ( )

Definition at line 1557 of file node.cpp.

References _snapSourceType(), _snapTargetType(), and Inkscape::UI::ControlPoint::position().

◆ transform()

void Inkscape::UI::Node::transform ( Geom::Affine const & m )

overridevirtual

Apply an arbitrary affine transformation to a control point.

This is used by ControlPointSelection, and is important for things like nodes with handles. The default implementation simply moves the point according to the transform.

Reimplemented from Inkscape::UI::ControlPoint.

Definition at line 835 of file node.cpp.

References _back, Inkscape::UI::PathManipulator::_bsplineHandlePosition(), _front, _pm(), _unfixed_pos, back(), front(), Inkscape::UI::NO_POWER, Inkscape::UI::ControlPoint::position(), Inkscape::UI::Handle::setPosition(), and Inkscape::UI::ControlPoint::setPosition().

◆ type()

NodeType Inkscape::UI::Node::type ( ) const

inline

Definition at line 140 of file node.h.

References _type.

Referenced by Inkscape::UI::Handle::move(), node_type_to_localized_string(), and setType().

◆ updateHandles()

void Inkscape::UI::Node::updateHandles ( )

Definition at line 974 of file node.cpp.

References _back, _front, and Inkscape::UI::ControlPoint::_handleControlStyling().

Friends And Related Symbol Documentation

◆ Handle

friend class Handle

friend

Definition at line 252 of file node.h.

◆ NodeIterator< Node >

friend class NodeIterator< Node >

friend

Definition at line 253 of file node.h.

◆ NodeIterator< Node const >

friend class NodeIterator< Node const >

friend

Definition at line 253 of file node.h.

◆ NodeList

friend class NodeList

friend

Definition at line 253 of file node.h.

Member Data Documentation

◆ _back

Handle Inkscape::UI::Node::_back

private

Node handle in the forward direction of the path.

Definition at line 244 of file node.h.

Referenced by _getTip(), _is_line_segment(), _updateAutoHandles(), back(), bounds(), dragged(), fixNeighbors(), grabbed(), isDegenerate(), move(), pickBestType(), setType(), showHandles(), transform(), and updateHandles().

◆ _front

Handle Inkscape::UI::Node::_front

private

Node handle in the backward direction of the path.

Definition at line 243 of file node.h.

Referenced by _getTip(), _is_line_segment(), _updateAutoHandles(), bounds(), dragged(), fixNeighbors(), front(), grabbed(), isDegenerate(), move(), pickBestType(), setType(), showHandles(), transform(), and updateHandles().

◆ _handles_shown

bool Inkscape::UI::Node::_handles_shown

private

Definition at line 246 of file node.h.

Referenced by Inkscape::UI::Handle::setPosition(), and showHandles().

◆ _type

NodeType Inkscape::UI::Node::_type

private

Type of node - cusp, smooth...

Definition at line 245 of file node.h.

Referenced by Inkscape::UI::Handle::_eventHandler(), _getTip(), _snapSourceType(), _snapTargetType(), dragged(), fixNeighbors(), pickBestType(), setType(), and type().

◆ _unfixed_pos

std::optional<Geom::Point> Inkscape::UI::Node::_unfixed_pos

private

Definition at line 250 of file node.h.

Referenced by fixNeighbors(), move(), and transform().

The documentation for this class was generated from the following files:

/builds/inkscape/inkscape/src/ui/tool/node.h
/builds/inkscape/inkscape/src/ui/tool/node.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Node() [1/2]

◆ Node() [2/2]

Member Function Documentation

◆ _eventHandler()

◆ _getDragTip()

◆ _getTip()

◆ _hasDragTips()

◆ _is_line_segment()

◆ _linearGrow()

◆ _next() [1/2]

◆ _next() [2/2]

◆ _pm() [1/2]

◆ _pm() [2/2]

◆ _prev() [1/2]

◆ _prev() [2/2]

◆ _setState()

◆ _snapSourceType()

◆ _snapTargetType()

◆ _updateAutoHandles()

◆ back()

◆ bounds()

◆ clicked()

◆ dragged()

◆ fixNeighbors()

◆ front()

◆ grabbed()

◆ handleAwayFrom()

◆ handleToward()

◆ isDegenerate()

◆ isEndNode()

◆ move()

◆ node_type_to_localized_string()

◆ nodeAwayFrom()

◆ nodeList() [1/2]

◆ nodeList() [2/2]

◆ nodeToward()

◆ parse_nodetype()

◆ pickBestType()

◆ setType()

◆ showHandles()

◆ sink()

◆ snapCandidatePoint()

◆ transform()

◆ type()

◆ updateHandles()

Friends And Related Symbol Documentation

◆ Handle

◆ NodeIterator< Node >

◆ NodeIterator< Node const >

◆ NodeList

Member Data Documentation

◆ _back

◆ _front

◆ _handles_shown

◆ _type

◆ _unfixed_pos