KoPathToolSelection Class Reference

Handle the selection of points. More...

#include <KoPathToolSelection.h>

Inheritance diagram for KoPathToolSelection:

Signals
void	selectionChanged ()

Public Member Functions
void	add (KoPathPoint *point, bool clear)
	Add a point to the selection.
void	clear ()
	Clear the selection.
bool	contains (KoPathPoint *point)
	Check if a point is in the selection.
bool	hasSelection () override
	reimplemented from KoToolSelection
	KoPathToolSelection (KoPathTool *tool)
void	notifyPathPointsChanged (KoPathShape *shape) override
void	notifyShapeChanged (KoShape::ChangeType type, KoShape *shape) override
int	objectCount () const
	Get the number of path objects in the selection.
void	paint (QPainter &painter, const KoViewConverter &converter, qreal handleRadius)
	Draw the selected points.
void	recommendPointSelectionChange (KoPathShape *shape, const QList< KoPathPointIndex > &newSelection) override
void	remove (KoPathPoint *point)
	Remove a point form the selection.
void	selectAll ()
const QSet< KoPathPoint * > &	selectedPoints () const
	Get all selected points.
QList< KoPathPointData >	selectedPointsData () const
	Get the point data of all selected points.
QList< KoPathPointData >	selectedSegmentsData () const
	Get the point data of all selected segments.
QList< KoPathShape * >	selectedShapes () const
	Returns list of selected shapes.
void	selectPoints (const QRectF &rect, bool clearSelection)
	Select points in rect.
void	setSelectedShapes (const QList< KoPathShape * > shapes)
	Sets list of selected shapes.
int	size () const
	Get the number of path points in the selection.
void	update ()
	Update the selection to contain only valid points.
	~KoPathToolSelection () override
Public Member Functions inherited from KoToolSelection
	KoToolSelection (QObject *parent=0)
	~KoToolSelection () override
Public Member Functions inherited from KoPathShape::PointSelectionChangeListener
void	notifyShapeChanged (ChangeType type, KoShape *shape) override

Private Types
typedef QMap< KoPathShape *, QSet< KoPathPoint * > >	PathShapePointMap

Private Attributes
QSet< KoPathPoint * >	m_selectedPoints
QList< KoPathShape * >	m_selectedShapes
PathShapePointMap	m_shapePointMap
KoPathTool *	m_tool

Detailed Description

Handle the selection of points.

This class handles the selection of points. It makes sure the canvas is repainted when the selection changes.

Definition at line 28 of file KoPathToolSelection.h.

Member Typedef Documentation

PathShapePointMap

typedef QMap<KoPathShape *, QSet<KoPathPoint *> > KoPathToolSelection::PathShapePointMap

private

Definition at line 141 of file KoPathToolSelection.h.

Constructor & Destructor Documentation

KoPathToolSelection()

KoPathToolSelection::KoPathToolSelection ( KoPathTool * tool )

explicit

Definition at line 22 of file KoPathToolSelection.cpp.

        : m_tool(tool)
{
}

~KoPathToolSelection()

KoPathToolSelection::~KoPathToolSelection ( )

override

Definition at line 27 of file KoPathToolSelection.cpp.

{
}

Member Function Documentation

add()

void KoPathToolSelection::add	(	KoPathPoint *	point,
		bool	clear )

Add a point to the selection.

Parameters

point	to add to the selection
clear	if true the selection will be cleared before adding the point

Definition at line 46 of file KoPathToolSelection.cpp.

{
    if(! point)
        return;
 
    bool alreadyIn = false;
    if (clear) {
        if (size() == 1 && m_selectedPoints.contains(point)) {
            alreadyIn = true;
        } else {
            this->clear();
        }
    } else {
        alreadyIn = m_selectedPoints.contains(point);
    }
 
    if (!alreadyIn) {
        m_selectedPoints.insert(point);
        KoPathShape * pathShape = point->parent();
        PathShapePointMap::iterator it(m_shapePointMap.find(pathShape));
        if (it == m_shapePointMap.end()) {
            it = m_shapePointMap.insert(pathShape, QSet<KoPathPoint *>());
        }
        it.value().insert(point);
        Q_EMIT selectionChanged();
    }
}

References clear(), m_selectedPoints, m_shapePointMap, KoPathPoint::parent(), selectionChanged(), and size().

clear()

void KoPathToolSelection::clear

(

)

Clear the selection.

Definition at line 86 of file KoPathToolSelection.cpp.

{
    m_selectedPoints.clear();
    m_shapePointMap.clear();
    Q_EMIT selectionChanged();
}

References m_selectedPoints, m_shapePointMap, and selectionChanged().

contains()

bool KoPathToolSelection::contains

(

KoPathPoint *

point

)

Check if a point is in the selection.

Returns

true when the point is in the selection, false otherwise

Definition at line 135 of file KoPathToolSelection.cpp.

{
    return m_selectedPoints.contains(point);
}

References m_selectedPoints.

hasSelection()

bool KoPathToolSelection::hasSelection ( )

overridevirtual

reimplemented from KoToolSelection

Reimplemented from KoToolSelection.

Definition at line 240 of file KoPathToolSelection.cpp.

{
    return !m_selectedPoints.isEmpty();
}

References m_selectedPoints.

notifyPathPointsChanged()

void KoPathToolSelection::notifyPathPointsChanged ( KoPathShape * shape )

overridevirtual

Implements KoPathShape::PointSelectionChangeListener.

Definition at line 263 of file KoPathToolSelection.cpp.

{
    QSet<KoPathPoint*> selectedShapePoints = m_shapePointMap.value(shape, QSet<KoPathPoint*>());
 
    Q_FOREACH (KoPathPoint *point, selectedShapePoints) {
        m_selectedPoints.remove(point);
    }
    m_shapePointMap.remove(shape);
 
    m_tool->notifyPathPointsChanged(shape);
 
    Q_EMIT selectionChanged();
}

References m_selectedPoints, m_shapePointMap, m_tool, KoPathTool::notifyPathPointsChanged(), and selectionChanged().

notifyShapeChanged()

void KoPathToolSelection::notifyShapeChanged ( KoShape::ChangeType type, KoShape * shape )

override

Definition at line 277 of file KoPathToolSelection.cpp.

{
    if (type == KoShape::Deleted) {
        // we cannot select non-path shapes, so static cast is safe here
        KIS_SAFE_ASSERT_RECOVER_NOOP(shape->shapeId() == KoPathShapeId);
 
        if (KoPathShape *pathShape = static_cast<KoPathShape*>(shape)) {
 
            QSet<KoPathPoint*> selectedShapePoints = m_shapePointMap.value(pathShape, QSet<KoPathPoint*>());
            Q_FOREACH (KoPathPoint *point, selectedShapePoints) {
                m_selectedPoints.remove(point);
            }
            m_shapePointMap.remove(pathShape);
            m_selectedShapes.removeAll(pathShape);
        }
    }
 
    KoPathShape::PointSelectionChangeListener::notifyShapeChanged(type, shape);
}

References KoShape::Deleted, KIS_SAFE_ASSERT_RECOVER_NOOP, KoPathShapeId, m_selectedPoints, m_selectedShapes, m_shapePointMap, KoPathShape::PointSelectionChangeListener::notifyShapeChanged(), and KoShape::shapeId().

objectCount()

int KoPathToolSelection::objectCount

(

)

const

Get the number of path objects in the selection.

Returns

number of path object in the point selection

Definition at line 125 of file KoPathToolSelection.cpp.

{
    return m_shapePointMap.size();
}

References m_shapePointMap.

paint()

void KoPathToolSelection::paint	(	QPainter &	painter,
		const KoViewConverter &	converter,
		qreal	handleRadius )

Draw the selected points.

Definition at line 31 of file KoPathToolSelection.cpp.

{
    int decorationThickness = m_tool? m_tool->decorationThickness(): 1;
    PathShapePointMap::iterator it(m_shapePointMap.begin());
    for (; it != m_shapePointMap.end(); ++it) {
        KisHandlePainterHelper helper =
            KoShape::createHandlePainterHelperView(&painter, it.key(), converter, handleRadius, decorationThickness);
        helper.setHandleStyle(KisHandleStyle::selectedPrimaryHandles());
 
        Q_FOREACH (KoPathPoint *p, it.value()) {
            p->paint(helper, KoPathPoint::All);
        }
    }
}

References KoPathPoint::All, KoShape::createHandlePainterHelperView(), KoToolBase::decorationThickness(), m_shapePointMap, m_tool, p, KisHandleStyle::selectedPrimaryHandles(), and KisHandlePainterHelper::setHandleStyle().

recommendPointSelectionChange()

void KoPathToolSelection::recommendPointSelectionChange ( KoPathShape * shape, const QList< KoPathPointIndex > & newSelection )

overridevirtual

Implements KoPathShape::PointSelectionChangeListener.

Definition at line 245 of file KoPathToolSelection.cpp.

{
    QSet<KoPathPoint*> selectedShapePoints = m_shapePointMap.value(shape, QSet<KoPathPoint*>());
 
    Q_FOREACH (KoPathPoint *point, selectedShapePoints) {
        remove(point);
    }
 
    Q_FOREACH (const KoPathPointIndex &index, newSelection) {
        KoPathPoint *point = shape->pointByIndex(index);
        KIS_SAFE_ASSERT_RECOVER(point) { continue; }
 
        add(point, false);
    }
 
    Q_EMIT selectionChanged();
}

References add(), KIS_SAFE_ASSERT_RECOVER, m_shapePointMap, KoPathShape::pointByIndex(), remove(), and selectionChanged().

remove()

void KoPathToolSelection::remove

(

KoPathPoint *

point

)

Remove a point form the selection.

Parameters

point

to remove from the selection

Definition at line 74 of file KoPathToolSelection.cpp.

{
    if (m_selectedPoints.remove(point)) {
        KoPathShape * pathShape = point->parent();
        m_shapePointMap[pathShape].remove(point);
        if (m_shapePointMap[pathShape].size() == 0) {
            m_shapePointMap.remove(pathShape);
        }
        Q_EMIT selectionChanged();
    }
}

References m_selectedPoints, m_shapePointMap, KoPathPoint::parent(), selectionChanged(), and size().

selectAll()

void KoPathToolSelection::selectAll

(

)

Definition at line 111 of file KoPathToolSelection.cpp.

{
    blockSignals(true);
    Q_FOREACH (KoPathShape* shape, m_selectedShapes) {
        KoParameterShape *parameterShape = dynamic_cast<KoParameterShape*>(shape);
        if (parameterShape && parameterShape->isParametricShape())
            continue;
        Q_FOREACH (KoPathPoint* point, shape->pointsAt(shape->outlineRect().adjusted(-2, -2, 2, 2)))
            add(point, false);
    }
    blockSignals(false);
    Q_EMIT selectionChanged();
}

References add(), KoParameterShape::isParametricShape(), m_selectedShapes, KoPathShape::outlineRect(), KoPathShape::pointsAt(), and selectionChanged().

selectedPoints()

const QSet< KoPathPoint * > & KoPathToolSelection::selectedPoints

(

)

const

Get all selected points.

Returns

set of selected points

Definition at line 140 of file KoPathToolSelection.cpp.

{
    return m_selectedPoints;
}

References m_selectedPoints.

selectedPointsData()

QList< KoPathPointData > KoPathToolSelection::selectedPointsData

(

)

const

Get the point data of all selected points.

This is subject to change

Definition at line 145 of file KoPathToolSelection.cpp.

{
    QList<KoPathPointData> pointData;
    Q_FOREACH (KoPathPoint* p, m_selectedPoints) {
        KoPathShape * pathShape = p->parent();
        pointData.append(KoPathPointData(pathShape, pathShape->pathPointIndex(p)));
    }
    return pointData;
}

References m_selectedPoints, p, KoShape::parent(), and KoPathShape::pathPointIndex().

selectedSegmentsData()

QList< KoPathPointData > KoPathToolSelection::selectedSegmentsData

(

)

const

Get the point data of all selected segments.

This is subject to change

Definition at line 155 of file KoPathToolSelection.cpp.

{
    QList<KoPathPointData> pointData;
 
    QList<KoPathPointData> pd(selectedPointsData());
    std::sort(pd.begin(), pd.end());
 
    KoPathPointData last(0, KoPathPointIndex(-1, -1));
    KoPathPointData lastSubpathStart(0, KoPathPointIndex(-1, -1));
 
    QList<KoPathPointData>::const_iterator it(pd.constBegin());
    for (; it != pd.constEnd(); ++it) {
        if (it->pointIndex.second == 0)
            lastSubpathStart = *it;
 
        if (last.pathShape == it->pathShape
                && last.pointIndex.first == it->pointIndex.first
                && last.pointIndex.second + 1 == it->pointIndex.second) {
            pointData.append(last);
        }
 
        if (lastSubpathStart.pathShape == it->pathShape
                && it->pathShape->pointByIndex(it->pointIndex)->properties() & KoPathPoint::CloseSubpath
                && (it->pathShape->pointByIndex(it->pointIndex)->properties() & KoPathPoint::StartSubpath) == 0) {
            pointData.append(*it);
        }
 
        last = *it;
    }
 
    return pointData;
}

References KoPathPoint::CloseSubpath, KoPathPointData::pathShape, KoPathPointData::pointIndex, selectedPointsData(), and KoPathPoint::StartSubpath.

selectedShapes()

QList< KoPathShape * > KoPathToolSelection::selectedShapes

(

)

const

Returns list of selected shapes.

Definition at line 188 of file KoPathToolSelection.cpp.

{
    return m_selectedShapes;
}

References m_selectedShapes.

selectionChanged

void KoPathToolSelection::selectionChanged ( )

signal

selectPoints()

void KoPathToolSelection::selectPoints	(	const QRectF &	rect,
		bool	clearSelection )

Select points in rect.

Parameters

rect	the selection rectangle in document coordinates
clearSelection	if set clear the current selection before the selection

Definition at line 93 of file KoPathToolSelection.cpp.

{
    if (clearSelection) {
        clear();
    }
 
    blockSignals(true);
    Q_FOREACH (KoPathShape* shape, m_selectedShapes) {
        KoParameterShape *parameterShape = dynamic_cast<KoParameterShape*>(shape);
        if (parameterShape && parameterShape->isParametricShape())
            continue;
        Q_FOREACH (KoPathPoint* point, shape->pointsAt(shape->documentToShape(rect)))
            add(point, false);
    }
    blockSignals(false);
    Q_EMIT selectionChanged();
}

References add(), clear(), KoShape::documentToShape(), KoParameterShape::isParametricShape(), m_selectedShapes, KoPathShape::pointsAt(), and selectionChanged().

setSelectedShapes()

void KoPathToolSelection::setSelectedShapes

(

const QList< KoPathShape * >

shapes

)

Sets list of selected shapes.

Definition at line 193 of file KoPathToolSelection.cpp.

{
    Q_FOREACH(KoPathShape *shape, m_selectedShapes) {
        shape->removeShapeChangeListener(this);
    }
 
    m_selectedShapes = shapes;
 
    Q_FOREACH(KoPathShape *shape, m_selectedShapes) {
        shape->addShapeChangeListener(this);
    }
}

References KoShape::addShapeChangeListener(), m_selectedShapes, and KoShape::removeShapeChangeListener().

size()

int KoPathToolSelection::size

(

)

const

Get the number of path points in the selection.

Returns

number of points in the selection

Definition at line 130 of file KoPathToolSelection.cpp.

{
    return m_selectedPoints.size();
}

References m_selectedPoints.

update()

void KoPathToolSelection::update

(

)

Update the selection to contain only valid points.

This function checks which points are no longer valid and removes them from the selection. If e.g. some points are selected and the shape which contains the points is removed by undo, the points are no longer valid and have therefore to be removed from the selection.

Definition at line 206 of file KoPathToolSelection.cpp.

{
    bool selectionHasChanged = false;
 
    PathShapePointMap::iterator it(m_shapePointMap.begin());
    while (it != m_shapePointMap.end()) {
        KoParameterShape *parameterShape = dynamic_cast<KoParameterShape*>(it.key());
        bool isParametricShape = parameterShape && parameterShape->isParametricShape();
        if (! m_selectedShapes.contains(it.key()) || isParametricShape) {
            QSet<KoPathPoint *>::iterator pointIt(it.value().begin());
            for (; pointIt != it.value().end(); ++pointIt) {
                m_selectedPoints.remove(*pointIt);
            }
            it = m_shapePointMap.erase(it);
            selectionHasChanged = true;
        } else {
            QSet<KoPathPoint *>::iterator pointIt(it.value().begin());
            while (pointIt != it.value().end()) {
                if ((*pointIt)->parent()->pathPointIndex(*pointIt) == KoPathPointIndex(-1, -1)) {
                    m_selectedPoints.remove(*pointIt);
                    pointIt = it.value().erase(pointIt);
                    selectionHasChanged = true;
                } else {
                    ++pointIt;
                }
            }
            ++it;
        }
    }
 
    if (selectionHasChanged)
        Q_EMIT selectionChanged();
}

References KoParameterShape::isParametricShape(), m_selectedPoints, m_selectedShapes, m_shapePointMap, and selectionChanged().

Member Data Documentation

m_selectedPoints

QSet<KoPathPoint *> KoPathToolSelection::m_selectedPoints

private

Definition at line 143 of file KoPathToolSelection.h.

m_selectedShapes

QList<KoPathShape*> KoPathToolSelection::m_selectedShapes

private

Definition at line 146 of file KoPathToolSelection.h.

m_shapePointMap

PathShapePointMap KoPathToolSelection::m_shapePointMap

private

Definition at line 144 of file KoPathToolSelection.h.

m_tool

KoPathTool* KoPathToolSelection::m_tool

private

Definition at line 145 of file KoPathToolSelection.h.

---

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

• libs/flake/tools/KoPathToolSelection.h
• libs/flake/tools/KoPathToolSelection.cpp