kis_selection.h

/*
 *  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 <tqrect.h>
 
#include "kis_types.h"
#include "kis_paint_device.h"
 
#include <koffice_export.h>
 
 
enum enumSelectionMode {
    SELECTION_ADD,
    SELECTION_SUBTRACT
};

class KRITACORE_EXPORT KisSelection : public KisPaintDevice {
 
    typedef KisPaintDevice super;
 
public:
    KisSelection(KisPaintDeviceSP dev);

    KisSelection();
    
    KisSelection(const KisSelection& rhs);
    
    virtual ~KisSelection();
 
    // Returns selectedness, or 0 if invalid coordinates
    TQ_UINT8 selected(TQ_INT32 x, TQ_INT32 y);
 
    void setSelected(TQ_INT32 x, TQ_INT32 y, TQ_UINT8 s);
 
    TQImage maskImage();
 
    void select(TQRect r);
 
    void invert();
 
    void clear(TQRect r);
 
    void clear();

    bool isTotallyUnselected(TQRect r);

    bool isProbablyTotallyUnselected(TQRect r);

    TQRect selectedRect() const;

    TQRect selectedExactRect() const;
 
    void paintSelection(TQImage img, TQ_INT32 x, TQ_INT32 y, TQ_INT32 w, TQ_INT32 h);
    void paintSelection(TQImage img, const TQRect& scaledImageRect, const TQSize& scaledImageSize, const TQSize& 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 TQRect & rc);
    virtual void setDirty();
    inline KisPaintDeviceSP parentPaintDevice() { return m_parentPaintDevice; }
private:
    void paintUniformSelectionRegion(TQImage img, const TQRect& imageRect, const TQRegion& uniformRegion);
 
private:
 
    // We don't want these methods to be used on selections:
    void extent(TQ_INT32 &x, TQ_INT32 &y, TQ_INT32 &w, TQ_INT32 &h) const 
        { 
            KisPaintDevice::extent(x,y,w,h);
        }
    
    TQRect extent() const { return KisPaintDevice::extent(); }
    
    void exactBounds(TQ_INT32 &x, TQ_INT32 &y, TQ_INT32 &w, TQ_INT32 &h) const 
        {
            return KisPaintDevice::exactBounds(x,y,w,h);
        }   
 
    TQRect exactBounds() const
        {
            return KisPaintDevice::exactBounds();
        }
 
    TQRect exactBoundsOldMethod() const 
        {
            return KisPaintDevice::exactBoundsOldMethod();
        }
 
    TQRect exactBoundsImprovedOldMethod() const
        {
            return KisPaintDevice::exactBoundsImprovedOldMethod();
        }
 
 
private:
    KisPaintDeviceSP m_parentPaintDevice;
    bool m_doCacheExactRect;
    TQRect m_cachedExactRect;
    bool m_dirty;
};
 
#endif // KIS_SELECTION_H_