#include <SkPaint.h>

Public Types
enum	Style : uint8_t { kFill_Style , kStroke_Style , kStrokeAndFill_Style }

enum	Cap { kButt_Cap , kRound_Cap , kSquare_Cap , kLast_Cap = kSquare_Cap , kDefault_Cap = kButt_Cap }

enum	Join : uint8_t { kMiter_Join , kRound_Join , kBevel_Join , kLast_Join = kBevel_Join , kDefault_Join = kMiter_Join }

using	sk_is_trivially_relocatable = std::true_type

Public Member Functions
	SkPaint ()

	SkPaint (const SkColor4f &color, SkColorSpace *colorSpace=nullptr)

	SkPaint (const SkPaint &paint)

	SkPaint (SkPaint &&paint)

	~SkPaint ()

SkPaint &	operator= (const SkPaint &paint)

SkPaint &	operator= (SkPaint &&paint)

void	reset ()

bool	isAntiAlias () const

void	setAntiAlias (bool aa)

bool	isDither () const

void	setDither (bool dither)

Style	getStyle () const

void	setStyle (Style style)

void	setStroke (bool)

SkColor	getColor () const

SkColor4f	getColor4f () const

void	setColor (SkColor color)

void	setColor (const SkColor4f &color, SkColorSpace *colorSpace=nullptr)

void	setColor4f (const SkColor4f &color, SkColorSpace *colorSpace=nullptr)

float	getAlphaf () const

uint8_t	getAlpha () const

void	setAlphaf (float a)

void	setAlpha (U8CPU a)

void	setARGB (U8CPU a, U8CPU r, U8CPU g, U8CPU b)

SkScalar	getStrokeWidth () const

void	setStrokeWidth (SkScalar width)

SkScalar	getStrokeMiter () const

void	setStrokeMiter (SkScalar miter)

Cap	getStrokeCap () const

void	setStrokeCap (Cap cap)

Join	getStrokeJoin () const

void	setStrokeJoin (Join join)

SkShader *	getShader () const

sk_sp< SkShader >	refShader () const

void	setShader (sk_sp< SkShader > shader)

SkColorFilter *	getColorFilter () const

sk_sp< SkColorFilter >	refColorFilter () const

void	setColorFilter (sk_sp< SkColorFilter > colorFilter)

std::optional< SkBlendMode >	asBlendMode () const

SkBlendMode	getBlendMode_or (SkBlendMode defaultMode) const

bool	isSrcOver () const

void	setBlendMode (SkBlendMode mode)

SkBlender *	getBlender () const

sk_sp< SkBlender >	refBlender () const

void	setBlender (sk_sp< SkBlender > blender)

SkPathEffect *	getPathEffect () const

sk_sp< SkPathEffect >	refPathEffect () const

void	setPathEffect (sk_sp< SkPathEffect > pathEffect)

SkMaskFilter *	getMaskFilter () const

sk_sp< SkMaskFilter >	refMaskFilter () const

void	setMaskFilter (sk_sp< SkMaskFilter > maskFilter)

SkImageFilter *	getImageFilter () const

sk_sp< SkImageFilter >	refImageFilter () const

void	setImageFilter (sk_sp< SkImageFilter > imageFilter)

bool	nothingToDraw () const

bool	canComputeFastBounds () const

const SkRect &	computeFastBounds (const SkRect &orig, SkRect *storage) const

const SkRect &	computeFastStrokeBounds (const SkRect &orig, SkRect *storage) const

const SkRect &	doComputeFastBounds (const SkRect &orig, SkRect *storage, Style style) const

Static Public Attributes
static constexpr int	kStyleCount = kStrokeAndFill_Style + 1

static constexpr int	kCapCount = kLast_Cap + 1

static constexpr int	kJoinCount = kLast_Join + 1

Friends
class	SkPaintPriv

SK_API friend bool	operator== (const SkPaint &a, const SkPaint &b)

bool	operator!= (const SkPaint &a, const SkPaint &b)

Detailed Description

SkPaint controls options applied when drawing. SkPaint collects all options outside of the SkCanvas clip and SkCanvas matrix.

Various options apply to strokes and fills, and images.

SkPaint collects effects and filters that describe single-pass and multiple-pass algorithms that alter the drawing geometry, color, and transparency. For instance, SkPaint does not directly implement dashing or blur, but contains the objects that do so.

Definition at line 44 of file SkPaint.h.

Member Typedef Documentation

◆ sk_is_trivially_relocatable

using SkPaint::sk_is_trivially_relocatable = std::true_type

Definition at line 658 of file SkPaint.h.

Member Enumeration Documentation

◆ Cap

enum SkPaint::Cap

Enumerator
kButt_Cap	no stroke extension
kRound_Cap	adds circle
kSquare_Cap	adds square
kLast_Cap	largest Cap value
kDefault_Cap	equivalent to kButt_Cap

Definition at line 333 of file SkPaint.h.

             {
        kButt_Cap,                  //!< no stroke extension
        kRound_Cap,                 //!< adds circle
        kSquare_Cap,                //!< adds square
        kLast_Cap    = kSquare_Cap, //!< largest Cap value
        kDefault_Cap = kButt_Cap,   //!< equivalent to kButt_Cap
    };

◆ Join

enum SkPaint::Join : uint8_t

Enumerator
kMiter_Join	extends to miter limit
kRound_Join	adds circle
kBevel_Join	connects outside edges
kLast_Join	equivalent to the largest value for Join
kDefault_Join	equivalent to kMiter_Join

Definition at line 358 of file SkPaint.h.

              : uint8_t {
        kMiter_Join,                 //!< extends to miter limit
        kRound_Join,                 //!< adds circle
        kBevel_Join,                 //!< connects outside edges
        kLast_Join    = kBevel_Join, //!< equivalent to the largest value for Join
        kDefault_Join = kMiter_Join, //!< equivalent to kMiter_Join
    };

◆ Style

enum SkPaint::Style : uint8_t

Enumerator
kFill_Style	set to fill geometry
kStroke_Style	set to stroke geometry
kStrokeAndFill_Style	sets to stroke and fill geometry

Definition at line 192 of file SkPaint.h.

               : uint8_t {
        kFill_Style,          //!< set to fill geometry
        kStroke_Style,        //!< set to stroke geometry
        kStrokeAndFill_Style, //!< sets to stroke and fill geometry
    };

Constructor & Destructor Documentation

◆ SkPaint() [1/4]

SkPaint::SkPaint ( )

Constructs SkPaint with default values.

Returns: default initialized SkPaint

example: https://fiddle.skia.org/c/@Paint_empty_constructor

Definition at line 38 of file SkPaint.cpp.

    : fColor4f{0, 0, 0, 1}  // opaque black
    , fWidth{0}
    , fMiterLimit{SkPaintDefaults_MiterLimit}
    , fBitfields{(unsigned)false,                   // fAntiAlias
                 (unsigned)false,                   // fDither
                 (unsigned)SkPaint::kDefault_Cap,   // fCapType
                 (unsigned)SkPaint::kDefault_Join,  // fJoinType
                 (unsigned)SkPaint::kFill_Style,    // fStyle
                 0}                                 // fPadding
{
    static_assert(sizeof(fBitfields) == sizeof(fBitfieldsUInt), "");
}

◆ SkPaint() [2/4]

SkPaint::SkPaint	(	const SkColor4f &	color,
		SkColorSpace *	colorSpace = `nullptr`
	)

explicit

Constructs SkPaint with default values and the given color.

Sets alpha and RGB used when stroking and filling. The color is four floating point values, unpremultiplied. The color values are interpreted as being in the colorSpace. If colorSpace is nullptr, then color is assumed to be in the sRGB color space.

Parameters

color	unpremultiplied RGBA
colorSpace	SkColorSpace describing the encoding of color

Returns: SkPaint with the given color

Definition at line 52 of file SkPaint.cpp.

                                                                 : SkPaint() {
    this->setColor(color, colorSpace);
}

◆ SkPaint() [3/4]

SkPaint::SkPaint ( const SkPaint & paint )

default

Makes a shallow copy of SkPaint. SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, and SkImageFilter are shared between the original paint and the copy. Objects containing SkRefCnt increment their references by one.

The referenced objects SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, and SkImageFilter cannot be modified after they are created. This prevents objects with SkRefCnt from being modified once SkPaint refers to them.

Parameters

paint original to copy

Returns: shallow copy of paint

example: https://fiddle.skia.org/c/@Paint_copy_const_SkPaint

◆ SkPaint() [4/4]

SkPaint::SkPaint ( SkPaint && paint )

default

Implements a move constructor to avoid increasing the reference counts of objects referenced by the paint.

After the call, paint is undefined, and can be safely destructed.

Parameters

paint original to move

Returns: content of paint

example: https://fiddle.skia.org/c/@Paint_move_SkPaint

◆ ~SkPaint()

SkPaint::~SkPaint ( )

default

Decreases SkPaint SkRefCnt of owned objects: SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, and SkImageFilter. If the objects containing SkRefCnt go to zero, they are deleted.

Member Function Documentation

◆ asBlendMode()

std::optional< SkBlendMode > SkPaint::asBlendMode ( ) const

If the current blender can be represented as a SkBlendMode enum, this returns that enum in the optional's value(). If it cannot, then the returned optional does not contain a value.

Definition at line 138 of file SkPaint.cpp.

                                                    {
    return fBlender ? as_BB(fBlender)->asBlendMode()
                    : SkBlendMode::kSrcOver;
}

◆ canComputeFastBounds()

bool SkPaint::canComputeFastBounds ( ) const

(to be made private) Returns true if SkPaint does not include elements requiring extensive computation to compute device bounds of drawn geometry. For instance, SkPaint with SkPathEffect always returns false.

Returns: true if SkPaint allows for fast computation of bounds

Definition at line 201 of file SkPaint.cpp.

                                         {
    if (this->getImageFilter() && !this->getImageFilter()->canComputeFastBounds()) {
        return false;
    }
    // Pass nullptr for the bounds to determine if they can be computed
    if (this->getPathEffect() &&
        !as_PEB(this->getPathEffect())->computeFastBounds(nullptr)) {
        return false;
    }
    return true;
}

◆ computeFastBounds()

const SkRect & SkPaint::computeFastBounds	(	const SkRect &	orig,
		SkRect *	storage
	)		const

(to be made private) Only call this if canComputeFastBounds() returned true. This takes a raw rectangle (the raw bounds of a shape), and adjusts it for stylistic effects in the paint (e.g. stroking). If needed, it uses the storage parameter. It returns the adjusted bounds that can then be used for SkCanvas::quickReject tests.

The returned SkRect will either be orig or storage, thus the caller should not rely on storage being set to the result, but should always use the returned value. It is legal for orig and storage to be the same SkRect. For example: if (!path.isInverseFillType() && paint.canComputeFastBounds()) { SkRect storage; if (canvas->quickReject(paint.computeFastBounds(path.getBounds(), &storage))) { return; // do not draw the path } } draw the path

    @param orig     geometry modified by SkPaint when drawn
    @param storage  computed bounds of geometry; may not be nullptr
    @return         fast computed bounds

Definition at line 213 of file SkPaint.cpp.

                                                                                  {
    // Things like stroking, etc... will do math on the bounds rect, assuming that it's sorted.
    SkASSERT(orig.isSorted());
    SkPaint::Style style = this->getStyle();
    // ultra fast-case: filling with no effects that affect geometry
    if (kFill_Style == style) {
        uintptr_t effects = 0;
        effects |= reinterpret_cast<uintptr_t>(this->getMaskFilter());
        effects |= reinterpret_cast<uintptr_t>(this->getPathEffect());
        effects |= reinterpret_cast<uintptr_t>(this->getImageFilter());
        if (!effects) {
            return orig;
        }
    }
 
    return this->doComputeFastBounds(orig, storage, style);
}

◆ computeFastStrokeBounds()

const SkRect & SkPaint::computeFastStrokeBounds	(	const SkRect &	orig,
		SkRect *	storage
	)		const

inline

(to be made private)

Parameters

orig	geometry modified by SkPaint when drawn
storage	computed bounds of geometry

Returns: fast computed bounds

Definition at line 640 of file SkPaint.h.

                                                                 {
        return this->doComputeFastBounds(orig, storage, kStroke_Style);
    }

◆ doComputeFastBounds()

const SkRect & SkPaint::doComputeFastBounds	(	const SkRect &	orig,
		SkRect *	storage,
		Style	style
	)		const

(to be made private) Computes the bounds, overriding the SkPaint SkPaint::Style. This can be used to account for additional width required by stroking orig, without altering SkPaint::Style set to fill.

Parameters

orig	geometry modified by SkPaint when drawn
storage	computed bounds of geometry
style	overrides SkPaint::Style

Returns: fast computed bounds

Definition at line 231 of file SkPaint.cpp.

                                                              {
    SkASSERT(storage);
 
    const SkRect* src = &origSrc;
 
    SkRect tmpSrc;
    if (this->getPathEffect()) {
        tmpSrc = origSrc;
        SkAssertResult(as_PEB(this->getPathEffect())->computeFastBounds(&tmpSrc));
        src = &tmpSrc;
    }
 
    SkScalar radius = SkStrokeRec::GetInflationRadius(*this, style);
    *storage = src->makeOutset(radius, radius);
 
    if (this->getMaskFilter()) {
        as_MFB(this->getMaskFilter())->computeFastBounds(*storage, storage);
    }
 
    if (this->getImageFilter()) {
        *storage = this->getImageFilter()->computeFastBounds(*storage);
    }
 
    return *storage;
}

◆ getAlpha()

uint8_t SkPaint::getAlpha ( ) const

inline

Definition at line 264 of file SkPaint.h.

                             {
        return static_cast<uint8_t>(sk_float_round2int(this->getAlphaf() * 255));
    }

◆ getAlphaf()

float SkPaint::getAlphaf ( ) const

inline

Retrieves alpha from the color used when stroking and filling.

Returns: alpha ranging from zero, fully transparent, to one, fully opaque

Definition at line 261 of file SkPaint.h.

261{ return fColor4f.fA; }

◆ getBlender()

SkBlender * SkPaint::getBlender ( ) const

inline

Returns the user-supplied blend function, if one has been set. Does not alter SkBlender's SkRefCnt.

A nullptr blender signifies the default SrcOver behavior.

Returns: the SkBlender assigned to this paint, otherwise nullptr

Definition at line 480 of file SkPaint.h.

480{ return fBlender.get(); }

sk_sp::get

T * get() const

Definition: SkRefCnt.h:303

◆ getBlendMode_or()

SkBlendMode SkPaint::getBlendMode_or ( SkBlendMode defaultMode ) const

Queries the blender, and if it can be represented as a SkBlendMode, return that mode, else return the defaultMode provided.

Definition at line 143 of file SkPaint.cpp.

                                                                  {
    return this->asBlendMode().value_or(defaultMode);
}

◆ getColor()

SkColor SkPaint::getColor ( ) const

inline

Retrieves alpha and RGB, unpremultiplied, packed into 32 bits. Use helpers SkColorGetA(), SkColorGetR(), SkColorGetG(), and SkColorGetB() to extract a color component.

Returns: unpremultiplied ARGB

Definition at line 225 of file SkPaint.h.

225{ return fColor4f.toSkColor(); }

◆ getColor4f()

SkColor4f SkPaint::getColor4f ( ) const

inline

Retrieves alpha and RGB, unpremultiplied, as four floating point values. RGB are extended sRGB values (sRGB gamut, and encoded with the sRGB transfer function).

Returns: unpremultiplied RGBA

Definition at line 232 of file SkPaint.h.

232{ return fColor4f; }

◆ getColorFilter()

SkColorFilter * SkPaint::getColorFilter ( ) const

inline

Returns SkColorFilter if set, or nullptr. Does not alter SkColorFilter SkRefCnt.

Returns: SkColorFilter if previously set, nullptr otherwise

Definition at line 426 of file SkPaint.h.

426{ return fColorFilter.get(); }

◆ getImageFilter()

SkImageFilter * SkPaint::getImageFilter ( ) const

inline

Returns SkImageFilter if set, or nullptr. Does not alter SkImageFilter SkRefCnt.

Returns: SkImageFilter if previously set, nullptr otherwise

Definition at line 564 of file SkPaint.h.

564{ return fImageFilter.get(); }

◆ getMaskFilter()

SkMaskFilter * SkPaint::getMaskFilter ( ) const

inline

Returns SkMaskFilter if set, or nullptr. Does not alter SkMaskFilter SkRefCnt.

Returns: SkMaskFilter if previously set, nullptr otherwise

Definition at line 534 of file SkPaint.h.

534{ return fMaskFilter.get(); }

◆ getPathEffect()

SkPathEffect * SkPaint::getPathEffect ( ) const

inline

Returns SkPathEffect if set, or nullptr. Does not alter SkPathEffect SkRefCnt.

Returns: SkPathEffect if previously set, nullptr otherwise

Definition at line 506 of file SkPaint.h.

506{ return fPathEffect.get(); }

◆ getShader()

SkShader * SkPaint::getShader ( ) const

inline

Returns optional colors used when filling a path, such as a gradient.

Does not alter SkShader SkRefCnt.

Returns: SkShader if previously set, nullptr otherwise

Definition at line 397 of file SkPaint.h.

397{ return fShader.get(); }

◆ getStrokeCap()

Cap SkPaint::getStrokeCap ( ) const

inline

Returns the geometry drawn at the beginning and end of strokes.

Definition at line 372 of file SkPaint.h.

372{ return (Cap)fBitfields.fCapType; }

SkPaint::Cap

Cap

Definition: SkPaint.h:333

◆ getStrokeJoin()

Join SkPaint::getStrokeJoin ( ) const

inline

Returns the geometry drawn at the corners of strokes.

Definition at line 383 of file SkPaint.h.

383{ return (Join)fBitfields.fJoinType; }

SkPaint::Join

Join

Definition: SkPaint.h:358

◆ getStrokeMiter()

SkScalar SkPaint::getStrokeMiter ( ) const

inline

Returns the limit at which a sharp corner is drawn beveled.

Returns: zero and greater miter limit

Definition at line 318 of file SkPaint.h.

318{ return fMiterLimit; }

◆ getStrokeWidth()

SkScalar SkPaint::getStrokeWidth ( ) const

inline

Returns the thickness of the pen used by SkPaint to outline the shape.

Returns: zero for hairline, greater than zero for pen thickness

Definition at line 300 of file SkPaint.h.

300{ return fWidth; }

◆ getStyle()

Style SkPaint::getStyle ( ) const

inline

Returns whether the geometry is filled, stroked, or filled and stroked.

Definition at line 204 of file SkPaint.h.

204{ return (Style)fBitfields.fStyle; }

◆ isAntiAlias()

bool SkPaint::isAntiAlias ( ) const

inline

Returns true if pixels on the active edges of SkPath may be drawn with partial transparency.

Returns: antialiasing state

Definition at line 162 of file SkPaint.h.

                             {
        return SkToBool(fBitfields.fAntiAlias);
    }

◆ isDither()

bool SkPaint::isDither ( ) const

inline

Returns true if color error may be distributed to smooth color transition.

Returns: dithering state

Definition at line 175 of file SkPaint.h.

                          {
        return SkToBool(fBitfields.fDither);
    }

◆ isSrcOver()

bool SkPaint::isSrcOver ( ) const

Returns true iff the current blender claims to be equivalent to SkBlendMode::kSrcOver.

Also returns true of the current blender is nullptr.

Definition at line 147 of file SkPaint.cpp.

                              {
    return !fBlender || as_BB(fBlender)->asBlendMode() == SkBlendMode::kSrcOver;
}

◆ nothingToDraw()

bool SkPaint::nothingToDraw ( ) const

Returns true if SkPaint prevents all drawing; otherwise, the SkPaint may or may not allow drawing.

Returns true if, for example, SkBlendMode combined with alpha computes a new alpha of zero.

Returns: true if SkPaint prevents all drawing

example: https://fiddle.skia.org/c/@Paint_nothingToDraw

Definition at line 273 of file SkPaint.cpp.

                                  {
    auto bm = this->asBlendMode();
    if (!bm) {
        return false;
    }
    switch (bm.value()) {
        case SkBlendMode::kSrcOver:
        case SkBlendMode::kSrcATop:
        case SkBlendMode::kDstOut:
        case SkBlendMode::kDstOver:
        case SkBlendMode::kPlus:
            if (0 == this->getAlpha()) {
                return !affects_alpha(fColorFilter.get()) && !affects_alpha(fImageFilter.get());
            }
            break;
        case SkBlendMode::kDst:
            return true;
        default:
            break;
    }
    return false;
}

◆ operator=() [1/2]

SkPaint & SkPaint::operator= ( const SkPaint & paint )

default

Makes a shallow copy of SkPaint. SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, and SkImageFilter are shared between the original paint and the copy. Objects containing SkRefCnt in the prior destination are decreased by one, and the referenced objects are deleted if the resulting count is zero. Objects containing SkRefCnt in the parameter paint are increased by one. paint is unmodified.

Parameters

paint original to copy

Returns: content of paint

example: https://fiddle.skia.org/c/@Paint_copy_operator

◆ operator=() [2/2]

SkPaint & SkPaint::operator= ( SkPaint && paint )

default

Moves the paint to avoid increasing the reference counts of objects referenced by the paint parameter. Objects containing SkRefCnt in the prior destination are decreased by one; those objects are deleted if the resulting count is zero.

After the call, paint is undefined, and can be safely destructed.

Parameters

paint original to move

Returns: content of paint

example: https://fiddle.skia.org/c/@Paint_move_operator

◆ refBlender()

sk_sp< SkBlender > SkPaint::refBlender ( ) const

Returns the user-supplied blend function, if one has been set. Increments the SkBlender's SkRefCnt by one.

A nullptr blender signifies the default SrcOver behavior.

Returns: the SkBlender assigned to this paint, otherwise nullptr

◆ refColorFilter()

sk_sp< SkColorFilter > SkPaint::refColorFilter ( ) const

Returns SkColorFilter if set, or nullptr. Increases SkColorFilter SkRefCnt by one.

Returns: SkColorFilter if set, or nullptr

example: https://fiddle.skia.org/c/@Paint_refColorFilter

◆ refImageFilter()

sk_sp< SkImageFilter > SkPaint::refImageFilter ( ) const

Returns SkImageFilter if set, or nullptr. Increases SkImageFilter SkRefCnt by one.

Returns: SkImageFilter if previously set, nullptr otherwise

example: https://fiddle.skia.org/c/@Paint_refImageFilter

◆ refMaskFilter()

sk_sp< SkMaskFilter > SkPaint::refMaskFilter ( ) const

Returns SkMaskFilter if set, or nullptr.

Increases SkMaskFilter SkRefCnt by one.

Returns: SkMaskFilter if previously set, nullptr otherwise

example: https://fiddle.skia.org/c/@Paint_refMaskFilter

◆ refPathEffect()

sk_sp< SkPathEffect > SkPaint::refPathEffect ( ) const

Returns SkPathEffect if set, or nullptr. Increases SkPathEffect SkRefCnt by one.

Returns: SkPathEffect if previously set, nullptr otherwise

example: https://fiddle.skia.org/c/@Paint_refPathEffect

◆ refShader()

sk_sp< SkShader > SkPaint::refShader ( ) const

Returns optional colors used when filling a path, such as a gradient.

Increases SkShader SkRefCnt by one.

Returns: SkShader if previously set, nullptr otherwise

example: https://fiddle.skia.org/c/@Paint_refShader

◆ reset()

void SkPaint::reset ( )

Sets all SkPaint contents to their initial values. This is equivalent to replacing SkPaint with the result of SkPaint().

example: https://fiddle.skia.org/c/@Paint_reset

Definition at line 103 of file SkPaint.cpp.

103{ *this = SkPaint(); }

◆ setAlpha()

void SkPaint::setAlpha ( U8CPU a )

inline

Definition at line 279 of file SkPaint.h.

                           {
        this->setAlphaf(a * (1.0f / 255));
    }

◆ setAlphaf()

void SkPaint::setAlphaf ( float a )

Replaces alpha, leaving RGB unchanged. An out of range value triggers an assert in the debug build. a is a value from 0.0 to 1.0. a set to zero makes color fully transparent; a set to 1.0 makes color fully opaque.

Parameters

a	alpha component of color

Definition at line 130 of file SkPaint.cpp.

                               {
    fColor4f.fA = SkTPin(a, 0.0f, 1.0f);
}

◆ setAntiAlias()

void SkPaint::setAntiAlias ( bool aa )

inline

Requests, but does not require, that edge pixels draw opaque or with partial transparency.

Parameters

aa	setting for antialiasing

Definition at line 170 of file SkPaint.h.

170{ fBitfields.fAntiAlias = static_cast<unsigned>(aa); }

◆ setARGB()

void SkPaint::setARGB	(	U8CPU	a,
		U8CPU	r,
		U8CPU	g,
		U8CPU	b
	)

Sets color used when drawing solid fills. The color components range from 0 to 255. The color is unpremultiplied; alpha sets the transparency independent of RGB.

Parameters

a	amount of alpha, from fully transparent (0) to fully opaque (255)
r	amount of red, from no red (0) to full red (255)
g	amount of green, from no green (0) to full green (255)
b	amount of blue, from no blue (0) to full blue (255)

example: https://fiddle.skia.org/c/@Paint_setARGB

Definition at line 134 of file SkPaint.cpp.

                                                        {
    this->setColor(SkColorSetARGB(a, r, g, b));
}

◆ setBlender()

void SkPaint::setBlender ( sk_sp< SkBlender > blender )

Sets the current blender, increasing its refcnt, and if a blender is already present, decreasing that object's refcnt.

A nullptr blender signifies the default SrcOver behavior.

For convenience, you can call setBlendMode() if the blend effect can be expressed as one of those values.

Definition at line 155 of file SkPaint.cpp.

                                                 {
    fBlender = std::move(blender);
}

◆ setBlendMode()

void SkPaint::setBlendMode ( SkBlendMode mode )

Helper method for calling setBlender().

This sets a blender that implements the specified blendmode enum.

Definition at line 151 of file SkPaint.cpp.

                                           {
    this->setBlender(mode == SkBlendMode::kSrcOver ? nullptr : SkBlender::Mode(mode));
}

◆ setColor() [1/2]

void SkPaint::setColor	(	const SkColor4f &	color,
		SkColorSpace *	colorSpace = `nullptr`
	)

Sets alpha and RGB used when stroking and filling. The color is four floating point values, unpremultiplied. The color values are interpreted as being in the colorSpace. If colorSpace is nullptr, then color is assumed to be in the sRGB color space.

Parameters

color	unpremultiplied RGBA
colorSpace	SkColorSpace describing the encoding of color

Definition at line 123 of file SkPaint.cpp.

                                                                       {
    SkColorSpaceXformSteps steps{colorSpace,          kUnpremul_SkAlphaType,
                                 sk_srgb_singleton(), kUnpremul_SkAlphaType};
    fColor4f = {color.fR, color.fG, color.fB, SkTPin(color.fA, 0.0f, 1.0f)};
    steps.apply(fColor4f.vec());
}

◆ setColor() [2/2]

void SkPaint::setColor ( SkColor color )

Sets alpha and RGB used when stroking and filling. The color is a 32-bit value, unpremultiplied, packing 8-bit components for alpha, red, blue, and green.

Parameters

color unpremultiplied ARGB

example: https://fiddle.skia.org/c/@Paint_setColor

Definition at line 119 of file SkPaint.cpp.

                                    {
    fColor4f = SkColor4f::FromColor(color);
}

◆ setColor4f()

void SkPaint::setColor4f	(	const SkColor4f &	color,
		SkColorSpace *	colorSpace = `nullptr`
	)

inline

Definition at line 253 of file SkPaint.h.

                                                                                {
        this->setColor(color, colorSpace);
    }

◆ setColorFilter()

void SkPaint::setColorFilter ( sk_sp< SkColorFilter > colorFilter )

Sets SkColorFilter to filter, decreasing SkRefCnt of the previous SkColorFilter. Pass nullptr to clear SkColorFilter.

Increments filter SkRefCnt by one.

Parameters

colorFilter SkColorFilter to apply to subsequent draw

example: https://fiddle.skia.org/c/@Blend_Mode_Methods example: https://fiddle.skia.org/c/@Paint_setColorFilter

◆ setDither()

void SkPaint::setDither ( bool dither )

inline

Requests, but does not require, to distribute color error.

Parameters

dither setting for dithering

Definition at line 182 of file SkPaint.h.

182{ fBitfields.fDither = static_cast<unsigned>(dither); }

◆ setImageFilter()

void SkPaint::setImageFilter ( sk_sp< SkImageFilter > imageFilter )

Sets SkImageFilter to imageFilter, decreasing SkRefCnt of the previous SkImageFilter. Pass nullptr to clear SkImageFilter, and remove SkImageFilter effect on drawing.

Increments imageFilter SkRefCnt by one.

Parameters

imageFilter how SkImage is sampled when transformed

example: https://fiddle.skia.org/c/@Paint_setImageFilter

◆ setMaskFilter()

void SkPaint::setMaskFilter ( sk_sp< SkMaskFilter > maskFilter )

Sets SkMaskFilter to maskFilter, decreasing SkRefCnt of the previous SkMaskFilter. Pass nullptr to clear SkMaskFilter and leave SkMaskFilter effect on mask alpha unaltered.

Increments maskFilter SkRefCnt by one.

Parameters

maskFilter modifies clipping mask generated from drawn geometry

example: https://fiddle.skia.org/c/@Paint_setMaskFilter example: https://fiddle.skia.org/c/@Typeface_Methods

◆ setPathEffect()

void SkPaint::setPathEffect ( sk_sp< SkPathEffect > pathEffect )

Sets SkPathEffect to pathEffect, decreasing SkRefCnt of the previous SkPathEffect. Pass nullptr to leave the path geometry unaltered.

Increments pathEffect SkRefCnt by one.

Parameters

pathEffect replace SkPath with a modification when drawn

example: https://fiddle.skia.org/c/@Mask_Filter_Methods example: https://fiddle.skia.org/c/@Paint_setPathEffect

◆ setShader()

void SkPaint::setShader ( sk_sp< SkShader > shader )

Sets optional colors used when filling a path, such as a gradient.

Sets SkShader to shader, decreasing SkRefCnt of the previous SkShader. Increments shader SkRefCnt by one.

Parameters

shader how geometry is filled with color; if nullptr, color is used instead

example: https://fiddle.skia.org/c/@Color_Filter_Methods example: https://fiddle.skia.org/c/@Paint_setShader

◆ setStroke()

void SkPaint::setStroke ( bool isStroke )

Set paint's style to kStroke if true, or kFill if false.

Definition at line 115 of file SkPaint.cpp.

                                     {
    fBitfields.fStyle = isStroke ? kStroke_Style : kFill_Style;
}

◆ setStrokeCap()

void SkPaint::setStrokeCap ( Cap cap )

Sets the geometry drawn at the beginning and end of strokes.

example: https://fiddle.skia.org/c/@Paint_setStrokeCap_a example: https://fiddle.skia.org/c/@Paint_setStrokeCap_b

Definition at line 179 of file SkPaint.cpp.

                                 {
    if ((unsigned)ct < kCapCount) {
        fBitfields.fCapType = SkToU8(ct);
    } else {
#ifdef SK_REPORT_API_RANGE_CHECK
        SkDebugf("SkPaint::setStrokeCap(%d) out of range\n", ct);
#endif
    }
}

◆ setStrokeJoin()

void SkPaint::setStrokeJoin ( Join join )

Sets the geometry drawn at the corners of strokes.

example: https://fiddle.skia.org/c/@Paint_setStrokeJoin

Definition at line 189 of file SkPaint.cpp.

                                   {
    if ((unsigned)jt < kJoinCount) {
        fBitfields.fJoinType = SkToU8(jt);
    } else {
#ifdef SK_REPORT_API_RANGE_CHECK
        SkDebugf("SkPaint::setStrokeJoin(%d) out of range\n", jt);
#endif
    }
}

◆ setStrokeMiter()

void SkPaint::setStrokeMiter ( SkScalar miter )

Sets the limit at which a sharp corner is drawn beveled. Valid values are zero and greater. Has no effect if miter is less than zero.

Parameters

miter zero and greater miter limit

example: https://fiddle.skia.org/c/@Paint_setStrokeMiter

Definition at line 169 of file SkPaint.cpp.

                                           {
    if (limit >= 0) {
        fMiterLimit = limit;
    } else {
#ifdef SK_REPORT_API_RANGE_CHECK
        SkDebugf("SkPaint::setStrokeMiter() called with negative value\n");
#endif
    }
}

◆ setStrokeWidth()

void SkPaint::setStrokeWidth ( SkScalar width )

Sets the thickness of the pen used by the paint to outline the shape. A stroke-width of zero is treated as "hairline" width. Hairlines are always exactly one pixel wide in device space (their thickness does not change as the canvas is scaled). Negative stroke-widths are invalid; setting a negative width will have no effect.

Parameters

width zero thickness for hairline; greater than zero for pen thickness

example: https://fiddle.skia.org/c/@Miter_Limit example: https://fiddle.skia.org/c/@Paint_setStrokeWidth

Definition at line 159 of file SkPaint.cpp.

                                           {
    if (width >= 0) {
        fWidth = width;
    } else {
#ifdef SK_REPORT_API_RANGE_CHECK
        SkDebugf("SkPaint::setStrokeWidth() called with negative value\n");
#endif
    }
}

◆ setStyle()

void SkPaint::setStyle ( Style style )

Sets whether the geometry is filled, stroked, or filled and stroked. Has no effect if style is not a legal SkPaint::Style value.

example: https://fiddle.skia.org/c/@Paint_setStyle example: https://fiddle.skia.org/c/@Stroke_Width

Definition at line 105 of file SkPaint.cpp.

                                  {
    if ((unsigned)style < kStyleCount) {
        fBitfields.fStyle = style;
    } else {
#ifdef SK_REPORT_API_RANGE_CHECK
        SkDebugf("SkPaint::setStyle(%d) out of range\n", style);
#endif
    }
}

Friends And Related Function Documentation

◆ operator!=

bool operator!=	(	const SkPaint &	a,
		const SkPaint &	b
	)

friend

Compares a and b, and returns true if a and b are not equivalent. May return true if SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, or SkImageFilter have identical contents but different pointers.

Parameters

a	SkPaint to compare
b	SkPaint to compare

Returns: true if SkPaint pair are not equivalent

Definition at line 148 of file SkPaint.h.

                                                               {
        return !(a == b);
    }

◆ operator==

SK_API friend bool operator==	(	const SkPaint &	a,
		const SkPaint &	b
	)

friend

Compares a and b, and returns true if a and b are equivalent. May return false if SkPathEffect, SkShader, SkMaskFilter, SkColorFilter, or SkImageFilter have identical contents but different pointers.

Parameters

a	SkPaint to compare
b	SkPaint to compare

Returns: true if SkPaint pair are equivalent

Definition at line 66 of file SkPaint.cpp.

                                                    {
#define EQUAL(field) (a.field == b.field)
    return EQUAL(fPathEffect)
        && EQUAL(fShader)
        && EQUAL(fMaskFilter)
        && EQUAL(fColorFilter)
        && EQUAL(fBlender)
        && EQUAL(fImageFilter)
        && EQUAL(fColor4f)
        && EQUAL(fWidth)
        && EQUAL(fMiterLimit)
        && EQUAL(fBitfieldsUInt)
        ;
#undef EQUAL
}

◆ SkPaintPriv

friend class SkPaintPriv

friend

Definition at line 692 of file SkPaint.h.

Member Data Documentation

◆ fAntiAlias

unsigned SkPaint::fAntiAlias

Definition at line 673 of file SkPaint.h.

◆

struct { ... } SkPaint::fBitfields

◆ fBitfieldsUInt

uint32_t SkPaint::fBitfieldsUInt

Definition at line 680 of file SkPaint.h.

◆ fCapType

unsigned SkPaint::fCapType

Definition at line 675 of file SkPaint.h.

◆ fDither

unsigned SkPaint::fDither

Definition at line 674 of file SkPaint.h.

◆ fJoinType

unsigned SkPaint::fJoinType

Definition at line 676 of file SkPaint.h.

◆ fPadding

unsigned SkPaint::fPadding

Definition at line 678 of file SkPaint.h.

◆ fStyle

unsigned SkPaint::fStyle

Definition at line 677 of file SkPaint.h.

◆ kCapCount

constexpr int SkPaint::kCapCount = kLast_Cap + 1

staticconstexpr

May be used to verify that SkPaint::Cap is a legal value.

Definition at line 343 of file SkPaint.h.

◆ kJoinCount

constexpr int SkPaint::kJoinCount = kLast_Join + 1

staticconstexpr

May be used to verify that SkPaint::Join is a legal value.

Definition at line 368 of file SkPaint.h.

◆ kStyleCount

constexpr int SkPaint::kStyleCount = kStrokeAndFill_Style + 1

staticconstexpr

May be used to verify that SkPaint::Style is a legal value.

Definition at line 200 of file SkPaint.h.

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

third_party/skia/include/core/SkPaint.h
third_party/skia/src/core/SkPaint.cpp

Public Types

Public Member Functions

Static Public Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ sk_is_trivially_relocatable

Member Enumeration Documentation

◆ Cap

◆ Join

◆ Style

Constructor & Destructor Documentation

◆ SkPaint() [1/4]

◆ SkPaint() [2/4]

◆ SkPaint() [3/4]

◆ SkPaint() [4/4]

◆ ~SkPaint()

Member Function Documentation

◆ asBlendMode()

◆ canComputeFastBounds()

◆ computeFastBounds()

◆ computeFastStrokeBounds()

◆ doComputeFastBounds()

◆ getAlpha()

◆ getAlphaf()

◆ getBlender()

◆ getBlendMode_or()

◆ getColor()

◆ getColor4f()

◆ getColorFilter()

◆ getImageFilter()

◆ getMaskFilter()

◆ getPathEffect()

◆ getShader()

◆ getStrokeCap()

◆ getStrokeJoin()

◆ getStrokeMiter()

◆ getStrokeWidth()

◆ getStyle()

◆ isAntiAlias()

◆ isDither()

◆ isSrcOver()

◆ nothingToDraw()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ refBlender()

◆ refColorFilter()

◆ refImageFilter()

◆ refMaskFilter()

◆ refPathEffect()

◆ refShader()

◆ reset()

◆ setAlpha()

◆ setAlphaf()

◆ setAntiAlias()

◆ setARGB()

◆ setBlender()

◆ setBlendMode()

◆ setColor() [1/2]

◆ setColor() [2/2]

◆ setColor4f()

◆ setColorFilter()

◆ setDither()

◆ setImageFilter()

◆ setMaskFilter()

◆ setPathEffect()

◆ setShader()

◆ setStroke()

◆ setStrokeCap()

◆ setStrokeJoin()

◆ setStrokeMiter()

◆ setStrokeWidth()

◆ setStyle()

Friends And Related Function Documentation

◆ operator!=

◆ operator==

◆ SkPaintPriv

Member Data Documentation

◆ fAntiAlias

◆