KisLiquifyTransformWorker Class Reference

#include <kis_liquify_transform_worker.h>

Inheritance diagram for KisLiquifyTransformWorker:

Public Member Functions
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
QSize	gridSize
QVector< QPointF >	originalPoints
int	pixelPrecision
KoUpdater *	progress
QRect	srcBounds
QVector< QPointF >	transformedPoints
Public Attributes inherited from Private
KisCanvas2 *	canvas
int	displayedFrame
int	intendedFrame

Private Attributes
const QScopedPointer< Private >	m_d

Detailed Description

Definition at line 15 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 58 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 69 of file kis_liquify_transform_worker.cpp.

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

~KisLiquifyTransformWorker()

KisLiquifyTransformWorker::~KisLiquifyTransformWorker

(

)

Definition at line 74 of file kis_liquify_transform_worker.cpp.

{
}

Member Function Documentation

approxChangeRect()

QRect KisLiquifyTransformWorker::approxChangeRect

(

const QRect &

rc

)

Here we just return the full area occupied by the transformed grid. We sample grid points for not doing too much work.

Definition at line 408 of file kis_liquify_transform_worker.cpp.

{
    const qreal margin = 0.05;
 
    const int maxSamplePoints = 200;
    const int minStep = 3;
    const int step = qMax(minStep, m_d->transformedPoints.size() / maxSamplePoints);
    Q_UNUSED(step);
 
    QVector<QPoint> samplePoints;
    for (auto it = m_d->transformedPoints.constBegin(); it != m_d->transformedPoints.constEnd(); ++it) {
        samplePoints << it->toPoint();
    }
 
    QRect resultRect = KisAlgebra2D::approximateRectFromPoints(samplePoints);
    return KisAlgebra2D::blowRect(resultRect | rc, margin);
}

References KisAlgebra2D::approximateRectFromPoints(), KisAlgebra2D::blowRect(), and m_d.

approxNeedRect()

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

Definition at line 430 of file kis_liquify_transform_worker.cpp.

{
    Q_UNUSED(rc);
    return fullBounds;
}

fromXML()

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

static

Definition at line 530 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;
    }
 
    for (int i = 0; i < numPoints; i++) {
        worker->m_d->originalPoints[i] = originalPoints[i];
        worker->m_d->transformedPoints[i] = transformedPoints[i];
    }
 
 
    return worker;
}

References KisDomUtils::findOnlyElement(), 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 98 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 78 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 104 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 17 of file kis_liquify_transform_worker.cpp.

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

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 382 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 392 of file kis_liquify_transform_worker.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(*srcDevice->colorSpace() == *dstDevice->colorSpace());
 
    dstDevice->clear();
 
    using namespace GridIterationTools;
 
    PaintDevicePolygonOp polygonOp(srcDevice, dstDevice);
    RegularGridIndexesOp indexesOp(m_d->gridSize);
    iterateThroughGrid<AlwaysCompletePolygonPolicy>(polygonOp, indexesOp,
                                                    m_d->gridSize,
                                                    m_d->originalPoints,
                                                    m_d->transformedPoints);
}

References KisPaintDevice::clear(), KisPaintDevice::colorSpace(), KIS_SAFE_ASSERT_RECOVER_RETURN, and m_d.

runOnQImage()

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

Definition at line 463 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);
    GridIterationTools::iterateThroughGrid
        <GridIterationTools::AlwaysCompletePolygonPolicy>(polygonOp, indexesOp,
                                                          m_d->gridSize,
                                                          originalPointsLocal,
                                                          transformedPointsLocal);
    return dstImage;
}

References KisAlgebra2D::accumulateBounds(), bindPointMapTransform(), GridIterationTools::iterateThroughGrid(), KIS_ASSERT_RECOVER, m_d, and srcBounds.

scalePoints()

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

Definition at line 372 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 517 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 436 of file kis_liquify_transform_worker.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(t.type() <= QTransform::TxScale);
 
    m_d->srcBounds = t.mapRect(m_d->srcBounds);
 
    for (auto it = m_d->originalPoints.begin(); it != m_d->originalPoints.end(); ++it) {
        *it = t.map(*it);
    }
    for (auto it = m_d->transformedPoints.begin(); it != m_d->transformedPoints.end(); ++it) {
        *it = t.map(*it);
    }
}

References KIS_SAFE_ASSERT_RECOVER_RETURN, and m_d.

translate()

void KisLiquifyTransformWorker::translate

(

const QPointF &

offset

)

Definition at line 164 of file kis_liquify_transform_worker.cpp.

{
    QVector<QPointF>::iterator it = m_d->transformedPoints.begin();
    QVector<QPointF>::iterator end = m_d->transformedPoints.end();
 
    QVector<QPointF>::iterator refIt = m_d->originalPoints.begin();
    KIS_ASSERT_RECOVER_RETURN(m_d->originalPoints.size() ==
                              m_d->transformedPoints.size());
 
    for (; it != end; ++it, ++refIt) {
        *it += offset;
        *refIt += offset;
    }
}

References KIS_ASSERT_RECOVER_RETURN, and m_d.

translateDstSpace()

void KisLiquifyTransformWorker::translateDstSpace

(

const QPointF &

offset

)

Definition at line 179 of file kis_liquify_transform_worker.cpp.

{
    QVector<QPointF>::iterator it = m_d->transformedPoints.begin();
    QVector<QPointF>::iterator end = m_d->transformedPoints.end();
 
    for (; it != end; ++it) {
        *it += offset;
    }
}

References m_d.

translatePoints()

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

Definition at line 362 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 189 of file kis_liquify_transform_worker.cpp.

{
    const qreal maxDistCoeff = 3.0;
    const qreal maxDist = maxDistCoeff * sigma;
    QRectF clipRect(base.x() - maxDist, base.y() - maxDist,
                    2 * maxDist, 2 * maxDist);
 
    QVector<QPointF>::iterator it = m_d->transformedPoints.begin();
    QVector<QPointF>::iterator end = m_d->transformedPoints.end();
 
    QVector<QPointF>::iterator refIt = m_d->originalPoints.begin();
    KIS_ASSERT_RECOVER_RETURN(m_d->originalPoints.size() ==
                              m_d->transformedPoints.size());
 
    for (; it != end; ++it, ++refIt) {
        if (!clipRect.contains(*it)) continue;
 
        QPointF diff = *it - base;
        qreal dist = KisAlgebra2D::norm(diff);
        if (dist > maxDist) continue;
 
        qreal lambda = exp(-0.5 * pow2(dist / sigma));
        lambda *= amount;
        *it = *refIt * lambda + *it * (1.0 - lambda);
    }
}

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

Member Data Documentation

gridSize

QSize KisLiquifyTransformWorker::gridSize

Definition at line 33 of file kis_liquify_transform_worker.cpp.

m_d

const QScopedPointer<Private> KisLiquifyTransformWorker::m_d

private

Definition at line 85 of file kis_liquify_transform_worker.h.

originalPoints

const QVector< QPointF > & KisLiquifyTransformWorker::originalPoints

Definition at line 28 of file kis_liquify_transform_worker.cpp.

pixelPrecision

int KisLiquifyTransformWorker::pixelPrecision

Definition at line 32 of file kis_liquify_transform_worker.cpp.

progress

KoUpdater* KisLiquifyTransformWorker::progress

Definition at line 31 of file kis_liquify_transform_worker.cpp.

srcBounds

QRect KisLiquifyTransformWorker::srcBounds

Definition at line 26 of file kis_liquify_transform_worker.cpp.

transformedPoints

QVector< QPointF > & KisLiquifyTransformWorker::transformedPoints

Definition at line 29 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