KoShapeShadow Class Reference

#include <KoShapeShadow.h>

Inheritance diagram for KoShapeShadow:

Public Member Functions
qreal	blur () const
	Returns the shadow blur radius.
void	blurShadow (QImage &image, int radius, const QColor &shadowColor)
QColor	color () const
	Returns the shadow color including opacity.
bool	deref ()
void	insets (KoInsets &insets) const
	Fills the insets object with the space the shadow takes around a shape.
bool	isVisible () const
	Returns if shadow is visible.
	KoShapeShadow ()
	KoShapeShadow (const KoShapeShadow &rhs)
QPointF	offset () const
	Returns the shadow offset.
KoShapeShadow &	operator= (const KoShapeShadow &rhs)
void	paint (KoShape *shape, QPainter &painter)
void	paintGroupShadow (KoShapeGroup *group, QPainter &painter)
void	paintShadow (KoShape *shape, QPainter &painter)
	Private ()
bool	ref ()
void	setBlur (qreal blur)
void	setColor (const QColor &color)
void	setOffset (const QPointF &offset)
void	setVisible (bool visible)
	Sets the shadow visibility.
int	useCount () const
	Return the usage count.
	~KoShapeShadow ()

Public Attributes
qreal	blur
QColor	color
QPointF	offset
QAtomicInt	refCount
bool	visible

Private Attributes
Private *const	d
Private Attributes inherited from Private
KisCanvas2 *	canvas
int	displayedFrame
int	intendedFrame

Additional Inherited Members
Private Member Functions inherited from Private
	Private (KisCanvas2 *c)

Detailed Description

Definition at line 25 of file KoShapeShadow.cpp.

Constructor & Destructor Documentation

KoShapeShadow() [1/2]

KoShapeShadow::KoShapeShadow

(

)

Definition at line 177 of file KoShapeShadow.cpp.

        : d(new Private())
{
}

~KoShapeShadow()

KoShapeShadow::~KoShapeShadow

(

)

Definition at line 182 of file KoShapeShadow.cpp.

{
    delete d;
}

References d.

KoShapeShadow() [2/2]

KoShapeShadow::KoShapeShadow

(

const KoShapeShadow &

rhs

)

Definition at line 187 of file KoShapeShadow.cpp.

    : d(new Private(*rhs.d))
{
    d->refCount = 0;
}

References d.

Member Function Documentation

blur()

qreal KoShapeShadow::blur

(

)

const

Returns the shadow blur radius.

blurShadow()

void KoShapeShadow::blurShadow	(	QImage &	image,
		int	radius,
		const QColor &	shadowColor )

color()

QColor KoShapeShadow::color

(

)

const

Returns the shadow color including opacity.

deref()

bool KoShapeShadow::deref

(

)

Decrements the use-value. Returns true if the new value is non-zero, false otherwise.

Definition at line 321 of file KoShapeShadow.cpp.

{
    return d->refCount.deref();
}

References d.

insets()

void KoShapeShadow::insets

(

KoInsets &

insets

)

const

Fills the insets object with the space the shadow takes around a shape.

Definition at line 293 of file KoShapeShadow.cpp.

{
    if (!d->visible) {
        insets.top = 0;
        insets.bottom = 0;
        insets.left = 0;
        insets.right = 0;
        return;
    }
 
    qreal expand = d->blur;
 
    insets.left = (d->offset.x() < 0.0) ? qAbs(d->offset.x()) : 0.0;
    insets.top = (d->offset.y() < 0.0) ? qAbs(d->offset.y()) : 0.0;
    insets.right = (d->offset.x() > 0.0) ? d->offset.x() : 0.0;
    insets.bottom = (d->offset.y() > 0.0) ? d->offset.y() : 0.0;
 
    insets.left += expand;
    insets.top += expand;
    insets.right += expand;
    insets.bottom += expand;
}

References d, expand(), and insets().

isVisible()

bool KoShapeShadow::isVisible

(

)

const

Returns if shadow is visible.

Definition at line 288 of file KoShapeShadow.cpp.

{
    return d->visible;
}

References d.

offset()

QPointF KoShapeShadow::offset

(

)

const

Returns the shadow offset.

operator=()

KoShapeShadow & KoShapeShadow::operator=

(

const KoShapeShadow &

rhs

)

Definition at line 193 of file KoShapeShadow.cpp.

{
    *d = *rhs.d;
    d->refCount = 0;
    return *this;
}

References d.

paint()

void KoShapeShadow::paint	(	KoShape *	shape,
		QPainter &	painter )

Paints the shadow of the shape.

Parameters

shape	the shape to paint around
painter	the painter to paint shadows to canvas
converter	to convert between internal and view coordinates.

Definition at line 200 of file KoShapeShadow.cpp.

{
    if (! d->visible)
        return;
 
    // So the approach we are taking here is to draw into a buffer image the size of boundingRect
    // We offset by the shadow offset at the time we draw into the buffer
    // Then we filter the image and draw it at the position of the bounding rect on canvas
 
    QTransform documentToView = painter.transform();
 
    //the boundingRect of the shape or the KoSelection boundingRect of the group
    QRectF shadowRect = shape->boundingRect();
    QRectF zoomedClipRegion = documentToView.mapRect(shadowRect);
 
    // Init the buffer image
    QImage sourceGraphic(zoomedClipRegion.size().toSize(), QImage::Format_ARGB32_Premultiplied);
    sourceGraphic.fill(qRgba(0,0,0,0));
    // Init the buffer painter
    QPainter imagePainter(&sourceGraphic);
    imagePainter.setPen(Qt::NoPen);
    imagePainter.setBrush(Qt::NoBrush);
    imagePainter.setRenderHint(QPainter::Antialiasing, painter.testRenderHint(QPainter::Antialiasing));
    // Since our image buffer and the canvas don't align we need to offset our drawings
    imagePainter.translate(-1.0f*documentToView.map(shadowRect.topLeft()));
 
    // Handle the shadow offset
    imagePainter.translate(documentToView.map(offset()));
 
    KoShapeGroup *group = dynamic_cast<KoShapeGroup*>(shape);
    if (group) {
        d->paintGroupShadow(group, imagePainter);
    } else {
        //apply shape's transformation
        imagePainter.setTransform(shape->absoluteTransformation(), true);
 
        d->paintShadow(shape, imagePainter);
    }
    imagePainter.end();
 
    // Blur the shadow (well the entire buffer)
    d->blurShadow(sourceGraphic, qRound(documentToView.m11() * d->blur), d->color);
 
    // Paint the result
    painter.save();
    // The painter is initialized for us with canvas transform 'plus' shape transform
    // we are only interested in the canvas transform so 'subtract' the shape transform part
    painter.setTransform(shape->absoluteTransformation().inverted() * painter.transform());
    painter.drawImage(zoomedClipRegion.topLeft(), sourceGraphic);
    painter.restore();
}

References KoShape::absoluteTransformation(), KoShape::boundingRect(), d, and offset.

paintGroupShadow()

void KoShapeShadow::paintGroupShadow	(	KoShapeGroup *	group,
		QPainter &	painter )

Paints the shadow of the shape group to the buffer image.

Parameters

group	the shape group to paint around
painter	the painter to paint on the image
converter	to convert between internal and view coordinates.

paintShadow()

void KoShapeShadow::paintShadow	(	KoShape *	shape,
		QPainter &	painter )

Paints the shadow of the shape to the buffer image.

Parameters

shape	the shape to paint around
painter	the painter to paint on the image

Private()

KoShapeShadow::Private ( )

inline

Definition at line 28 of file KoShapeShadow.cpp.

            : offset(2, 2), color(Qt::black), blur(8), visible(true), refCount(0) {
    }

ref()

bool KoShapeShadow::ref

(

)

Increments the use-value. Returns true if the new value is non-zero, false otherwise.

Definition at line 316 of file KoShapeShadow.cpp.

{
    return d->refCount.ref();
}

References d.

setBlur()

void KoShapeShadow::setBlur

(

qreal

blur

)

Sets the shadow blur radius of the shape

Parameters

blur	the shadow blur radius

Definition at line 272 of file KoShapeShadow.cpp.

{
    // force positive blur radius
    d->blur = qAbs(blur);
}

References blur, and d.

setColor()

void KoShapeShadow::setColor

(

const QColor &

color

)

Sets the shadow color, including the shadow opacity.

Parameters

color

the shadow color and opacity

Definition at line 262 of file KoShapeShadow.cpp.

{
    d->color = color;
}

References color, and d.

setOffset()

void KoShapeShadow::setOffset

(

const QPointF &

offset

)

Sets the shadow offset from the topleft corner of the shape

Parameters

offset

the shadow offset

Definition at line 252 of file KoShapeShadow.cpp.

{
    d->offset = offset;
}

References d, and offset.

setVisible()

void KoShapeShadow::setVisible

(

bool

visible

)

Sets the shadow visibility.

Definition at line 283 of file KoShapeShadow.cpp.

{
    d->visible = visible;
}

References d, and visible.

useCount()

int KoShapeShadow::useCount

(

)

const

Return the usage count.

Definition at line 326 of file KoShapeShadow.cpp.

{
    return d->refCount;
}

References d.

Member Data Documentation

blur

qreal KoShapeShadow::blur

Definition at line 33 of file KoShapeShadow.cpp.

color

QColor KoShapeShadow::color

Definition at line 32 of file KoShapeShadow.cpp.

d

Private* const KoShapeShadow::d

private

Definition at line 90 of file KoShapeShadow.h.

offset

QPointF KoShapeShadow::offset

Definition at line 31 of file KoShapeShadow.cpp.

refCount

QAtomicInt KoShapeShadow::refCount

Definition at line 35 of file KoShapeShadow.cpp.

visible

bool KoShapeShadow::visible

Definition at line 34 of file KoShapeShadow.cpp.

---

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

• libs/flake/KoShapeShadow.cpp
• libs/flake/KoShapeShadow.h