KisSimplifiedActionPolicyStrategy Class Reference

#include <kis_simplified_action_policy_strategy.h>

Inheritance diagram for KisSimplifiedActionPolicyStrategy:

Classes
struct	Private

Public Member Functions
void	activateAlternateAction (KisTool::AlternateAction action) override
void	activatePrimaryAction () override
bool	beginAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
bool	beginPrimaryAction (KoPointerEvent *event) override
void	continueAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
void	continuePrimaryAction (KoPointerEvent *event) override
void	deactivateAlternateAction (KisTool::AlternateAction action) override
bool	endAlternateAction (KoPointerEvent *event, KisTool::AlternateAction action) override
bool	endPrimaryAction (KoPointerEvent *event) override
virtual QPointF	handleSnapPoint (const QPointF &imagePos)
void	hoverActionCommon (KoPointerEvent *event) override
	KisSimplifiedActionPolicyStrategy (const KisCoordinatesConverter *_converter, KoSnapGuide *snapGuide=0)
	~KisSimplifiedActionPolicyStrategy () override
Public Member Functions inherited from KisTransformStrategyBase
virtual bool	acceptsClicks () const
virtual void	deactivatePrimaryAction ()
virtual int	decorationThickness () const
virtual void	externalConfigChanged ()=0
virtual QCursor	getCurrentCursor () const =0
virtual QPainterPath	getCursorOutline () const
	KisTransformStrategyBase ()
QImage	originalImage () const
virtual void	paint (QPainter &gc)=0
virtual void	setDecorationThickness (int thickness)
void	setThumbnailImage (const QImage &image, QTransform thumbToImageTransform)
QTransform	thumbToImageTransform () const
	~KisTransformStrategyBase () override

Protected Member Functions
virtual bool	beginPrimaryAction (const QPointF &pt)=0
virtual void	continuePrimaryAction (const QPointF &pt, bool shiftModifierActive, bool altModifierActive)=0
virtual bool	endPrimaryAction ()=0
virtual void	hoverActionCommon (const QPointF &pt)
virtual void	setTransformFunction (const QPointF &mousePos, bool perspectiveModifierActive, bool shiftModifierActive, bool altModifierActive)=0
virtual bool	shiftModifierIsUsed () const

Private Member Functions
QPointF	snapDocPoint (const QPointF &point, Qt::KeyboardModifiers modifiers) const

Private Attributes
const QScopedPointer< Private >	m_d

Detailed Description

Definition at line 19 of file kis_simplified_action_policy_strategy.h.

Constructor & Destructor Documentation

KisSimplifiedActionPolicyStrategy()

KisSimplifiedActionPolicyStrategy::KisSimplifiedActionPolicyStrategy	(	const KisCoordinatesConverter *	_converter,
		KoSnapGuide *	snapGuide = 0 )

Definition at line 34 of file kis_simplified_action_policy_strategy.cpp.

    : m_d(new Private(_converter, _snapGuide))
{
}

~KisSimplifiedActionPolicyStrategy()

KisSimplifiedActionPolicyStrategy::~KisSimplifiedActionPolicyStrategy ( )

override

Definition at line 39 of file kis_simplified_action_policy_strategy.cpp.

{
}

Member Function Documentation

activateAlternateAction()

void KisSimplifiedActionPolicyStrategy::activateAlternateAction ( KisTool::AlternateAction action )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 136 of file kis_simplified_action_policy_strategy.cpp.

{
    if (action == KisTool::ChangeSize) {
        m_d->changeSizeModifierActive = true;
    } else if (action == KisTool::SampleFgNode || action == KisTool::SampleBgNode) {
        m_d->anySamplerModifierActive = true;
        m_d->sampleFromNodeModifierActive = true;
    } else if (action == KisTool::SampleFgImage || action == KisTool::SampleBgImage) {
        m_d->anySamplerModifierActive = true;
        m_d->sampleFromNodeModifierActive = false;
    }
 
    setTransformFunction(m_d->lastImagePos, m_d->anySamplerModifierActive && !m_d->sampleFromNodeModifierActive, m_d->changeSizeModifierActive, m_d->sampleFromNodeModifierActive);
}

References KisTool::ChangeSize, m_d, KisTool::SampleBgImage, KisTool::SampleBgNode, KisTool::SampleFgImage, KisTool::SampleFgNode, and setTransformFunction().

activatePrimaryAction()

void KisSimplifiedActionPolicyStrategy::activatePrimaryAction ( )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 131 of file kis_simplified_action_policy_strategy.cpp.

{
    setTransformFunction(m_d->lastImagePos, m_d->anySamplerModifierActive && !m_d->sampleFromNodeModifierActive, m_d->changeSizeModifierActive, m_d->sampleFromNodeModifierActive);
}

References m_d, and setTransformFunction().

beginAlternateAction()

bool KisSimplifiedActionPolicyStrategy::beginAlternateAction ( KoPointerEvent * event, KisTool::AlternateAction action )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 163 of file kis_simplified_action_policy_strategy.cpp.

{
    Q_UNUSED(action);
 
    if (!m_d->changeSizeModifierActive && !m_d->anySamplerModifierActive) return false;
 
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    return beginPrimaryAction(imagePos);
}

References beginPrimaryAction(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

beginPrimaryAction() [1/2]

virtual bool KisSimplifiedActionPolicyStrategy::beginPrimaryAction ( const QPointF & pt )

protectedpure virtual

Implemented in KisFreeTransformStrategy, KisMeshTransformStrategy, KisPerspectiveTransformStrategy, KisWarpTransformStrategy, and KisMeshTransformStrategy.

beginPrimaryAction() [2/2]

bool KisSimplifiedActionPolicyStrategy::beginPrimaryAction ( KoPointerEvent * event )

overridevirtual

Note: Snapping with Offset is not yet used in the transform strategies. When the user starts an action, we just move the handle to the mouse position, even if it was positioned with an offset. That is not what we do in Crop Tool.

Implements KisTransformStrategyBase.

Reimplemented in KisWarpTransformStrategy.

Definition at line 65 of file kis_simplified_action_policy_strategy.cpp.

{
    const QPointF rawImagePoint = m_d->converter->documentToImage(event->point);
    const QPointF snappedImagePoint = handleSnapPoint(rawImagePoint);
 
    if (m_d->snapGuide && rawImagePoint != snappedImagePoint) {
        QPointF imageOffset = snappedImagePoint - rawImagePoint;
        m_d->dragOffset = m_d->converter->imageToDocument(imageOffset);
    }
 
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
 
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    return beginPrimaryAction(imagePos);
}

References beginPrimaryAction(), handleSnapPoint(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

continueAlternateAction()

void KisSimplifiedActionPolicyStrategy::continueAlternateAction ( KoPointerEvent * event, KisTool::AlternateAction action )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 176 of file kis_simplified_action_policy_strategy.cpp.

{
    Q_UNUSED(action);
 
    if (!m_d->changeSizeModifierActive && !m_d->anySamplerModifierActive) return;
    const bool altIsActive = event->modifiers() & Qt::AltModifier;
 
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    continuePrimaryAction(imagePos, m_d->changeSizeModifierActive, altIsActive);
}

References continuePrimaryAction(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

continuePrimaryAction() [1/2]

virtual void KisSimplifiedActionPolicyStrategy::continuePrimaryAction ( const QPointF & pt, bool shiftModifierActive, bool altModifierActive )

protectedpure virtual

Implemented in KisFreeTransformStrategy, KisMeshTransformStrategy, KisPerspectiveTransformStrategy, KisWarpTransformStrategy, and KisMeshTransformStrategy.

continuePrimaryAction() [2/2]

void KisSimplifiedActionPolicyStrategy::continuePrimaryAction ( KoPointerEvent * event )

overridevirtual

HACK ALERT!

Here we explicitly check for Shift key pressed! The choice of the stroke type is usually done before the tablet press, but for some actions like constrain proportions we should be able to activate it even after the stroke has been started. For now, KisShortcutMatcher does not support it, so just hardcode this special case.

See bug 340496

Implements KisTransformStrategyBase.

Reimplemented in KisWarpTransformStrategy.

Definition at line 90 of file kis_simplified_action_policy_strategy.cpp.

{
    const bool shiftIsActive = event->modifiers() & Qt::ShiftModifier;
    const bool altIsActive = event->modifiers() & Qt::AltModifier;
 
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    return continuePrimaryAction(imagePos, shiftIsActive, altIsActive);
}

References continuePrimaryAction(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

deactivateAlternateAction()

void KisSimplifiedActionPolicyStrategy::deactivateAlternateAction ( KisTool::AlternateAction action )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 151 of file kis_simplified_action_policy_strategy.cpp.

{
    if (action == KisTool::ChangeSize) {
        m_d->changeSizeModifierActive = false;
    } else if (action == KisTool::SampleFgNode || action == KisTool::SampleBgNode ||
               action == KisTool::SampleFgImage || action == KisTool::SampleBgImage) {
 
        m_d->anySamplerModifierActive = false;
        m_d->sampleFromNodeModifierActive = false;
    }
}

References KisTool::ChangeSize, m_d, KisTool::SampleBgImage, KisTool::SampleBgNode, KisTool::SampleFgImage, and KisTool::SampleFgNode.

endAlternateAction()

bool KisSimplifiedActionPolicyStrategy::endAlternateAction ( KoPointerEvent * event, KisTool::AlternateAction action )

overridevirtual

Reimplemented from KisTransformStrategyBase.

Definition at line 190 of file kis_simplified_action_policy_strategy.cpp.

{
    Q_UNUSED(action);
 
    if (!m_d->changeSizeModifierActive && !m_d->anySamplerModifierActive) return false;
 
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    return endPrimaryAction();
}

References endPrimaryAction(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

endPrimaryAction() [1/2]

virtual bool KisSimplifiedActionPolicyStrategy::endPrimaryAction ( )

protectedpure virtual

Implemented in KisFreeTransformStrategy, KisMeshTransformStrategy, KisPerspectiveTransformStrategy, KisWarpTransformStrategy, and KisMeshTransformStrategy.

endPrimaryAction() [2/2]

bool KisSimplifiedActionPolicyStrategy::endPrimaryAction ( KoPointerEvent * event )

overridevirtual

Implements KisTransformStrategyBase.

Reimplemented in KisWarpTransformStrategy.

Definition at line 122 of file kis_simplified_action_policy_strategy.cpp.

{
    const QPointF pos = snapDocPoint(event->point, event->modifiers());
    QPointF imagePos = m_d->converter->documentToImage(pos);
    m_d->lastImagePos = imagePos;
 
    return endPrimaryAction();
}

References endPrimaryAction(), m_d, KoPointerEvent::modifiers(), KoPointerEvent::point, and snapDocPoint().

handleSnapPoint()

QPointF KisSimplifiedActionPolicyStrategy::handleSnapPoint ( const QPointF & imagePos )

virtual

Reimplemented in KisMeshTransformStrategy.

Definition at line 43 of file kis_simplified_action_policy_strategy.cpp.

{
    return imagePos;
}

hoverActionCommon() [1/2]

void KisSimplifiedActionPolicyStrategy::hoverActionCommon ( const QPointF & pt )

protectedvirtual

Definition at line 208 of file kis_simplified_action_policy_strategy.cpp.

{
    setTransformFunction(pt, m_d->anySamplerModifierActive && !m_d->sampleFromNodeModifierActive, m_d->changeSizeModifierActive, m_d->sampleFromNodeModifierActive);
}

References m_d, and setTransformFunction().

hoverActionCommon() [2/2]

void KisSimplifiedActionPolicyStrategy::hoverActionCommon ( KoPointerEvent * event )

overridevirtual

Implements KisTransformStrategyBase.

Definition at line 114 of file kis_simplified_action_policy_strategy.cpp.

{
    QPointF imagePos = m_d->converter->documentToImage(event->point);
    m_d->lastImagePos = imagePos;
 
    hoverActionCommon(imagePos);
}

References hoverActionCommon(), m_d, and KoPointerEvent::point.

setTransformFunction()

virtual void KisSimplifiedActionPolicyStrategy::setTransformFunction ( const QPointF & mousePos, bool perspectiveModifierActive, bool shiftModifierActive, bool altModifierActive )

protectedpure virtual

Implemented in KisFreeTransformStrategy, KisMeshTransformStrategy, KisPerspectiveTransformStrategy, and KisWarpTransformStrategy.

shiftModifierIsUsed()

bool KisSimplifiedActionPolicyStrategy::shiftModifierIsUsed ( ) const

protectedvirtual

Reimplemented in KisFreeTransformStrategy, and KisMeshTransformStrategy.

Definition at line 203 of file kis_simplified_action_policy_strategy.cpp.

{
    return false;
}

snapDocPoint()

QPointF KisSimplifiedActionPolicyStrategy::snapDocPoint ( const QPointF & point, Qt::KeyboardModifiers modifiers ) const

private

Definition at line 48 of file kis_simplified_action_policy_strategy.cpp.

{
    QPointF pos = point;
 
    if (m_d->snapGuide) {
        Qt::KeyboardModifiers modifiersForSnapping = modifiers;
 
        if (shiftModifierIsUsed()) {
            modifiersForSnapping.setFlag(Qt::ShiftModifier, false);
        }
 
        pos = m_d->snapGuide->snap(point, m_d->dragOffset, modifiersForSnapping);
    }
 
    return pos;
}

References m_d, and shiftModifierIsUsed().

Member Data Documentation

m_d

const QScopedPointer<Private> KisSimplifiedActionPolicyStrategy::m_d

private

Definition at line 56 of file kis_simplified_action_policy_strategy.h.

---

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

• plugins/tools/tool_transform2/kis_simplified_action_policy_strategy.h
• plugins/tools/tool_transform2/kis_simplified_action_policy_strategy.cpp