KisPerspectiveTransformWorker Class Reference

#include <kis_perspectivetransform_worker.h>

Public Types
enum	SampleType { NearestNeighbour = 0 , Bilinear }

Public Member Functions
QTransform	backwardTransform () const
bool	forceSubPixelTranslation () const
QTransform	forwardTransform () const
	KisPerspectiveTransformWorker (KisPaintDeviceSP dev, const QTransform &transform, bool cropDst, KoUpdaterPtr progress)
	KisPerspectiveTransformWorker (KisPaintDeviceSP dev, QPointF center, double aX, double aY, double distance, bool cropDst, KoUpdaterPtr progress)
void	run (SampleType sampleType=Bilinear)
void	runPartialDst (KisPaintDeviceSP srcDev, KisPaintDeviceSP dstDev, const QRect &dstRect)
void	setForceSubPixelTranslation (bool value)
void	setForwardTransform (const QTransform &transform)
	~KisPerspectiveTransformWorker ()

Private Member Functions
void	fillParams (const QRectF &srcRect, const QRect &dstBaseClipRect, KisRegion *dstRegion, QPolygonF *dstClipPolygon)
void	init (const QTransform &transform)
template<class SrcAccessorPolicy >
void	runImpl ()

Private Attributes
QTransform	m_backwardTransform
bool	m_cropDst
KisPaintDeviceSP	m_dev
KisRegion	m_dstRegion
bool	m_forceSubPixelTranslation {false}
QTransform	m_forwardTransform
bool	m_isIdentity
bool	m_isTranslating
KoUpdaterPtr	m_progressUpdater
QRectF	m_srcRect

Detailed Description

Definition at line 20 of file kis_perspectivetransform_worker.h.

Member Enumeration Documentation

SampleType

enum KisPerspectiveTransformWorker::SampleType

Enumerator
NearestNeighbour
Bilinear

Definition at line 28 of file kis_perspectivetransform_worker.h.

                    {
        NearestNeighbour = 0,
        Bilinear
    };

Constructor & Destructor Documentation

KisPerspectiveTransformWorker() [1/2]

KisPerspectiveTransformWorker::KisPerspectiveTransformWorker	(	KisPaintDeviceSP	dev,
		QPointF	center,
		double	aX,
		double	aY,
		double	distance,
		bool	cropDst,
		KoUpdaterPtr	progress )

Definition at line 36 of file kis_perspectivetransform_worker.cpp.

        : m_dev(dev), m_progressUpdater(progress), m_cropDst(cropDst)
 
{
    QMatrix4x4 m;
    m.rotate(180. * aX / M_PI, QVector3D(1, 0, 0));
    m.rotate(180. * aY / M_PI, QVector3D(0, 1, 0));
 
    QTransform project = m.toTransform(distance);
    QTransform t = QTransform::fromTranslate(center.x(), center.y());
 
    QTransform forwardTransform = t.inverted() * project * t;
 
    init(forwardTransform);
}

References distance(), forwardTransform(), init(), and M_PI.

KisPerspectiveTransformWorker() [2/2]

KisPerspectiveTransformWorker::KisPerspectiveTransformWorker	(	KisPaintDeviceSP	dev,
		const QTransform &	transform,
		bool	cropDst,
		KoUpdaterPtr	progress )

Definition at line 52 of file kis_perspectivetransform_worker.cpp.

    : m_dev(dev), m_progressUpdater(progress), m_cropDst(cropDst)
{
    init(transform);
}

References init().

~KisPerspectiveTransformWorker()

KisPerspectiveTransformWorker::~KisPerspectiveTransformWorker

(

)

Definition at line 100 of file kis_perspectivetransform_worker.cpp.

{
}

Member Function Documentation

backwardTransform()

QTransform KisPerspectiveTransformWorker::backwardTransform

(

)

const

Definition at line 243 of file kis_perspectivetransform_worker.cpp.

{
    return m_backwardTransform;
}

References m_backwardTransform.

fillParams()

void KisPerspectiveTransformWorker::fillParams ( const QRectF & srcRect, const QRect & dstBaseClipRect, KisRegion * dstRegion, QPolygonF * dstClipPolygon )

private

Definition at line 58 of file kis_perspectivetransform_worker.cpp.

{
    QPolygonF bounds = srcRect;
    QPolygonF newBounds = m_forwardTransform.map(bounds);
 
    QRectF clipRect = dstBaseClipRect;
 
    if (!m_cropDst) {
        clipRect |= srcRect;
        clipRect = KisAlgebra2D::blowRect(clipRect, 3.0);
    }
 
    newBounds = newBounds.intersected(clipRect);
    QPainterPath path;
    path.addPolygon(newBounds);
    *dstRegion = KritaUtils::splitPath(path);
    *dstClipPolygon = newBounds;
}

References KisAlgebra2D::blowRect(), bounds, m_cropDst, m_forwardTransform, and KritaUtils::splitPath().

forceSubPixelTranslation()

bool KisPerspectiveTransformWorker::forceSubPixelTranslation

(

)

const

Definition at line 248 of file kis_perspectivetransform_worker.cpp.

{
    return m_forceSubPixelTranslation;
}

References m_forceSubPixelTranslation.

forwardTransform()

QTransform KisPerspectiveTransformWorker::forwardTransform

(

)

const

Definition at line 238 of file kis_perspectivetransform_worker.cpp.

{
    return m_forwardTransform;
}

References m_forwardTransform.

init()

void KisPerspectiveTransformWorker::init ( const QTransform & transform )

private

Definition at line 80 of file kis_perspectivetransform_worker.cpp.

{
    m_isIdentity = transform.isIdentity();
    m_isTranslating = transform.type() == QTransform::TxTranslate;
 
    m_forwardTransform = transform;
    m_backwardTransform = transform.inverted();
 
    if (m_dev) {
        m_srcRect = kisGrowRect(m_dev->exactBounds(), 1.0);
 
        QPolygonF dstClipPolygonUnused;
 
        fillParams(m_srcRect,
                   m_dev->defaultBounds()->bounds(),
                   &m_dstRegion,
                   &dstClipPolygonUnused);
    }
}

References KisDefaultBoundsBase::bounds(), KisPaintDevice::defaultBounds(), KisPaintDevice::exactBounds(), fillParams(), kisGrowRect(), m_backwardTransform, m_dev, m_dstRegion, m_forwardTransform, m_isIdentity, m_isTranslating, and m_srcRect.

run()

void KisPerspectiveTransformWorker::run

(

SampleType

sampleType = Bilinear

)

Definition at line 192 of file kis_perspectivetransform_worker.cpp.

{
    if (sampleType == Bilinear) {
        runImpl<BilinearWrapper>();
    } else {
        runImpl<NearestNeighbourWrapper>();
    }
}

References Bilinear.

runImpl()

template<class SrcAccessorWrapper >

void KisPerspectiveTransformWorker::runImpl ( )

private

Definition at line 147 of file kis_perspectivetransform_worker.cpp.

{
    KIS_ASSERT_RECOVER_RETURN(m_dev);
 
    if (m_isIdentity) return;
 
    // TODO: check if this optimization is possible. The only blocking issue might be if
    //       some other thread also accesses this device (which should not be the case,
    //       theoretically
    //
    // if (m_isTranslating) {
    //     m_dev->moveTo(m_dev->offset() + QPoint(qRound(m_forwardTransform.dx()), qRound(m_forwardTransform.dy())));
    //     return;
    // }
 
    KisPaintDeviceSP cloneDevice = new KisPaintDevice(*m_dev.data());
 
    // Clear the destination device, since all the tiles are already
    // shared with cloneDevice
    m_dev->clear();
 
    KIS_ASSERT_RECOVER_NOOP(!m_isIdentity);
 
    KisProgressUpdateHelper progressHelper(m_progressUpdater, 100, m_dstRegion.rectCount());
 
    SrcAccessorWrapper srcAcc(cloneDevice);
    KisRandomAccessorSP accessor = m_dev->createRandomAccessorNG();
 
    Q_FOREACH (const QRect &rect, m_dstRegion.rects()) {
        for (int y = rect.y(); y < rect.y() + rect.height(); ++y) {
            for (int x = rect.x(); x < rect.x() + rect.width(); ++x) {
 
                QPointF dstPoint(x, y);
                QPointF srcPoint = m_backwardTransform.map(dstPoint);
 
                if (m_srcRect.contains(srcPoint)) {
                    accessor->moveTo(dstPoint.x(), dstPoint.y());
                    srcAcc.samplePixel(srcPoint, accessor->rawData());
                }
            }
        }
        progressHelper.step();
    }
}

References KisPaintDevice::clear(), KisPaintDevice::createRandomAccessorNG(), KisSharedPtr< T >::data(), dstPoint, KIS_ASSERT_RECOVER_NOOP, KIS_ASSERT_RECOVER_RETURN, m_backwardTransform, m_dev, m_dstRegion, m_isIdentity, m_progressUpdater, m_srcRect, KisRandomConstAccessorNG::moveTo(), KisBaseAccessor::rawData(), KisRegion::rectCount(), KisRegion::rects(), and KisProgressUpdateHelper::step().

runPartialDst()

void KisPerspectiveTransformWorker::runPartialDst	(	KisPaintDeviceSP	srcDev,
		KisPaintDeviceSP	dstDev,
		const QRect &	dstRect )

Definition at line 201 of file kis_perspectivetransform_worker.cpp.

{
    KIS_SAFE_ASSERT_RECOVER_RETURN(srcDev->pixelSize() == dstDev->pixelSize());
    KIS_SAFE_ASSERT_RECOVER_NOOP(*srcDev->colorSpace() == *dstDev->colorSpace());
 
    QRectF srcClipRect = kisGrowRect(srcDev->exactBounds(), 1) | srcDev->defaultBounds()->imageBorderRect();
    if (srcClipRect.isEmpty()) return;
 
    if (m_isIdentity || (m_isTranslating && !m_forceSubPixelTranslation)) {
        KisPainter gc(dstDev);
        gc.setCompositeOpId(COMPOSITE_COPY);
        gc.bitBlt(dstRect.topLeft(), srcDev, m_backwardTransform.mapRect(dstRect));
    } else {
        KisProgressUpdateHelper progressHelper(m_progressUpdater, 100, dstRect.height());
 
        KisRandomSubAccessorSP srcAcc = srcDev->createRandomSubAccessor();
        KisRandomAccessorSP accessor = dstDev->createRandomAccessorNG();
 
        for (int y = dstRect.y(); y < dstRect.y() + dstRect.height(); ++y) {
            for (int x = dstRect.x(); x < dstRect.x() + dstRect.width(); ++x) {
 
                QPointF dstPoint(x, y);
                QPointF srcPoint = m_backwardTransform.map(dstPoint);
 
                if (srcClipRect.contains(srcPoint) || srcDev->defaultBounds()->wrapAroundMode()) {
                    accessor->moveTo(dstPoint.x(), dstPoint.y());
                    srcAcc->moveTo(srcPoint.x(), srcPoint.y());
                    srcAcc->sampledOldRawData(accessor->rawData());
                }
            }
            progressHelper.step();
        }
    }
}

References KisPainter::bitBlt(), KisPaintDevice::colorSpace(), COMPOSITE_COPY, KisPaintDevice::createRandomAccessorNG(), KisPaintDevice::createRandomSubAccessor(), KisPaintDevice::defaultBounds(), dstPoint, KisPaintDevice::exactBounds(), KisDefaultBoundsBase::imageBorderRect(), KIS_SAFE_ASSERT_RECOVER_NOOP, KIS_SAFE_ASSERT_RECOVER_RETURN, kisGrowRect(), m_backwardTransform, m_forceSubPixelTranslation, m_isIdentity, m_isTranslating, m_progressUpdater, KisRandomConstAccessorNG::moveTo(), KisRandomSubAccessor::moveTo(), KisPaintDevice::pixelSize(), KisBaseAccessor::rawData(), KisRandomSubAccessor::sampledOldRawData(), KisPainter::setCompositeOpId(), KisProgressUpdateHelper::step(), and KisDefaultBoundsBase::wrapAroundMode().

setForceSubPixelTranslation()

void KisPerspectiveTransformWorker::setForceSubPixelTranslation

(

bool

value

)

Definition at line 253 of file kis_perspectivetransform_worker.cpp.

{
    m_forceSubPixelTranslation = value;
}

References m_forceSubPixelTranslation, and value().

setForwardTransform()

void KisPerspectiveTransformWorker::setForwardTransform

(

const QTransform &

transform

)

Definition at line 104 of file kis_perspectivetransform_worker.cpp.

{
    init(transform);
}

References init().

Member Data Documentation

m_backwardTransform

QTransform KisPerspectiveTransformWorker::m_backwardTransform

private

Definition at line 62 of file kis_perspectivetransform_worker.h.

m_cropDst

bool KisPerspectiveTransformWorker::m_cropDst

private

Definition at line 66 of file kis_perspectivetransform_worker.h.

m_dev

KisPaintDeviceSP KisPerspectiveTransformWorker::m_dev

private

Definition at line 58 of file kis_perspectivetransform_worker.h.

m_dstRegion

KisRegion KisPerspectiveTransformWorker::m_dstRegion

private

Definition at line 60 of file kis_perspectivetransform_worker.h.

m_forceSubPixelTranslation

bool KisPerspectiveTransformWorker::m_forceSubPixelTranslation {false}

private

Definition at line 67 of file kis_perspectivetransform_worker.h.

{false};

m_forwardTransform

QTransform KisPerspectiveTransformWorker::m_forwardTransform

private

Definition at line 63 of file kis_perspectivetransform_worker.h.

m_isIdentity

bool KisPerspectiveTransformWorker::m_isIdentity

private

Definition at line 64 of file kis_perspectivetransform_worker.h.

m_isTranslating

bool KisPerspectiveTransformWorker::m_isTranslating

private

Definition at line 65 of file kis_perspectivetransform_worker.h.

m_progressUpdater

KoUpdaterPtr KisPerspectiveTransformWorker::m_progressUpdater

private

Definition at line 59 of file kis_perspectivetransform_worker.h.

m_srcRect

QRectF KisPerspectiveTransformWorker::m_srcRect

private

Definition at line 61 of file kis_perspectivetransform_worker.h.

---

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

• libs/image/kis_perspectivetransform_worker.h
• libs/image/kis_perspectivetransform_worker.cpp