#include <kis_transform_mask.h>

Inheritance diagram for KisTransformMask:

Signals
void	sigInternalForceStaticImageUpdate ()

Signals inherited from KisNode
void	sigNodeChangedInternal ()

Signals inherited from KisBaseNode
void	keyframeChannelAdded (KisKeyframeChannel *channel)

void	opacityChanged (quint8 value)

Public Member Functions
bool	accept (KisNodeVisitor &v) override

void	accept (KisProcessingVisitor &visitor, KisUndoAdapter *undoAdapter) override

KisPaintDeviceSP	buildPreviewDevice ()

KisPaintDeviceSP	buildSourcePreviewDevice ()

QRect	changeRect (const QRect &rect, PositionToFilthy pos=N_FILTHY) const override

KisNodeSP	clone () const override

QRect	decorateRect (KisPaintDeviceSP &src, KisPaintDeviceSP &dst, const QRect &rc, PositionToFilthy maskPos, KisRenderPassFlags flags) const override

QRect	exactBounds () const override

QRect	extent () const override

void	forceUpdateTimedNode () override
	forceUpdateTimedNode forces the node to regenerate its project. The update might be asynchronous, so you should call image->waitForDone() after that.

KisPaintDeviceList	getLodCapableDevices () const override

bool	hasPendingTimedUpdates () const override

QIcon	icon () const override

	KisTransformMask (const KisTransformMask &rhs)

	KisTransformMask (KisImageWSP image, const QString &name)

QRect	needRect (const QRect &rect, PositionToFilthy pos=N_FILTHY) const override

void	overrideStaticCacheDevice (KisPaintDeviceSP device)

KisPaintDeviceSP	paintDevice () const override

	Private (const Private &rhs)

	Private (KisImageSP image)

void	recalculateStaticImage ()

void	setImage (KisImageWSP image) override

void	setTestingInterface (KisTransformMaskTestingInterface *interface)

void	setTransformParams (KisTransformMaskParamsInterfaceSP params)

void	setTransformParamsWithUndo (KisTransformMaskParamsInterfaceSP params, KUndo2Command *parentCommand)

void	setX (qint32 x) override

void	setY (qint32 y) override

QRect	sourceDataBounds () const

bool	staticImageCacheIsValid () const

void	syncLodCache () override

KisTransformMaskTestingInterface *	testingInterface () const

void	threadSafeForceStaticImageUpdate ()

void	threadSafeForceStaticImageUpdate (const QRect &extraUpdateRect)

KisTransformMaskParamsInterfaceSP	transformParams () const

qint32	x () const override

qint32	y () const override

	~KisTransformMask () override

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

Public Member Functions inherited from KisEffectMask
void	apply (KisPaintDeviceSP projection, const QRect &applyRect, const QRect &needRect, PositionToFilthy maskPos, KisRenderPassFlags flags) const

	KisEffectMask (const KisEffectMask &rhs)

	KisEffectMask (KisImageWSP image, const QString &name)

	~KisEffectMask () override

Public Member Functions inherited from KisMask
bool	allowAsChild (KisNodeSP node) const override

const KoColorSpace *	colorSpace () const override

const KoCompositeOp *	compositeOp () const override

QImage	createThumbnail (qint32 w, qint32 h, Qt::AspectRatioMode aspectRatioMode=Qt::IgnoreAspectRatio) override

void	initSelection (KisLayerSP parentLayer)
	initSelection initializes an empty selection

void	initSelection (KisPaintDeviceSP copyFromDevice, KisLayerSP parentLayer)
	initSelection initializes the selection for the mask from the given paint device.

void	initSelection (KisSelectionSP copyFrom, KisLayerSP parentLayer)
	initSelection initializes the selection for the mask from the given selection's projection.

void	initSelectionImpl (KisSelectionSP copyFrom, KisLayerSP parentLayer, KisPaintDeviceSP copyFromDevice, KisImageWSP image)

	KisMask (const KisMask &rhs)

	KisMask (KisImageWSP image, const QString &name)

virtual QRect	nonDependentExtent () const

KisPaintDeviceSP	original () const override

	Private (KisMask *_q)

KisPaintDeviceSP	projection () const override

KisAbstractProjectionPlaneSP	projectionPlane () const override

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

KisSelectionSP	selection () const

void	setSelection (KisSelectionSP selection)

bool	supportsLodPainting () const override

void	testingInitSelection (const QRect &rect, KisLayerSP parentLayer)

int	thumbnailSeqNo () const override

	~KisMask () override

Public Member Functions inherited from KisNode
KisNodeSP	at (quint32 index) const

KisBusyProgressIndicator *	busyProgressIndicator () const

quint32	childCount () const

QList< KisNodeSP >	childNodes (const QStringList &nodeTypes, const KoProperties &properties) const

const KisNode *	findSymmetricClone (const KisNode srcRoot, const KisNode dstRoot, const KisNode *srcTarget)

KisNodeSP	firstChild () const

KisNodeGraphListener *	graphListener () const

int	graphSequenceNumber () const

void	handleKeyframeChannelFrameAboutToBeRemoved (const KisKeyframeChannel *channel, int time)

virtual void	handleKeyframeChannelFrameAdded (const KisKeyframeChannel *channel, int time)

virtual void	handleKeyframeChannelFrameChange (const KisKeyframeChannel *channel, int time)

void	handleKeyframeChannelFrameHasBeenRemoved (const KisKeyframeChannel *channel, int time)

KisFrameChangeUpdateRecipe	handleKeyframeChannelUpdateImpl (const KisKeyframeChannel *channel, int time)

int	index (const KisNodeSP node) const

void	invalidateFrames (const KisTimeSpan &range, const QRect &rect)

	KisNode (const KisNode &rhs)

	KisNode (KisImageWSP image)

KisNodeSP	lastChild () const

KisNodeSP	nextSibling () const

KisNodeProgressProxy *	nodeProgressProxy () const

KisNodeSP	parent () const

KisNodeSP	prevSibling () const

	Private (KisNode *node)

void	processDuplicatedClones (const KisNode srcDuplicationRoot, const KisNode dstDuplicationRoot, KisNode *node)

virtual KisProjectionLeafSP	projectionLeaf () const

void	requestTimeSwitch (int time)

virtual void	setDirty ()

void	setDirty (const KisRegion &region)

void	setDirty (const QRect &rect)

virtual void	setDirty (const QVector< QRect > &rects)

void	setDirtyDontResetAnimationCache ()

void	setDirtyDontResetAnimationCache (const QRect &rect)

void	setDirtyDontResetAnimationCache (const QVector< QRect > &rects)
	setDirtyDontResetAnimationCache does almost the same thing as usual setDirty() call, but doesn't reset the animation cache (since onion skins are not used when rendering animation.

void	setGraphListener (KisNodeGraphListener *graphListener)

	~KisNode () override

Public Member Functions inherited from KisBaseNode
bool	belongsToIsolatedGroup () const

bool	check (const KoProperties &properties) const

bool	collapsed () const

int	colorLabelIndex () const

virtual KisPaintDeviceSP	colorSampleSourceDevice () const

const QString &	compositeOpId () const

virtual QImage	createThumbnailForFrame (qint32 w, qint32 h, int time, Qt::AspectRatioMode aspectRatioMode=Qt::IgnoreAspectRatio)

void	enableAnimation ()

KisKeyframeChannel *	getKeyframeChannel (const QString &id) const

KisKeyframeChannel *	getKeyframeChannel (const QString &id, bool create)

bool	hasEditablePaintDevice () const

KisImageWSP	image () const

bool	isAnimated () const

bool	isEditable (bool checkVisibility=true) const

virtual bool	isFakeNode () const

bool	isIsolatedRoot () const

bool	isPinnedToTimeline () const

QMap< QString, KisKeyframeChannel * >	keyframeChannels () const

	KisBaseNode (const KisBaseNode &rhs)

	KisBaseNode (KisImageWSP image)

void	mergeNodeProperties (const KoProperties &properties)

QString	name () const

const KoProperties &	nodeProperties () const

quint8	opacity () const

quint8	percentOpacity () const

	Private (const Private &rhs)

	Private (KisImageWSP p_image)

virtual PropertyList	sectionModelProperties () const

void	setCollapsed (bool collapsed)

void	setColorLabelIndex (int index)

void	setCompositeOpId (const QString &compositeOpId)

void	setName (const QString &name)

void	setNodeProperty (const QString &name, const QVariant &value)

void	setOpacity (quint8 val)

void	setPercentOpacity (quint8 val)

void	setPinnedToTimeline (bool pinned)

virtual void	setSectionModelProperties (const PropertyList &properties)

virtual void	setUserLocked (bool l)

void	setUuid (const QUuid &id)

virtual void	setVisible (bool visible, bool loading=false)

bool	supportsLodMoves () const

virtual void	updateSettings ()

bool	userLocked () const

QUuid	uuid () const

virtual bool	visible (bool recursive=false) const

	~KisBaseNode () override

Public Member Functions inherited from KisShared
bool	deref ()

bool	ref ()

int	refCount ()

QAtomicInt *	sharedWeakReference ()

Public Member Functions inherited from KisIndirectPaintingSupport
bool	hasTemporaryTarget () const

	KisIndirectPaintingSupport ()

void	mergeToLayer (KisNodeSP layer, KUndo2Command *parentCommand, const KUndo2MagicString &transactionText, int timedID)

virtual void	mergeToLayerThreaded (KisNodeSP layer, KUndo2Command parentCommand, const KUndo2MagicString &transactionText, int timedID, QVector< KisRunnableStrokeJobData > *jobs)

virtual void	setCurrentColor (const KoColor &color)

void	setTemporaryChannelFlags (const QBitArray &channelFlags)

void	setTemporaryCompositeOp (const QString &id)

void	setTemporaryOpacity (qreal o)

void	setTemporarySelection (KisSelectionSP selection)

void	setTemporaryTarget (KisPaintDeviceSP t)

void	setupTemporaryPainter (KisPainter *painter) const

virtual bool	supportsNonIndirectPainting () const

KisPaintDeviceSP	temporaryTarget () const

FinalMergeSuspenderSP	trySuspendFinalMerge ()

virtual	~KisIndirectPaintingSupport ()

Public Member Functions inherited from KisDelayedUpdateNodeInterface
virtual	~KisDelayedUpdateNodeInterface ()

Public Attributes
AccumulatedRectStorage	forcedStaticUpdateExtraUpdateRect

qreal	offBoundsReadArea

KisLodCapableLayerOffset	offset

KisAnimatedTransformParamsHolderInterfaceSP	paramsHolder

bool	recalculatingStaticImage

StaticCacheStorage	staticCache

QScopedPointer< KisTransformMaskTestingInterface >	testingInterface

KisThreadSafeSignalCompressor	updateSignalCompressor

KisPerspectiveTransformWorker	worker

Public Attributes inherited from Private
KisCanvas2 *	canvas

int	displayedFrame

int	intendedFrame

Public Attributes inherited from KisMask
QScopedPointer< QPoint >	deferredSelectionOffset

KisCachedPaintDevice	paintDeviceCache

KisAbstractProjectionPlaneSP	projectionPlane

KisMask *	q

KisSafeSelectionNodeProjectionStoreSP	safeProjection

KisSelectionSP	selection

Public Attributes inherited from KisNode
KisBusyProgressIndicator *	busyProgressIndicator

std::optional< KisFrameChangeUpdateRecipe >	frameRemovalUpdateRecipe

KisNodeGraphListener *	graphListener

KisNodeProgressProxy *	nodeProgressProxy

KisSafeReadNodeList	nodes

QReadWriteLock	nodeSubgraphLock

KisNodeWSP	parent

KisProjectionLeafSP	projectionLeaf

Public Attributes inherited from KisBaseNode
bool	animated {false}

bool	collapsed {false}

QString	compositeOp

KisBaseNode::Property	hack_visible

QUuid	id

KisImageWSP	image

QMap< QString, KisKeyframeChannel * >	keyframeChannels

KisAnimatedOpacityProperty	opacityProperty

bool	pinnedToTimeline {false}

KoProperties	properties

bool	supportsLodMoves {false}

Public Attributes inherited from KisIndirectPaintingSupport
QBitArray	channelFlags

QString	compositeOp

qreal	compositeOpacity

bool	finalMergeInProgress = true

QReadWriteLock	lock

KisSelectionSP	selection

KisPaintDeviceSP	temporaryTarget

Protected Member Functions
KisKeyframeChannel *	requestKeyframeChannel (const QString &id) override

bool	supportsKeyframeChannel (const QString &id) override

Protected Member Functions inherited from KisMask
void	apply (KisPaintDeviceSP projection, const QRect &applyRect, const QRect &needRect, PositionToFilthy maskPos, KisRenderPassFlags flags) const

void	baseNodeChangedCallback () override

virtual void	flattenSelectionProjection (KisSelectionSP selection, const QRect &dirtyRect) const

virtual void	mergeInMaskInternal (KisPaintDeviceSP projection, KisSelectionSP effectiveSelection, const QRect &applyRect, const QRect &preparedNeedRect, PositionToFilthy maskPos, KisRenderPassFlags flags) const

virtual bool	paintsOutsideSelection () const

Protected Member Functions inherited from KisNode
virtual QRect	accessRect (const QRect &rect, PositionToFilthy pos=N_FILTHY) const

void	addKeyframeChannel (KisKeyframeChannel *channel) override

void	baseNodeChangedCallback () override

void	baseNodeCollapsedChangedCallback () override

void	baseNodeInvalidateAllFramesCallback () override

virtual void	childNodeChanged (KisNodeSP changedChildNode)

virtual KisFrameChangeUpdateRecipe	handleKeyframeChannelFrameAboutToBeRemovedImpl (const KisKeyframeChannel *channel, int time)

void	notifyParentVisibilityChanged (bool value) override

KisBaseNodeSP	parentCallback () const override

Protected Member Functions inherited from KisBaseNode
void	setSupportsLodMoves (bool value)

Protected Member Functions inherited from KisShared
	KisShared ()

	~KisShared ()

Protected Member Functions inherited from KisIndirectPaintingSupport
void	lockTemporaryTargetForWrite () const

void	mergeToLayerImpl (KisPaintDeviceSP dst, KUndo2Command parentCommand, const KUndo2MagicString &transactionText, int timedID, bool cleanResources, WriteLockerSP sharedWriteLock, QVector< KisRunnableStrokeJobData > *jobs)

void	releaseResources ()

QString	temporaryCompositeOp () const

virtual void	writeMergeData (KisPainter *painter, KisPaintDeviceSP src, const QRect &rc)

Private Slots
void	slotDelayedStaticUpdate ()

void	slotInternalForceStaticImageUpdate ()

Private Member Functions
void	forceStartAsyncRegenerationJob ()

void	startAsyncRegenerationJob ()

Private Attributes
const QScopedPointer< Private >	m_d

Additional Inherited Members
Public Types inherited from KisNode
enum	PositionToFilthy { N_ABOVE_FILTHY = 0x08 , N_FILTHY_PROJECTION = 0x20 , N_FILTHY = 0x40 , N_BELOW_FILTHY = 0x80 }

Public Types inherited from KisBaseNode
typedef QList< Property >	PropertyList

Public Types inherited from KisIndirectPaintingSupport
using	FinalMergeSuspenderSP = QSharedPointer<FinalMergeSuspender>

Protected Types inherited from KisIndirectPaintingSupport
using	WriteLockerSP = QSharedPointer<WriteLocker>

Detailed Description

Transform a layer according to a matrix transform

Definition at line 156 of file kis_transform_mask.cpp.

Constructor & Destructor Documentation

◆ KisTransformMask() [1/2]

KisTransformMask::KisTransformMask	(	KisImageWSP	image,
		const QString &	name )

Create an empty transform mask.

Definition at line 195 of file kis_transform_mask.cpp.

    : KisEffectMask(image, name),
      m_d(new Private(image))
{
    connect(&m_d->updateSignalCompressor, SIGNAL(timeout()), SLOT(slotDelayedStaticUpdate()));
    connect(this, SIGNAL(sigInternalForceStaticImageUpdate()), SLOT(slotInternalForceStaticImageUpdate()));
    m_d->offBoundsReadArea = KisImageConfig(true).transformMaskOffBoundsReadArea();
    setSupportsLodMoves(false);
}

References connect(), m_d, KisBaseNode::setSupportsLodMoves(), sigInternalForceStaticImageUpdate(), slotDelayedStaticUpdate(), slotInternalForceStaticImageUpdate(), and KisImageConfig::transformMaskOffBoundsReadArea().

◆ ~KisTransformMask()

KisTransformMask::~KisTransformMask ( )

override

Definition at line 205 of file kis_transform_mask.cpp.

206{

207}

◆ KisTransformMask() [2/2]

KisTransformMask::KisTransformMask ( const KisTransformMask & rhs )

The channels has already been cloned inside the params object, just relink them to the node

Definition at line 209 of file kis_transform_mask.cpp.

    : KisEffectMask(rhs),
      m_d(new Private(*rhs.m_d))
{
    connect(&m_d->updateSignalCompressor, SIGNAL(timeout()), SLOT(slotDelayedStaticUpdate()));
 
 
    const QVector<QString> ids = {KisKeyframeChannel::PositionX.id(),
                                  KisKeyframeChannel::PositionY.id(),
                                  KisKeyframeChannel::ScaleX.id(),
                                  KisKeyframeChannel::ScaleY.id(),
                                  KisKeyframeChannel::ShearX.id(),
                                  KisKeyframeChannel::ShearY.id(),
                                  KisKeyframeChannel::RotationX.id(),
                                  KisKeyframeChannel::RotationY.id(),
                                  KisKeyframeChannel::RotationZ.id()};
 
    Q_FOREACH (const QString &id, ids) {
        KisKeyframeChannel *channel = m_d->paramsHolder->getKeyframeChannel(id);
        if (channel) {
            addKeyframeChannel(channel);
        }
    }
}

References KisNode::addKeyframeChannel(), connect(), KoID::id(), m_d, KisKeyframeChannel::PositionX, KisKeyframeChannel::PositionY, KisKeyframeChannel::RotationX, KisKeyframeChannel::RotationY, KisKeyframeChannel::RotationZ, KisKeyframeChannel::ScaleX, KisKeyframeChannel::ScaleY, KisKeyframeChannel::ShearX, KisKeyframeChannel::ShearY, and slotDelayedStaticUpdate().

Member Function Documentation

◆ accept() [1/2]

bool KisTransformMask::accept ( KisNodeVisitor & )

overridevirtual

Accept the KisNodeVisitor (for the Visitor design pattern), should call the correct function on the KisNodeVisitor for this node type, so you need to override it for all leaf classes in the node inheritance hierarchy.

return false if the visitor could not successfully act on this node instance.

Reimplemented from KisNode.

Definition at line 540 of file kis_transform_mask.cpp.

{
    return v.visit(this);
}

References v.

◆ accept() [2/2]

void KisTransformMask::accept	(	KisProcessingVisitor &	visitor,
		KisUndoAdapter *	undoAdapter )

overridevirtual

Accept the KisNodeVisitor (for the Visitor design pattern), should call the correct function on the KisProcessingVisitor for this node type, so you need to override it for all leaf classes in the node inheritance hierarchy.

The processing visitor differs from node visitor in the way that it accepts undo adapter, that allows the processing to be multithreaded

Reimplemented from KisNode.

Definition at line 545 of file kis_transform_mask.cpp.

{
    return visitor.visit(this, undoAdapter);
}

References KisProcessingVisitor::visit().

◆ buildPreviewDevice()

KisPaintDeviceSP KisTransformMask::buildPreviewDevice ( )

Note: this function must be called from within the scheduler's context. We are accessing parent's updateProjection(), which is not entirely safe. The calling job must ensure it is the only job running.

Definition at line 317 of file kis_transform_mask.cpp.

{
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    KIS_ASSERT_RECOVER(parentLayer) { return new KisPaintDevice(colorSpace()); }
 
    KisPaintDeviceSP device =
        new KisPaintDevice(parentLayer->original()->colorSpace());
    device->setDefaultBounds(parentLayer->original()->defaultBounds());
 
    QRect requestedRect = parentLayer->original()->exactBounds();
    parentLayer->buildProjectionUpToNode(device, this, requestedRect);
 
    return device;
}

References KisLayer::buildProjectionUpToNode(), KisPaintDevice::colorSpace(), KisMask::colorSpace(), KisPaintDevice::defaultBounds(), KisPaintDevice::exactBounds(), KIS_ASSERT_RECOVER, KisLayer::original(), KisNode::parent, and KisPaintDevice::setDefaultBounds().

◆ buildSourcePreviewDevice()

KisPaintDeviceSP KisTransformMask::buildSourcePreviewDevice ( )

Note: this function must be called from within the scheduler's context. We are accessing parent's updateProjection(), which is not entirely safe. The calling job must ensure it is the only job running.

Definition at line 339 of file kis_transform_mask.cpp.

{
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    KIS_ASSERT_RECOVER(parentLayer) { return new KisPaintDevice(colorSpace()); }
 
    KisPaintDeviceSP device =
        new KisPaintDevice(parentLayer->original()->colorSpace());
    device->setDefaultBounds(parentLayer->original()->defaultBounds());
 
    QRect requestedRect = parentLayer->original()->exactBounds();
 
    KisNodeSP prevSibling = this->prevSibling();
    if (prevSibling) {
        parentLayer->buildProjectionUpToNode(device, prevSibling, requestedRect);
    } else {
        requestedRect = parentLayer->outgoingChangeRect(requestedRect);
        parentLayer->copyOriginalToProjection(parentLayer->original(), device, requestedRect);
    }
 
    return device;
}

References KisLayer::buildProjectionUpToNode(), KisPaintDevice::colorSpace(), KisMask::colorSpace(), KisLayer::copyOriginalToProjection(), KisPaintDevice::defaultBounds(), KisPaintDevice::exactBounds(), KIS_ASSERT_RECOVER, KisLayer::original(), KisLayer::outgoingChangeRect(), KisNode::parent, KisNode::prevSibling(), and KisPaintDevice::setDefaultBounds().

◆ changeRect()

QRect KisTransformMask::changeRect	(	const QRect &	rect,
		PositionToFilthy	pos = N_FILTHY ) const

overridevirtual

Returns: internal changeRect() of the node. Do not mix with

See also: projectionPlane()

Some filters will cause a change of pixels those are outside a requested rect. E.g. we change a rect of 2x2, then we want to apply a convolution filter with kernel 4x4 (changeRect is (2+2*3)x(2+2*3)=8x8) to that area. The rect that should be updated on the layer will be exactly 8x8. More than that the needRect for that update will be 14x14. See needRect.

FIXME: This check of the emptiness should be done on the higher/lower level

Reimplemented from KisMask.

Definition at line 564 of file kis_transform_mask.cpp.

{
    Q_UNUSED(pos);
 
    if (rect.isEmpty()) return rect;
 
    KisTransformMaskParamsInterfaceSP params = m_d->paramsHolder->bakeIntoParams();
 
    QRect changeRect = rect;
 
    if (params->isAffine()) {
        QRect bounds;
        QRect interestRect;
        KisNodeSP parentNode = parent();
 
        if (parentNode) {
            bounds = parentNode->original()->defaultBounds()->bounds();
            interestRect = calculateInterestRect(parentNode);
        } else {
            bounds = QRect(0,0,777,777);
            interestRect = QRect(0,0,888,888);
            warnKrita << "WARNING: transform mask has no parent (change rect)."
                      << "Cannot run safe transformations."
                      << "Will limit bounds to" << ppVar(bounds);
        }
 
        const QRect limitingRect = KisAlgebra2D::blowRect(bounds, m_d->offBoundsReadArea);
 
        KisSafeTransform transform(params->finalAffineTransform(), limitingRect, interestRect);
        changeRect = transform.mapRectForward(rect);
    } else {
        changeRect = params->nonAffineChangeRect(rect);
    }
 
    return changeRect;
}

References KisAlgebra2D::blowRect(), KisDefaultBoundsBase::bounds(), bounds, changeRect(), KisPaintDevice::defaultBounds(), m_d, KisSafeTransform::mapRectForward(), KisBaseNode::original(), KisNode::parent, ppVar, and warnKrita.

◆ clone()

KisNodeSP KisTransformMask::clone ( ) const

inlineoverridevirtual

Implements KisNode.

Definition at line 36 of file kis_transform_mask.h.

                                     {
        return KisNodeSP(new KisTransformMask(*this));
    }

◆ decorateRect()

QRect KisTransformMask::decorateRect	(	KisPaintDeviceSP &	src,
		KisPaintDeviceSP &	dst,
		const QRect &	rc,
		PositionToFilthy	maskPos,
		KisRenderPassFlags	flags ) const

overridevirtual

We shouldn't reset or use the static image when rendering the animation frames.

TODO: implement proper high-quality rendering for animation frames

clone layers may fetch data outside image bounds, that should never cause async refresh, since it will cause an infinite loop

Reimplemented from KisMask.

Definition at line 433 of file kis_transform_mask.cpp.

{
    Q_ASSERT_X(src != dst, "KisTransformMask::decorateRect",
               "src must be != dst, because we can't create transactions "
               "during merge, as it breaks reentrancy");
 
    KisTransformMaskParamsInterfaceSP params = m_d->paramsHolder->bakeIntoParams();
 
    if (params->isHidden()) return rc;
    KIS_ASSERT_RECOVER_NOOP(maskPos == N_FILTHY ||
                            maskPos == N_ABOVE_FILTHY ||
                            maskPos == N_BELOW_FILTHY);
 
    if (m_d->paramsHolder->defaultBounds()->externalFrameActive()) {
 
        // no preview for non-affine transforms currently...
        if (params->isAffine()) {
            m_d->worker.setForceSubPixelTranslation(m_d->paramsHolder->isAnimated());
            m_d->worker.setForwardTransform(params->finalAffineTransform());
            m_d->worker.runPartialDst(src, dst, rc);
 
#ifdef DEBUG_RENDERING
            qDebug() << "Partial for external frame" << name() << ppVar(src->exactBounds()) << ppVar(src->extent()) << ppVar(dst->exactBounds()) << ppVar(dst->extent()) << ppVar(rc);
            KIS_DUMP_DEVICE_2(src, DUMP_RECT, "partial_ext_src", "dd");
            KIS_DUMP_DEVICE_2(dst, DUMP_RECT, "partial_ext_dst", "dd");
#endif /* DEBUG_RENDERING */
        }
 
        return rc;
    }
 
    if (!m_d->staticCache.isCacheOverridden() &&
        !m_d->recalculatingStaticImage &&
        (maskPos == N_FILTHY || maskPos == N_ABOVE_FILTHY ||
         !m_d->staticCache.isCacheValid(params)) &&
 
        !flags.testFlag(KisRenderPassFlag::NoTransformMaskUpdates)) {
 
        if (m_d->testingInterface) {
            m_d->testingInterface->notifyDecorateRectTriggeredStaticImageUpdate();
        }
 
        m_d->staticCache.invalidateDeviceCache();
        m_d->updateSignalCompressor.start();
    }
 
    if (m_d->recalculatingStaticImage) {
        KIS_SAFE_ASSERT_RECOVER_NOOP(!m_d->staticCache.isCacheValid(params));
 
        KisPaintDeviceSP staticCacheDevice = m_d->staticCache.device();
 
        staticCacheDevice->clear();
        params->transformDevice(const_cast<KisTransformMask*>(this), src,
                                staticCacheDevice, m_d->paramsHolder->isAnimated());
        QRect updatedRect = staticCacheDevice->extent();
        KisPainter::copyAreaOptimized(updatedRect.topLeft(), staticCacheDevice, dst, updatedRect);
 
        m_d->staticCache.setDeviceCacheValid(params);
 
#ifdef DEBUG_RENDERING
        qDebug() << "Recalculate" << name() << ppVar(src->exactBounds()) << ppVar(dst->exactBounds()) << ppVar(rc);
        KIS_DUMP_DEVICE_2(src, DUMP_RECT, "recalc_src", "dd");
        KIS_DUMP_DEVICE_2(dst, DUMP_RECT, "recalc_dst", "dd");
#endif /* DEBUG_RENDERING */
 
    // Note: overridden cache is **always** valid
    } else if (params->isAffine() && !m_d->staticCache.isCacheValid(params)) {
        m_d->worker.setForceSubPixelTranslation(m_d->paramsHolder->isAnimated());
        m_d->worker.setForwardTransform(params->finalAffineTransform());
        m_d->worker.runPartialDst(src, dst, rc);
 
#ifdef DEBUG_RENDERING
        qDebug() << "Partial" << name() << ppVar(src->exactBounds()) << ppVar(src->extent()) << ppVar(dst->exactBounds()) << ppVar(dst->extent()) << ppVar(rc);
        KIS_DUMP_DEVICE_2(src, DUMP_RECT, "partial_src", "dd");
        KIS_DUMP_DEVICE_2(dst, DUMP_RECT, "partial_dst", "dd");
#endif /* DEBUG_RENDERING */
 
    } else if (m_d->staticCache.isCacheValid(params)) {
        KisPainter::copyAreaOptimized(rc.topLeft(), m_d->staticCache.device(), dst, rc);
 
#ifdef DEBUG_RENDERING
        qDebug() << "Fetch" << name() << ppVar(src->exactBounds()) << ppVar(dst->exactBounds()) << ppVar(rc);
        KIS_DUMP_DEVICE_2(src, DUMP_RECT, "fetch_src", "dd");
        KIS_DUMP_DEVICE_2(dst, DUMP_RECT, "fetch_dst", "dd");
#endif /* DEBUG_RENDERING */
 
    }
 
    KIS_ASSERT_RECOVER_NOOP(this->busyProgressIndicator());
    this->busyProgressIndicator()->update();
 
    return rc;
}

References KisNode::busyProgressIndicator, KisPaintDevice::clear(), KisPainter::copyAreaOptimized(), KisPaintDevice::exactBounds(), KisPaintDevice::extent(), KIS_ASSERT_RECOVER_NOOP, KIS_DUMP_DEVICE_2, KIS_SAFE_ASSERT_RECOVER_NOOP, m_d, KisNode::N_ABOVE_FILTHY, KisNode::N_BELOW_FILTHY, KisNode::N_FILTHY, KisBaseNode::name(), NoTransformMaskUpdates, ppVar, and KisBusyProgressIndicator::update().

◆ exactBounds()

QRect KisTransformMask::exactBounds ( ) const

overridevirtual

Returns the exact bounds of where the actual data resides in this node.

Reimplemented from KisMask.

Definition at line 669 of file kis_transform_mask.cpp.

{
    QRect existentProjection;
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    if (parentLayer) {
        existentProjection = parentLayer->projection()->exactBounds();
 
        /* Take into account multiple keyframes... */
        if (parentLayer->original() && parentLayer->original()->defaultBounds() && parentLayer->original()->keyframeChannel()) {
            Q_FOREACH( const int& time, parentLayer->original()->keyframeChannel()->allKeyframeTimes() ) {
                KisRasterKeyframeSP keyframe = parentLayer->original()->keyframeChannel()->keyframeAt<KisRasterKeyframe>(time);
                existentProjection |= keyframe->contentBounds();
            }
        }
    }
 
    if (isAnimated()) {
        existentProjection |= changeRect(image()->bounds());
    }
 
    return changeRect(sourceDataBounds()) | existentProjection;
}

References KisKeyframeChannel::allKeyframeTimes(), bounds, changeRect(), KisPaintDevice::defaultBounds(), KisPaintDevice::exactBounds(), KisBaseNode::image, KisBaseNode::isAnimated(), KisKeyframeChannel::keyframeAt(), KisPaintDevice::keyframeChannel(), KisLayer::original(), KisNode::parent, KisLayer::projection(), and sourceDataBounds().

◆ extent()

QRect KisTransformMask::extent ( ) const

overridevirtual

The extent and bounds of the mask are those of the selection inside

Reimplemented from KisMask.

Definition at line 654 of file kis_transform_mask.cpp.

{
    QRect rc = KisMask::extent();
 
    QRect partialChangeRect;
    QRect existentProjection;
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    if (parentLayer) {
        partialChangeRect = parentLayer->partialChangeRect(const_cast<KisTransformMask*>(this), rc);
        existentProjection = parentLayer->projection()->extent();
    }
 
    return changeRect(partialChangeRect) | existentProjection;
}

References changeRect(), KisPaintDevice::extent(), KisMask::extent(), KisNode::parent, KisLayer::partialChangeRect(), and KisLayer::projection().

◆ forceStartAsyncRegenerationJob()

void KisTransformMask::forceStartAsyncRegenerationJob ( )

private

Definition at line 279 of file kis_transform_mask.cpp.

{
    m_d->staticCache.invalidateDeviceCache();
    m_d->updateSignalCompressor.stop();
    startAsyncRegenerationJob();
}

References m_d, and startAsyncRegenerationJob().

◆ forceUpdateTimedNode()

void KisTransformMask::forceUpdateTimedNode ( )

overridevirtual

forceUpdateTimedNode forces the node to regenerate its project. The update might be asynchronous, so you should call image->waitForDone() after that.

When flattening the layer with animated transform mask we should actually rerender the static image

Implements KisDelayedUpdateNodeInterface.

Definition at line 745 of file kis_transform_mask.cpp.

{
    if (m_d->testingInterface) {
        m_d->testingInterface->notifyForceUpdateTimedNode();
    }
 
    if (hasPendingTimedUpdates() ||
        !m_d->staticCache.isCacheValid(m_d->paramsHolder->bakeIntoParams())) {
 
        forceStartAsyncRegenerationJob();
    }
}

References forceStartAsyncRegenerationJob(), hasPendingTimedUpdates(), and m_d.

◆ getLodCapableDevices()

KisPaintDeviceList KisTransformMask::getLodCapableDevices ( ) const

overridevirtual

Reimplemented from KisNode.

Definition at line 795 of file kis_transform_mask.cpp.

{
    KisPaintDeviceList devices;
    devices += KisEffectMask::getLodCapableDevices();
    if (m_d->staticCache.device()) {
        devices << m_d->staticCache.device();
    }
    return devices;
}

References KisNode::getLodCapableDevices(), and m_d.

◆ hasPendingTimedUpdates()

bool KisTransformMask::hasPendingTimedUpdates ( ) const

overridevirtual

Returns: true if forceUpdateTimedNode() is going to produce any real updates, that is the node has any updates still pending

Implements KisDelayedUpdateNodeInterface.

Definition at line 762 of file kis_transform_mask.cpp.

{
    return m_d->updateSignalCompressor.isActive();
}

References m_d.

◆ icon()

QIcon KisTransformMask::icon ( ) const

overridevirtual

Returns: the icon used to represent the node type, for instance in the layerbox and in the menu.

Reimplemented from KisEffectMask.

Definition at line 243 of file kis_transform_mask.cpp.

{
    return KisIconUtils::loadIcon("transformMask");
}

References KisIconUtils::loadIcon().

◆ needRect()

QRect KisTransformMask::needRect	(	const QRect &	rect,
		PositionToFilthy	pos = N_FILTHY ) const

overridevirtual

Returns: internal needRect() of the node. Do not mix with

See also: projectionPlane()

Some filters need pixels outside the current processing rect to compute the new value (for instance, convolution filters) See changeRect See accessRect

FIXME: This check of the emptiness should be done on the higher/lower level

When sampling affine transformations we use KisRandomSubAccessor, which uses bilinear interpolation for calculating pixels. Therefore, we need to extend the sides of the need rect by one pixel.

Reimplemented from KisMask.

Definition at line 605 of file kis_transform_mask.cpp.

{
    Q_UNUSED(pos);
 
    if (rect.isEmpty()) return rect;
 
    KisTransformMaskParamsInterfaceSP params = m_d->paramsHolder->bakeIntoParams();
 
    QRect bounds;
    QRect interestRect;
    KisNodeSP parentNode = parent();
 
    if (parentNode) {
        bounds = parentNode->original()->defaultBounds()->bounds();
        interestRect = calculateInterestRect(parentNode);
    } else {
        bounds = QRect(0,0,777,777);
        interestRect = QRect(0,0,888,888);
        warnKrita << "WARNING: transform mask has no parent (need rect)."
                   << "Cannot run safe transformations."
                   << "Will limit bounds to" << ppVar(bounds);
    }
 
    QRect needRect = rect;
 
    if (params->isAffine()) {
        const QRect limitingRect = KisAlgebra2D::blowRect(bounds, m_d->offBoundsReadArea);
 
        KisSafeTransform transform(params->finalAffineTransform(), limitingRect, interestRect);
        needRect = transform.mapRectBackward(rect);
 
        needRect = kisGrowRect(needRect, 1);
 
    } else {
        needRect = params->nonAffineNeedRect(rect, interestRect);
    }
 
    return needRect;
}

References KisAlgebra2D::blowRect(), KisDefaultBoundsBase::bounds(), bounds, KisPaintDevice::defaultBounds(), kisGrowRect(), m_d, KisSafeTransform::mapRectBackward(), needRect(), KisBaseNode::original(), KisNode::parent, ppVar, and warnKrita.

◆ overrideStaticCacheDevice()

void KisTransformMask::overrideStaticCacheDevice ( KisPaintDeviceSP device )

Transform Tool may override mask's device for the sake of in-stack preview

Definition at line 368 of file kis_transform_mask.cpp.

{
    // TODO: make sure the device is allocated
    m_d->staticCache.overrideStaticCacheDevice(device);
}

References m_d.

◆ paintDevice()

KisPaintDeviceSP KisTransformMask::paintDevice ( ) const

overridevirtual

Returns: the selection: if you paint on mask, you paint on the selections

Reimplemented from KisMask.

Definition at line 238 of file kis_transform_mask.cpp.

{
    return 0;
}

◆ Private() [1/2]

KisTransformMask::Private ( const Private & rhs )

inline

Definition at line 168 of file kis_transform_mask.cpp.

        : worker(rhs.worker),
          paramsHolder(rhs.paramsHolder->clone()),
          recalculatingStaticImage(rhs.recalculatingStaticImage),
          offset(rhs.offset),
          updateSignalCompressor(UPDATE_DELAY, KisSignalCompressor::POSTPONE),
          offBoundsReadArea(rhs.offBoundsReadArea)
    {
    }

◆ Private() [2/2]

KisTransformMask::Private ( KisImageSP image )

inline

Definition at line 158 of file kis_transform_mask.cpp.

        : worker(0, QTransform(), true, 0),
          paramsHolder(KisTransformMaskParamsFactoryRegistry::instance()->createAnimatedParamsHolder(new KisDefaultBounds(image))),
          recalculatingStaticImage(false),
          offset(new KisDefaultBounds(image)),
          updateSignalCompressor(UPDATE_DELAY, KisSignalCompressor::POSTPONE),
          offBoundsReadArea(0.5)
    {
    }

◆ recalculateStaticImage()

void KisTransformMask::recalculateStaticImage ( )

Note: this function must be called from within the scheduler's context. We are accessing parent's updateProjection(), which is not entirely safe.

updateProjection() is assuming that the requestedRect takes into account all the change rects of all the masks. Usually, this work is done by the walkers.

NOTE: we should use layer's exact bounds, not its original paint device's exact bounds; it is necessary because the layer may have onion skins, which are a part of layer's bounds.

Here we use updateProjection() to regenerate the projection of the layer and after that a special update call (no-filthy) will be issued to pass the changed further through the stack.

Definition at line 379 of file kis_transform_mask.cpp.

{
    if (m_d->testingInterface) {
        m_d->testingInterface->notifyRecalculateStaticImage();
    }
 
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    KIS_SAFE_ASSERT_RECOVER_RETURN(parentLayer);
 
    // It might happen that the mask became invisible in the meantime
    // and the projection has become disabled. That mush be "impossible"
    // situation, hence assert.
    KIS_SAFE_ASSERT_RECOVER_RETURN(parentLayer->projection() != parentLayer->paintDevice());
 
    m_d->staticCache.lazyAllocateStaticCache(parentLayer->original()->colorSpace(),
                                             parentLayer->original()->defaultBounds());
 
    m_d->recalculatingStaticImage = true;
    QRect requestedRect =
        parentLayer->changeRect(parentLayer->exactBounds());
 
    const QRect bounds = parentLayer->original()->defaultBounds()->bounds();
    const QRect limitingRect = KisAlgebra2D::blowRect(bounds, m_d->offBoundsReadArea);
 
    requestedRect &= limitingRect;
 
    // force reset parent layer's projection, because we might have changed
    // our mask parameters and going to write to some other area
    parentLayer->projection()->clear();
 
    parentLayer->updateProjection(requestedRect, this, KisRenderPassFlag::NoTransformMaskUpdates);
    m_d->recalculatingStaticImage = false;
}

References KisAlgebra2D::blowRect(), KisDefaultBoundsBase::bounds(), bounds, KisLayer::changeRect(), KisPaintDevice::clear(), KisPaintDevice::colorSpace(), KisPaintDevice::defaultBounds(), KisLayer::exactBounds(), KIS_SAFE_ASSERT_RECOVER_RETURN, m_d, NoTransformMaskUpdates, KisLayer::original(), KisBaseNode::paintDevice(), KisNode::parent, KisLayer::projection(), and KisLayer::updateProjection().

◆ requestKeyframeChannel()

KisKeyframeChannel * KisTransformMask::requestKeyframeChannel ( const QString & id )

overrideprotectedvirtual

Attempt to create the requested channel. Used internally by getKeyframeChannel. Subclasses should implement this method to catch any new channel types they support.

Parameters

id	channel to create

Returns: newly created channel or null

Reimplemented from KisMask.

Definition at line 815 of file kis_transform_mask.cpp.

{
    if (id == KisKeyframeChannel::PositionX.id() ||
        id == KisKeyframeChannel::PositionY.id() ||
        id == KisKeyframeChannel::ScaleX.id() ||
        id == KisKeyframeChannel::ScaleY.id() ||
        id == KisKeyframeChannel::ShearX.id() ||
        id == KisKeyframeChannel::ShearY.id() ||
        id == KisKeyframeChannel::RotationX.id() ||
        id == KisKeyframeChannel::RotationY.id() ||
        id == KisKeyframeChannel::RotationZ.id()) {
 
        KisKeyframeChannel *channel = m_d->paramsHolder->requestKeyframeChannel(id);
        KIS_SAFE_ASSERT_RECOVER_NOOP(channel);
        return channel;
    }
 
    return KisEffectMask::requestKeyframeChannel(id);
}

References KIS_SAFE_ASSERT_RECOVER_NOOP, m_d, KisKeyframeChannel::PositionX, KisKeyframeChannel::PositionY, KisBaseNode::requestKeyframeChannel(), KisKeyframeChannel::RotationX, KisKeyframeChannel::RotationY, KisKeyframeChannel::RotationZ, KisKeyframeChannel::ScaleX, KisKeyframeChannel::ScaleY, KisKeyframeChannel::ShearX, and KisKeyframeChannel::ShearY.

◆ setImage()

void KisTransformMask::setImage ( KisImageWSP image )

overridevirtual

Reimplemented from KisMask.

Definition at line 708 of file kis_transform_mask.cpp.

{
    m_d->paramsHolder->setDefaultBounds(new KisDefaultBounds(image));
    m_d->offset.setDefaultBounds(new KisDefaultBounds(image));
    KisEffectMask::setImage(image);
}

References KisBaseNode::image, m_d, and KisBaseNode::setImage().

◆ setTestingInterface()

void KisTransformMask::setTestingInterface ( KisTransformMaskTestingInterface * interface )

Definition at line 805 of file kis_transform_mask.cpp.

{
    m_d->testingInterface.reset(interface);
}

References m_d.

◆ setTransformParams()

void KisTransformMask::setTransformParams ( KisTransformMaskParamsInterfaceSP params )

Definition at line 255 of file kis_transform_mask.cpp.

{
    KUndo2Command todo_REMOVE;
    setTransformParamsWithUndo(params, &todo_REMOVE);
    todo_REMOVE.redo();
 
    m_d->staticCache.invalidateDeviceCache();
    m_d->updateSignalCompressor.start();
}

References m_d, KUndo2Command::redo(), and setTransformParamsWithUndo().

◆ setTransformParamsWithUndo()

void KisTransformMask::setTransformParamsWithUndo	(	KisTransformMaskParamsInterfaceSP	params,
		KUndo2Command *	parentCommand )

Definition at line 248 of file kis_transform_mask.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(params);
 
    m_d->paramsHolder->setParamsAtCurrentPosition(params.data(), parentCommand);
}

References KIS_SAFE_ASSERT_RECOVER_RETURN, and m_d.

◆ setX()

void KisTransformMask::setX ( qint32 x )

overridevirtual

overridden from KisBaseNode

Reimplemented from KisMask.

Definition at line 725 of file kis_transform_mask.cpp.

{
    KisTransformMaskParamsInterfaceSP params(m_d->paramsHolder->bakeIntoParams());
 
    params->translateSrcAndDst(QPointF(x - this->x(), 0));
 
    setTransformParams(params);
    m_d->offset->setX(x);
}

References m_d, setTransformParams(), and x().

◆ setY()

void KisTransformMask::setY ( qint32 y )

overridevirtual

overridden from KisBaseNode

Reimplemented from KisMask.

Definition at line 735 of file kis_transform_mask.cpp.

{
    KisTransformMaskParamsInterfaceSP params(m_d->paramsHolder->bakeIntoParams());
 
    params->translateSrcAndDst(QPointF(0, y - this->y()));
 
    setTransformParams(params);
    m_d->offset->setY(y);
}

References m_d, setTransformParams(), and y().

◆ sigInternalForceStaticImageUpdate

void KisTransformMask::sigInternalForceStaticImageUpdate ( )

signal

◆ slotDelayedStaticUpdate

void KisTransformMask::slotDelayedStaticUpdate ( )

privateslot

Definition at line 270 of file kis_transform_mask.cpp.

{
    if (m_d->testingInterface) {
        m_d->testingInterface->notifySlotDelayedStaticUpdate();
    }
 
    startAsyncRegenerationJob();
}

References m_d, and startAsyncRegenerationJob().

◆ slotInternalForceStaticImageUpdate

void KisTransformMask::slotInternalForceStaticImageUpdate ( )

privateslot

Definition at line 783 of file kis_transform_mask.cpp.

{
    forceStartAsyncRegenerationJob();
}

References forceStartAsyncRegenerationJob().

◆ sourceDataBounds()

QRect KisTransformMask::sourceDataBounds ( ) const

NOTE: we should avoid including parent layer's projection's extent into the source of changeRect calculation, because that is exactly what partialChangeRect() calculates.

Definition at line 692 of file kis_transform_mask.cpp.

{
 
    QRect partialChangeRect;
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    if (parentLayer) {
        const QRect rc = parentLayer->original()->exactBounds();
        partialChangeRect = parentLayer->partialChangeRect(const_cast<KisTransformMask*>(this), rc);
    }
 
    return partialChangeRect;
}

References KisPaintDevice::exactBounds(), KisLayer::original(), KisNode::parent, and KisLayer::partialChangeRect().

◆ startAsyncRegenerationJob()

void KisTransformMask::startAsyncRegenerationJob ( )

private

The mask might have been deleted from the layers stack in the meanwhile. Just ignore the updates in the case.

Don't try to start a regeneration stroke while image is locked. It may happen on loading, when all necessary conversions are not yet finished.

Definition at line 286 of file kis_transform_mask.cpp.

{
    KisLayerSP parentLayer = qobject_cast<KisLayer*>(parent().data());
    if (!parentLayer) return;
 
    KisImageSP image = parentLayer->image();
 
    if (!image) {
        return;
    }
 
    if (image->locked()) {
        m_d->updateSignalCompressor.start();
        return;
    }
 
 
    const QRect extraUpdateRect = m_d->forcedStaticUpdateExtraUpdateRect.takeRect();
    image->addSpontaneousJob(new KisRecalculateTransformMaskJob(this, extraUpdateRect));
}

References KisImage::addSpontaneousJob(), KisBaseNode::image, KisImage::locked(), m_d, and KisNode::parent.

◆ staticImageCacheIsValid()

bool KisTransformMask::staticImageCacheIsValid ( ) const

Definition at line 374 of file kis_transform_mask.cpp.

{
    return m_d->staticCache.isCacheValid(m_d->paramsHolder->bakeIntoParams());
}

References m_d.

◆ supportsKeyframeChannel()

bool KisTransformMask::supportsKeyframeChannel ( const QString & id )

overrideprotectedvirtual

Ideally, this function would be used to query for keyframe support before trying to create channels. The ability to query would help in cases such as animation curves where you might want to ask which channels it supports before allowing the user to add.

Parameters

id	queried channel

Returns: bool whether it supports said channel or not.

Reimplemented from KisMask.

Definition at line 835 of file kis_transform_mask.cpp.

{
    if (id == KisKeyframeChannel::PositionX.id() ||
        id == KisKeyframeChannel::PositionY.id() ||
        id == KisKeyframeChannel::ScaleX.id() ||
        id == KisKeyframeChannel::ScaleY.id() ||
        id == KisKeyframeChannel::ShearX.id() ||
        id == KisKeyframeChannel::ShearY.id() ||
        id == KisKeyframeChannel::RotationX.id() ||
        id == KisKeyframeChannel::RotationY.id() ||
            id == KisKeyframeChannel::RotationZ.id()) {
        return true;
    }
    else if (id == KisKeyframeChannel::Opacity.id()) {
        return false;
    }
 
    return KisEffectMask::supportsKeyframeChannel(id);
}

References KisKeyframeChannel::Opacity, KisKeyframeChannel::PositionX, KisKeyframeChannel::PositionY, KisKeyframeChannel::RotationX, KisKeyframeChannel::RotationY, KisKeyframeChannel::RotationZ, KisKeyframeChannel::ScaleX, KisKeyframeChannel::ScaleY, KisKeyframeChannel::ShearX, KisKeyframeChannel::ShearY, and KisBaseNode::supportsKeyframeChannel().

◆ syncLodCache()

void KisTransformMask::syncLodCache ( )

overridevirtual

Synchronizes LoD caches of the node with the current state of it. The current level of detail is fetched from the image pointed by default bounds object

Reimplemented from KisNode.

Definition at line 788 of file kis_transform_mask.cpp.

{
    m_d->offset.syncLodCache();
    m_d->paramsHolder->syncLodCache();
    KisEffectMask::syncLodCache();
}

References m_d, and KisNode::syncLodCache().

◆ testingInterface()

KisTransformMaskTestingInterface * KisTransformMask::testingInterface ( ) const

◆ threadSafeForceStaticImageUpdate() [1/2]

void KisTransformMask::threadSafeForceStaticImageUpdate ( )

Definition at line 767 of file kis_transform_mask.cpp.

{
    threadSafeForceStaticImageUpdate(QRect());
}

References threadSafeForceStaticImageUpdate().

◆ threadSafeForceStaticImageUpdate() [2/2]

void KisTransformMask::threadSafeForceStaticImageUpdate ( const QRect & extraUpdateRect )

Definition at line 772 of file kis_transform_mask.cpp.

{
    if (m_d->testingInterface) {
        m_d->testingInterface->notifyThreadSafeForceStaticImageUpdate();
    }
    if (!extraUpdateRect.isEmpty()) {
        m_d->forcedStaticUpdateExtraUpdateRect.addRect(extraUpdateRect);
    }
    Q_EMIT sigInternalForceStaticImageUpdate();
}

References m_d, and sigInternalForceStaticImageUpdate().

◆ transformParams()

KisTransformMaskParamsInterfaceSP KisTransformMask::transformParams ( ) const

Definition at line 265 of file kis_transform_mask.cpp.

{
    return m_d->paramsHolder->bakeIntoParams();
}

References m_d.

◆ x()

qint32 KisTransformMask::x ( ) const

overridevirtual

overridden from KisBaseNode

Reimplemented from KisMask.

Definition at line 715 of file kis_transform_mask.cpp.

{
    return m_d->offset->x();
}

References m_d.

◆ y()

qint32 KisTransformMask::y ( ) const

overridevirtual

overridden from KisBaseNode

Reimplemented from KisMask.

Definition at line 720 of file kis_transform_mask.cpp.

{
    return m_d->offset->y();
}

References m_d.

Member Data Documentation

◆ forcedStaticUpdateExtraUpdateRect

AccumulatedRectStorage KisTransformMask::forcedStaticUpdateExtraUpdateRect

Definition at line 184 of file kis_transform_mask.cpp.

◆ m_d

const QScopedPointer<Private> KisTransformMask::m_d

private

Definition at line 113 of file kis_transform_mask.h.

◆ offBoundsReadArea

qreal KisTransformMask::offBoundsReadArea

Definition at line 189 of file kis_transform_mask.cpp.

◆ offset

KisLodCapableLayerOffset KisTransformMask::offset

Definition at line 186 of file kis_transform_mask.cpp.

◆ paramsHolder

KisAnimatedTransformParamsHolderInterfaceSP KisTransformMask::paramsHolder

Definition at line 179 of file kis_transform_mask.cpp.

◆ recalculatingStaticImage

bool KisTransformMask::recalculatingStaticImage

Definition at line 182 of file kis_transform_mask.cpp.

◆ staticCache

StaticCacheStorage KisTransformMask::staticCache

Definition at line 181 of file kis_transform_mask.cpp.

◆ testingInterface

KisTransformMaskTestingInterface * KisTransformMask::testingInterface

Definition at line 191 of file kis_transform_mask.cpp.

◆ updateSignalCompressor

KisThreadSafeSignalCompressor KisTransformMask::updateSignalCompressor

Definition at line 188 of file kis_transform_mask.cpp.

◆ worker

KisPerspectiveTransformWorker KisTransformMask::worker

Definition at line 178 of file kis_transform_mask.cpp.

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

libs/image/kis_transform_mask.cpp
libs/image/kis_transform_mask.h

Signals

Public Member Functions

Public Attributes

Protected Member Functions

Private Slots

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ KisTransformMask() [1/2]

◆ ~KisTransformMask()

◆ KisTransformMask() [2/2]

Member Function Documentation

◆ accept() [1/2]

◆ accept() [2/2]

◆ buildPreviewDevice()

◆ buildSourcePreviewDevice()

◆ changeRect()

◆ clone()

◆ decorateRect()

◆ exactBounds()

◆ extent()

◆ forceStartAsyncRegenerationJob()

◆ forceUpdateTimedNode()

◆ getLodCapableDevices()

◆ hasPendingTimedUpdates()

◆ icon()

◆ needRect()

◆ overrideStaticCacheDevice()

◆ paintDevice()

◆ Private() [1/2]

◆ Private() [2/2]

◆ recalculateStaticImage()

◆ requestKeyframeChannel()

◆ setImage()

◆ setTestingInterface()

◆ setTransformParams()

◆ setTransformParamsWithUndo()

◆ setX()

◆ setY()

◆ sigInternalForceStaticImageUpdate

◆ slotDelayedStaticUpdate

◆ slotInternalForceStaticImageUpdate

◆ sourceDataBounds()

◆ startAsyncRegenerationJob()

◆ staticImageCacheIsValid()

◆ supportsKeyframeChannel()

◆ syncLodCache()

◆ testingInterface()

◆ threadSafeForceStaticImageUpdate() [1/2]

◆ threadSafeForceStaticImageUpdate() [2/2]

◆ transformParams()

◆ x()

◆ y()

Member Data Documentation

◆ forcedStaticUpdateExtraUpdateRect

◆ m_d

◆ offBoundsReadArea

◆ offset

◆ paramsHolder

◆ recalculatingStaticImage

◆ staticCache

◆ testingInterface

◆ updateSignalCompressor

◆ worker