ShapeRotateStrategy Class Reference

#include <ShapeRotateStrategy.h>

Inheritance diagram for ShapeRotateStrategy:

Public Member Functions
KUndo2Command *	createCommand () override
void	finishInteraction (Qt::KeyboardModifiers modifiers) override
void	handleMouseMove (const QPointF &mouseLocation, Qt::KeyboardModifiers modifiers) override
void	paint (QPainter &painter, const KoViewConverter &converter) override
	ShapeRotateStrategy (KoToolBase *tool, KoSelection *selection, const QPointF &clicked, Qt::MouseButtons buttons)
	~ShapeRotateStrategy () override
Public Member Functions inherited from KoInteractionStrategy
virtual void	cancelInteraction ()
	KoInteractionStrategy (KoToolBase *parent)
	constructor
KoToolBase *	tool () const
virtual	~KoInteractionStrategy ()
	Destructor.

Private Member Functions
void	rotateBy (qreal angle)

Private Attributes
QList< QTransform >	m_oldTransforms
QPointF	m_rotationCenter
QTransform	m_rotationMatrix
QPointF	m_start
QList< KoShape * >	m_transformedShapesAndSelection

Additional Inherited Members
Protected Member Functions inherited from KoInteractionStrategy
uint	decorationThickness () const
uint	grabSensitivity () const
	Convenience function to get the global grab sensitivity.
uint	handleRadius () const
	Convenience function to get the global handle radius.
	KoInteractionStrategy (KoInteractionStrategyPrivate &)
	constructor
Protected Attributes inherited from KoInteractionStrategy
KoInteractionStrategyPrivate *	d_ptr

Detailed Description

A strategy for the KoInteractionTool. This strategy is invoked when the user starts a rotate of a selection of objects, the strategy will then rotate the objects interactively and provide a command afterwards.

Definition at line 26 of file ShapeRotateStrategy.h.

Constructor & Destructor Documentation

ShapeRotateStrategy()

ShapeRotateStrategy::ShapeRotateStrategy	(	KoToolBase *	tool,
		KoSelection *	selection,
		const QPointF &	clicked,
		Qt::MouseButtons	buttons )

Constructor that starts to rotate the objects.

Parameters

tool	the parent tool which controls this strategy
clicked	the initial point that the user depressed (in pt).

The outline of the selection should look as if it is also rotated, so we add it to the transformed shapes list.

Definition at line 23 of file ShapeRotateStrategy.cpp.

    : KoInteractionStrategy(tool)
    , m_start(clicked)
{
    m_transformedShapesAndSelection = selection->selectedEditableShapes();
    m_transformedShapesAndSelection << selection;
 
    Q_FOREACH (KoShape *shape, m_transformedShapesAndSelection) {
        m_oldTransforms << shape->transformation();
    }
 
    KoFlake::AnchorPosition anchor = !(buttons & Qt::RightButton) ?
                KoFlake::Center :
                KoFlake::AnchorPosition(tool->canvas()->resourceManager()->resource(KoFlake::HotPosition).toInt());
 
    m_rotationCenter = selection->absolutePosition(anchor);
 
    tool->setStatusText(i18n("Press ALT to rotate in 45 degree steps."));
}

References KoShape::absolutePosition(), buttons(), KoToolBase::canvas(), KoFlake::Center, KoFlake::HotPosition, m_oldTransforms, m_rotationCenter, m_transformedShapesAndSelection, KoCanvasBase::resourceManager, KoSelection::selectedEditableShapes(), KoToolBase::setStatusText(), KoInteractionStrategy::tool(), and KoShape::transformation().

~ShapeRotateStrategy()

ShapeRotateStrategy::~ShapeRotateStrategy ( )

inlineoverride

Definition at line 35 of file ShapeRotateStrategy.h.

{}

Member Function Documentation

createCommand()

KUndo2Command * ShapeRotateStrategy::createCommand ( )

overridevirtual

For interactions that are undo-able this method should be implemented to return such a command. Implementations should return 0 otherwise.

Returns

a command, or 0.

Implements KoInteractionStrategy.

Definition at line 95 of file ShapeRotateStrategy.cpp.

{
    QList<QTransform> newTransforms;
    Q_FOREACH (KoShape *shape, m_transformedShapesAndSelection) {
        newTransforms << shape->transformation();
    }
 
    KoShapeTransformCommand *cmd = new KoShapeTransformCommand(m_transformedShapesAndSelection, m_oldTransforms, newTransforms);
    cmd->setText(kundo2_i18n("Rotate"));
    return cmd;
}

References kundo2_i18n(), m_oldTransforms, m_transformedShapesAndSelection, KUndo2Command::setText(), and KoShape::transformation().

finishInteraction()

void ShapeRotateStrategy::finishInteraction ( Qt::KeyboardModifiers modifiers )

inlineoverridevirtual

Override to make final changes to the data on the end of an interaction.

Implements KoInteractionStrategy.

Definition at line 39 of file ShapeRotateStrategy.h.

    {
        Q_UNUSED(modifiers);
    }

handleMouseMove()

void ShapeRotateStrategy::handleMouseMove ( const QPointF & mouseLocation, Qt::KeyboardModifiers modifiers )

overridevirtual

Extending classes should implement this method to update the selectedShapes based on the new mouse position.

Parameters

mouseLocation	the new location in pt
modifiers	OR-ed set of keys pressed.

Implements KoInteractionStrategy.

Definition at line 47 of file ShapeRotateStrategy.cpp.

{
    qreal angle = atan2(point.y() - m_rotationCenter.y(), point.x() - m_rotationCenter.x()) -
                  atan2(m_start.y() - m_rotationCenter.y(), m_start.x() - m_rotationCenter.x());
    angle = angle / M_PI * 180;  // convert to degrees.
    if (modifiers & (Qt::AltModifier | Qt::ControlModifier)) {
        // limit to 45 degree angles
        qreal modula = qAbs(angle);
        while (modula > 45.0) {
            modula -= 45.0;
        }
        if (modula > 22.5) {
            modula -= 45.0;
        }
        angle += (angle > 0 ? -1 : 1) * modula;
    }
 
    rotateBy(angle);
}

References M_PI, m_rotationCenter, m_start, and rotateBy().

paint()

void ShapeRotateStrategy::paint ( QPainter & painter, const KoViewConverter & converter )

overridevirtual

Reimplement this if the action needs to draw a "blob" on the canvas; that is, a transient decoration like a rubber band.

Reimplemented from KoInteractionStrategy.

Definition at line 84 of file ShapeRotateStrategy.cpp.

{
    // paint the rotation center
    painter.setPen(QPen(Qt::red));
    painter.setBrush(QBrush(Qt::red));
    painter.setRenderHint(QPainter::Antialiasing, true);
    QRectF circle(0, 0, handleRadius(), handleRadius());
    circle.moveCenter(converter.documentToView(m_rotationCenter));
    painter.drawEllipse(circle);
}

References KoViewConverter::documentToView(), KoInteractionStrategy::handleRadius(), and m_rotationCenter.

rotateBy()

void ShapeRotateStrategy::rotateBy ( qreal angle )

private

Definition at line 67 of file ShapeRotateStrategy.cpp.

{
    QTransform matrix;
    matrix.translate(m_rotationCenter.x(), m_rotationCenter.y());
    matrix.rotate(angle);
    matrix.translate(-m_rotationCenter.x(), -m_rotationCenter.y());
 
    QTransform applyMatrix = matrix * m_rotationMatrix.inverted();
    m_rotationMatrix = matrix;
    Q_FOREACH (KoShape *shape, m_transformedShapesAndSelection) {
        QRectF dirtyRect = shape->boundingRect();
        shape->applyAbsoluteTransformation(applyMatrix);
        dirtyRect |= shape->boundingRect();
        shape->updateAbsolute(dirtyRect);
    }
}

References KoShape::applyAbsoluteTransformation(), KoShape::boundingRect(), m_rotationCenter, m_rotationMatrix, m_transformedShapesAndSelection, and KoShape::updateAbsolute().

Member Data Documentation

m_oldTransforms

QList<QTransform> ShapeRotateStrategy::m_oldTransforms

private

Definition at line 50 of file ShapeRotateStrategy.h.

m_rotationCenter

QPointF ShapeRotateStrategy::m_rotationCenter

private

Definition at line 51 of file ShapeRotateStrategy.h.

m_rotationMatrix

QTransform ShapeRotateStrategy::m_rotationMatrix

private

Definition at line 49 of file ShapeRotateStrategy.h.

m_start

QPointF ShapeRotateStrategy::m_start

private

Definition at line 48 of file ShapeRotateStrategy.h.

m_transformedShapesAndSelection

QList<KoShape *> ShapeRotateStrategy::m_transformedShapesAndSelection

private

Definition at line 52 of file ShapeRotateStrategy.h.

---

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

• plugins/tools/defaulttool/defaulttool/ShapeRotateStrategy.h
• plugins/tools/defaulttool/defaulttool/ShapeRotateStrategy.cpp