KisToolTransformFactory Class Reference

#include <kis_tool_transform.h>

Inheritance diagram for KisToolTransformFactory:

Public Member Functions
QList< QAction * >	createActionsImpl () override
	createActionsImpl should be reimplemented if the tool needs any actions. The actions should have a valid objectName().
KoToolBase *	createTool (KoCanvasBase *canvas) override
	KisToolTransformFactory ()
	~KisToolTransformFactory () override
Public Member Functions inherited from KisToolPaintFactoryBase
	KisToolPaintFactoryBase (const QString &id)
	~KisToolPaintFactoryBase () override
Public Member Functions inherited from KoToolFactoryBase
QString	activationShapeId () const
QList< QAction * >	createActions (KisKActionCollection *actionCollection)
QString	iconName () const
QString	id () const
	KoToolFactoryBase (const QString &id)
int	priority () const
	Private (const QString &i)
QString	section () const
QKeySequence	shortcut () const
QString	toolTip () const
virtual	~KoToolFactoryBase ()

Private Slots
void	activateSubtoolCage ()
void	activateSubtoolFree ()
void	activateSubtoolLiquify ()
void	activateSubtoolMesh ()
void	activateSubtoolPerspective ()
void	activateSubtoolWarp ()

Private Member Functions
void	activateSubtool (KisToolTransform::TransformToolMode mode)

Additional Inherited Members
Public Attributes inherited from KoToolFactoryBase
QString	activationId
QString	iconName
const QString	id
int	priority
QString	section
QKeySequence	shortcut
QString	tooltip
Protected Member Functions inherited from KoToolFactoryBase
void	setActivationShapeId (const QString &activationShapeId)
void	setIconName (const char *iconName)
void	setIconName (const QString &iconName)
void	setPriority (int newPriority)
void	setSection (const QString &section)
void	setShortcut (const QKeySequence &shortcut)
void	setToolTip (const QString &tooltip)

Detailed Description

Definition at line 361 of file kis_tool_transform.h.

Constructor & Destructor Documentation

KisToolTransformFactory()

KisToolTransformFactory::KisToolTransformFactory ( )

inline

Definition at line 368 of file kis_tool_transform.h.

            : KisToolPaintFactoryBase("KisToolTransform") {
        setToolTip(i18n("Transform a layer or a selection"));
        setSection(ToolBoxSection::Transform);
        setIconName(koIconNameCStr("krita_tool_transform"));
        setShortcut(QKeySequence(Qt::CTRL | Qt::Key_T));
        setPriority(2);
        setActivationShapeId(KRITA_TOOL_ACTIVATION_ID);
    }

References koIconNameCStr, KRITA_TOOL_ACTIVATION_ID, KoToolFactoryBase::setActivationShapeId(), KoToolFactoryBase::setIconName(), KoToolFactoryBase::setPriority(), KoToolFactoryBase::setSection(), KoToolFactoryBase::setShortcut(), KoToolFactoryBase::setToolTip(), and ToolBoxSection::Transform.

~KisToolTransformFactory()

KisToolTransformFactory::~KisToolTransformFactory ( )

inlineoverride

Definition at line 378 of file kis_tool_transform.h.

{}

Member Function Documentation

activateSubtool()

void KisToolTransformFactory::activateSubtool ( KisToolTransform::TransformToolMode mode )

private

Definition at line 1521 of file kis_tool_transform.cc.

{
    KoToolManager *toolManager = KoToolManager::instance();
 
    KoCanvasController *canvasController = toolManager->activeCanvasController();
    if (!canvasController) return;
    KoCanvasBase *canvas = canvasController->canvas();
    if (!canvas) return;
 
    KoToolBase *tool = toolManager->toolById(canvas, id());
    KIS_SAFE_ASSERT_RECOVER_RETURN(tool);
    KisToolTransform *transformTool = dynamic_cast<KisToolTransform*>(tool);
    KIS_SAFE_ASSERT_RECOVER_RETURN(transformTool);
 
    if (toolManager->activeToolId() == id()) {
        // Transform tool is already active, switch the current mode
        transformTool->setTransformMode(mode);
    } else {
        // Works like KoToolFactoryBase::activateTool, but tells the tool beforehand which initial transform mode to use
        transformTool->setNextActivationTransformMode(mode);
        toolManager->switchToolRequested(id());
    }
}

References KoToolManager::activeCanvasController(), KoToolManager::activeToolId(), KoCanvasController::canvas(), Private::canvas, KoToolManager::instance(), KIS_SAFE_ASSERT_RECOVER_RETURN, KisToolTransform::setNextActivationTransformMode(), KisToolTransform::setTransformMode(), KoToolManager::switchToolRequested(), and KoToolManager::toolById().

activateSubtoolCage

void KisToolTransformFactory::activateSubtoolCage ( )

privateslot

Definition at line 1556 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::CageTransformMode);
}

References activateSubtool(), and KisToolTransform::CageTransformMode.

activateSubtoolFree

void KisToolTransformFactory::activateSubtoolFree ( )

privateslot

Definition at line 1544 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::FreeTransformMode);
}

References activateSubtool(), and KisToolTransform::FreeTransformMode.

activateSubtoolLiquify

void KisToolTransformFactory::activateSubtoolLiquify ( )

privateslot

Definition at line 1560 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::LiquifyTransformMode);
}

References activateSubtool(), and KisToolTransform::LiquifyTransformMode.

activateSubtoolMesh

void KisToolTransformFactory::activateSubtoolMesh ( )

privateslot

Definition at line 1564 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::MeshTransformMode);
}

References activateSubtool(), and KisToolTransform::MeshTransformMode.

activateSubtoolPerspective

void KisToolTransformFactory::activateSubtoolPerspective ( )

privateslot

Definition at line 1548 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::PerspectiveTransformMode);
}

References activateSubtool(), and KisToolTransform::PerspectiveTransformMode.

activateSubtoolWarp

void KisToolTransformFactory::activateSubtoolWarp ( )

privateslot

Definition at line 1552 of file kis_tool_transform.cc.

{
    activateSubtool(KisToolTransform::WarpTransformMode);
}

References activateSubtool(), and KisToolTransform::WarpTransformMode.

createActionsImpl()

QList< QAction * > KisToolTransformFactory::createActionsImpl ( )

overridevirtual

createActionsImpl should be reimplemented if the tool needs any actions. The actions should have a valid objectName().

Returns

the list of actions this tool wishes to be available.

Reimplemented from KisToolPaintFactoryBase.

Definition at line 1491 of file kis_tool_transform.cc.

{
    KisActionRegistry *actionRegistry = KisActionRegistry::instance();
    QList<QAction *> actions = KisToolPaintFactoryBase::createActionsImpl();
 
    actions << actionRegistry->makeQAction("movetool-move-up", this);
    actions << actionRegistry->makeQAction("movetool-move-down", this);
    actions << actionRegistry->makeQAction("movetool-move-left", this);
    actions << actionRegistry->makeQAction("movetool-move-right", this);
    actions << actionRegistry->makeQAction("movetool-move-up-more", this);
    actions << actionRegistry->makeQAction("movetool-move-down-more", this);
    actions << actionRegistry->makeQAction("movetool-move-left-more", this);
    actions << actionRegistry->makeQAction("movetool-move-right-more", this);
 
    auto makeSubtoolAction = [&actionRegistry, &actions, this](QString actionName, const char *slot) {
        QAction *action = actionRegistry->makeQAction(actionName, this);
        action->setProperty("always_enabled", true); // To allow this action to be triggered when the transform tool isn't already active
        connect(action, SIGNAL(triggered()), slot);
        actions << action;
    };
    makeSubtoolAction("KisToolTransformFree", SLOT(activateSubtoolFree()));
    makeSubtoolAction("KisToolTransformPerspective", SLOT(activateSubtoolPerspective()));
    makeSubtoolAction("KisToolTransformWarp", SLOT(activateSubtoolWarp()));
    makeSubtoolAction("KisToolTransformCage", SLOT(activateSubtoolCage()));
    makeSubtoolAction("KisToolTransformLiquify", SLOT(activateSubtoolLiquify()));
    makeSubtoolAction("KisToolTransformMesh", SLOT(activateSubtoolMesh()));
 
    return actions;
}

References activateSubtoolCage(), activateSubtoolFree(), activateSubtoolLiquify(), activateSubtoolMesh(), activateSubtoolPerspective(), activateSubtoolWarp(), KisToolPaintFactoryBase::createActionsImpl(), KisActionRegistry::instance(), and KisActionRegistry::makeQAction().

createTool()

KoToolBase * KisToolTransformFactory::createTool ( KoCanvasBase * canvas )

inlineoverridevirtual

Instantiate a new tool

Parameters

canvas

the canvas that the new tool will work on. Should be passed to the constructor of the tool.

Returns

a new KoToolBase instance, or zero if the tool doesn't want to show up.

Implements KoToolFactoryBase.

Definition at line 380 of file kis_tool_transform.h.

                                                           {
        return new KisToolTransform(canvas);
    }

References Private::canvas.

---

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

• plugins/tools/tool_transform2/kis_tool_transform.h
• plugins/tools/tool_transform2/kis_tool_transform.cc