#include <kis_temporary_paint_constraint.h>

Public Types
enum class	InteractionMode { Normal , SnapToAngle }

Public Member Functions
QPointF	adjustPosition (const QPointF &point, const QPointF &strokeBegin, bool checkForInitialMovement, qreal moveThresholdPt) const

void	beginLine (const QPointF &anchor)

bool	hasLine () const

bool	hasValidLine () const

InteractionMode	interactionMode () const

bool	isLocked () const

QPointF	lineAnchor () const

QPointF	lineSecondPoint () const

void	setInteractionMode (InteractionMode mode)

void	setLocked (bool locked)

void	updateLine (const QPointF &secondPoint, bool snapToAngle=false)

Private Attributes
QPointF	m_anchor

bool	m_angleSnapped {false}

bool	m_hasLine {false}

InteractionMode	m_interactionMode {InteractionMode::Normal}

bool	m_locked {false}

QPointF	m_secondPoint

Detailed Description

Definition at line 13 of file kis_temporary_paint_constraint.h.

Member Enumeration Documentation

◆ InteractionMode

enum class KisTemporaryPaintConstraint::InteractionMode

strong

Enumerator
Normal
SnapToAngle

Definition at line 16 of file kis_temporary_paint_constraint.h.

                               {
        Normal,
        SnapToAngle
    };

Member Function Documentation

◆ adjustPosition()

QPointF KisTemporaryPaintConstraint::adjustPosition	(	const QPointF &	point,
		const QPointF &	strokeBegin,
		bool	checkForInitialMovement,
		qreal	moveThresholdPt ) const

Definition at line 100 of file kis_temporary_paint_constraint.cpp.

{
    if (!m_locked || !hasValidLine()) {
        return point;
    }
 
    if (checkForInitialMovement && KisAlgebra2D::norm(point - strokeBegin) < moveThresholdPt) {
        return strokeBegin;
    }
 
    const QPointF delta = m_secondPoint - m_anchor;
    const qreal squareLength = KisAlgebra2D::normSquared(delta);
    if (qFuzzyIsNull(squareLength)) {
        return point;
    }
 
    const qreal t = KisAlgebra2D::dotProduct(point - m_anchor, delta) / squareLength;
    return m_anchor + delta * t;
}

References KisAlgebra2D::dotProduct(), hasValidLine(), m_anchor, m_locked, m_secondPoint, KisAlgebra2D::norm(), KisAlgebra2D::normSquared(), and qFuzzyIsNull().

◆ beginLine()

void KisTemporaryPaintConstraint::beginLine ( const QPointF & anchor )

Definition at line 42 of file kis_temporary_paint_constraint.cpp.

{
    m_anchor = anchor;
    m_secondPoint = anchor;
    m_hasLine = true;
    m_locked = false;
    m_angleSnapped = false;
}

References m_anchor, m_angleSnapped, m_hasLine, m_locked, and m_secondPoint.

◆ hasLine()

bool KisTemporaryPaintConstraint::hasLine ( ) const

Definition at line 70 of file kis_temporary_paint_constraint.cpp.

{
    return m_hasLine;
}

References m_hasLine.

◆ hasValidLine()

bool KisTemporaryPaintConstraint::hasValidLine ( ) const

Definition at line 85 of file kis_temporary_paint_constraint.cpp.

{
    return m_hasLine && KisAlgebra2D::normSquared(m_secondPoint - m_anchor) > minLineLengthSquared;
}

References m_anchor, m_hasLine, m_secondPoint, and KisAlgebra2D::normSquared().

◆ interactionMode()

KisTemporaryPaintConstraint::InteractionMode KisTemporaryPaintConstraint::interactionMode ( ) const

Definition at line 37 of file kis_temporary_paint_constraint.cpp.

{
    return m_interactionMode;
}

References m_interactionMode.

◆ isLocked()

bool KisTemporaryPaintConstraint::isLocked ( ) const

Definition at line 80 of file kis_temporary_paint_constraint.cpp.

{
    return m_locked;
}

References m_locked.

◆ lineAnchor()

QPointF KisTemporaryPaintConstraint::lineAnchor ( ) const

Definition at line 90 of file kis_temporary_paint_constraint.cpp.

{
    return m_anchor;
}

References m_anchor.

◆ lineSecondPoint()

QPointF KisTemporaryPaintConstraint::lineSecondPoint ( ) const

Definition at line 95 of file kis_temporary_paint_constraint.cpp.

{
    return m_secondPoint;
}

References m_secondPoint.

◆ setInteractionMode()

void KisTemporaryPaintConstraint::setInteractionMode ( InteractionMode mode )

Definition at line 32 of file kis_temporary_paint_constraint.cpp.

{
    m_interactionMode = mode;
}

References m_interactionMode.

◆ setLocked()

void KisTemporaryPaintConstraint::setLocked ( bool locked )

Definition at line 75 of file kis_temporary_paint_constraint.cpp.

{
    m_locked = locked && hasValidLine();
}

References hasValidLine(), and m_locked.

◆ updateLine()

void KisTemporaryPaintConstraint::updateLine	(	const QPointF &	secondPoint,
		bool	snapToAngle = false )

Definition at line 51 of file kis_temporary_paint_constraint.cpp.

{
    if (m_locked) {
        return;
    }
 
    if (!m_hasLine) {
        beginLine(secondPoint);
        return;
    }
 
    if (snapToAngle) {
        m_secondPoint = snappedEndpoint(m_anchor, secondPoint);
        m_angleSnapped = true;
    } else if (!m_angleSnapped) {
        m_secondPoint = secondPoint;
    }
}