KisImagePatch Class Reference

#include <kis_image_patch.h>

Public Member Functions
void	drawMe (QPainter &gc, const QRectF &dstRect, QPainter::RenderHints renderHints)
bool	isValid ()
	KisImagePatch ()
	KisImagePatch (QRect imageRect, qint32 borderWidth, qreal scaleX, qreal scaleY)
QRect	patchRect ()
void	preScale (const QRectF &dstRect)
void	setImage (QImage image)

Private Attributes
QImage	m_image
QRectF	m_interestRect
bool	m_isScaled {false}
QRect	m_patchRect
qreal	m_scaleX {0.0}
qreal	m_scaleY {0.0}

Detailed Description

Definition at line 17 of file kis_image_patch.h.

Constructor & Destructor Documentation

KisImagePatch() [1/2]

KisImagePatch::KisImagePatch

(

)

A default constructor initializing invalid patch

Definition at line 44 of file kis_image_patch.cpp.

{
}

KisImagePatch() [2/2]

KisImagePatch::KisImagePatch	(	QRect	imageRect,
		qint32	borderWidth,
		qreal	scaleX,
		qreal	scaleY )

Initializes a new patch with given values. Be careful, because the constructor does not fill QImage of the patch, as the patch rect is not known yet

See also

setImage

Definition at line 48 of file kis_image_patch.cpp.

    : m_scaleX(scaleX)
    , m_scaleY(scaleY)
    , m_isScaled(false)
{
    // First we get unscaled rects
    m_interestRect = QRectF(borderWidth, borderWidth,
                            imageRect.width(), imageRect.height());
    m_patchRect = imageRect.adjusted(-borderWidth, -borderWidth,
                                     borderWidth, borderWidth);
    // And then we scale them
    scaleRect(m_interestRect, scaleX, scaleY);
    scaleRect(m_patchRect, scaleX, scaleY);
 
    dbgRender << "A new patch has been created:";
    dbgRender << ppVar(scaleX) << ppVar(scaleY);
    dbgRender << ppVar(m_interestRect);
    dbgRender << ppVar(m_patchRect);
}

References dbgRender, m_interestRect, m_patchRect, ppVar, and scaleRect().

Member Function Documentation

drawMe()

void KisImagePatch::drawMe	(	QPainter &	gc,
		const QRectF &	dstRect,
		QPainter::RenderHints	renderHints )

Draws an m_interestRect of the patch onto gc By the way it fits this rect into dstRect renderHints are directly transmitted to QPainter

Definition at line 109 of file kis_image_patch.cpp.

{
    gc.save();
    gc.setCompositionMode(QPainter::CompositionMode_Source);
    gc.setRenderHints(renderHints, true);
    gc.drawImage(dstRect, m_image, m_interestRect);
    gc.restore();
 
#if 0
    qreal scaleX = dstRect.width() / m_interestRect.width();
    qreal scaleY = dstRect.height() / m_interestRect.height();
    dbgRender << "## PATCH.DRAWME #####################";
    dbgRender << ppVar(scaleX) << ppVar(scaleY);
    dbgRender << ppVar(m_patchRect);
    dbgRender << ppVar(m_interestRect);
    dbgRender << ppVar(dstRect);
    dbgRender << "## EODM #############################";
#endif
}

References dbgRender, m_image, m_interestRect, m_patchRect, and ppVar.

isValid()

bool KisImagePatch::isValid

(

)

Checks whether the patch can be used for drawing the image

Definition at line 104 of file kis_image_patch.cpp.

{
    return !m_image.isNull();
}

References m_image.

patchRect()

QRect KisImagePatch::patchRect

(

)

Returns the rect of KisImage covered by the image of the patch (in KisImage pixels)

See also

m_patchRect

Definition at line 99 of file kis_image_patch.cpp.

{
    return m_patchRect;
}

References m_patchRect.

preScale()

void KisImagePatch::preScale

(

const QRectF &

dstRect

)

prescale the patch image. Call after setImage(). This ensures that we use the QImage smoothscale method, not the QPainter scaling, which is far inferior.

Definition at line 75 of file kis_image_patch.cpp.

{
    if (m_isScaled) return;
 
    qreal scaleX = dstRect.width() / m_interestRect.width();
    qreal scaleY = dstRect.height() / m_interestRect.height();
 
    QSize newImageSize = QSize(ceil(m_image.width() * scaleX),
                                   ceil(m_image.height() * scaleY));
    // Calculating new _aligned_ scale
    scaleX = qreal(newImageSize.width()) / m_image.width();
    scaleY = qreal(newImageSize.height()) / m_image.height();
 
    m_scaleX *= scaleX;
    m_scaleY *= scaleY;
 
    scaleRect(m_interestRect, scaleX, scaleY);
 
    m_image = m_image.scaled(newImageSize, Qt::IgnoreAspectRatio, Qt::SmoothTransformation);
 
    m_isScaled = true;
 
}

References m_image, m_interestRect, m_isScaled, m_scaleX, m_scaleY, and scaleRect().

setImage()

void KisImagePatch::setImage

(

QImage

image

)

Sets the image of the patch Should be called right after the constructor to finish initializing the object

Definition at line 69 of file kis_image_patch.cpp.

{
    m_image = image;
    m_isScaled = false;
}

References m_image, and m_isScaled.

Member Data Documentation

m_image

QImage KisImagePatch::m_image

private

Definition at line 95 of file kis_image_patch.h.

m_interestRect

QRectF KisImagePatch::m_interestRect

private

The rect that was requested during creation of the patch. It equals to patchRect without borders These borders are introduced for more accurate smooth scaling to reduce border effects (IN m_image PIXELS, relative to m_image's topLeft);

Definition at line 93 of file kis_image_patch.h.

m_isScaled

bool KisImagePatch::m_isScaled {false}

private

Definition at line 96 of file kis_image_patch.h.

{false};

m_patchRect

QRect KisImagePatch::m_patchRect

private

The rect of KisImage covered by the image of the patch (in KisImage pixels)

Definition at line 82 of file kis_image_patch.h.

m_scaleX

qreal KisImagePatch::m_scaleX {0.0}

private

The scale of the image stored in the patch

Definition at line 75 of file kis_image_patch.h.

{0.0};

m_scaleY

qreal KisImagePatch::m_scaleY {0.0}

private

Definition at line 76 of file kis_image_patch.h.

{0.0};

---

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

• libs/ui/canvas/kis_image_patch.h
• libs/ui/canvas/kis_image_patch.cpp