#include <kis_circle_mask_generator.h>

Inheritance diagram for KisCircleMaskGenerator:

Public Member Functions
KisBrushMaskApplicatorBase *	applicator () const override

KisMaskGenerator *	clone () const override

	KisCircleMaskGenerator (const KisCircleMaskGenerator &rhs)

	KisCircleMaskGenerator (qreal radius, qreal ratio, qreal fh, qreal fv, int spikes, bool antialiasEdges)

	Private ()

	Private (const Private &rhs)

void	setMaskScalarApplicator ()

void	setScale (qreal scaleX, qreal scaleY) override

void	setSoftness (qreal softness) override

bool	shouldVectorize () const override

quint8	valueAt (qreal x, qreal y) const override

	~KisCircleMaskGenerator () override

Public Member Functions inherited from KisMaskGenerator
bool	antialiasEdges () const

QString	curveString () const

qreal	diameter () const

void	fixRotation (qreal &xr, qreal &yr) const

qreal	height () const

qreal	horizontalFade () const

QString	id () const

bool	isEmpty () const

	KisMaskGenerator (const KisMaskGenerator &rhs)

	KisMaskGenerator (qreal radius, qreal ratio, qreal fh, qreal fv, int spikes, bool antialiasEdges, Type type, const KoID &id=DefaultId)

QString	name () const

qreal	ratio () const

void	setCurveString (const QString &curveString)

void	setDiameter (qreal value)

virtual bool	shouldSupersample () const

virtual bool	shouldSupersample6x6 () const

qreal	softness () const

int	spikes () const

virtual void	toXML (QDomDocument &, QDomElement &) const

Type	type () const

qreal	verticalFade () const

qreal	width () const

virtual	~KisMaskGenerator ()

Public Member Functions inherited from KisMaskGenerator::Private
	Private ()

	Private (const Private &rhs)

Public Attributes
QScopedPointer< KisBrushMaskApplicatorBase >	applicator

bool	copyOfAntialiasEdges

qreal	safeSoftnessCoeff

double	transformedFadeX

double	transformedFadeY

double	xcoef

double	xfadecoef

double	ycoef

double	yfadecoef

Public Attributes inherited from KisMaskGenerator::Private
bool	antialiasEdges

qreal	cachedSpikesAngle

qreal	cs

QString	curveString

qreal	diameter

bool	empty

qreal	fh

qreal	fv

qreal	ratio

qreal	scaleX

qreal	scaleY

qreal	softness

int	spikes

qreal	ss

Type	type

Private Member Functions
qreal	norme (qreal a, qreal b) const

Private Attributes
const QScopedPointer< Private >	d

Friends
struct	FastRowProcessor< KisCircleMaskGenerator >

Additional Inherited Members
Public Types inherited from KisMaskGenerator
enum	Type { CIRCLE , RECTANGLE }

Static Public Member Functions inherited from KisMaskGenerator
static KisMaskGenerator *	fromXML (const QDomElement &)

static QList< KoID >	maskGeneratorIds ()

Protected Member Functions inherited from KisMaskGenerator
qreal	effectiveSrcHeight () const

qreal	effectiveSrcWidth () const

Detailed Description

Create, serialize and deserialize an elliptical 8-bit mask.

Definition at line 22 of file kis_circle_mask_generator.h.

Constructor & Destructor Documentation

◆ KisCircleMaskGenerator() [1/2]

KisCircleMaskGenerator::KisCircleMaskGenerator	(	qreal	radius,
		qreal	ratio,
		qreal	fh,
		qreal	fv,
		int	spikes,
		bool	antialiasEdges )

Definition at line 21 of file kis_circle_mask_generator.cpp.

    : KisMaskGenerator(diameter, ratio, fh, fv, spikes, antialiasEdges, CIRCLE, DefaultId),
      d(new Private)
{
    setScale(1.0, 1.0);
 
    // store the variable locally to allow vector implementation read it easily
    d->copyOfAntialiasEdges = antialiasEdges;
 
    d->applicator.reset(createOptimizedClass<MaskApplicatorFactory<KisCircleMaskGenerator> >(this));
}

References KisMaskGenerator::Private::antialiasEdges, createOptimizedClass(), d, and setScale().

◆ KisCircleMaskGenerator() [2/2]

KisCircleMaskGenerator::KisCircleMaskGenerator ( const KisCircleMaskGenerator & rhs )

Definition at line 33 of file kis_circle_mask_generator.cpp.

    : KisMaskGenerator(rhs),
      d(new Private(*rhs.d))
{
    d->applicator.reset(createOptimizedClass<MaskApplicatorFactory<KisCircleMaskGenerator> >(this));
}

References createOptimizedClass(), and d.

◆ ~KisCircleMaskGenerator()

KisCircleMaskGenerator::~KisCircleMaskGenerator ( )

override

Definition at line 57 of file kis_circle_mask_generator.cpp.

58{

59}

Member Function Documentation

◆ applicator()

KisBrushMaskApplicatorBase * KisCircleMaskGenerator::applicator ( ) const

overridevirtual

Implements KisMaskGenerator.

◆ clone()

KisMaskGenerator * KisCircleMaskGenerator::clone ( ) const

overridevirtual

Implements KisMaskGenerator.

Definition at line 40 of file kis_circle_mask_generator.cpp.

{
    return new KisCircleMaskGenerator(*this);
}

References KisCircleMaskGenerator().

◆ norme()

qreal KisCircleMaskGenerator::norme	(	qreal	a,
		qreal	b ) const

inlineprivate

Definition at line 43 of file kis_circle_mask_generator.h.

                                        {
        return a*a + b * b;
    }

◆ Private() [1/2]

KisCircleMaskGenerator::Private ( )

inline

Definition at line 11 of file kis_circle_mask_generator_p.h.

        : xcoef(0),
        ycoef(0),
        xfadecoef(0),
        yfadecoef(0),
        safeSoftnessCoeff(1.0),
        transformedFadeX(0),
        transformedFadeY(0),
        copyOfAntialiasEdges(false)
    {
    }

◆ Private() [2/2]

KisCircleMaskGenerator::Private ( const Private & rhs )

inline

Definition at line 23 of file kis_circle_mask_generator_p.h.

        : xcoef(rhs.xcoef),
        ycoef(rhs.ycoef),
        xfadecoef(rhs.xfadecoef),
        yfadecoef(rhs.yfadecoef),
        safeSoftnessCoeff(rhs.safeSoftnessCoeff),
        transformedFadeX(rhs.transformedFadeX),
        transformedFadeY(rhs.transformedFadeY),
        copyOfAntialiasEdges(rhs.copyOfAntialiasEdges)
    {
    }

◆ setMaskScalarApplicator()

void KisCircleMaskGenerator::setMaskScalarApplicator ( )

Definition at line 103 of file kis_circle_mask_generator.cpp.

{
    d->applicator.reset(
        createScalarClass<MaskApplicatorFactory<KisCircleMaskGenerator>>(this));
}

References createScalarClass(), and d.

◆ setScale()

void KisCircleMaskGenerator::setScale	(	qreal	scaleX,
		qreal	scaleY )

overridevirtual

Reimplemented from KisMaskGenerator.

Definition at line 45 of file kis_circle_mask_generator.cpp.

{
    KisMaskGenerator::setScale(scaleX, scaleY);
 
    d->xcoef = 2.0 / effectiveSrcWidth();
    d->ycoef = 2.0 / effectiveSrcHeight();
    d->xfadecoef = qFuzzyCompare(horizontalFade(), 0) ? 1 : (2.0 / (horizontalFade() * effectiveSrcWidth()));
    d->yfadecoef = qFuzzyCompare(verticalFade()  , 0) ? 1 : (2.0 / (verticalFade() * effectiveSrcHeight()));
    d->transformedFadeX = d->xfadecoef * d->safeSoftnessCoeff;
    d->transformedFadeY = d->yfadecoef * d->safeSoftnessCoeff;
}

References d, KisMaskGenerator::effectiveSrcHeight(), KisMaskGenerator::effectiveSrcWidth(), KisMaskGenerator::horizontalFade(), qFuzzyCompare(), KisMaskGenerator::Private::scaleX, KisMaskGenerator::Private::scaleY, KisMaskGenerator::setScale(), and KisMaskGenerator::verticalFade().

◆ setSoftness()

void KisCircleMaskGenerator::setSoftness ( qreal softness )

overridevirtual

Reimplemented from KisMaskGenerator.

Definition at line 94 of file kis_circle_mask_generator.cpp.

{
    KisMaskGenerator::setSoftness(softness);
    d->safeSoftnessCoeff = qreal(1.0) / qMax(qreal(0.01), softness);
 
    d->transformedFadeX = d->xfadecoef * d->safeSoftnessCoeff;
    d->transformedFadeY = d->yfadecoef * d->safeSoftnessCoeff;
}

References d, KisMaskGenerator::setSoftness(), and KisMaskGenerator::Private::softness.

◆ shouldVectorize()

bool KisCircleMaskGenerator::shouldVectorize ( ) const

overridevirtual

Reimplemented from KisMaskGenerator.

Definition at line 61 of file kis_circle_mask_generator.cpp.

{
    return !shouldSupersample() && spikes() == 2;
}

References KisMaskGenerator::shouldSupersample(), and KisMaskGenerator::Private::spikes.

◆ valueAt()

quint8 KisCircleMaskGenerator::valueAt	(	qreal	x,
		qreal	y ) const

overridevirtual

Returns: the alpha value at the position (x,y)

Implements KisMaskGenerator.

Definition at line 71 of file kis_circle_mask_generator.cpp.

{
    if (isEmpty()) return 255;
    qreal xr = (x /*- m_xcenter*/);
    qreal yr = qAbs(y /*- m_ycenter*/);
    fixRotation(xr, yr);
 
    qreal n = norme(xr * d->xcoef, yr * d->ycoef);
    if (n > 1.0) return 255;
 
    // we add +1.0 to ensure correct antialiasing on the border
    if (antialiasEdges()) {
        xr = qAbs(xr) + 1.0;
        yr = qAbs(yr) + 1.0;
    }
 
    qreal nf = norme(xr * d->transformedFadeX,
                     yr * d->transformedFadeY);
 
    if (nf < 1.0) return 0;
    return 255 * n * (nf - 1.0) / (nf - n);
}