KoGradientBackground Class Reference

A gradient shape background. More...

#include <KoGradientBackground.h>

Inheritance diagram for KoGradientBackground:

Classes
class	Private

Public Member Functions
bool	compareTo (const KoShapeBackground *other) const override
const QGradient *	gradient () const
	Returns the gradient.
	KoGradientBackground (const KoGradientBackground &)
	KoGradientBackground (const QGradient &gradient, const QTransform &matrix=QTransform())
	KoGradientBackground (QGradient *gradient, const QTransform &matrix=QTransform())
KoGradientBackground &	operator= (const KoGradientBackground &)
void	paint (QPainter &painter, const QPainterPath &fillPath) const override
	reimplemented from KoShapeBackground
void	setGradient (const QGradient &gradient)
void	setTransform (const QTransform &matrix)
	Sets the transform matrix.
QTransform	transform () const
	Returns the transform matrix.
	~KoGradientBackground () override
	Destroys the background.
Public Member Functions inherited from KoShapeBackground
virtual bool	hasTransparency () const
	Returns if the background has some transparency.
	KoShapeBackground ()
virtual	operator bool () const
virtual	~KoShapeBackground ()

Private Attributes
QSharedDataPointer< Private >	d

Detailed Description

A gradient shape background.

Definition at line 19 of file KoGradientBackground.h.

Constructor & Destructor Documentation

KoGradientBackground() [1/3]

KoGradientBackground::KoGradientBackground ( QGradient * gradient, const QTransform & matrix = QTransform() )

explicit

Creates new gradient background from given gradient. The background takes ownership of the given gradient.

Definition at line 31 of file KoGradientBackground.cpp.

    : KoShapeBackground()
    , d(new Private)
{
    d->gradient = gradient;
    d->matrix = matrix;
    Q_ASSERT(d->gradient);
}

References d, and gradient().

KoGradientBackground() [2/3]

KoGradientBackground::KoGradientBackground ( const QGradient & gradient, const QTransform & matrix = QTransform() )

explicit

Create new gradient background from the given gradient. A clone of the given gradient is used.

Definition at line 40 of file KoGradientBackground.cpp.

    : KoShapeBackground()
    , d(new Private)
{
    d->gradient = KoFlake::cloneGradient(&gradient);
    d->matrix = matrix;
    Q_ASSERT(d->gradient);
}

References KoFlake::cloneGradient(), d, and gradient().

~KoGradientBackground()

KoGradientBackground::~KoGradientBackground ( )

override

Destroys the background.

Definition at line 49 of file KoGradientBackground.cpp.

{
    delete d->gradient;
}

References d.

KoGradientBackground() [3/3]

KoGradientBackground::KoGradientBackground

(

const KoGradientBackground &

rhs

)

Definition at line 54 of file KoGradientBackground.cpp.

    : d(new Private(*rhs.d))
{
}

Member Function Documentation

compareTo()

bool KoGradientBackground::compareTo ( const KoShapeBackground * other ) const

overridevirtual

Implements KoShapeBackground.

Definition at line 65 of file KoGradientBackground.cpp.

{
    const KoGradientBackground *otherGradient = dynamic_cast<const KoGradientBackground*>(other);
 
    return otherGradient &&
        d->matrix == otherGradient->d->matrix &&
        *d->gradient == *otherGradient->d->gradient;
}

References d.

gradient()

const QGradient * KoGradientBackground::gradient

(

)

const

Returns the gradient.

Definition at line 92 of file KoGradientBackground.cpp.

{
    return d->gradient;
}

References d.

operator=()

KoGradientBackground & KoGradientBackground::operator=

(

const KoGradientBackground &

rhs

)

Definition at line 59 of file KoGradientBackground.cpp.

{
    d = rhs.d;
    return *this;
}

References d.

paint()

void KoGradientBackground::paint ( QPainter & painter, const QPainterPath & fillPath ) const

overridevirtual

reimplemented from KoShapeBackground

NOTE: important hack!

Qt has different notation of QBrush::setTransform() in comparison to what SVG defines. SVG defines gradientToUser matrix to be postmultiplied by QBrush::transform(), but Qt does exactly reverse!

That most probably has been caused by the fact that Qt uses transposed matrices and someone just mistyped the stuff long ago :(

So here we basically emulate this feature by converting the gradient into QGradient::LogicalMode and doing transformations manually.

Implements KoShapeBackground.

Definition at line 97 of file KoGradientBackground.cpp.

{
    if (!d->gradient) return;
 
    if (d->gradient->coordinateMode() == QGradient::ObjectBoundingMode) {
 
        const QRectF boundingRect = fillPath.boundingRect();
        QTransform gradientToUser(boundingRect.width(), 0, 0, boundingRect.height(),
                                  boundingRect.x(), boundingRect.y());
 
        // TODO: how about slicing the object?
        QGradient g = *d->gradient;
        g.setCoordinateMode(QGradient::LogicalMode);
 
        QBrush b(g);
        b.setTransform(d->matrix * gradientToUser);
        painter.setBrush(b);
    } else {
        QBrush b(*d->gradient);
        b.setTransform(d->matrix);
        painter.setBrush(b);
    }
 
    painter.drawPath(fillPath);
}

References d.

setGradient()

void KoGradientBackground::setGradient

(

const QGradient &

gradient

)

Sets a new gradient. A clone of the given gradient is used.

Definition at line 84 of file KoGradientBackground.cpp.

{
    delete d->gradient;
 
    d->gradient = KoFlake::cloneGradient(&gradient);
    Q_ASSERT(d->gradient);
}

References KoFlake::cloneGradient(), d, and gradient().

setTransform()

void KoGradientBackground::setTransform

(

const QTransform &

matrix

)

Sets the transform matrix.

Definition at line 74 of file KoGradientBackground.cpp.

{
    d->matrix = matrix;
}

References d.

transform()

QTransform KoGradientBackground::transform

(

)

const

Returns the transform matrix.

Definition at line 79 of file KoGradientBackground.cpp.

{
    return d->matrix;
}

References d.

Member Data Documentation

d

QSharedDataPointer<Private> KoGradientBackground::d

private

Definition at line 62 of file KoGradientBackground.h.

---

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

• libs/flake/KoGradientBackground.h
• libs/flake/KoGradientBackground.cpp