Inkscape: Inkscape::UI::MultiPathManipulator Class Reference

Searching...

No Matches

Manipulator that manages multiple path manipulators active at the same time. More...

#include <multi-path-manipulator.h>

Inheritance diagram for Inkscape::UI::MultiPathManipulator:

Public Member Functions
	MultiPathManipulator (PathSharedData &data)

	~MultiPathManipulator () override

bool	event (Inkscape::UI::Tools::ToolBase *tool, CanvasEvent const &event) override
	Handle input event. Returns true if handled.

bool	empty () const

size_t	size () const

void	setItems (std::set< ShapeRecord > const &)
	Change the set of items to edit.

void	clear ()

void	cleanup ()
	Remove empty manipulators.

void	selectSubpaths ()

void	shiftSelection (int dir)

void	invertSelectionInSubpaths ()

void	setNodeType (NodeType t)

void	setSegmentType (SegmentType t)

void	insertNodesAtExtrema (ExtremumType extremum)

void	insertNodes ()

void	insertNode (Geom::Point pt)

void	alertLPE ()

void	duplicateNodes ()

void	copySelectedPath (Geom::PathBuilder *builder)

void	joinNodes ()

void	breakNodes ()

void	deleteNodes ()
	Delete nodes, use the preference to decide which mode to use.

void	deleteNodes (NodeDeleteMode mode)

void	joinSegments ()
	Join selected endpoints to create segments.

void	deleteSegments ()

void	alignNodes (Geom::Dim2 d, AlignTargetNode target=AlignTargetNode::MID_NODE)

void	distributeNodes (Geom::Dim2 d)

void	reverseSubpaths ()

void	move (Geom::Point const &delta)

void	scale (Geom::Point const &center, Geom::Point const &scale)

void	showOutline (bool show)

void	showHandles (bool show)

void	showPathDirection (bool show)

void	setLiveOutline (bool set)
	Set live outline update status.

void	setLiveObjects (bool set)
	Set live object update status.

void	updateOutlineColors ()

void	updateHandles ()

void	updatePaths ()

Public Member Functions inherited from Inkscape::UI::PointManipulator
	PointManipulator (SPDesktop *d, ControlPointSelection &sel)

Public Member Functions inherited from Inkscape::UI::Manipulator
	Manipulator (SPDesktop *d)

virtual	~Manipulator ()=default

Public Attributes
sigc::signal< void()>	signal_coords_changed
	Emitted whenever the coordinates shown in the status bar need updating.

PathSharedData const &	_path_data

Public Attributes inherited from Inkscape::UI::Manipulator
SPDesktop *const	_desktop

Private Types
using	MapPair = std::pair< ShapeRecord, std::shared_ptr< PathManipulator > >

using	MapType = std::map< ShapeRecord, std::shared_ptr< PathManipulator > >

Private Member Functions
template<typename R >
void	invokeForAll (R(PathManipulator::*method)())

template<typename R , typename A >
void	invokeForAll (R(PathManipulator::*method)(A), A a)

template<typename R , typename A >
void	invokeForAll (R(PathManipulator::*method)(A const &), A const &a)

template<typename R , typename A , typename B >
void	invokeForAll (R(PathManipulator::*method)(A, B), A a, B b)

void	_commit (CommitEvent cps)
	Commit changes to XML and add undo stack entry based on the action that was done.

void	_done (gchar const *reason, bool alert_LPE=true)
	Commits changes to XML and adds undo stack entry.

void	_doneWithCleanup (gchar const *reason, bool alert_LPE=false)
	Commits changes to XML, adds undo stack entry and removes empty manipulators.

Colors::Color	_getOutlineColor (ShapeRole role, SPObject *object)
	Get an outline color based on the shape's role (normal, mask, LPE parameter, etc.).

Private Attributes
MapType	_mmap

ModifierTracker	_tracker

bool	_show_handles

bool	_show_outline

bool	_show_path_direction

bool	_live_outline

bool	_live_objects

Friends
class	PathManipulator

Additional Inherited Members
Public Types inherited from Inkscape::UI::PointManipulator
enum	ExtremumType { EXTR_MIN_X , EXTR_MAX_X , EXTR_MIN_Y , EXTR_MAX_Y }
	Type of extremum points to add in PathManipulator::insertNodeAtExtremum. More...

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

Detailed Description

Manipulator that manages multiple path manipulators active at the same time.

Definition at line 35 of file multi-path-manipulator.h.

Member Typedef Documentation

◆ MapPair

using Inkscape::UI::MultiPathManipulator::MapPair = std::pair<ShapeRecord, std::shared_ptr<PathManipulator> >

private

Definition at line 87 of file multi-path-manipulator.h.

◆ MapType

using Inkscape::UI::MultiPathManipulator::MapType = std::map<ShapeRecord, std::shared_ptr<PathManipulator> >

private

Definition at line 88 of file multi-path-manipulator.h.

Constructor & Destructor Documentation

◆ MultiPathManipulator()

Inkscape::UI::MultiPathManipulator::MultiPathManipulator ( PathSharedData & data )

Definition at line 117 of file multi-path-manipulator.cpp.

References _commit(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::signal_commit, signal_coords_changed, and Inkscape::UI::ControlPointSelection::signal_selection_changed.

◆ ~MultiPathManipulator()

Inkscape::UI::MultiPathManipulator::~MultiPathManipulator ( )

override

Definition at line 128 of file multi-path-manipulator.cpp.

References _mmap.

Member Function Documentation

◆ _commit()

void Inkscape::UI::MultiPathManipulator::_commit ( CommitEvent cps )

private

Commit changes to XML and add undo stack entry based on the action that was done.

Invoked by sub-manipulators, for example TransformHandleSet and ControlPointSelection.

Definition at line 804 of file multi-path-manipulator.cpp.

Referenced by MultiPathManipulator().

◆ _done()

void Inkscape::UI::MultiPathManipulator::_done	(	gchar const *	reason,
		bool	alert_LPE = `true`
	)

private

Commits changes to XML and adds undo stack entry.

Definition at line 873 of file multi-path-manipulator.cpp.

References Inkscape::UI::Manipulator::_desktop, Inkscape::DocumentUndo::done(), SPDesktop::getDocument(), invokeForAll(), signal_coords_changed, Inkscape::UI::PathManipulator::update(), and Inkscape::UI::PathManipulator::writeXML().

Referenced by _doneWithCleanup(), alignNodes(), breakNodes(), copySelectedPath(), distributeNodes(), duplicateNodes(), insertNode(), insertNodes(), insertNodesAtExtrema(), move(), reverseSubpaths(), scale(), setNodeType(), and setSegmentType().

◆ _doneWithCleanup()

void Inkscape::UI::MultiPathManipulator::_doneWithCleanup	(	gchar const *	reason,
		bool	alert_LPE = `false`
	)

private

Commits changes to XML, adds undo stack entry and removes empty manipulators.

Definition at line 881 of file multi-path-manipulator.cpp.

References _done(), and cleanup().

Referenced by Inkscape::UI::PathManipulator::_nodeClicked(), deleteNodes(), deleteSegments(), joinNodes(), and joinSegments().

◆ _getOutlineColor()

Colors::Color Inkscape::UI::MultiPathManipulator::_getOutlineColor	(	ShapeRole	role,
		SPObject *	object
	)

private

Get an outline color based on the shape's role (normal, mask, LPE parameter, etc.).

Definition at line 887 of file multi-path-manipulator.cpp.

References Inkscape::Preferences::get(), Inkscape::Preferences::getColor(), Inkscape::UI::SHAPE_ROLE_CLIPPING_PATH, Inkscape::UI::SHAPE_ROLE_LPE_PARAM, Inkscape::UI::SHAPE_ROLE_MASK, and Inkscape::UI::SHAPE_ROLE_NORMAL.

Referenced by setItems().

◆ alertLPE()

void Inkscape::UI::MultiPathManipulator::alertLPE ( )

References scale().

◆ alignNodes()

void Inkscape::UI::MultiPathManipulator::alignNodes	(	Geom::Dim2	d,
		AlignTargetNode	target = `AlignTargetNode::MID_NODE`
	)

Definition at line 482 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::align(), Inkscape::UI::ControlPointSelection::empty(), and Geom::X.

◆ breakNodes()

void Inkscape::UI::MultiPathManipulator::breakNodes ( )

Definition at line 426 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::PathManipulator::breakNodes(), Inkscape::UI::ControlPointSelection::empty(), and invokeForAll().

Referenced by event().

◆ cleanup()

void Inkscape::UI::MultiPathManipulator::cleanup ( )

Remove empty manipulators.

Definition at line 134 of file multi-path-manipulator.cpp.

References _mmap.

Referenced by _doneWithCleanup().

◆ clear()

void Inkscape::UI::MultiPathManipulator::clear ( )

inline

Definition at line 46 of file multi-path-manipulator.h.

References _mmap.

◆ copySelectedPath()

void Inkscape::UI::MultiPathManipulator::copySelectedPath ( Geom::PathBuilder * builder )

Definition at line 355 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, builder, Inkscape::UI::PathManipulator::copySelectedPath(), Inkscape::UI::ControlPointSelection::empty(), and invokeForAll().

◆ deleteNodes() [1/2]

void Inkscape::UI::MultiPathManipulator::deleteNodes ( )

Delete nodes, use the preference to decide which mode to use.

Definition at line 436 of file multi-path-manipulator.cpp.

References deleteNodes(), and Inkscape::Preferences::get().

Referenced by deleteNodes(), Inkscape::UI::Tools::NodeTool::deleteSelected(), and event().

◆ deleteNodes() [2/2]

void Inkscape::UI::MultiPathManipulator::deleteNodes ( NodeDeleteMode mode )

Definition at line 441 of file multi-path-manipulator.cpp.

References _doneWithCleanup(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::PathManipulator::deleteNodes(), Inkscape::UI::ControlPointSelection::empty(), invokeForAll(), and mode.

◆ deleteSegments()

void Inkscape::UI::MultiPathManipulator::deleteSegments ( )

Definition at line 475 of file multi-path-manipulator.cpp.

References _doneWithCleanup(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::PathManipulator::deleteSegments(), Inkscape::UI::ControlPointSelection::empty(), and invokeForAll().

◆ distributeNodes()

void Inkscape::UI::MultiPathManipulator::distributeNodes ( Geom::Dim2 d )

Definition at line 493 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::distribute(), Inkscape::UI::ControlPointSelection::empty(), and Geom::X.

◆ duplicateNodes()

void Inkscape::UI::MultiPathManipulator::duplicateNodes ( )

Definition at line 348 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::PathManipulator::duplicateNodes(), Inkscape::UI::ControlPointSelection::empty(), and invokeForAll().

Referenced by event().

◆ empty()

bool Inkscape::UI::MultiPathManipulator::empty ( ) const

inline

Definition at line 43 of file multi-path-manipulator.h.

References _mmap.

Referenced by Inkscape::UI::Tools::NodeTool::select_area(), Inkscape::SelectionHelper::selectAll(), shiftSelection(), and Inkscape::UI::Tools::NodeTool::update_tip().

◆ event()

bool Inkscape::UI::MultiPathManipulator::event	(	Inkscape::UI::Tools::ToolBase *	tool,
		CanvasEvent const &	event
	)

overridevirtual

Handle input event. Returns true if handled.

Implements Inkscape::UI::Manipulator.

Definition at line 595 of file multi-path-manipulator.cpp.

References Inkscape::UI::Manipulator::_desktop, _mmap, Inkscape::UI::PointManipulator::_selection, _tracker, Inkscape::UI::automatic, Inkscape::UI::ControlPointSelection::begin(), breakNodes(), deleteNodes(), Inkscape::UI::Tools::ToolBase::deleteSelectedDrag(), duplicateNodes(), Inkscape::UI::ModifierTracker::event(), event(), Inkscape::UI::gap_nodes, Inkscape::Preferences::get(), Inkscape::Preferences::getInt(), insertNodes(), Inkscape::inspect_event(), Inkscape::UI::inverse_auto, joinNodes(), joinSegments(), key, Inkscape::KEY_PRESS, Inkscape::UI::ModifierTracker::leftAlt(), Inkscape::UI::ModifierTracker::leftControl(), Inkscape::UI::line_segment, Inkscape::mod_alt(), Inkscape::mod_alt_only(), Inkscape::mod_ctrl(), Inkscape::mod_shift(), Inkscape::mod_shift_only(), Inkscape::UI::NODE_AUTO, Inkscape::UI::NODE_CUSP, Inkscape::UI::NODE_SMOOTH, Inkscape::UI::NODE_SYMMETRIC, reverseSubpaths(), Inkscape::UI::ModifierTracker::rightAlt(), Inkscape::UI::ModifierTracker::rightControl(), Inkscape::UI::SEGMENT_CUBIC_BEZIER, Inkscape::UI::SEGMENT_STRAIGHT, setNodeType(), setSegmentType(), Inkscape::UI::ControlPointSelection::size(), and SPDesktop::yaxisdir().

Referenced by event(), and Inkscape::UI::Tools::NodeTool::root_handler().

◆ insertNode()

void Inkscape::UI::MultiPathManipulator::insertNode ( Geom::Point pt )

Definition at line 340 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PathManipulator::insertNode(), and invokeForAll().

Referenced by Inkscape::UI::Tools::NodeTool::root_handler().

◆ insertNodes()

void Inkscape::UI::MultiPathManipulator::insertNodes ( )

Definition at line 327 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), Inkscape::UI::PathManipulator::insertNodes(), and invokeForAll().

Referenced by event().

◆ insertNodesAtExtrema()

void Inkscape::UI::MultiPathManipulator::insertNodesAtExtrema ( ExtremumType extremum )

Definition at line 333 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), Inkscape::UI::PathManipulator::insertNodeAtExtremum(), and invokeForAll().

◆ invertSelectionInSubpaths()

void Inkscape::UI::MultiPathManipulator::invertSelectionInSubpaths ( )

Definition at line 283 of file multi-path-manipulator.cpp.

References Inkscape::UI::PathManipulator::invertSelectionInSubpaths(), and invokeForAll().

Referenced by Inkscape::SelectionHelper::invert().

◆ invokeForAll() [1/4]

template<typename R >

void Inkscape::UI::MultiPathManipulator::invokeForAll ( R(PathManipulator::*)() method )

inlineprivate

Definition at line 91 of file multi-path-manipulator.h.

References _mmap.

Referenced by _commit(), _done(), breakNodes(), copySelectedPath(), deleteNodes(), deleteSegments(), duplicateNodes(), insertNode(), insertNodes(), insertNodesAtExtrema(), invertSelectionInSubpaths(), joinNodes(), joinSegments(), reverseSubpaths(), selectSubpaths(), setLiveObjects(), setLiveOutline(), setSegmentType(), showHandles(), showPathDirection(), updateHandles(), and updatePaths().

◆ invokeForAll() [2/4]

template<typename R , typename A >

void Inkscape::UI::MultiPathManipulator::invokeForAll	(	R(PathManipulator::*)(A const &)	method,
		A const &	a
	)

inlineprivate

Definition at line 114 of file multi-path-manipulator.h.

References _mmap.

◆ invokeForAll() [3/4]

template<typename R , typename A >

void Inkscape::UI::MultiPathManipulator::invokeForAll	(	R(PathManipulator::*)(A)	method,
		A	a
	)

inlineprivate

Definition at line 108 of file multi-path-manipulator.h.

References _mmap.

◆ invokeForAll() [4/4]

template<typename R , typename A , typename B >

void Inkscape::UI::MultiPathManipulator::invokeForAll	(	R(PathManipulator::*)(A, B)	method,
		A	a,
		B	b
	)

inlineprivate

Definition at line 120 of file multi-path-manipulator.h.

References _mmap.

◆ joinNodes()

void Inkscape::UI::MultiPathManipulator::joinNodes ( )

◆ joinSegments()

void Inkscape::UI::MultiPathManipulator::joinSegments ( )

Join selected endpoints to create segments.

Definition at line 449 of file multi-path-manipulator.cpp.

References _doneWithCleanup(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), Inkscape::UI::NodeList::end(), Inkscape::UI::NodeList::get(), invokeForAll(), Inkscape::join(), Inkscape::UI::NodeList::kill(), Inkscape::UI::NODE_CUSP, Inkscape::UI::NodeList::setClosed(), Inkscape::UI::NodeList::splice(), and Inkscape::UI::PathManipulator::weldSegments().

Referenced by event().

◆ move()

void Inkscape::UI::MultiPathManipulator::move ( Geom::Point const & delta )

Definition at line 515 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, delta, Inkscape::UI::ControlPointSelection::empty(), and Inkscape::UI::ControlPointSelection::transform().

◆ reverseSubpaths()

void Inkscape::UI::MultiPathManipulator::reverseSubpaths ( )

Definition at line 504 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), invokeForAll(), and Inkscape::UI::PathManipulator::reverseSubpaths().

Referenced by event(), and Inkscape::SelectionHelper::reverse().

◆ scale()

void Inkscape::UI::MultiPathManipulator::scale	(	Geom::Point const &	center,
		Geom::Point const &	scale
	)

Definition at line 522 of file multi-path-manipulator.cpp.

References _done(), Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), scale, and Inkscape::UI::ControlPointSelection::transform().

Referenced by alertLPE().

◆ selectSubpaths()

void Inkscape::UI::MultiPathManipulator::selectSubpaths ( )

Definition at line 194 of file multi-path-manipulator.cpp.

References Inkscape::UI::PointManipulator::_selection, Inkscape::UI::ControlPointSelection::empty(), invokeForAll(), Inkscape::UI::ControlPointSelection::selectAll(), and Inkscape::UI::PathManipulator::selectSubpaths().

Referenced by Inkscape::SelectionHelper::selectAll().

◆ setItems()

void Inkscape::UI::MultiPathManipulator::setItems ( std::set< ShapeRecord > const & s )

Change the set of items to edit.

This method attempts to preserve as much of the state as possible.

Definition at line 146 of file multi-path-manipulator.cpp.

References _getOutlineColor(), _live_objects, _live_outline, _mmap, _show_handles, _show_outline, _show_path_direction, Inkscape::UI::ShapeRecord::edit_transform, PathManipulator, Inkscape::UI::ShapeRecord::role, Inkscape::UI::SHAPE_ROLE_NORMAL, and Inkscape::Colors::Color::toRGBA().

Referenced by Inkscape::UI::Tools::NodeTool::selection_changed().

◆ setLiveObjects()

void Inkscape::UI::MultiPathManipulator::setLiveObjects ( bool set )

Set live object update status.

When set to true, objects will be updated continuously when dragging or transforming nodes. Otherwise they will only update when changes are committed to XML.

Definition at line 572 of file multi-path-manipulator.cpp.

References _live_objects, invokeForAll(), set, and Inkscape::UI::PathManipulator::setLiveObjects().

Referenced by Inkscape::UI::Tools::NodeTool::set().

◆ setLiveOutline()

void Inkscape::UI::MultiPathManipulator::setLiveOutline ( bool set )

Set live outline update status.

When set to true, outline will be updated continuously when dragging or transforming nodes. Otherwise it will only update when changes are committed to XML.

Definition at line 560 of file multi-path-manipulator.cpp.

References _live_outline, invokeForAll(), set, and Inkscape::UI::PathManipulator::setLiveOutline().

Referenced by Inkscape::UI::Tools::NodeTool::set().