This class handles both rotation and zooming operation. This is separate from Zoom and Rotate operation applied individually because the order of transformation is different. More...

#include <kis_zoom_and_rotate_action.h>

Inheritance diagram for KisZoomAndRotateAction:

Classes
class	Private

Public Types
enum	Shortcut { PanAndZoomAndRotateMode , PanAndZoomAndDiscreteRotateMode , PanAndDiscreteZoomAndRotateMode , PanAndDiscreteZoomAndDiscreteRotateMode , ZoomAndRotateMode , ZoomAndDiscreteRotateMode , DiscreteZoomAndRotateMode , DiscreteZoomAndDiscreteRotateMode }

Public Member Functions
void	activate (int shortcut) override

void	begin (int shortcut, QEvent *event) override

void	cursorMovedAbsolute (const QPointF &lastPos, const QPointF &pos) override

void	deactivate (int shortcut) override

void	end (QEvent *event) override

KisInputActionGroup	inputActionGroup (int shortcut) const override

void	inputEvent (QEvent *event) override

	KisZoomAndRotateAction ()

int	priority () const override

	~KisZoomAndRotateAction ()

Public Member Functions inherited from KisAbstractInputAction
virtual bool	canIgnoreModifiers () const

virtual QString	description () const

virtual QString	id () const

virtual bool	isAvailable () const

virtual bool	isShortcutRequired (int shortcut) const

	KisAbstractInputAction (const QString &id)

virtual QString	name () const

virtual QHash< QString, int >	shortcutIndexes () const

virtual bool	supportsHiResInputEvents (int shortcut) const

virtual bool	trySwitchShortcut (int oldShortcut, int newShortcut)

virtual	~KisAbstractInputAction ()

Private Attributes
const QScopedPointer< Private >	d

Additional Inherited Members
Public Attributes inherited from KisAbstractInputAction
QString	description

QString	id

QHash< QString, int >	indexes

QPointF	lastCursorPosition

QString	name

QPointF	startCursorPosition

Static Public Attributes inherited from KisAbstractInputAction
static KisInputManager *	inputManager

Protected Member Functions inherited from KisAbstractInputAction
virtual void	cursorMoved (const QPointF &lastPos, const QPointF &pos)

QPoint	eventPos (const QEvent *event)

QPointF	eventPosF (const QEvent *event)

KisInputManager *	inputManager () const

void	setDescription (const QString &description)

void	setName (const QString &name)

void	setShortcutIndexes (const QHash< QString, int > &indexes)

Detailed Description

This class handles both rotation and zooming operation. This is separate from Zoom and Rotate operation applied individually because the order of transformation is different.

Definition at line 19 of file kis_zoom_and_rotate_action.h.

Member Enumeration Documentation

◆ Shortcut

enum KisZoomAndRotateAction::Shortcut

Enumerator
PanAndZoomAndRotateMode
PanAndZoomAndDiscreteRotateMode
PanAndDiscreteZoomAndRotateMode
PanAndDiscreteZoomAndDiscreteRotateMode
ZoomAndRotateMode
ZoomAndDiscreteRotateMode
DiscreteZoomAndRotateMode
DiscreteZoomAndDiscreteRotateMode

Definition at line 22 of file kis_zoom_and_rotate_action.h.

                  {
        PanAndZoomAndRotateMode,
        PanAndZoomAndDiscreteRotateMode,
        PanAndDiscreteZoomAndRotateMode,
        PanAndDiscreteZoomAndDiscreteRotateMode,
        ZoomAndRotateMode,
        ZoomAndDiscreteRotateMode,
        DiscreteZoomAndRotateMode,
        DiscreteZoomAndDiscreteRotateMode,
    };

Constructor & Destructor Documentation

◆ KisZoomAndRotateAction()

KisZoomAndRotateAction::KisZoomAndRotateAction ( )

Definition at line 52 of file kis_zoom_and_rotate_action.cpp.

    : KisAbstractInputAction ("Zoom and Rotate Canvas")
    , d(new Private)
{
    setName(i18n("Zoom and Rotate Canvas"));
    QHash<QString, int> shortcuts;
    shortcuts.insert(i18n("Pan, Zoom, Rotate Mode"), PanAndZoomAndRotateMode);
    shortcuts.insert(i18n("Pan, Zoom, Discrete Rotate Mode"), PanAndZoomAndDiscreteRotateMode);
    shortcuts.insert(i18n("Pan, Discrete Zoom, Rotate Mode"), PanAndDiscreteZoomAndRotateMode);
    shortcuts.insert(i18n("Pan, Discrete Zoom, Discrete Rotate Mode"), PanAndDiscreteZoomAndDiscreteRotateMode);
    shortcuts.insert(i18n("Zoom, Rotate Mode"), ZoomAndRotateMode);
    shortcuts.insert(i18n("Zoom, Discrete Rotate Mode"), ZoomAndDiscreteRotateMode);
    shortcuts.insert(i18n("Discrete Zoom, Rotate Mode"), DiscreteZoomAndRotateMode);
    shortcuts.insert(i18n("Discrete Zoom, Discrete Rotate Mode"), DiscreteZoomAndDiscreteRotateMode);
    setShortcutIndexes(shortcuts);
}

References DiscreteZoomAndDiscreteRotateMode, DiscreteZoomAndRotateMode, PanAndDiscreteZoomAndDiscreteRotateMode, PanAndDiscreteZoomAndRotateMode, PanAndZoomAndDiscreteRotateMode, PanAndZoomAndRotateMode, KisAbstractInputAction::setName(), KisAbstractInputAction::setShortcutIndexes(), ZoomAndDiscreteRotateMode, and ZoomAndRotateMode.

◆ ~KisZoomAndRotateAction()

KisZoomAndRotateAction::~KisZoomAndRotateAction ( )

Definition at line 69 of file kis_zoom_and_rotate_action.cpp.

70{

71}

Member Function Documentation

◆ activate()

void KisZoomAndRotateAction::activate ( int shortcut )

overridevirtual

The method is called when the action is yet to be started, that is, e.g. the user has pressed all the modifiers for the action but hasn't started painting yet. This method is a right place to show the user what is going to happen, e.g. change the cursor.

Reimplemented from KisAbstractInputAction.

Definition at line 78 of file kis_zoom_and_rotate_action.cpp.

{
    Q_UNUSED(shortcut);
}

◆ begin()

void KisZoomAndRotateAction::begin	(	int	shortcut,
		QEvent *	event )

overridevirtual

Begin the action.

Parameters

shortcut	The index of the behaviour to trigger.
event	The mouse event that has triggered this action. Is null for keyboard-activated actions.

Reimplemented from KisAbstractInputAction.

Definition at line 88 of file kis_zoom_and_rotate_action.cpp.

{
    if (!event) return;
 
    if (event->type() == QEvent::NativeGesture || event->type() == QEvent::TouchBegin
        || event->type() == QEvent::TouchUpdate) {
 
        using Flag = KisCanvasNavigationActionStrategy::Flag;
        using Flags = KisCanvasNavigationActionStrategy::Flags;
 
        Flags flags;
        flags.setFlag(Flag::PanEnabled, d->hasPanAction(shortcut));
        flags.setFlag(Flag::RotationEnabled);
        flags.setFlag(Flag::RotationDescrete, d->rotationIsDiscrete(shortcut));
        flags.setFlag(Flag::ZoomEnabled);
        flags.setFlag(Flag::ZoomDescrete, d->zoomIsDiscrete(shortcut));
 
        if (event->type() == QEvent::NativeGesture) {
            d->actionStrategy.reset(new KisCanvasNavigationActionStrategyNativeGesture(flags, eventPosF(event), inputManager()->canvas()));
        } else {
            const QTouchEvent *tevent = static_cast<const QTouchEvent*>(event);
            d->actionStrategy.reset(new KisCanvasNavigationActionStrategyTouch(flags, tevent, inputManager()->canvas()));
        }
    }
}

References Private::canvas, d, KisAbstractInputAction::eventPosF(), and KisAbstractInputAction::inputManager.

◆ cursorMovedAbsolute()

void KisZoomAndRotateAction::cursorMovedAbsolute	(	const QPointF &	lastPos,
		const QPointF &	pos )

overridevirtual

Reimplemented from KisAbstractInputAction.

Definition at line 120 of file kis_zoom_and_rotate_action.cpp.

121{

122}

◆ deactivate()

void KisZoomAndRotateAction::deactivate ( int shortcut )

overridevirtual

The method is called when the action is not a candidate for the starting anymore. The action should revert everything that was done in activate() method.

See also: activate()

Reimplemented from KisAbstractInputAction.

Definition at line 83 of file kis_zoom_and_rotate_action.cpp.

{
    Q_UNUSED(shortcut);
}

◆ end()

void KisZoomAndRotateAction::end ( QEvent * event )

overridevirtual

End the action.

Parameters

event The mouse event that has finished this action. Is null for keyboard-activated actions.

Reimplemented from KisAbstractInputAction.

Definition at line 114 of file kis_zoom_and_rotate_action.cpp.

{
    d->actionStrategy.reset();
    KisAbstractInputAction::end(event);
}

References d, and KisAbstractInputAction::end().

◆ inputActionGroup()

KisInputActionGroup KisZoomAndRotateAction::inputActionGroup ( int shortcut ) const

overridevirtual

Returns: the group of the action the specified shortcut belongs to

Reimplemented from KisAbstractInputAction.

Definition at line 134 of file kis_zoom_and_rotate_action.cpp.

{
    Q_UNUSED(shortcut);
    return ViewTransformActionGroup;
}

References ViewTransformActionGroup.

◆ inputEvent()

void KisZoomAndRotateAction::inputEvent ( QEvent * event )

overridevirtual

Process an input event.

By default handles MouseMove events and passes the data to a convenience cursorMoved() method

Parameters

event An event to process.

Reimplemented from KisAbstractInputAction.

Definition at line 125 of file kis_zoom_and_rotate_action.cpp.

{
    if (d->actionStrategy && d->actionStrategy->supportsEvent(event)) {
        d->actionStrategy->inputEvent(event);
    } else {
        KisAbstractInputAction::inputEvent(event);
    }
}