You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
144 lines
4.0 KiB
144 lines
4.0 KiB
/*
|
|
* Copyright (c) 1999 Matthias Elter <me@kde.org>
|
|
* Copyright (c) 2002, 2003 Patrick Julien <freak@codepimps.org>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef KIS_TOOL_H_
|
|
#define KIS_TOOL_H_
|
|
|
|
#include <qobject.h>
|
|
#include <qstring.h>
|
|
|
|
#include <ksharedptr.h>
|
|
#include <kaction.h>
|
|
|
|
#include "kis_shared_ptr_vector.h"
|
|
#include "kis_canvas_observer.h"
|
|
|
|
class QCursor;
|
|
class QEvent;
|
|
class QKeyEvent;
|
|
class QRect;
|
|
class QWidget;
|
|
class KActionCollection;
|
|
class KRadioAction;
|
|
class KDialog;
|
|
class KisBrush;
|
|
class KisGradient;
|
|
class KisPattern;
|
|
class KisButtonPressEvent;
|
|
class KisButtonReleaseEvent;
|
|
class KisDoubleClickEvent;
|
|
class KisMoveEvent;
|
|
class KisCanvasPainter;
|
|
|
|
enum enumToolType {
|
|
TOOL_SHAPE = 0, // Geometric shapes like ellipses and lines
|
|
TOOL_FREEHAND = 1, // Freehand drawing tools
|
|
TOOL_TRANSFORM = 2, // Tools that transform the layer
|
|
TOOL_FILL = 3, // Tools that fill parts of the canvas
|
|
TOOL_VIEW = 4, // Tools that affect the canvas: pan, zoom, etc.
|
|
TOOL_SELECT = 5
|
|
|
|
};
|
|
|
|
const Q_UINT8 NUMBER_OF_TOOLTYPES = 6;
|
|
|
|
class KisTool : public QObject, public KisCanvasObserver, public KShared {
|
|
Q_OBJECT
|
|
|
|
public:
|
|
KisTool(const QString & name);
|
|
virtual ~KisTool();
|
|
|
|
public:
|
|
|
|
virtual void paint(KisCanvasPainter& gc) = 0;
|
|
virtual void paint(KisCanvasPainter& gc, const QRect& rc) = 0;
|
|
|
|
/**
|
|
* This function is called after the creation of a tool to create the KAction corresponding
|
|
* to the tool.
|
|
*
|
|
* The code should look like :
|
|
* @code
|
|
*
|
|
* @endcode
|
|
*/
|
|
virtual void setup(KActionCollection *collection) = 0;
|
|
|
|
virtual void buttonPress(KisButtonPressEvent *e) = 0;
|
|
virtual void move(KisMoveEvent *e) = 0;
|
|
virtual void buttonRelease(KisButtonReleaseEvent *e) = 0;
|
|
virtual void doubleClick(KisDoubleClickEvent *e) = 0;
|
|
virtual void keyPress(QKeyEvent *e) = 0;
|
|
virtual void keyRelease(QKeyEvent *e) = 0;
|
|
|
|
virtual QCursor cursor() = 0;
|
|
virtual void setCursor(const QCursor& cursor) = 0;
|
|
/**
|
|
* This function is called to create the configuration widget of the tool.
|
|
* @param parent the parent of the widget
|
|
*/
|
|
virtual QWidget* createOptionWidget(QWidget* parent);
|
|
/**
|
|
* @return the current configuration widget.
|
|
*/
|
|
virtual QWidget* optionWidget();
|
|
KRadioAction *action() const { return m_action; }
|
|
|
|
/**
|
|
* Return true if this tool wants auto canvas-scrolling to
|
|
* work when this tool is active.
|
|
*/
|
|
virtual bool wantsAutoScroll() const { return true; }
|
|
|
|
// Methods for integration with karbon-style toolbox
|
|
virtual Q_UINT32 priority() { return 0; }
|
|
virtual enumToolType toolType() { return TOOL_FREEHAND; }
|
|
virtual QString icon() { return m_action->icon(); }
|
|
virtual QString quickHelp() const { return ""; }
|
|
|
|
public slots:
|
|
/**
|
|
* This slot is called when the tool is selected in the toolbox
|
|
*/
|
|
virtual void activate() = 0;
|
|
|
|
/**
|
|
* deactivate is called when the tool gets deactivated because another
|
|
* tool is selected. Tools can then clean up after themselves.
|
|
*/
|
|
virtual void deactivate() = 0;
|
|
|
|
private:
|
|
KisTool(const KisTool&);
|
|
KisTool& operator=(const KisTool&);
|
|
|
|
protected:
|
|
KRadioAction *m_action;
|
|
bool m_ownAction;
|
|
|
|
private:
|
|
class KisToolPrivate;
|
|
KisToolPrivate * d;
|
|
|
|
};
|
|
|
|
#endif // KIS_TOOL_H_
|
|
|