#include <kis_png_brush.h>

Inheritance diagram for KisPngBrush:

Public Member Functions
KoResourceSP	clone () const override

QString	defaultFileExtension () const override

	KisPngBrush (const KisPngBrush &rhs)

	KisPngBrush (const QString &filename)
	Construct brush to load filename later as brush.

bool	loadFromDevice (QIODevice *dev, KisResourcesInterfaceSP resourcesInterface) override

KisPngBrush &	operator= (const KisPngBrush &rhs)=delete

QPair< QString, QString >	resourceType () const override

bool	saveToDevice (QIODevice *dev) const override

void	toXML (QDomDocument &d, QDomElement &e) const override

Public Member Functions inherited from KisColorfulBrush
qreal	adjustedMidPoint () const

quint8	adjustmentMidPoint () const

bool	autoAdjustMidPoint () const

qreal	brightnessAdjustment () const

QImage	brushTipImage () const override
	brushImage the image the brush tip can paint with. Not all brush types have a single image.

qreal	contrastAdjustment () const

qreal	estimatedSourceMidPoint () const

bool	hasColorAndTransparency () const

virtual bool	isImageType () const

	KisColorfulBrush ()=default

	KisColorfulBrush (const KisColorfulBrush &rhs)=default

	KisColorfulBrush (const QString &filename)

virtual void	setAdjustmentMidPoint (quint8 value)

virtual void	setAutoAdjustMidPoint (bool autoAdjustMidPoint)

virtual void	setBrightnessAdjustment (qreal value)

virtual void	setContrastAdjustment (qreal value)

void	setHasColorAndTransparency (bool value)

Public Member Functions inherited from KisScalingSizeBrush
	KisScalingSizeBrush ()

	KisScalingSizeBrush (const KisScalingSizeBrush &rhs)

	KisScalingSizeBrush (const QString &filename)

void	setUserEffectiveSize (qreal value) override

qreal	userEffectiveSize () const override

Public Member Functions inherited from KisBrush
qreal	angle () const

virtual bool	applyingGradient () const

bool	autoSpacingActive () const

qreal	autoSpacingCoeff () const

virtual enumBrushApplication	brushApplication () const

virtual quint32	brushIndex () const

virtual enumBrushType	brushType () const

virtual bool	canPaintFor (const KisPaintInformation &)

virtual QSizeF	characteristicSize (KisDabShape const &) const

void	clearBrushPyramid ()

virtual void	coldInitBrush ()

virtual void	generateMaskAndApplyMaskOrCreateDab (KisFixedPaintDeviceSP dst, ColoringInformation *coloringInfo, KisDabShape const &, const KisPaintInformation &info, double subPixelX, double subPixelY, qreal softnessFactor, qreal lightnessStrength) const

void	generateMaskAndApplyMaskOrCreateDab (KisFixedPaintDeviceSP dst, ColoringInformation *coloringInfo, KisDabShape const &, const KisPaintInformation &info, double subPixelX=0, double subPixelY=0, qreal softnessFactor=DEFAULT_SOFTNESS_FACTOR) const

qint32	height () const

QPointF	hotSpot (KisDabShape const &, const KisPaintInformation &info) const

virtual bool	isPiercedApprox () const

	KisBrush ()

	KisBrush (const KisBrush &rhs)

	KisBrush (const QString &filename)

virtual void	lodLimitations (KisPaintopLodLimitations *l) const

void	mask (KisFixedPaintDeviceSP dst, const KisPaintDeviceSP src, KisDabShape const &shape, const KisPaintInformation &info, double subPixelX=0, double subPixelY=0, qreal softnessFactor=DEFAULT_SOFTNESS_FACTOR, qreal lightnessStrength=DEFAULT_LIGHTNESS_STRENGTH) const

void	mask (KisFixedPaintDeviceSP dst, const KoColor &color, KisDabShape const &shape, const KisPaintInformation &info, double subPixelX=0, double subPixelY=0, qreal softnessFactor=DEFAULT_SOFTNESS_FACTOR, qreal lightnessStrength=DEFAULT_LIGHTNESS_STRENGTH) const

double	maskAngle (double angle=0) const

virtual qint32	maskHeight (KisDabShape const &, qreal subPixelX, qreal subPixelY, const KisPaintInformation &info) const

virtual qint32	maskWidth (KisDabShape const &, qreal subPixelX, qreal subPixelY, const KisPaintInformation &info) const

virtual void	notifyBrushIsGoingToBeClonedForStroke ()

virtual void	notifyStrokeStarted ()

KisBrush &	operator= (const KisBrush &rhs)=delete

virtual KisOptimizedBrushOutline	outline (bool forcePreciseOutline=false) const

virtual KisFixedPaintDeviceSP	outlineSourceImage () const

virtual KisFixedPaintDeviceSP	paintDevice (const KoColorSpace *colorSpace, KisDabShape const &, const KisPaintInformation &info, double subPixelX=0, double subPixelY=0) const

virtual void	prepareForSeqNo (const KisPaintInformation &info, int seqNo)

virtual bool	preserveLightness () const

qreal	scale () const

virtual void	setAngle (qreal _angle)

void	setAutoSpacing (bool active, qreal coeff)

virtual void	setBrushApplication (enumBrushApplication brushApplication)

virtual void	setBrushTipImage (const QImage &image)

virtual void	setGradient (KoAbstractGradientSP gradient)

virtual void	setScale (qreal _scale)

virtual void	setSpacing (double spacing)

double	spacing () const

virtual bool	supportsCaching () const

qint32	width () const

	~KisBrush () override

Public Member Functions inherited from KoResource
bool	active () const

void	addMetaData (QString key, QVariant value)
	store the given key, value pair in the resource

virtual void	clearSideLoadedResources ()

virtual QList< KoResourceLoadResult >	embeddedResources (KisResourcesInterfaceSP globalResourcesInterface) const

QString	filename () const

QImage	image () const

bool	isDirty () const

virtual bool	isEphemeral () const

virtual bool	isSerializable () const

	KoResource ()

	KoResource (const KoResource &rhs)

	KoResource (const QString &filename)

virtual QList< KoResourceLoadResult >	linkedResources (KisResourcesInterfaceSP globalResourcesInterface) const

bool	load (KisResourcesInterfaceSP resourcesInterface)

QString	md5Sum (bool generateIfEmpty=true) const

QMap< QString, QVariant >	metadata () const
	get a map with all the metadata

virtual QString	name () const

KoResource &	operator= (const KoResource &rhs)=delete

bool	permanent () const

virtual QList< int >	requiredCanvasResources () const

QList< KoResourceLoadResult >	requiredResources (KisResourcesInterfaceSP globalResourcesInterface) const

int	resourceId () const

bool	save ()

void	setActive (bool active)

void	setDirty (bool value)
	Mark the preset as modified but not saved.

void	setFilename (const QString &filename)

void	setImage (const QImage &image)

void	setMD5Sum (const QString &md5sum)
	Set the md5sum of this resource. It must be in hex-encoded string format.

void	setName (const QString &name)

void	setPermanent (bool permanent)

void	setResourceId (int id)

void	setStorageLocation (const QString &location)

void	setValid (bool valid)

void	setVersion (int version)

virtual QList< KoResourceLoadResult >	sideLoadedResources (KisResourcesInterfaceSP globalResourcesInterface) const

KoResourceSignature	signature () const

QString	storageLocation () const

QList< KoResourceLoadResult >	takeSideLoadedResources (KisResourcesInterfaceSP globalResourcesInterface)

virtual QImage	thumbnail () const
	thumbnail the thumbnail image to use in resource selectors

virtual QString	thumbnailPath () const
	thumbnailPath returns the path to a separate thumbnail image, outside the actual resource file itself. If the path is relative, it is supposed start in the same location as the resource itself. If it's absolute, that is, it starts with "/", it is from the root of the storage.

virtual void	updateThumbnail ()
	updateThumbnail updates the thumbnail for this resource. Reimplement if your thumbnail is something else than the image set with setImage.

bool	valid () const

int	version () const
	Get the version of the resource.

virtual	~KoResource ()

Public Member Functions inherited from Private
	Private (KisCanvas2 *c)

Additional Inherited Members
Static Public Member Functions inherited from KisBrush
static KisBrushSP	fromXML (const QDomElement &element, KisResourcesInterfaceSP resourcesInterface)

static KoResourceLoadResult	fromXMLLoadResult (const QDomElement &element, KisResourcesInterfaceSP resourcesInterface)

Public Attributes inherited from KoResource
bool	active {true}

QString	filename

QImage	image

QString	md5sum

QMap< QString, QVariant >	metadata

bool	modified {false}

QString	name

bool	permanent {false}

int	resourceId {-1}

QString	storageLocation

bool	valid {false}

int	version {-1}

Public Attributes inherited from Private
KisCanvas2 *	canvas

int	displayedFrame

int	intendedFrame

Static Public Attributes inherited from KisBrush
static const QString	brushTypeMetaDataKey = "image-based-brush"

Protected Member Functions inherited from KisBrush
void	generateOutlineCache ()

bool	outlineCacheIsValid () const

void	predefinedBrushToXML (const QString &type, QDomElement &e) const

void	resetOutlineCache ()

virtual void	setBrushType (enumBrushType type)

void	setHeight (qint32 height)

void	setHotSpot (QPointF)

void	setWidth (qint32 width)

Detailed Description

Definition at line 12 of file kis_png_brush.h.

Constructor & Destructor Documentation

◆ KisPngBrush() [1/2]

KisPngBrush::KisPngBrush ( const QString & filename )

Construct brush to load filename later as brush.

Definition at line 18 of file kis_png_brush.cpp.

    : KisColorfulBrush(filename)
{
    setBrushType(INVALID);
    setSpacing(0.25);
}

References INVALID, KisBrush::setBrushType(), and KisBrush::setSpacing().

◆ KisPngBrush() [2/2]

KisPngBrush::KisPngBrush ( const KisPngBrush & rhs )

Definition at line 25 of file kis_png_brush.cpp.

    : KisColorfulBrush(rhs)
{
}

Member Function Documentation

◆ clone()

KoResourceSP KisPngBrush::clone ( ) const

overridevirtual

Implements KoResource.

Definition at line 30 of file kis_png_brush.cpp.

{
    return KoResourceSP(new KisPngBrush(*this));
}

References KisPngBrush().

◆ defaultFileExtension()

QString KisPngBrush::defaultFileExtension ( ) const

overridevirtual

Returns: the default file extension which should be used when saving the resource

Reimplemented from KoResource.

Definition at line 130 of file kis_png_brush.cpp.

{
    return QString(".png");
}

◆ loadFromDevice()

bool KisPngBrush::loadFromDevice	(	QIODevice *	dev,
		KisResourcesInterfaceSP	resourcesInterface )

overridevirtual

Implements KoResource.

Definition at line 35 of file kis_png_brush.cpp.

{
    Q_UNUSED(resourcesInterface);
 
    // Workaround for some OS (Debian, Ubuntu), where loading directly from the QIODevice
    // fails with "libpng error: IDAT: CRC error"
    QByteArray data = dev->readAll();
    QBuffer buf(&data);
    buf.open(QIODevice::ReadOnly);
    QImageReader reader(&buf, "PNG");
 
    if (!reader.canRead()) {
        dbgKrita << "Could not read brush" << filename() << ". Error:" << reader.errorString();
        setValid(false);
        return false;
    }
 
    if (reader.textKeys().contains("brush_spacing")) {
        setSpacing(KisDomUtils::toDouble(reader.text("brush_spacing")));
    }
 
    if (reader.textKeys().contains("brush_name")) {
        setName(reader.text("brush_name"));
    }
    else {
        QFileInfo info(filename());
        setName(info.completeBaseName());
    }
 
    QImage image = reader.read();
 
    if (image.isNull()) {
        dbgKrita << "Could not create image for" << filename() << ". Error:" << reader.errorString();
        setValid(false);
        return false;
    }
 
    setValid(true);
 
    bool hasAlpha = false;
    for (int y = 0; y < image.height(); y++) {
        for (int x = 0; x < image.width(); x++) {
            if (qAlpha(image.pixel(x, y)) != 255) {
                hasAlpha = true;
                break;
            }
        }
    }
 
    const bool isAllGray = image.allGray();
 
    if (isAllGray && !hasAlpha) {
        // Make sure brush tips all have a white background
        // NOTE: drawing it over white background can probably be skipped now...
        //       Any images with an Alpha channel should be loaded as RGBA so
        //       they can have the lightness and gradient options available
        QImage base(image.size(), image.format());
        if ((int)base.format() < (int)QImage::Format_RGB32) {
            base.convertTo(QImage::Format_ARGB32);
        }
        QPainter gc(&base);
        gc.fillRect(base.rect(), Qt::white);
        gc.drawImage(0, 0, image);
        gc.end();
        QImage converted = base.convertToFormat(QImage::Format_Grayscale8);
        setBrushTipImage(converted);
        setBrushType(MASK);
        setBrushApplication(ALPHAMASK);
        setHasColorAndTransparency(false);
    }
    else {
        // see bug https://bugs.kde.org/show_bug.cgi?id=484115 if you want to edit this condition
        // keep it in sync with KisColorfulBrush code
        if ((int)image.format() != (int)QImage::Format_ARGB32) {
            image.convertTo(QImage::Format_ARGB32);
        }
 
        setBrushTipImage(image);
        setBrushType(IMAGE);
        setBrushApplication(isAllGray ? ALPHAMASK : LIGHTNESSMAP);
        setHasColorAndTransparency(!isAllGray);
    }
 
 
    setWidth(brushTipImage().width());
    setHeight(brushTipImage().height());
 
    return valid();
}

References ALPHAMASK, KisColorfulBrush::brushTipImage(), dbgKrita, KoResource::filename, KisBrush::height(), IMAGE, KoResource::image, LIGHTNESSMAP, MASK, KisBrush::setBrushApplication(), KisBrush::setBrushTipImage(), KisBrush::setBrushType(), KisColorfulBrush::setHasColorAndTransparency(), KisBrush::setHeight(), KoResource::setName(), KisBrush::setSpacing(), KoResource::setValid(), KisBrush::setWidth(), KisDomUtils::toDouble(), KoResource::valid, and KisBrush::width().

◆ operator=()

KisPngBrush & KisPngBrush::operator= ( const KisPngBrush & rhs )

delete

◆ resourceType()

QPair< QString, QString > KisPngBrush::resourceType ( ) const

inlineoverridevirtual

Returns: the resource type

Reimplemented from KisBrush.

Definition at line 27 of file kis_png_brush.h.

                                                          {
        return QPair<QString, QString>(ResourceType::Brushes, ResourceSubType::PngBrushes);
    }

References ResourceType::Brushes, and ResourceSubType::PngBrushes.

◆ saveToDevice()

bool KisPngBrush::saveToDevice ( QIODevice * dev ) const

overridevirtual

Reimplemented from KoResource.

Definition at line 125 of file kis_png_brush.cpp.

{
    return brushTipImage().save(dev, "PNG");
}

References KisColorfulBrush::brushTipImage().

◆ toXML()

void KisPngBrush::toXML	(	QDomDocument &	,
		QDomElement &	element ) const

overridevirtual

Serialize this brush to XML.

Reimplemented from KisColorfulBrush.

Definition at line 135 of file kis_png_brush.cpp.

{
    predefinedBrushToXML("png_brush", e);
    KisColorfulBrush::toXML(d, e);
}

References KisBrush::d, KisBrush::predefinedBrushToXML(), and KisColorfulBrush::toXML().

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

libs/brush/kis_png_brush.h
libs/brush/kis_png_brush.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ KisPngBrush() [1/2]

◆ KisPngBrush() [2/2]

Member Function Documentation

◆ clone()

◆ defaultFileExtension()

◆ loadFromDevice()

◆ operator=()

◆ resourceType()

◆ saveToDevice()

◆ toXML()