KisLiquifyTransformWorker Class Reference

#include <kis_liquify_transform_worker.h>

Inheritance diagram for KisLiquifyTransformWorker:

Public Member Functions
QRectF	accumulatedStrokesBounds () const
QRect	approxChangeRect (const QRect &rc)
QRect	approxNeedRect (const QRect &rc, const QRect &fullBounds)
QSize	gridSize () const
bool	isIdentity () const
	KisLiquifyTransformWorker (const KisLiquifyTransformWorker &rhs)
	KisLiquifyTransformWorker (const QRect &srcBounds, KoUpdater *progress, int pixelPrecision=8)
bool	operator== (const KisLiquifyTransformWorker &other) const
const QVector< QPointF > &	originalPoints () const
int	pointToIndex (const QPoint &cellPt)
void	preparePoints ()
	Private (const QRect &_srcBounds, KoUpdater *_progress, int _pixelPrecision)
template<class ProcessOp >
void	processTransformedPixels (ProcessOp op, const QPointF &base, qreal sigma, bool useWashMode, qreal flow)
template<class ProcessOp >
void	processTransformedPixelsBuildUp (ProcessOp op, const QPointF &base, qreal sigma)
template<class ProcessOp >
void	processTransformedPixelsWash (ProcessOp op, const QPointF &base, qreal sigma, qreal flow)
void	rotatePoints (const QPointF &base, qreal angle, qreal sigma, bool useWashMode, qreal flow)
void	run (KisPaintDeviceSP srcDevice, KisPaintDeviceSP dstDevice)
QImage	runOnQImage (const QImage &srcImage, const QPointF &srcImageOffset, const QTransform &imageToThumbTransform, QPointF *newOffset)
void	scalePoints (const QPointF &base, qreal scale, qreal sigma, bool useWashMode, qreal flow)
void	toXML (QDomElement *e) const
QVector< QPointF > &	transformedPoints ()
void	transformSrcAndDst (const QTransform &t)
void	translate (const QPointF &offset)
void	translateDstSpace (const QPointF &offset)
void	translatePoints (const QPointF &base, const QPointF &offset, qreal sigma, bool useWashMode, qreal flow)
void	undoPoints (const QPointF &base, qreal amount, qreal sigma)
	~KisLiquifyTransformWorker ()
Public Member Functions inherited from Private
	Private (KisCanvas2 *c)

Static Public Member Functions
static KisLiquifyTransformWorker *	fromXML (const QDomElement &e)

Public Attributes
QRectF	accumulatedBrushStrokes
QSize	gridSize
QVector< QPointF >	originalPoints
KisSpatialContainer	originalPointsContainer
int	pixelPrecision
KoUpdater *	progress
QRect	srcBounds
QVector< QPointF >	transformedPoints
KisSpatialContainer	transformedPointsContainer
Public Attributes inherited from Private
KisCanvas2 *	canvas
int	displayedFrame
int	intendedFrame

Private Attributes
const QScopedPointer< Private >	m_d

Detailed Description

Definition at line 16 of file kis_liquify_transform_worker.cpp.

Constructor & Destructor Documentation

KisLiquifyTransformWorker() [1/2]

KisLiquifyTransformWorker::KisLiquifyTransformWorker	(	const QRect &	srcBounds,
		KoUpdater *	progress,
		int	pixelPrecision = 8 )

Definition at line 66 of file kis_liquify_transform_worker.cpp.

    : m_d(new Private(srcBounds, progress, pixelPrecision))
{
    KIS_ASSERT_RECOVER_RETURN(!srcBounds.isEmpty());
 
    // TODO: implement 'progress' stuff
    m_d->preparePoints();
}

References KIS_ASSERT_RECOVER_RETURN, m_d, and srcBounds.

KisLiquifyTransformWorker() [2/2]

KisLiquifyTransformWorker::KisLiquifyTransformWorker

(

const KisLiquifyTransformWorker &

rhs

)

Definition at line 77 of file kis_liquify_transform_worker.cpp.

    : m_d(new Private(*rhs.m_d.data()))
{
}

~KisLiquifyTransformWorker()

KisLiquifyTransformWorker::~KisLiquifyTransformWorker

(

)

Definition at line 82 of file kis_liquify_transform_worker.cpp.

{
}

Member Function Documentation

accumulatedStrokesBounds()

QRectF KisLiquifyTransformWorker::accumulatedStrokesBounds

(

)

const

Definition at line 451 of file kis_liquify_transform_worker.cpp.

{
    return m_d->accumulatedBrushStrokes;
}

References m_d.

approxChangeRect()

QRect KisLiquifyTransformWorker::approxChangeRect

(

const QRect &

rc

)

Definition at line 438 of file kis_liquify_transform_worker.cpp.

{
    const qreal margin = 0.05;
    QRect resultRect = m_d->transformedPointsContainer.exactBounds().toRect();
    return KisAlgebra2D::blowRect(resultRect | rc, margin);
}

References KisAlgebra2D::blowRect(), and m_d.

approxNeedRect()

QRect KisLiquifyTransformWorker::approxNeedRect	(	const QRect &	rc,
		const QRect &	fullBounds )

Definition at line 445 of file kis_liquify_transform_worker.cpp.

{
    Q_UNUSED(rc);
    return fullBounds;
}

fromXML()

KisLiquifyTransformWorker * KisLiquifyTransformWorker::fromXML ( const QDomElement & e )

static

Definition at line 566 of file kis_liquify_transform_worker.cpp.

{
    QDomElement liquifyEl;
 
    QRect srcBounds;
    QVector<QPointF> originalPoints;
    QVector<QPointF> transformedPoints;
    int pixelPrecision;
    QSize gridSize;
 
    bool result = false;
 
 
    result =
        KisDomUtils::findOnlyElement(e, "liquify_points", &liquifyEl) &&
 
        KisDomUtils::loadValue(liquifyEl, "srcBounds", &srcBounds) &&
        KisDomUtils::loadValue(liquifyEl, "originalPoints", &originalPoints) &&
        KisDomUtils::loadValue(liquifyEl, "transformedPoints", &transformedPoints) &&
        KisDomUtils::loadValue(liquifyEl, "pixelPrecision", &pixelPrecision) &&
        KisDomUtils::loadValue(liquifyEl, "gridSize", &gridSize);
 
    if (!result) {
        warnKrita << "WARNING: Failed to load liquify worker from XML";
        return new KisLiquifyTransformWorker(QRect(0,0,1024, 1024), 0, 8);
    }
 
    KisLiquifyTransformWorker *worker =
        new KisLiquifyTransformWorker(srcBounds, 0, pixelPrecision);
 
    const int numPoints = originalPoints.size();
 
    if (numPoints != transformedPoints.size() ||
        numPoints != worker->m_d->originalPoints.size() ||
        gridSize != worker->m_d->gridSize) {
        warnKrita << "WARNING: Inconsistent number of points!";
        warnKrita << ppVar(originalPoints.size());
        warnKrita << ppVar(transformedPoints.size());
        warnKrita << ppVar(gridSize);
        warnKrita << ppVar(worker->m_d->originalPoints.size());
        warnKrita << ppVar(worker->m_d->transformedPoints.size());
        warnKrita << ppVar(worker->m_d->gridSize);
 
        return worker;
    }
 
    QRectF changedRect = QRectF();
 
    for (int i = 0; i < numPoints; i++) {
        worker->m_d->originalPoints[i] = originalPoints[i];
        worker->m_d->transformedPoints[i] = transformedPoints[i];
        if (!KisAlgebra2D::fuzzyPointCompare(transformedPoints[i], originalPoints[i])) {
            KisAlgebra2D::accumulateBounds(transformedPoints[i], &changedRect);
        }
    }
 
    worker->m_d->transformedPointsContainer.initializeWith(worker->m_d->transformedPoints);
    worker->m_d->originalPointsContainer.initializeWith(worker->m_d->originalPoints);
 
    worker->m_d->accumulatedBrushStrokes = changedRect;
 
 
    return worker;
}

References KisAlgebra2D::accumulateBounds(), KisDomUtils::findOnlyElement(), KisAlgebra2D::fuzzyPointCompare(), gridSize, KisLiquifyTransformWorker(), KisDomUtils::loadValue(), m_d, originalPoints, pixelPrecision, ppVar, srcBounds, transformedPoints, and warnKrita.

gridSize()

QSize KisLiquifyTransformWorker::gridSize

(

)

const

isIdentity()

bool KisLiquifyTransformWorker::isIdentity

(

)

const

Definition at line 106 of file kis_liquify_transform_worker.cpp.

{
    const qreal eps = 1e-6;
    return KisAlgebra2D::fuzzyPointCompare(m_d->originalPoints, m_d->transformedPoints, eps);
}

References eps, KisAlgebra2D::fuzzyPointCompare(), and m_d.

operator==()

bool KisLiquifyTransformWorker::operator==

(

const KisLiquifyTransformWorker &

other

)

const

Definition at line 86 of file kis_liquify_transform_worker.cpp.

{
    bool result =
            m_d->srcBounds == other.m_d->srcBounds &&
            m_d->pixelPrecision == other.m_d->pixelPrecision &&
            m_d->gridSize == other.m_d->gridSize &&
            m_d->originalPoints.size() == other.m_d->originalPoints.size() &&
            m_d->transformedPoints.size() == other.m_d->transformedPoints.size();
 
    if (!result) return false;
 
    const qreal eps = 1e-6;
 
    result =
        KisAlgebra2D::fuzzyPointCompare(m_d->originalPoints, other.m_d->originalPoints, eps) &&
        KisAlgebra2D::fuzzyPointCompare(m_d->transformedPoints, other.m_d->transformedPoints, eps);
 
    return result;
}

References eps, KisAlgebra2D::fuzzyPointCompare(), and m_d.

originalPoints()

const QVector< QPointF > & KisLiquifyTransformWorker::originalPoints

(

)

const

pointToIndex()

int KisLiquifyTransformWorker::pointToIndex

(

const QPoint &

cellPt

)

Definition at line 112 of file kis_liquify_transform_worker.cpp.

{
    return GridIterationTools::pointToIndex(cellPt, m_d->gridSize);
}

References m_d, and GridIterationTools::pointToIndex().

preparePoints()

void KisLiquifyTransformWorker::preparePoints

(

)

Private()

KisLiquifyTransformWorker::Private ( const QRect & _srcBounds, KoUpdater * _progress, int _pixelPrecision )

inline

Definition at line 18 of file kis_liquify_transform_worker.cpp.

        : srcBounds(_srcBounds),
          progress(_progress),
          pixelPrecision(_pixelPrecision)
        , originalPointsContainer(_srcBounds)
        , transformedPointsContainer(_srcBounds)
    {
    }

processTransformedPixels()

template<class ProcessOp >

void KisLiquifyTransformWorker::processTransformedPixels	(	ProcessOp	op,
		const QPointF &	base,
		qreal	sigma,
		bool	useWashMode,
		qreal	flow )

processTransformedPixelsBuildUp()

template<class ProcessOp >

void KisLiquifyTransformWorker::processTransformedPixelsBuildUp	(	ProcessOp	op,
		const QPointF &	base,
		qreal	sigma )

processTransformedPixelsWash()

template<class ProcessOp >

void KisLiquifyTransformWorker::processTransformedPixelsWash	(	ProcessOp	op,
		const QPointF &	base,
		qreal	sigma,
		qreal	flow )

rotatePoints()

void KisLiquifyTransformWorker::rotatePoints	(	const QPointF &	base,
		qreal	angle,
		qreal	sigma,
		bool	useWashMode,
		qreal	flow )

Definition at line 402 of file kis_liquify_transform_worker.cpp.

{
    RotateOp op(angle);
    m_d->processTransformedPixels(op, base, sigma, useWashMode, flow);
}

References m_d.

run()

void KisLiquifyTransformWorker::run	(	KisPaintDeviceSP	srcDevice,
		KisPaintDeviceSP	dstDevice )

Definition at line 412 of file kis_liquify_transform_worker.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(*srcDevice->colorSpace() == *dstDevice->colorSpace());
 
    dstDevice->clear();
 
    using namespace GridIterationTools;
    QRect correctSubGrid = calculateCorrectSubGrid(m_d->srcBounds, m_d->pixelPrecision, m_d->accumulatedBrushStrokes, m_d->gridSize);
 
    PaintDevicePolygonOp polygonOp(srcDevice, dstDevice);
    RegularGridIndexesOp indexesOp(m_d->gridSize);
 
    bool canMergeRects = GridIterationTools::canProcessRectsInRandomOrder(indexesOp, m_d->transformedPoints, correctSubGrid);
    polygonOp.setCanMergeRects(canMergeRects);
 
    iterateThroughGrid<AlwaysCompletePolygonPolicy>(polygonOp, indexesOp,
                                                    m_d->gridSize,
                                                    m_d->originalPoints,
                                                    m_d->transformedPoints,
                                                    correctSubGrid);
    QList<QRectF> areasToCopy = cutOutSubgridFromBounds(correctSubGrid, m_d->srcBounds, m_d->gridSize, m_d->originalPoints);
    for (int i = 0; i < areasToCopy.length(); i++) {
        polygonOp.fastCopyArea(areasToCopy[i].toRect(), false);
    }
}

References GridIterationTools::canProcessRectsInRandomOrder(), KisPaintDevice::clear(), KisPaintDevice::colorSpace(), GridIterationTools::PaintDevicePolygonOp::fastCopyArea(), KIS_SAFE_ASSERT_RECOVER_RETURN, m_d, and GridIterationTools::PaintDevicePolygonOp::setCanMergeRects().

runOnQImage()

QImage KisLiquifyTransformWorker::runOnQImage	(	const QImage &	srcImage,
		const QPointF &	srcImageOffset,
		const QTransform &	imageToThumbTransform,
		QPointF *	newOffset )

Definition at line 485 of file kis_liquify_transform_worker.cpp.

{
    KIS_ASSERT_RECOVER(m_d->originalPoints.size() == m_d->transformedPoints.size()) {
        return QImage();
    }
 
    KIS_ASSERT_RECOVER(!srcImage.isNull()) {
        return QImage();
    }
 
    KIS_ASSERT_RECOVER(srcImage.format() == QImage::Format_ARGB32) {
        return QImage();
    }
 
    QVector<QPointF> originalPointsLocal(m_d->originalPoints);
    QVector<QPointF> transformedPointsLocal(m_d->transformedPoints);
 
    PointMapFunction mapFunc = bindPointMapTransform(imageToThumbTransform);
 
    std::transform(originalPointsLocal.begin(), originalPointsLocal.end(),
                   originalPointsLocal.begin(), mapFunc);
 
    std::transform(transformedPointsLocal.begin(), transformedPointsLocal.end(),
                   transformedPointsLocal.begin(), mapFunc);
 
    QRectF dstBounds;
    Q_FOREACH (const QPointF &pt, transformedPointsLocal) {
        KisAlgebra2D::accumulateBounds(pt, &dstBounds);
    }
 
    const QRectF srcBounds(srcImageOffset, srcImage.size());
    dstBounds |= srcBounds;
 
    QPointF dstQImageOffset = dstBounds.topLeft();
    *newOffset = dstQImageOffset;
 
    QRect dstBoundsI = dstBounds.toAlignedRect();
 
    QImage dstImage(dstBoundsI.size(), srcImage.format());
    dstImage.fill(0);
 
    GridIterationTools::QImagePolygonOp polygonOp(srcImage, dstImage, srcImageOffset, dstQImageOffset);
    GridIterationTools::RegularGridIndexesOp indexesOp(m_d->gridSize);
 
 
    QRect correctSubGrid = GridIterationTools::calculateCorrectSubGrid(m_d->srcBounds, m_d->pixelPrecision, m_d->accumulatedBrushStrokes, m_d->gridSize);
    bool canMergeRects = GridIterationTools::canProcessRectsInRandomOrder(indexesOp, m_d->transformedPoints, correctSubGrid);
    polygonOp.setCanMergeRects(canMergeRects);
 
 
    GridIterationTools::iterateThroughGrid<GridIterationTools::AlwaysCompletePolygonPolicy>(polygonOp, indexesOp,
                                                    m_d->gridSize,
                                                    originalPointsLocal,
                                                    transformedPointsLocal,
                                                    correctSubGrid);
 
 
    QList<QRectF> areasToCopy = GridIterationTools::cutOutSubgridFromBounds(correctSubGrid, m_d->srcBounds, m_d->gridSize, m_d->originalPoints);
    polygonOp.setCanMergeRects(false);
    for (int i = 0; i < areasToCopy.length(); i++) {
        polygonOp.fastCopyArea(imageToThumbTransform.map(QPolygonF(areasToCopy[i])));
    }
    return dstImage;
}

References KisAlgebra2D::accumulateBounds(), bindPointMapTransform(), GridIterationTools::calculateCorrectSubGrid(), GridIterationTools::canProcessRectsInRandomOrder(), GridIterationTools::cutOutSubgridFromBounds(), GridIterationTools::QImagePolygonOp::fastCopyArea(), KIS_ASSERT_RECOVER, m_d, GridIterationTools::QImagePolygonOp::setCanMergeRects(), and srcBounds.

scalePoints()

void KisLiquifyTransformWorker::scalePoints	(	const QPointF &	base,
		qreal	scale,
		qreal	sigma,
		bool	useWashMode,
		qreal	flow )

Definition at line 392 of file kis_liquify_transform_worker.cpp.

{
    ScaleOp op(scale);
    m_d->processTransformedPixels(op, base, sigma, useWashMode, flow);
}

References m_d.

toXML()

void KisLiquifyTransformWorker::toXML

(

QDomElement *

e

)

const

Definition at line 553 of file kis_liquify_transform_worker.cpp.

{
    QDomDocument doc = e->ownerDocument();
    QDomElement liqEl = doc.createElement("liquify_points");
    e->appendChild(liqEl);
 
    KisDomUtils::saveValue(&liqEl, "srcBounds", m_d->srcBounds);
    KisDomUtils::saveValue(&liqEl, "originalPoints", m_d->originalPoints);
    KisDomUtils::saveValue(&liqEl, "transformedPoints", m_d->transformedPoints);
    KisDomUtils::saveValue(&liqEl, "pixelPrecision", m_d->pixelPrecision);
    KisDomUtils::saveValue(&liqEl, "gridSize", m_d->gridSize);
}

References m_d, and KisDomUtils::saveValue().

transformedPoints()

QVector< QPointF > & KisLiquifyTransformWorker::transformedPoints

(

)

transformSrcAndDst()

void KisLiquifyTransformWorker::transformSrcAndDst

(

const QTransform &

t

)

Definition at line 456 of file kis_liquify_transform_worker.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(t.type() <= QTransform::TxScale);
 
    m_d->srcBounds = t.mapRect(m_d->srcBounds);
 
    // TODO: do it within Spatial Container
    for (int i = 0; i < m_d->transformedPoints.count(); i++) {
        m_d->originalPointsContainer.movePoint(i, m_d->originalPoints[i], t.map(m_d->originalPoints[i]));
        m_d->transformedPointsContainer.movePoint(i, m_d->transformedPoints[i], t.map(m_d->transformedPoints[i]));
 
        m_d->originalPoints[i] = t.map(m_d->originalPoints[i]);
        m_d->transformedPoints[i] = t.map(m_d->transformedPoints[i]);
    }
}

References KIS_SAFE_ASSERT_RECOVER_RETURN, and m_d.

translate()

void KisLiquifyTransformWorker::translate

(

const QPointF &

offset

)

Definition at line 176 of file kis_liquify_transform_worker.cpp.

{
    KIS_ASSERT_RECOVER_RETURN(m_d->originalPoints.size() ==
                              m_d->transformedPoints.size());
 
    // TODO: make it within Spatial Container, either a hidden offset, or just offsetting all points at once
    // and benchmark
    for (int i = 0; i < m_d->transformedPoints.count(); i++) {
        m_d->originalPointsContainer.movePoint(i, m_d->originalPoints[i], m_d->originalPoints[i] + offset);
        m_d->transformedPointsContainer.movePoint(i, m_d->transformedPoints[i], m_d->transformedPoints[i] + offset);
 
        m_d->originalPoints[i] += offset;
        m_d->transformedPoints[i] += offset;
    }
}

References KIS_ASSERT_RECOVER_RETURN, and m_d.

translateDstSpace()

void KisLiquifyTransformWorker::translateDstSpace

(

const QPointF &

offset

)

Definition at line 192 of file kis_liquify_transform_worker.cpp.

{
    // TODO: make it within Spatial Container, either a hidden offset, or just offsetting all points at once
    // and benchmark
    for (int i = 0; i < m_d->transformedPoints.count(); i++) {
        m_d->transformedPointsContainer.movePoint(i, m_d->transformedPoints[i], m_d->transformedPoints[i] + offset);
        m_d->transformedPoints[i] += offset;
    }
}

References m_d.

translatePoints()

void KisLiquifyTransformWorker::translatePoints	(	const QPointF &	base,
		const QPointF &	offset,
		qreal	sigma,
		bool	useWashMode,
		qreal	flow )

Definition at line 382 of file kis_liquify_transform_worker.cpp.

{
    TranslateOp op(offset);
    m_d->processTransformedPixels(op, base, sigma, useWashMode, flow);
}

References m_d.

undoPoints()

void KisLiquifyTransformWorker::undoPoints	(	const QPointF &	base,
		qreal	amount,
		qreal	sigma )

Definition at line 202 of file kis_liquify_transform_worker.cpp.

{
    const qreal maxDistCoeff = 3.0;
    const qreal maxDist = maxDistCoeff * sigma;
 
    KIS_ASSERT_RECOVER_RETURN(m_d->originalPoints.size() ==
                              m_d->transformedPoints.size());
 
    QVector<int> indexes;
    m_d->transformedPointsContainer.findAllInRange(indexes, base, maxDist);
    for (int i = 0; i < indexes.count(); i++) {
 
        QPointF diff = m_d->transformedPoints[indexes[i]] - base;
        qreal dist = KisAlgebra2D::norm(diff);
        qreal lambda = exp(-0.5 * pow2(dist / sigma));
        lambda *= amount;
 
        QPointF oldPosition = m_d->transformedPoints[indexes[i]];
        m_d->transformedPoints[indexes[i]] = m_d->originalPoints[indexes[i]] * lambda + m_d->transformedPoints[indexes[i]] * (1.0 - lambda);
 
        m_d->transformedPointsContainer.movePoint(indexes[i], oldPosition, m_d->transformedPoints[indexes[i]]);
    }
}

References KIS_ASSERT_RECOVER_RETURN, m_d, KisAlgebra2D::norm(), and pow2().

Member Data Documentation

accumulatedBrushStrokes

QRectF KisLiquifyTransformWorker::accumulatedBrushStrokes

Definition at line 37 of file kis_liquify_transform_worker.cpp.

gridSize

QSize KisLiquifyTransformWorker::gridSize

Definition at line 41 of file kis_liquify_transform_worker.cpp.

m_d

const QScopedPointer<Private> KisLiquifyTransformWorker::m_d

private

Definition at line 86 of file kis_liquify_transform_worker.h.

originalPoints

const QVector< QPointF > & KisLiquifyTransformWorker::originalPoints

Definition at line 31 of file kis_liquify_transform_worker.cpp.

originalPointsContainer

KisSpatialContainer KisLiquifyTransformWorker::originalPointsContainer

Definition at line 34 of file kis_liquify_transform_worker.cpp.

pixelPrecision

int KisLiquifyTransformWorker::pixelPrecision

Definition at line 40 of file kis_liquify_transform_worker.cpp.

progress

KoUpdater* KisLiquifyTransformWorker::progress

Definition at line 39 of file kis_liquify_transform_worker.cpp.

srcBounds

QRect KisLiquifyTransformWorker::srcBounds

Definition at line 29 of file kis_liquify_transform_worker.cpp.

transformedPoints

QVector< QPointF > & KisLiquifyTransformWorker::transformedPoints

Definition at line 32 of file kis_liquify_transform_worker.cpp.

transformedPointsContainer

KisSpatialContainer KisLiquifyTransformWorker::transformedPointsContainer

Definition at line 35 of file kis_liquify_transform_worker.cpp.

---

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

• libs/image/kis_liquify_transform_worker.cpp
• libs/image/kis_liquify_transform_worker.h