AngleSnapStrategy Class Reference

#include <KoCreatePathTool_p.h>

Inheritance diagram for AngleSnapStrategy:

Public Member Functions
void	activate ()
	AngleSnapStrategy (qreal angleStep, bool active)
void	deactivate ()
QPainterPath	decoration (const KoViewConverter &converter) const override
	returns the current snap strategy decoration
void	setAngleStep (qreal angleStep)
void	setStartPoint (const QPointF &startPoint)
bool	snap (const QPointF &mousePosition, KoSnapProxy *proxy, qreal maxSnapDistance) override
Public Member Functions inherited from KoSnapStrategy
	KoSnapStrategy (KoSnapGuide::Strategy type)
QPointF	snappedPosition () const
	returns the snapped position form the last call to snapToPoints
SnapType	snappedType () const
KoSnapGuide::Strategy	type () const
	returns the strategies type
virtual	~KoSnapStrategy ()

Private Attributes
bool	m_active
qreal	m_angleStep
QPointF	m_startPoint

Additional Inherited Members
Public Types inherited from KoSnapStrategy
enum	SnapType { ToPoint = 0 , ToLine }
Static Public Member Functions inherited from KoSnapStrategy
static qreal	scalarProduct (const QPointF &p1, const QPointF &p2)
static qreal	squareDistance (const QPointF &p1, const QPointF &p2)
Protected Member Functions inherited from KoSnapStrategy
void	setSnappedPosition (const QPointF &position, SnapType snapType)
	sets the current snapped position

Detailed Description

Definition at line 98 of file KoCreatePathTool_p.h.

Constructor & Destructor Documentation

AngleSnapStrategy()

AngleSnapStrategy::AngleSnapStrategy ( qreal angleStep, bool active )

inlineexplicit

Definition at line 101 of file KoCreatePathTool_p.h.

        : KoSnapStrategy(KoSnapGuide::CustomSnapping), m_angleStep(angleStep), m_active(active) {
    }

Member Function Documentation

activate()

void AngleSnapStrategy::activate ( )

inline

Definition at line 154 of file KoCreatePathTool_p.h.

                    {
        m_active = true;
    }

References m_active.

deactivate()

void AngleSnapStrategy::deactivate ( )

inline

Definition at line 150 of file KoCreatePathTool_p.h.

                      {
        m_active = false;
    }

References m_active.

decoration()

QPainterPath AngleSnapStrategy::decoration ( const KoViewConverter & converter ) const

inlineoverridevirtual

returns the current snap strategy decoration

Implements KoSnapStrategy.

Definition at line 141 of file KoCreatePathTool_p.h.

                                                                             {
        Q_UNUSED(converter);
 
        QPainterPath decoration;
        decoration.moveTo(m_startPoint);
        decoration.lineTo(snappedPosition());
        return decoration;
    }

References decoration(), m_startPoint, and KoSnapStrategy::snappedPosition().

setAngleStep()

void AngleSnapStrategy::setAngleStep ( qreal angleStep )

inline

Definition at line 109 of file KoCreatePathTool_p.h.

                                       {
        m_angleStep = qAbs(angleStep);
    }

References m_angleStep.

setStartPoint()

void AngleSnapStrategy::setStartPoint ( const QPointF & startPoint )

inline

Definition at line 105 of file KoCreatePathTool_p.h.

                                                  {
        m_startPoint = startPoint;
    }

References m_startPoint.

snap()

bool AngleSnapStrategy::snap ( const QPointF & mousePosition, KoSnapProxy * proxy, qreal maxSnapDistance )

inlineoverridevirtual

Implements KoSnapStrategy.

Definition at line 113 of file KoCreatePathTool_p.h.

                                                                                                 {
        Q_UNUSED(proxy);
 
        if (!m_active)
            return false;
 
        QLineF line(m_startPoint, mousePosition);
        qreal currentAngle = line.angle();
        int prevStep = qAbs(currentAngle / m_angleStep);
        int nextStep = prevStep + 1;
        qreal prevAngle = prevStep * m_angleStep;
        qreal nextAngle = nextStep * m_angleStep;
 
        if (qAbs(currentAngle - prevAngle) <= qAbs(currentAngle - nextAngle)) {
            line.setAngle(prevAngle);
        } else {
            line.setAngle(nextAngle);
        }
 
        qreal maxSquareSnapDistance = maxSnapDistance * maxSnapDistance;
        qreal snapDistance = squareDistance(mousePosition, line.p2());
        if (snapDistance > maxSquareSnapDistance)
            return false;
 
        setSnappedPosition(line.p2(), ToLine);
        return true;
    }

References m_active, m_angleStep, m_startPoint, KoSnapStrategy::setSnappedPosition(), KoSnapStrategy::squareDistance(), and KoSnapStrategy::ToLine.

Member Data Documentation

m_active

bool AngleSnapStrategy::m_active

private

Definition at line 161 of file KoCreatePathTool_p.h.

m_angleStep

qreal AngleSnapStrategy::m_angleStep

private

Definition at line 160 of file KoCreatePathTool_p.h.

m_startPoint

QPointF AngleSnapStrategy::m_startPoint

private

Definition at line 159 of file KoCreatePathTool_p.h.

---

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

• libs/basicflakes/tools/KoCreatePathTool_p.h