#include <kis_pixel_selection.h>

Inheritance diagram for KisPixelSelection:

Public Member Functions
void	applySelection (KisPixelSelectionSP selection, SelectionAction action)

void	clear () override

void	clear (const QRect &r)

KisSelectionComponent *	clone (KisSelection *) override

const KoColorSpace *	compositionSourceColorSpace () const override

void	copyAlphaFrom (KisPaintDeviceSP src, const QRect &processRect)

void	invalidateOutlineCache ()

void	invalidateThumbnailImage ()

void	invert ()

bool	isEmpty () const override

bool	isTotallyUnselected (const QRect &r) const
	Tests if the rect is totally outside the selection.

	KisPixelSelection (const KisPaintDeviceSP copySource, KritaUtils::DeviceCopyMode copyMode=KritaUtils::CopySnapshot, KisSelectionWSP parentSelection=KisSelectionWSP())

	KisPixelSelection (const KisPixelSelection &rhs, KritaUtils::DeviceCopyMode copyMode=KritaUtils::CopySnapshot)

	KisPixelSelection (KisDefaultBoundsBaseSP defaultBounds=KisDefaultBoundsBaseSP(), KisSelectionWSP parentSelection=KisSelectionWSP())

virtual void	moveTo (const QPoint &pt)

void	moveTo (const QPoint &pt) override

void	moveTo (qint32 x, qint32 y)

QVector< QPolygon >	outline () const
	outline returns the outline of the current selection

QPainterPath	outlineCache () const override

bool	outlineCacheValid () const override

KisSelectionWSP	parentSelection () const

bool	read (QIODevice *stream)

void	recalculateOutlineCache () override

void	recalculateThumbnailImage (const QColor &maskColor)

void	renderToProjection (KisPaintDeviceSP projection) override

void	renderToProjection (KisPaintDeviceSP projection, const QRect &r) override

void	select (const QRect &r, quint8 selectedness=MAX_SELECTED)

QRect	selectedExactRect () const

QRect	selectedRect () const

void	setOutlineCache (const QPainterPath &cache)

void	setParentSelection (KisSelectionWSP selection)

QImage	thumbnailImage () const

QTransform	thumbnailImageTransform () const

bool	thumbnailImageValid () const

	~KisPixelSelection () override

Public Member Functions inherited from Private
	Private (KisCanvas2 *c)

Public Member Functions inherited from KisPaintDevice
bool	burnKeyframe ()

bool	burnKeyframe (int frameID)
	burnKeyframe

QRect	calculateExactBounds (bool nonDefaultOnly) const

quint32	channelCount () const

void	clear (const QRect &rc)

void	clearSelection (KisSelectionSP selection)

const KoColorSpace *	colorSpace () const

void	convertFromQImage (const QImage &image, const KoColorProfile *profile, qint32 offsetX=0, qint32 offsetY=0)

void	convertTo (const KoColorSpace dstColorSpace, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags(), KUndo2Command parentCommand=nullptr, KoUpdater *progressUpdater=nullptr)

QImage	convertToQImage (const KoColorProfile *dstProfile, const QRect &rc, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags()) const

QImage	convertToQImage (const KoColorProfile *dstProfile, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags()) const

QImage	convertToQImage (const KoColorProfile *dstProfile, qint32 x, qint32 y, qint32 w, qint32 h, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags()) const

KUndo2Command *	createChangeInterstrokeDataCommand (KisInterstrokeDataSP data)
	set interstroke data to the device

KisPaintDeviceSP	createCompositionSourceDevice () const

KisPaintDeviceSP	createCompositionSourceDevice (KisPaintDeviceSP cloneSource) const

KisPaintDeviceSP	createCompositionSourceDevice (KisPaintDeviceSP cloneSource, const QRect roughRect) const

KisFixedPaintDeviceSP	createCompositionSourceDeviceFixed () const

KisHLineConstIteratorSP	createHLineConstIteratorNG (qint32 x, qint32 y, qint32 w) const

KisHLineIteratorSP	createHLineIteratorNG (qint32 x, qint32 y, qint32 w)

KisRasterKeyframeChannel *	createKeyframeChannel (const KoID &id)

LodDataStruct *	createLodDataStruct (int lod)

KisRandomAccessorSP	createRandomAccessorNG ()

KisRandomConstAccessorSP	createRandomConstAccessorNG () const

KisRandomSubAccessorSP	createRandomSubAccessor () const

KisRepeatHLineConstIteratorSP	createRepeatHLineConstIterator (qint32 x, qint32 y, qint32 w, const QRect &_dataWidth) const

KisRepeatVLineConstIteratorSP	createRepeatVLineConstIterator (qint32 x, qint32 y, qint32 h, const QRect &_dataWidth) const

QImage	createThumbnail (qint32 maxw, qint32 maxh, qreal oversample=1, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags())

QImage	createThumbnail (qint32 maxw, qint32 maxh, QRect rect, qreal oversample=1, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags())

QImage	createThumbnail (qint32 maxw, qint32 maxh, Qt::AspectRatioMode aspectRatioMode, qreal oversample=1, KoColorConversionTransformation::Intent renderingIntent=KoColorConversionTransformation::internalRenderingIntent(), KoColorConversionTransformation::ConversionFlags conversionFlags=KoColorConversionTransformation::internalConversionFlags())

KisPaintDeviceSP	createThumbnailDevice (qint32 w, qint32 h, QRect rect=QRect(), QRect outputRect=QRect()) const

KisPaintDeviceSP	createThumbnailDeviceOversampled (qint32 w, qint32 h, qreal oversample, QRect rect=QRect(), QRect outputRect=QRect()) const

KisVLineConstIteratorSP	createVLineConstIteratorNG (qint32 x, qint32 y, qint32 h) const

KisVLineIteratorSP	createVLineIteratorNG (qint32 x, qint32 y, qint32 h)

void	crop (const QRect &r)
	Convenience method for the above.

void	crop (qint32 x, qint32 y, qint32 w, qint32 h)

KisDataManagerSP	dataManager () const

KisDefaultBoundsBaseSP	defaultBounds () const

KoColor	defaultPixel () const

void	estimateMemoryStats (qint64 &imageData, qint64 &temporaryData, qint64 &lodData) const

QRect	exactBounds () const

QRect	exactBoundsAmortized () const

QRect	extent () const

void	extent (qint32 &x, qint32 &y, qint32 &w, qint32 &h) const
	Convenience method for the above.

void	fill (const QRect &rc, const KoColor &color)

void	fill (qint32 x, qint32 y, qint32 w, qint32 h, const quint8 *fillPixel)

KisPaintDeviceFramesInterface *	framesInterface ()

void	generateLodCloneDevice (KisPaintDeviceSP dst, const QRect &originalRect, int lod)

KisInterstrokeDataSP	interstrokeData () const

KisRasterKeyframeChannel *	keyframeChannel () const

	KisPaintDevice (const KisPaintDevice &rhs, KritaUtils::DeviceCopyMode copyMode=KritaUtils::CopySnapshot, KisNode *newParentNode=0)

	KisPaintDevice (const KoColorSpace *colorSpace, const QString &name=QString())

	KisPaintDevice (KisNodeWSP parent, const KoColorSpace *colorSpace, KisDefaultBoundsBaseSP defaultBounds=KisDefaultBoundsBaseSP(), const QString &name=QString())

void	makeCloneFrom (KisPaintDeviceSP src, const QRect &rect)

void	makeCloneFromRough (KisPaintDeviceSP src, const QRect &minimalRect)

void	makeFullCopyFrom (const KisPaintDevice &rhs, KritaUtils::DeviceCopyMode copyMode=KritaUtils::CopySnapshot, KisNode *newParentNode=0)

void	moveTo (qint32 x, qint32 y)

QRect	nonDefaultPixelArea () const

QPoint	offset () const

KoColor	pixel (const QPoint &pos) const

bool	pixel (qint32 x, qint32 y, KoColor *kc) const

bool	pixel (qint32 x, qint32 y, QColor *c) const

quint32	pixelSize () const

void	prepareClone (KisPaintDeviceSP src)

void	purgeDefaultPixels ()

bool	read (QIODevice *stream)

void	readBytes (quint8 *data, const QRect &rect) const

void	readBytes (quint8 *data, qint32 x, qint32 y, qint32 w, qint32 h) const

QVector< quint8 * >	readPlanarBytes (qint32 x, qint32 y, qint32 w, qint32 h) const

KisRegion	region () const

KisRegion	regionExact () const

KisRegion	regionForLodSyncing () const

KUndo2Command *	reincarnateWithDetachedHistory (bool copyContent)

void	requestTimeSwitch (int time)

int	sequenceNumber () const

void	setDataManager (KisDataManagerSP data, const KoColorSpace *colorSpace=0)

void	setDefaultBounds (KisDefaultBoundsBaseSP bounds)

void	setDefaultPixel (const KoColor &defPixel)

void	setDirty ()

void	setDirty (const KisRegion &region)

void	setDirty (const QRect &rc)

void	setDirty (const QVector< QRect > &rects)

void	setParentNode (KisNodeWSP parent)

bool	setPixel (qint32 x, qint32 y, const KoColor &kc)
	Convenience method for the above.

bool	setPixel (qint32 x, qint32 y, const QColor &c)

bool	setProfile (const KoColorProfile profile, KUndo2Command parentCommand)

void	setProjectionDevice (bool value)

void	setSupportsWraparoundMode (bool value)

void	setX (qint32 x)

void	setY (qint32 y)

bool	supportsWraproundMode () const

void	testingFetchLodDevice (KisPaintDeviceSP targetDevice)

void	updateLodDataStruct (LodDataStruct *dst, const QRect &srcRect)

void	uploadLodDataStruct (LodDataStruct *dst)

bool	write (KisPaintDeviceWriter &store)

void	writeBytes (const quint8 *data, const QRect &rect)

void	writeBytes (const quint8 *data, qint32 x, qint32 y, qint32 w, qint32 h)

void	writePlanarBytes (QVector< quint8 * > planes, qint32 x, qint32 y, qint32 w, qint32 h)

qint32	x () const

qint32	y () const

	~KisPaintDevice () override

Public Member Functions inherited from KisShared
bool	deref ()

bool	ref ()

int	refCount ()

QAtomicInt *	sharedWeakReference ()

Public Member Functions inherited from KisSelectionComponent
	KisSelectionComponent ()

virtual void	moveX (qint32 x)

virtual void	moveY (qint32 y)

virtual KUndo2Command *	resetToEmpty ()

virtual void	setResolutionProxy (KisImageResolutionProxySP)

virtual KUndo2Command *	transform (const QTransform &transform)

virtual	~KisSelectionComponent ()

Public Attributes
QPoint	lod0CachesOffset

QPainterPath	outlineCache

QMutex	outlineCacheMutex

bool	outlineCacheValid

KisSelectionWSP	parentSelection

QImage	thumbnailImage

QTransform	thumbnailImageTransform

bool	thumbnailImageValid

Public Attributes inherited from Private
KisCanvas2 *	canvas

int	displayedFrame

int	intendedFrame

Private Member Functions
void	addSelection (KisPixelSelectionSP selection)

QRect	exactBounds () const

QRect	extent () const

void	extent (qint32 &x, qint32 &y, qint32 &w, qint32 &h) const
	Convenience method for the above.

void	intersectSelection (KisPixelSelectionSP selection)

void	subtractSelection (KisPixelSelectionSP selection)

void	symmetricdifferenceSelection (KisPixelSelectionSP selection)

Private Attributes
Private *const	m_d

Additional Inherited Members
Signals inherited from KisPaintDevice
void	colorSpaceChanged (const KoColorSpace *colorspace)

void	profileChanged (const KoColorProfile *profile)

Static Public Member Functions inherited from KisPaintDevice
static MemoryReleaseObject *	createMemoryReleaseObject ()

Protected Member Functions inherited from KisPaintDevice
void	fastBitBlt (KisPaintDeviceSP src, const QRect &rect)

void	fastBitBltOldData (KisPaintDeviceSP src, const QRect &rect)

bool	fastBitBltPossible (KisPaintDeviceSP src)

void	fastBitBltRough (KisPaintDeviceSP src, const QRect &rect)

void	fastBitBltRoughOldData (KisPaintDeviceSP src, const QRect &rect)

	KisPaintDevice (KisDataManagerSP explicitDataManager, KisPaintDeviceSP src, const QString &name=QString())

KisNodeWSP	parentNode () const

Protected Member Functions inherited from KisShared
	KisShared ()

	~KisShared ()

Detailed Description

KisPixelSelection contains a byte-map representation of a layer, where the value of a byte signifies whether a corresponding pixel is selected, or not.

Definition at line 35 of file kis_pixel_selection.cpp.

Constructor & Destructor Documentation

◆ KisPixelSelection() [1/3]

KisPixelSelection::KisPixelSelection	(	KisDefaultBoundsBaseSP	defaultBounds = KisDefaultBoundsBaseSP(),
		KisSelectionWSP	parentSelection = KisSelectionWSP() )

Create a new KisPixelSelection. This selection will not have a parent paint device.

Definition at line 55 of file kis_pixel_selection.cpp.

        : KisPaintDevice(0, KoColorSpaceRegistry::instance()->alpha8(), defaultBounds)
        , m_d(new Private)
{
    m_d->outlineCacheValid = true;
    m_d->invalidateThumbnailImage();
 
    m_d->parentSelection = parentSelection;
}

References m_d, and parentSelection.

◆ KisPixelSelection() [2/3]

KisPixelSelection::KisPixelSelection	(	const KisPixelSelection &	rhs,
		KritaUtils::DeviceCopyMode	copyMode = KritaUtils::CopySnapshot )

Copy the selection

Definition at line 65 of file kis_pixel_selection.cpp.

        : KisPaintDevice(rhs, copyMode)
        , KisSelectionComponent(rhs)
        , m_d(new Private)
{
    // parent selection is not supposed to be shared
    m_d->outlineCache = rhs.m_d->outlineCache;
    m_d->outlineCacheValid = rhs.m_d->outlineCacheValid;
 
    m_d->thumbnailImageValid = rhs.m_d->thumbnailImageValid;
    m_d->thumbnailImage = rhs.m_d->thumbnailImage;
    m_d->thumbnailImageTransform = rhs.m_d->thumbnailImageTransform;
}

References m_d.

◆ KisPixelSelection() [3/3]

KisPixelSelection::KisPixelSelection	(	const KisPaintDeviceSP	copySource,
		KritaUtils::DeviceCopyMode	copyMode = KritaUtils::CopySnapshot,
		KisSelectionWSP	parentSelection = KisSelectionWSP() )

Create a new selection using the content of copySource as the mask.

Definition at line 79 of file kis_pixel_selection.cpp.

    : KisPaintDevice(0, KoColorSpaceRegistry::instance()->alpha8(), copySource->defaultBounds())
    , m_d(new Private)
{
    KisPaintDeviceSP tmpDevice = new KisPaintDevice(*copySource, copyMode, 0);
    tmpDevice->convertTo(this->colorSpace());
 
    this->makeFullCopyFrom(*tmpDevice, copyMode, 0);
 
    m_d->parentSelection = parentSelection;
    m_d->outlineCacheValid = false;
    m_d->invalidateThumbnailImage();
}

References KisPaintDevice::colorSpace(), KisPaintDevice::convertTo(), KisPaintDevice::KisPaintDevice(), m_d, KisPaintDevice::makeFullCopyFrom(), and parentSelection.

◆ ~KisPixelSelection()

KisPixelSelection::~KisPixelSelection ( )

override

Definition at line 98 of file kis_pixel_selection.cpp.

{
    delete m_d;
}

References m_d.

Member Function Documentation

◆ addSelection()

void KisPixelSelection::addSelection ( KisPixelSelectionSP selection )

private

Add a selection

Definition at line 184 of file kis_pixel_selection.cpp.

{
    QRect r = selection->selectedRect();
    if (r.isEmpty()) return;
 
    KisHLineIteratorSP dst = createHLineIteratorNG(r.x(), r.y(), r.width());
    KisHLineConstIteratorSP src = selection->createHLineConstIteratorNG(r.x(), r.y(), r.width());
    for (int i = 0; i < r.height(); ++i) {
        do {
            if (*src->oldRawData() + *dst->rawData() < MAX_SELECTED)
                *dst->rawData() = *src->oldRawData() + *dst->rawData();
            else
                *dst->rawData() = MAX_SELECTED;
 
        } while (src->nextPixel() && dst->nextPixel());
        dst->nextRow();
        src->nextRow();
    }
 
    const quint8 defPixel = qMax(*defaultPixel().data(), *selection->defaultPixel().data());
    setDefaultPixel(KoColor(&defPixel, colorSpace()));
 
    m_d->outlineCacheValid &= selection->outlineCacheValid();
 
    if (m_d->outlineCacheValid) {
        m_d->outlineCache += selection->outlineCache();
    }
 
    m_d->invalidateThumbnailImage();
}

References KisPaintDevice::colorSpace(), KisPaintDevice::createHLineConstIteratorNG(), KisPaintDevice::createHLineIteratorNG(), KoColor::data(), KisPaintDevice::defaultPixel(), m_d, MAX_SELECTED, outlineCache, outlineCacheValid, selectedRect(), and KisPaintDevice::setDefaultPixel().

◆ applySelection()

void KisPixelSelection::applySelection	(	KisPixelSelectionSP	selection,
		SelectionAction	action )

Apply a selection to the selection using the specified selection mode

Definition at line 141 of file kis_pixel_selection.cpp.

{
    switch (action) {
    case SELECTION_REPLACE:
        clear();
        addSelection(selection);
        break;
    case SELECTION_ADD:
        addSelection(selection);
        break;
    case SELECTION_SUBTRACT:
        subtractSelection(selection);
        break;
    case SELECTION_INTERSECT:
        intersectSelection(selection);
        break;
    case SELECTION_SYMMETRICDIFFERENCE:
        symmetricdifferenceSelection(selection);
        break;
    default:
        break;
    }
}

References addSelection(), clear(), intersectSelection(), SELECTION_ADD, SELECTION_INTERSECT, SELECTION_REPLACE, SELECTION_SUBTRACT, SELECTION_SYMMETRICDIFFERENCE, subtractSelection(), and symmetricdifferenceSelection().

◆ clear() [1/2]

void KisPixelSelection::clear ( )

overridevirtual

Reset the entire selection. The selectedRect and selectedExactRect will be empty. The selection will be completely deselected.

Reimplemented from KisPaintDevice.

Definition at line 330 of file kis_pixel_selection.cpp.

{
    setDefaultPixel(KoColor::createTransparent(colorSpace()));
    KisPaintDevice::clear();
 
    m_d->outlineCacheValid = true;
    m_d->outlineCache = QPainterPath();
 
    // Empty the thumbnail image. It is a valid state.
    m_d->invalidateThumbnailImage();
    m_d->thumbnailImageValid = true;
}

References KisPaintDevice::clear(), KisPaintDevice::colorSpace(), KoColor::createTransparent(), m_d, and KisPaintDevice::setDefaultPixel().

◆ clear() [2/2]

void KisPixelSelection::clear ( const QRect & r )

Set the specified rect to MIN_SELECTED.

Definition at line 310 of file kis_pixel_selection.cpp.

{
    if (*defaultPixel().data() != MIN_SELECTED) {
        KisFillPainter painter(KisPaintDeviceSP(this));
        const KoColorSpace * cs = KoColorSpaceRegistry::instance()->rgb8();
        painter.fillRect(r, KoColor(Qt::white, cs), MIN_SELECTED);
    } else {
        KisPaintDevice::clear(r);
    }
 
    if (m_d->outlineCacheValid) {
        QPainterPath path;
        path.addRect(r);
 
        m_d->outlineCache -= path;
    }
 
    m_d->invalidateThumbnailImage();
}

References KisPaintDevice::clear(), KisPaintDevice::defaultPixel(), KisFillPainter::fillRect(), KoColorSpaceRegistry::instance(), m_d, MIN_SELECTED, and KoColorSpaceRegistry::rgb8().

◆ clone()

KisSelectionComponent * KisPixelSelection::clone ( KisSelection * )

overridevirtual

Implements KisSelectionComponent.

Definition at line 93 of file kis_pixel_selection.cpp.

{
    return new KisPixelSelection(*this);
}

References KisPixelSelection().

◆ compositionSourceColorSpace()

const KoColorSpace * KisPixelSelection::compositionSourceColorSpace ( ) const

overridevirtual

This is a lowlevel method for the principle used in createCompositionSourceDevice(). In most of the cases the paint device creation methods should be used instead of this function.

See also: createCompositionSourceDevice(); createCompositionSourceDeviceFixed()

Reimplemented from KisPaintDevice.

Definition at line 103 of file kis_pixel_selection.cpp.

{
    return KoColorSpaceRegistry::instance()->
        colorSpace(GrayAColorModelID.id(),
                   Integer8BitsColorDepthID.id(),
                   QString());
}

References KisPaintDevice::colorSpace(), GrayAColorModelID, KoID::id(), KoColorSpaceRegistry::instance(), and Integer8BitsColorDepthID.

◆ copyAlphaFrom()

void KisPixelSelection::copyAlphaFrom	(	KisPaintDeviceSP	src,
		const QRect &	processRect )

Copies alpha channel form the specified src device

Definition at line 165 of file kis_pixel_selection.cpp.

{
    const KoColorSpace *srcCS = src->colorSpace();
 
    KisSequentialConstIterator srcIt(src, processRect);
    KisSequentialIterator dstIt(this, processRect);
 
    while (srcIt.nextPixel() && dstIt.nextPixel()) {
        const quint8 *srcPtr = srcIt.rawDataConst();
        quint8 *alpha8Ptr = dstIt.rawData();
 
        *alpha8Ptr = srcCS->opacityU8(srcPtr);
    }
 
    m_d->outlineCacheValid = false;
    m_d->outlineCache = QPainterPath();
    m_d->invalidateThumbnailImage();
}

References m_d, KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::nextPixel(), KoColorSpace::opacityU8(), KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::rawData(), and KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::rawDataConst().

◆ exactBounds()

QRect KisPaintDevice::exactBounds ( ) const

private

Get the exact bounds of this paint device. The real solution is very slow because it does a linear scanline search, but it uses caching, so calling to this function without changing the device is quite cheap.

exactBounds follows these rules:

if default pixel is transparent, then exact bounds of actual pixel data are returned
if default pixel is not transparent, then the union (defaultBounds()->bounds() | nonDefaultPixelArea()) is returned

See also: calculateExactBounds()

Definition at line 215 of file kis_paint_device.cc.

{
    return m_d->cache()->exactBounds();
}

◆ extent() [1/2]

QRect KisPaintDevice::extent ( ) const

private

Retrieve the bounds of the paint device. The size is not exact, but may be larger if the underlying datamanager works that way. For instance, the tiled datamanager keeps the extent to the nearest multiple of 64.

If default pixel is not transparent, then the actual extent rect is united with the defaultBounds()->bounds() value (the size of the image, usually).

Definition at line 193 of file kis_paint_device.cc.

{
    return m_d->currentStrategy()->extent();
}

◆ extent() [2/2]

void KisPaintDevice::extent	(	qint32 &	x,
		qint32 &	y,
		qint32 &	w,
		qint32 &	h ) const

private

Convenience method for the above.

Definition at line 196 of file kis_paint_device.cc.

{
    QRect rc = extent();
    x = rc.x();
    y = rc.y();
    w = rc.width();
    h = rc.height();
}

References KisPaintDevice::Private::fastBitBltPossible(), KIS_SAFE_ASSERT_RECOVER_NOOP, and KisPaintDevice::Private::prepareCloneImpl().

◆ intersectSelection()

void KisPixelSelection::intersectSelection ( KisPixelSelectionSP selection )

private

Intersects a selection using min-T-norm for this.

Definition at line 249 of file kis_pixel_selection.cpp.

{
    const QRect r = selection->selectedRect().united(selectedRect());
    if (r.isEmpty()) {
        clear();
        return;
    }
 
    KisHLineIteratorSP dst = createHLineIteratorNG(r.x(), r.y(), r.width());
    KisHLineConstIteratorSP src = selection->createHLineConstIteratorNG(r.x(), r.y(), r.width());
    for (int i = 0; i < r.height(); ++i) {
        do {
            *dst->rawData() = qMin(*dst->rawData(), *src->oldRawData());
        }  while (src->nextPixel() && dst->nextPixel());
        dst->nextRow();
        src->nextRow();
    }
 
    const quint8 defPixel = qMin(*defaultPixel().data(), *selection->defaultPixel().data());
    setDefaultPixel(KoColor(&defPixel, colorSpace()));
 
    crop(r);
 
    m_d->outlineCacheValid &= selection->outlineCacheValid();
 
    if (m_d->outlineCacheValid) {
        m_d->outlineCache = KritaUtils::tryCloseTornSubpathsAfterIntersection(m_d->outlineCache & selection->outlineCache());
    }
 
    m_d->invalidateThumbnailImage();
}

References clear(), KisPaintDevice::colorSpace(), KisPaintDevice::createHLineConstIteratorNG(), KisPaintDevice::createHLineIteratorNG(), KisPaintDevice::crop(), KoColor::data(), KisPaintDevice::defaultPixel(), m_d, outlineCache, outlineCacheValid, selectedRect(), KisPaintDevice::setDefaultPixel(), and KritaUtils::tryCloseTornSubpathsAfterIntersection().

◆ invalidateOutlineCache()

void KisPixelSelection::invalidateOutlineCache ( )

Definition at line 472 of file kis_pixel_selection.cpp.

{
    QMutexLocker locker(&m_d->outlineCacheMutex);
    m_d->outlineCacheValid = false;
    m_d->thumbnailImageValid = false;
}

References m_d.

◆ invalidateThumbnailImage()

void KisPixelSelection::invalidateThumbnailImage ( )

inline

Definition at line 48 of file kis_pixel_selection.cpp.

                                    {
        thumbnailImageValid = false;
        thumbnailImage = QImage();
        thumbnailImageTransform = QTransform();
    }

◆ invert()

void KisPixelSelection::invert ( )

Invert the total selection. This will also invert the default value of the selection paint device, from MIN_SELECTED to MAX_SELECTED or back.

Definition at line 343 of file kis_pixel_selection.cpp.

{
    // Region is needed here (not exactBounds or extent), because
    // unselected but existing pixels need to be inverted too
    QRect rc = region().boundingRect();
 
    if (!rc.isEmpty()) {
        KisSequentialIterator it(this, rc);
        while(it.nextPixel()) {
            *(it.rawData()) = MAX_SELECTED - *(it.rawData());
        }
    }
    quint8 defPixel = MAX_SELECTED - *defaultPixel().data();
    setDefaultPixel(KoColor(&defPixel, colorSpace()));
 
    if (m_d->outlineCacheValid) {
        QPainterPath path;
        path.addRect(defaultBounds()->bounds());
 
        m_d->outlineCache = path - m_d->outlineCache;
    }
 
    m_d->invalidateThumbnailImage();
}

References KisRegion::boundingRect(), bounds, KisPaintDevice::colorSpace(), KoColor::data(), KisPaintDevice::defaultBounds(), KisPaintDevice::defaultPixel(), m_d, MAX_SELECTED, KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::nextPixel(), KisSequentialIteratorBase< IteratorPolicy, SourcePolicy, ProgressPolicy >::rawData(), KisPaintDevice::region(), and KisPaintDevice::setDefaultPixel().

◆ isEmpty()

bool KisPixelSelection::isEmpty ( ) const

overridevirtual

Implements KisSelectionComponent.

Definition at line 447 of file kis_pixel_selection.cpp.

{
    return *defaultPixel().data() == MIN_SELECTED && selectedRect().isEmpty();
}

References KoColor::data(), KisPaintDevice::defaultPixel(), MIN_SELECTED, and selectedRect().

◆ isTotallyUnselected()

bool KisPixelSelection::isTotallyUnselected ( const QRect & r ) const

Tests if the rect is totally outside the selection.

Definition at line 391 of file kis_pixel_selection.cpp.

{
    if (*defaultPixel().data() != MIN_SELECTED)
        return false;
    QRect sr = selectedExactRect();
    return ! r.intersects(sr);
}

References KisPaintDevice::defaultPixel(), MIN_SELECTED, and selectedExactRect().

◆ moveTo() [1/3]

void KisPaintDevice::moveTo ( const QPoint & pt )

virtual

Convenience method for the above.

Reimplemented from KisPaintDevice.

Definition at line 156 of file kis_paint_device.cc.

{
    m_d->currentStrategy()->move(pt);
    m_d->cache()->invalidate();
}

References KisPaintDevice::Private::m_frames.

◆ moveTo() [2/3]

void KisPixelSelection::moveTo ( const QPoint & pt )

overridevirtual

Overridden from KisPaintDevice to handle outline cache moves

Reimplemented from KisPaintDevice.

Definition at line 368 of file kis_pixel_selection.cpp.

{
    const int lod = defaultBounds()->currentLevelOfDetail();
    const QPoint lod0Point = !lod ? pt :
        pt * KisLodTransform::lodToInvScale(lod);
 
    const QPoint offset = lod0Point - m_d->lod0CachesOffset;
 
    if (m_d->outlineCacheValid) {
        m_d->outlineCache.translate(offset);
    }
 
    if (m_d->thumbnailImageValid) {
        m_d->thumbnailImageTransform =
            QTransform::fromTranslate(offset.x(), offset.y()) *
            m_d->thumbnailImageTransform;
    }
 
    m_d->lod0CachesOffset = lod0Point;
 
    KisPaintDevice::moveTo(pt);
}

References KisDefaultBoundsBase::currentLevelOfDetail(), KisPaintDevice::defaultBounds(), KisLodTransformBase::lodToInvScale(), m_d, KisPaintDevice::moveTo(), and KisPaintDevice::offset().

◆ moveTo() [3/3]

void KisPaintDevice::moveTo	(	qint32	x,
		qint32	y )

Moves the device to these new coordinates (no incremental move)

Definition at line 151 of file kis_paint_device.cc.

{
    moveTo(QPoint(x, y));
}

◆ outline()

QVector< QPolygon > KisPixelSelection::outline ( ) const

outline returns the outline of the current selection

Returns: a vector of polygons that can be used to draw the outline

When the default pixel is not fully transparent, the exactBounds() return extent of the device instead. To make this value sane we should limit the calculated area by the bounds of the image.

Definition at line 409 of file kis_pixel_selection.cpp.

{
    QRect selectionExtent = selectedExactRect();
 
    if (*defaultPixel().data() != MIN_SELECTED) {
        selectionExtent &= defaultBounds()->bounds();
    }
 
    qint32 xOffset = selectionExtent.x();
    qint32 yOffset = selectionExtent.y();
    qint32 width = selectionExtent.width();
    qint32 height = selectionExtent.height();
 
    KisOutlineGenerator generator(colorSpace(), MIN_SELECTED);
    // If the selection is small using a buffer is much faster
    try {
        quint8* buffer = new quint8[width*height];
        readBytes(buffer, xOffset, yOffset, width, height);
 
        QVector<QPolygon> paths = generator.outline(buffer, xOffset, yOffset, width, height);
 
        delete[] buffer;
        return paths;
    }
    catch(const std::bad_alloc&) {
        // Allocating so much memory failed, so we fall through to the slow option.
        warnKrita << "KisPixelSelection::outline ran out of memory allocating" << width << "*" << height << "bytes.";
    }
 
    return generator.outline(this, xOffset, yOffset, width, height);
}

References KisDefaultBoundsBase::bounds(), KisPaintDevice::colorSpace(), KisPaintDevice::defaultBounds(), KisPaintDevice::defaultPixel(), MIN_SELECTED, KisOutlineGenerator::outline(), KisPaintDevice::readBytes(), selectedExactRect(), and warnKrita.

◆ outlineCache()

QPainterPath KisPixelSelection::outlineCache ( ) const

overridevirtual

Implements KisSelectionComponent.

◆ outlineCacheValid()

bool KisPixelSelection::outlineCacheValid ( ) const

overridevirtual

Implements KisSelectionComponent.

◆ parentSelection()

KisSelectionWSP KisPixelSelection::parentSelection ( ) const

◆ read()

bool KisPixelSelection::read ( QIODevice * stream )

Definition at line 111 of file kis_pixel_selection.cpp.

{
    bool retval = KisPaintDevice::read(stream);
    m_d->outlineCacheValid = false;
    m_d->invalidateThumbnailImage();
    return retval;
}

References m_d, and KisPaintDevice::read().

◆ recalculateOutlineCache()

void KisPixelSelection::recalculateOutlineCache ( )

overridevirtual

The outline generation algorithm has a small bug, which results in the starting point be repeated twice in the beginning of the path, instead of being put to the end. Here we just explicitly close the path to workaround it.

See also: KisSelectionTest::testOutlineGeneration()

Implements KisSelectionComponent.

Definition at line 479 of file kis_pixel_selection.cpp.

{
    QMutexLocker locker(&m_d->outlineCacheMutex);
 
    m_d->outlineCache = QPainterPath();
 
    Q_FOREACH (const QPolygon &polygon, outline()) {
        m_d->outlineCache.addPolygon(polygon);
 
        m_d->outlineCache.closeSubpath();
    }
 
    m_d->outlineCacheValid = true;
}

References m_d, and outline().

◆ recalculateThumbnailImage()

void KisPixelSelection::recalculateThumbnailImage ( const QColor & maskColor )

Definition at line 541 of file kis_pixel_selection.cpp.

{
    QRect rc = selectedExactRect();
    const int maxPreviewSize = 2000;
 
    if (rc.isEmpty()) {
        m_d->thumbnailImageTransform = QTransform();
        m_d->thumbnailImage = QImage();
        return;
    }
 
 
    if (rc.width() > maxPreviewSize ||
        rc.height() > maxPreviewSize) {
 
        qreal factor = 1.0;
 
        if (rc.width() > rc.height()) {
            factor = qreal(maxPreviewSize) / rc.width();
        } else {
            factor = qreal(maxPreviewSize) / rc.height();
        }
 
        int newWidth = qRound(rc.width() * factor);
        int newHeight = qRound(rc.height() * factor);
 
        m_d->thumbnailImageTransform =
            QTransform::fromScale(qreal(rc.width()) / newWidth,
                                  qreal(rc.height()) / newHeight) *
            QTransform::fromTranslate(rc.x(), rc.y());
 
        KisPaintDeviceSP thumbDevice =
            createThumbnailDevice(newWidth, newHeight, rc);
 
        QRect thumbRect(0, 0, newWidth, newHeight);
        m_d->thumbnailImage = deviceToQImage(thumbDevice, thumbRect, maskColor);
 
    } else {
        m_d->thumbnailImageTransform = QTransform::fromTranslate(rc.x(), rc.y());
        m_d->thumbnailImage = deviceToQImage(this, rc, maskColor);
    }
 
    m_d->thumbnailImageValid = true;
}

References KisPaintDevice::createThumbnailDevice(), deviceToQImage(), m_d, and selectedExactRect().

◆ renderToProjection() [1/2]

void KisPixelSelection::renderToProjection ( KisPaintDeviceSP projection )

overridevirtual

Implements KisSelectionComponent.

Definition at line 596 of file kis_pixel_selection.cpp.

{
    renderToProjection(projection, selectedExactRect());
}

References renderToProjection(), and selectedExactRect().

◆ renderToProjection() [2/2]

void KisPixelSelection::renderToProjection	(	KisPaintDeviceSP	projection,
		const QRect &	r )

overridevirtual

Implements KisSelectionComponent.

Definition at line 601 of file kis_pixel_selection.cpp.

{
    QRect updateRect = rc & selectedExactRect();
 
    if (updateRect.isValid()) {
        KisPainter::copyAreaOptimized(updateRect.topLeft(), KisPaintDeviceSP(this), projection, updateRect);
    }
}

References KisPainter::copyAreaOptimized(), and selectedExactRect().

◆ select()

void KisPixelSelection::select	(	const QRect &	r,
		quint8	selectedness = MAX_SELECTED )

Fill the specified rect with the specified selectedness.

Definition at line 119 of file kis_pixel_selection.cpp.

{
    QRect r = rc.normalized();
    if (r.isEmpty()) return;
 
    KisFillPainter painter(KisPaintDeviceSP(this));
    const KoColorSpace * cs = KoColorSpaceRegistry::instance()->rgb8();
    painter.fillRect(r, KoColor(Qt::white, cs), selectedness);
 
    if (m_d->outlineCacheValid) {
        QPainterPath path;
        path.addRect(r);
 
        if (selectedness != MIN_SELECTED) {
            m_d->outlineCache += path;
        } else {
            m_d->outlineCache -= path;
        }
    }
    m_d->invalidateThumbnailImage();
}

References KisFillPainter::fillRect(), KoColorSpaceRegistry::instance(), m_d, MIN_SELECTED, and KoColorSpaceRegistry::rgb8().

◆ selectedExactRect()

QRect KisPixelSelection::selectedExactRect ( ) const

Slow, but exact way of determining the rectangle that encloses the selection.

Definition at line 404 of file kis_pixel_selection.cpp.

{
    return exactBounds();
}

References exactBounds().

◆ selectedRect()

QRect KisPixelSelection::selectedRect ( ) const

Rough, but fastish way of determining the area of the tiles used by the selection.

Definition at line 399 of file kis_pixel_selection.cpp.

{
    return extent();
}

References extent().

◆ setOutlineCache()

void KisPixelSelection::setOutlineCache ( const QPainterPath & cache )

Definition at line 458 of file kis_pixel_selection.cpp.

{
    QMutexLocker locker(&m_d->outlineCacheMutex);
    m_d->outlineCache = cache;
    m_d->outlineCacheValid = true;
    m_d->thumbnailImageValid = false;
}

References m_d.

◆ setParentSelection()

void KisPixelSelection::setParentSelection ( KisSelectionWSP selection )

Definition at line 586 of file kis_pixel_selection.cpp.

{
    m_d->parentSelection = selection;
}

References m_d.

◆ subtractSelection()

void KisPixelSelection::subtractSelection ( KisPixelSelectionSP selection )

private

Subtracts a selection

Definition at line 215 of file kis_pixel_selection.cpp.

{
    QRect r = selection->selectedRect();
    if (r.isEmpty()) return;
 
 
    KisHLineIteratorSP dst = createHLineIteratorNG(r.x(), r.y(), r.width());
    KisHLineConstIteratorSP src = selection->createHLineConstIteratorNG(r.x(), r.y(), r.width());
    for (int i = 0; i < r.height(); ++i) {
        do {
            if (*dst->rawData() - *src->oldRawData() > MIN_SELECTED)
                *dst->rawData() = *dst->rawData() - *src->oldRawData();
            else
                *dst->rawData() = MIN_SELECTED;
 
        } while (src->nextPixel() && dst->nextPixel());
        dst->nextRow();
        src->nextRow();
    }
 
    const quint8 defPixel = *selection->defaultPixel().data() > *defaultPixel().data()
                            ? MIN_SELECTED
                            : *defaultPixel().data() - *selection->defaultPixel().data();
    setDefaultPixel(KoColor(&defPixel, colorSpace()));
 
    m_d->outlineCacheValid &= selection->outlineCacheValid();
 
    if (m_d->outlineCacheValid) {
        m_d->outlineCache -= selection->outlineCache();
    }
 
    m_d->invalidateThumbnailImage();
}

References KisPaintDevice::colorSpace(), KisPaintDevice::createHLineConstIteratorNG(), KisPaintDevice::createHLineIteratorNG(), KoColor::data(), KisPaintDevice::defaultPixel(), m_d, MIN_SELECTED, outlineCache, outlineCacheValid, selectedRect(), and KisPaintDevice::setDefaultPixel().

◆ symmetricdifferenceSelection()

void KisPixelSelection::symmetricdifferenceSelection ( KisPixelSelectionSP selection )

private

Invert a selection or intersect with the inverse of a selection

Definition at line 281 of file kis_pixel_selection.cpp.

{
    QRect r = selection->selectedRect().united(selectedRect());
    if (r.isEmpty()) return;
 
    KisHLineIteratorSP dst = createHLineIteratorNG(r.x(), r.y(), r.width());
    KisHLineConstIteratorSP src = selection->createHLineConstIteratorNG(r.x(), r.y(), r.width());
    for (int i = 0; i < r.height(); ++i) {
 
        do {
            *dst->rawData() = abs(*dst->rawData() - *src->oldRawData());
        }  while (src->nextPixel() && dst->nextPixel());
 
        dst->nextRow();
        src->nextRow();
    }
 
    const quint8 defPixel = abs(*defaultPixel().data() - *selection->defaultPixel().data());
    setDefaultPixel(KoColor(&defPixel, colorSpace()));
    
    m_d->outlineCacheValid &= selection->outlineCacheValid();
 
    if (m_d->outlineCacheValid) {
       m_d->outlineCache = (m_d->outlineCache | selection->outlineCache()) - (m_d->outlineCache & selection->outlineCache());
    }
 
    m_d->invalidateThumbnailImage();
}

References KisPaintDevice::colorSpace(), KisPaintDevice::createHLineConstIteratorNG(), KisPaintDevice::createHLineIteratorNG(), KoColor::data(), KisPaintDevice::defaultPixel(), m_d, outlineCache, outlineCacheValid, selectedRect(), and KisPaintDevice::setDefaultPixel().

◆ thumbnailImage()

QImage KisPixelSelection::thumbnailImage ( ) const

◆ thumbnailImageTransform()

QTransform KisPixelSelection::thumbnailImageTransform ( ) const

◆ thumbnailImageValid()

bool KisPixelSelection::thumbnailImageValid ( ) const

Member Data Documentation

◆ lod0CachesOffset

QPoint KisPixelSelection::lod0CachesOffset

Definition at line 46 of file kis_pixel_selection.cpp.

◆ m_d

Private* const KisPixelSelection::m_d

private

Definition at line 162 of file kis_pixel_selection.h.

◆ outlineCache

QPainterPath KisPixelSelection::outlineCache

Definition at line 38 of file kis_pixel_selection.cpp.

◆ outlineCacheMutex

QMutex KisPixelSelection::outlineCacheMutex

Definition at line 40 of file kis_pixel_selection.cpp.

◆ outlineCacheValid

bool KisPixelSelection::outlineCacheValid

Definition at line 39 of file kis_pixel_selection.cpp.

◆ parentSelection

KisSelectionWSP KisPixelSelection::parentSelection

Definition at line 36 of file kis_pixel_selection.cpp.

◆ thumbnailImage

QImage KisPixelSelection::thumbnailImage

Definition at line 43 of file kis_pixel_selection.cpp.

◆ thumbnailImageTransform

QTransform KisPixelSelection::thumbnailImageTransform

Definition at line 44 of file kis_pixel_selection.cpp.

◆ thumbnailImageValid

bool KisPixelSelection::thumbnailImageValid

Definition at line 42 of file kis_pixel_selection.cpp.

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

libs/image/kis_pixel_selection.cpp
libs/image/kis_pixel_selection.h

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ KisPixelSelection() [1/3]

◆ KisPixelSelection() [2/3]

◆ KisPixelSelection() [3/3]

◆ ~KisPixelSelection()

Member Function Documentation

◆ addSelection()

◆ applySelection()

◆ clear() [1/2]

◆ clear() [2/2]

◆ clone()

◆ compositionSourceColorSpace()

◆ copyAlphaFrom()

◆ exactBounds()

◆ extent() [1/2]

◆ extent() [2/2]

◆ intersectSelection()

◆ invalidateOutlineCache()

◆ invalidateThumbnailImage()

◆ invert()

◆ isEmpty()

◆ isTotallyUnselected()

◆ moveTo() [1/3]

◆ moveTo() [2/3]

◆ moveTo() [3/3]

◆ outline()

◆ outlineCache()

◆ outlineCacheValid()

◆ parentSelection()

◆ read()

◆ recalculateOutlineCache()

◆ recalculateThumbnailImage()

◆ renderToProjection() [1/2]

◆ renderToProjection() [2/2]

◆ select()

◆ selectedExactRect()

◆ selectedRect()

◆ setOutlineCache()

◆ setParentSelection()

◆ subtractSelection()

◆ symmetricdifferenceSelection()

◆ thumbnailImage()

◆ thumbnailImageTransform()

◆ thumbnailImageValid()

Member Data Documentation

◆ lod0CachesOffset

◆ m_d

◆ outlineCache

◆ outlineCacheMutex

◆ outlineCacheValid

◆ parentSelection

◆ thumbnailImage

◆ thumbnailImageTransform

◆ thumbnailImageValid