1 files changed, 160 insertions, 0 deletions
diff --git a/krita/core/kis_selection.h b/krita/core/kis_selection.h
new file mode 100644
index 000000000..959be4923
--- /dev/null
+++ b/krita/core/kis_selection.h
@@ -0,0 +1,160 @@
+/*
+ *  Copyright (c) 2004 Boudewijn Rempt <boud@valdyas.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., 675 mass ave, cambridge, ma 02139, usa.
+ */
+#ifndef KIS_SELECTION_H_
+#define KIS_SELECTION_H_
+
+#include <qrect.h>
+
+#include "kis_types.h"
+#include "kis_paint_device.h"
+
+#include <koffice_export.h>
+
+
+enum enumSelectionMode {
+    SELECTION_ADD,
+    SELECTION_SUBTRACT
+};
+
+/**
+ * KisSelection contains a byte-map representation of a layer, where
+ * the value of a byte signifies whether a corresponding pixel is selected, or not.
+ *
+ * NOTE: If you need to manually call emitSelectionChanged on the owner paint device
+ *       of a selection. KisSelection does not emit any signals by itself because
+ *       often you want to combine several actions in to perfom one operation and you
+ *       do not want recomposition to happen all the time.
+ */
+class KRITACORE_EXPORT KisSelection : public KisPaintDevice {
+
+    typedef KisPaintDevice super;
+
+public:
+    /**
+     * Create a new KisSelection
+    * @param dev the parent paint device. The selection will never be bigger than the parent
+     *              paint device.
+     */
+    KisSelection(KisPaintDeviceSP dev);
+
+    /**
+     * Create a new KisSelection. This selection will not have a parent paint device.
+     */
+    KisSelection();
+    
+    /**
+     * Copy the selection
+     */
+    KisSelection(const KisSelection& rhs);
+    
+    virtual ~KisSelection();
+
+    // Returns selectedness, or 0 if invalid coordinates
+    Q_UINT8 selected(Q_INT32 x, Q_INT32 y);
+
+    void setSelected(Q_INT32 x, Q_INT32 y, Q_UINT8 s);
+
+    QImage maskImage();
+
+    void select(QRect r);
+
+    void invert();
+
+    void clear(QRect r);
+
+    void clear();
+
+    /// Tests if the the rect is totally outside the selection
+    bool isTotallyUnselected(QRect r);
+
+    /**
+     * Tests if the the rect is totally outside the selection, but uses selectedRect
+     * instead of selectedRect, and this is faster (but might deliver false positives!)
+     *
+     * XXX: This comment makes no sense anymore! (BSAR)
+     */
+    bool isProbablyTotallyUnselected(QRect r);
+
+    /**
+     * Rough, but fastish way of determining the area
+     * of the tiles used by the selection.
+     */
+    QRect selectedRect() const;
+
+    /**
+     * Slow, but exact way of determining the rectangle
+     * that encloses the selection
+     */
+    QRect selectedExactRect() const;
+
+    void paintSelection(QImage img, Q_INT32 x, Q_INT32 y, Q_INT32 w, Q_INT32 h);
+    void paintSelection(QImage img, const QRect& scaledImageRect, const QSize& scaledImageSize, const QSize& imageSize);
+
+    void startCachingExactRect();
+    void stopCachingExactRect();
+
+    // if the parent layer is interested in keeping up to date with the dirtyness
+    // of this layer, set to true
+    void setInterestedInDirtyness(bool b) { m_dirty = b; }
+    bool interestedInDirtyness() const { return m_dirty; }
+
+    virtual void setDirty(const QRect & rc);
+    virtual void setDirty();
+    inline KisPaintDeviceSP parentPaintDevice() { return m_parentPaintDevice; }
+private:
+    void paintUniformSelectionRegion(QImage img, const QRect& imageRect, const QRegion& uniformRegion);
+
+private:
+
+    // We don't want these methods to be used on selections:
+    void extent(Q_INT32 &x, Q_INT32 &y, Q_INT32 &w, Q_INT32 &h) const 
+        { 
+            KisPaintDevice::extent(x,y,w,h);
+        }
+    
+    QRect extent() const { return KisPaintDevice::extent(); }
+    
+    void exactBounds(Q_INT32 &x, Q_INT32 &y, Q_INT32 &w, Q_INT32 &h) const 
+        {
+            return KisPaintDevice::exactBounds(x,y,w,h);
+        }   
+
+    QRect exactBounds() const
+        {
+            return KisPaintDevice::exactBounds();
+        }
+
+    QRect exactBoundsOldMethod() const 
+        {
+            return KisPaintDevice::exactBoundsOldMethod();
+        }
+
+    QRect exactBoundsImprovedOldMethod() const
+        {
+            return KisPaintDevice::exactBoundsImprovedOldMethod();
+        }
+
+
+private:
+    KisPaintDeviceSP m_parentPaintDevice;
+    bool m_doCacheExactRect;
+    QRect m_cachedExactRect;
+    bool m_dirty;
+};
+
+#endif // KIS_SELECTION_H_