SkPaint Reference

Paint

Class SkPaint

Paint controls options applied when drawing and measuring. Paint collects all options outside of the Canvas Clip and Canvas Matrix.

Various options apply to text, strokes and fills, and images.

Some options may not be implemented on all platforms; in these cases, setting the option has no effect. Some options are conveniences that duplicate Canvas functionality; for instance, text size is identical to matrix scale.

Paint options are rarely exclusive; each option modifies a stage of the drawing pipeline and multiple pipeline stages may be affected by a single Paint.

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

The objects contained by Paint are opaque, and cannot be edited outside of the Paint to affect it. The implementation is free to defer computations associated with the Paint, or ignore them altogether. For instance, some GPU implementations draw all Path geometries with Anti Aliasing, regardless of how SkPaint::kAntiAlias Flag is set in Paint.

Paint describes a single color, a single font, a single image quality, and so on. Multiple colors are drawn either by using multiple paints or with objects like Shader attached to Paint.

Overview

Related Function

SkPaint global, struct, and class related member functions share a topic.

Constant

SkPaint related constants are defined by enum, enum class, #define, const, and constexpr.

Struct

SkPaint uses C++ structs to declare the public data structures and interfaces.

Constructor

SkPaint can be constructed or initialized by these functions, including C++ class constructors.

Operator

SkPaint operators inline class member functions with arithmetic equivalents.

Member Function

SkPaint member functions read and modify the structure properties.

Initializers

SkPaint

Constructs Paint with default values.

attributedefault value
Anti Aliasfalse
Blend ModeSkBlendMode::kSrcOver
ColorSK ColorBLACK
Color Alpha255
Color Filternullptr
Ditherfalse
Draw Loopernullptr
Fake Boldfalse
Filter QualitykNone_SkFilterQuality
Font Embedded Bitmapsfalse
Automatic Hintingfalse
Full Hinting Spacingfalse
HintingkNormal Hinting
Image Filternullptr
LCD Textfalse
Linear Textfalse
Miter Limit4
Mask Filternullptr
Path Effectnullptr
Shadernullptr
StylekFill Style
Text AlignkLeft Align
Text EncodingkUTF8 TextEncoding
Text Scale X1
Text Size12
Text Skew X0
Typefacenullptr
Stroke CapkButt Cap
Stroke JoinkMiter Join
Stroke Width0
Subpixel Textfalse
Vertical Textfalse

The flags, text size, hinting, and miter limit may be overridden at compile time by defining paint default values. The overrides may be included in "SkUserConfig.h" or predefined by the build system.

Return Value

default initialized Paint

Example


SkPaint

Makes a shallow copy of Paint. Typeface, Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, and Image Filter are shared between the original paint and the copy. Objects containing Reference Count increment their references by one.

The referenced objects Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, and Image Filter cannot be modified after they are created. This prevents objects with Reference Count from being modified once Paint refers to them.

Parameters

Return Value

shallow copy of paint

Example

Example Output

SK_ColorRED == paint1.getColor()
SK_ColorBLUE == paint2.getColor()


SkPaint

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

Return Value

content of paint

Example

Example Output

path effect unique: true


reset

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

Example

Example Output

paint1 == paint2


~SkPaint

Decreases Paint Reference Count of owned objects: Typeface, Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, and Image Filter. If the objects containing Reference Count go to zero, they are deleted.


Management

operator=

Makes a shallow copy of Paint. Typeface, Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, and Image Filter are shared between the original paint and the copy. Objects containing Reference Count in the prior destination are decreased by one, and the referenced objects are deleted if the resulting count is zero. Objects containing Reference Count in the parameter paint are increased by one. paint is unmodified.

Parameters

Return Value

content of paint

Example

Example Output

SK_ColorRED == paint1.getColor()
SK_ColorRED == paint2.getColor()


operator=

Moves the paint to avoid increasing the reference counts of objects referenced by the paint parameter. Objects containing Reference Count 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

Return Value

content of paint

Example

Example Output

SK_ColorRED == paint2.getColor()


operator==

Compares a and b, and returns true if a and b are equivalent. May return false if Typeface, Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, or Image Filter have identical contents but different pointers.

Parameters

Return Value

true if Paint pair are equivalent

Example

Example Output

paint1 == paint2
paint1 != paint2

See Also

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


operator!=

Compares a and b, and returns true if a and b are not equivalent. May return true if Typeface, Path Effect, Shader, Mask Filter, Color Filter, Draw Looper, or Image Filter have identical contents but different pointers.

Parameters

Return Value

true if Paint pair are not equivalent

Example

Example Output

paint1 == paint2
paint1 == paint2

See Also

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


getHash

Returns a hash generated from Paint values and pointers. Identical hashes guarantee that the paints are equivalent, but differing hashes do not guarantee that the paints have differing contents.

If operator==(const SkPaint& a, const SkPaint& b) returns true for two paints, their hashes are also equal.

The hash returned is platform and implementation specific.

Return Value

a shallow hash

Example

Example Output

paint1 == paint2
paint1.getHash() == paint2.getHash()


Hinting

Enum SkPaint::Hinting

Hinting adjusts the glyph outlines so that the shape provides a uniform look at a given point size on font engines that support it. Hinting may have a muted effect or no effect at all depending on the platform.

The four levels roughly control corresponding features on platforms that use FreeType as the Font Engine.

Constants

On OS X and iOS, hinting controls whether Core Graphics dilates the font outlines to account for LCD text. No hinting uses Core Text Grayscale output. Normal hinting uses Core Text LCD output. If kLCDRenderText Flag is clear, the LCD output is reduced to a single Grayscale channel.

On Windows with DirectWrite, Hinting has no effect.

Hinting defaults to kNormal Hinting. Set SkPaintDefaults Hinting at compile time to change the default setting.

getHinting

Returns level of glyph outline adjustment.

Return Value

one of: kNo Hinting, kSlight Hinting, kNormal Hinting, kFull Hinting

Example

Example Output

SkPaint::kNormal_Hinting == paint.getHinting()


setHinting

Sets level of glyph outline adjustment. Does not check for valid values of hintingLevel.

Hintingvalueeffect on generated glyph outlines
kNo Hinting0leaves glyph outlines unchanged from their native representation
kSlight Hinting1modifies glyph outlines minimally to improve contrast
kNormal Hinting2modifies glyph outlines to improve contrast
kFull Hinting3modifies glyph outlines for maximum contrast

Parameters

Example

Example Output

paint1 == paint2


Flags

Enum SkPaint::Flags

The bit values stored in Flags. The default value for Flags, normally zero, can be changed at compile time with a custom definition of SkPaintDefaults Flags. All flags can be read and written explicitly; Flags allows manipulating multiple settings at once.

Constants

Enum SkPaint::ReserveFlags

Deprecated.

soonOnly valid for Android framework.

Constants

soon

soon

getFlags

Returns paint settings described by Flags. Each setting uses one bit, and can be tested with Flags members.

Return Value

zero, one, or more bits described by Flags

Example

Example Output

(SkPaint::kAntiAlias_Flag & paint.getFlags()) != 0


setFlags

Replaces Flags with flags, the union of the Flags members. All Flags members may be cleared, or one or more may be set.

Parameters

Example

Example Output

paint.isAntiAlias()
paint.isDither()


Anti Alias

Anti Alias drawing approximates partial pixel coverage with transparency. If kAntiAlias Flag is clear, pixel centers contained by the shape edge are drawn opaque. If kAntiAlias Flag is set, pixels are drawn with Color Alpha equal to their coverage.

The rule for Aliased pixels is inconsistent across platforms. A shape edge passing through the pixel center may, but is not required to, draw the pixel.

Raster Engine draws Aliased pixels whose centers are on or to the right of the start of an active Path edge, and whose center is to the left of the end of the active Path edge.

A platform may only support Anti Aliased drawing. Some GPU-backed platforms use Supersampling to Anti Alias all drawing, and have no mechanism to selectively Alias.

The amount of coverage computed for Anti Aliased pixels also varies across platforms.

Anti Alias is disabled by default. Anti Alias can be enabled by default by setting SkPaintDefaults Flags to kAntiAlias Flag at compile time.

Example

isAntiAlias

If true, pixels on the active edges of Path may be drawn with partial transparency.

Equivalent to getFlags masked with kAntiAlias Flag.

Return Value

kAntiAlias Flag state

Example

Example Output

paint.isAntiAlias() == !!(paint.getFlags() & SkPaint::kAntiAlias_Flag)
paint.isAntiAlias() == !!(paint.getFlags() & SkPaint::kAntiAlias_Flag)


setAntiAlias

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

Sets kAntiAlias Flag if aa is true. Clears kAntiAlias Flag if aa is false.

Parameters

Example

Example Output

paint1 == paint2


Dither

Dither increases fidelity by adjusting the color of adjacent pixels. This can help to smooth color transitions and reducing banding in gradients. Dithering lessens visible banding from kRGB_565_SkColorType and kRGBA_8888_SkColorType gradients, and improves rendering into a kRGB_565_SkColorType Surface.

Dithering is always enabled for linear gradients drawing into kRGB_565_SkColorType Surface and kRGBA_8888_SkColorType Surface. Dither cannot be enabled for kAlpha_8_SkColorType Surface and kRGBA_F16_SkColorType Surface.

Dither is disabled by default. Dither can be enabled by default by setting SkPaintDefaults Flags to kDither Flag at compile time.

Some platform implementations may ignore dithering. SetSK_IGNORE_GPU_DITHERto ignore Dither on GPU Surface.

Example

Example

isDither

If true, color error may be distributed to smooth color transition.

Equivalent to getFlags masked with kDither Flag.

Return Value

kDither Flag state

Example

Example Output

paint.isDither() == !!(paint.getFlags() & SkPaint::kDither_Flag)
paint.isDither() == !!(paint.getFlags() & SkPaint::kDither_Flag)


setDither

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

Sets kDither Flag if dither is true. Clears kDither Flag if dither is false.

Parameters

Example

Example Output

paint1 == paint2

See Also

kRGB_565_SkColorType


See Also

Gradient kRGB_565_SkColorType

Device Text

LCD Text and Subpixel Text increase the precision of glyph position.

When set, Flags kLCDRenderText Flag takes advantage of the organization of RGB stripes that create a color, and relies on the small size of the stripe and visual perception to make the color fringing imperceptible. LCD Text can be enabled on devices that orient stripes horizontally or vertically, and that order the color components as RGB or BGR.

Flags kSubpixelText Flag uses the pixel transparency to represent a fractional offset. As the opaqueness of the color increases, the edge of the glyph appears to move towards the outside of the pixel.

Either or both techniques can be enabled. kLCDRenderText Flag and kSubpixelText Flag are clear by default. LCD Text or Subpixel Text can be enabled by default by setting SkPaintDefaults Flags to kLCDRenderText Flag or kSubpixelText Flag (or both) at compile time.

Example

Linear Text

Linear Text selects whether text is rendered as a Glyph or as a Path. If kLinearText Flag is set, it has the same effect as setting Hinting to kNormal Hinting. If kLinearText Flag is clear, it is the same as setting Hinting to kNo Hinting.

isLinearText

If true, text is converted to Path before drawing and measuring.

Equivalent to getFlags masked with kLinearText Flag.

Return Value

kLinearText Flag state

Example

See Also

setLinearText Hinting


setLinearText

If true, text is converted to Path before drawing and measuring. By default, kLinearText Flag is clear.

Sets kLinearText Flag if linearText is true. Clears kLinearText Flag if linearText is false.

Parameters

Example

See Also

isLinearText Hinting


Subpixel Text

Flags kSubpixelText Flag uses the pixel transparency to represent a fractional offset. As the opaqueness of the color increases, the edge of the glyph appears to move towards the outside of the pixel.

isSubpixelText

If true, Glyphs at different sub-pixel positions may differ on pixel edge coverage.

Equivalent to getFlags masked with kSubpixelText Flag.

Return Value

kSubpixelText Flag state

Example

Example Output

paint.isSubpixelText() == !!(paint.getFlags() & SkPaint::kSubpixelText_Flag)
paint.isSubpixelText() == !!(paint.getFlags() & SkPaint::kSubpixelText_Flag)


setSubpixelText

Requests, but does not require, that Glyphs respect sub-pixel positioning.

Sets kSubpixelText Flag if subpixelText is true. Clears kSubpixelText Flag if subpixelText is false.

Parameters

Example

Example Output

paint1 == paint2


LCD Text

When set, Flags kLCDRenderText Flag takes advantage of the organization of RGB stripes that create a color, and relies on the small size of the stripe and visual perception to make the color fringing imperceptible. LCD Text can be enabled on devices that orient stripes horizontally or vertically, and that order the color components as RGB or BGR.

isLCDRenderText

If true, Glyphs may use LCD striping to improve glyph edges.

Returns true if Flags kLCDRenderText Flag is set.

Return Value

kLCDRenderText Flag state

Example

Example Output

paint.isLCDRenderText() == !!(paint.getFlags() & SkPaint::kLCDRenderText_Flag)
paint.isLCDRenderText() == !!(paint.getFlags() & SkPaint::kLCDRenderText_Flag)


setLCDRenderText

Requests, but does not require, that Glyphs use LCD striping for glyph edges.

Sets kLCDRenderText Flag if lcdText is true. Clears kLCDRenderText Flag if lcdText is false.

Parameters

Example

Example Output

paint1 == paint2


Font Embedded Bitmaps

Font Embedded Bitmaps allows selecting custom sized bitmap Glyphs. Flags kEmbeddedBitmapText Flag when set chooses an embedded bitmap glyph over an outline contained in a font if the platform supports this option.

FreeType selects the bitmap glyph if available when kEmbeddedBitmapText Flag is set, and selects the outline glyph if kEmbeddedBitmapText Flag is clear. Windows may select the bitmap glyph but is not required to do so. OS X and iOS do not support this option.

Font Embedded Bitmaps is disabled by default. Font Embedded Bitmaps can be enabled by default by setting SkPaintDefaults Flags to kEmbeddedBitmapText Flag at compile time.

Example

isEmbeddedBitmapText

If true, Font Engine may return Glyphs from font bitmaps instead of from outlines.

Equivalent to getFlags masked with kEmbeddedBitmapText Flag.

Return Value

kEmbeddedBitmapText Flag state

Example

Example Output

paint.isEmbeddedBitmapText() == !!(paint.getFlags() & SkPaint::kEmbeddedBitmapText_Flag)
paint.isEmbeddedBitmapText() == !!(paint.getFlags() & SkPaint::kEmbeddedBitmapText_Flag)


setEmbeddedBitmapText

Requests, but does not require, to use bitmaps in fonts instead of outlines.

Sets kEmbeddedBitmapText Flag if useEmbeddedBitmapText is true. Clears kEmbeddedBitmapText Flag if useEmbeddedBitmapText is false.

Parameters

Example

Example Output

paint1 == paint2


Automatic Hinting

If Hinting is set to kNormal Hinting or kFull Hinting, Automatic Hinting instructs the Font Manager to always hint Glyphs. Automatic Hinting has no effect if Hinting is set to kNo Hinting or kSlight Hinting.

Automatic Hinting only affects platforms that use FreeType as the Font Manager.

isAutohinted

If true, and if Hinting is set to kNormal Hinting or kFull Hinting, and if platform uses FreeType as the Font Manager, instruct the Font Manager to always hint Glyphs.

Equivalent to getFlags masked with kAutoHinting Flag.

Return Value

kAutoHinting Flag state

Example

Example Output

paint.isAutohinted() == !!(paint.getFlags() & SkPaint::kAutoHinting_Flag)
paint.isAutohinted() == !!(paint.getFlags() & SkPaint::kAutoHinting_Flag)

See Also

setAutohinted Hinting


setAutohinted

If Hinting is set to kNormal Hinting or kFull Hinting and useAutohinter is set, instruct the Font Manager to always hint Glyphs. Automatic Hinting has no effect if Hinting is set to kNo Hinting or kSlight Hinting.

Only affects platforms that use FreeType as the Font Manager.

Sets kAutoHinting Flag if useAutohinter is true. Clears kAutoHinting Flag if useAutohinter is false.

Parameters

Example

See Also

isAutohinted Hinting


Vertical Text

Text may be drawn by positioning each glyph, or by positioning the first glyph and using Font Advance to position subsequent Glyphs. By default, each successive glyph is positioned to the right of the preceding glyph. Vertical Text sets successive Glyphs to position below the preceding glyph.

Skia can translate text character codes as a series of Glyphs, but does not implement font substitution, textual substitution, line layout, or contextual spacing like Kerning pairs. Use a text shaping engine like HarfBuzz to translate text runs into glyph series.

Vertical Text is clear if text is drawn left to right or set if drawn from top to bottom.

Flags kVerticalText Flag if clear draws text left to right. Flags kVerticalText Flag if set draws text top to bottom.

Vertical Text is clear by default. Vertical Text can be set by default by setting SkPaintDefaults Flags to kVerticalText Flag at compile time.

Example

isVerticalText

If true, Glyphs are drawn top to bottom instead of left to right.

Equivalent to getFlags masked with kVerticalText Flag.

Return Value

kVerticalText Flag state

Example

Example Output

paint.isVerticalText() == !!(paint.getFlags() & SkPaint::kVerticalText_Flag)
paint.isVerticalText() == !!(paint.getFlags() & SkPaint::kVerticalText_Flag)


setVerticalText

If true, text advance positions the next glyph below the previous glyph instead of to the right of previous glyph.

Sets kVerticalText Flag if vertical is true. Clears kVerticalText Flag if vertical is false.

Parameters

Example

Example Output

paint1 == paint2


Fake Bold

Fake Bold approximates the bold font style accompanying a normal font when a bold font face is not available. Skia does not provide font substitution; it is up to the client to find the bold font face using the platform Font Manager.

Use Text Skew X to approximate an italic font style when the italic font face is not available.

A FreeType based port may define SK_USE_FREETYPE_EMBOLDEN at compile time to direct the font engine to create the bold Glyphs. Otherwise, the extra bold is computed by increasing the stroke width and setting the Style to kStrokeAndFill Style as needed.

Fake Bold is disabled by default.

Example

isFakeBoldText

If true, approximate bold by increasing the stroke width when creating glyph bitmaps from outlines.

Equivalent to getFlags masked with kFakeBoldText Flag.

Return Value

kFakeBoldText Flag state

Example

Example Output

paint.isFakeBoldText() == !!(paint.getFlags() & SkPaint::kFakeBoldText_Flag)
paint.isFakeBoldText() == !!(paint.getFlags() & SkPaint::kFakeBoldText_Flag)


setFakeBoldText

Use increased stroke width when creating glyph bitmaps to approximate a bold typeface.

Sets kFakeBoldText Flag if fakeBoldText is true. Clears kFakeBoldText Flag if fakeBoldText is false.

Parameters

Example

Example Output

paint1 == paint2


Full Hinting Spacing

if Hinting is set to kFull Hinting, Full Hinting Spacing adjusts the character spacing by the difference of the hinted and Unhinted Left Side Bearing and Right Side Bearing. Full Hinting Spacing only applies to platforms that use FreeType as their Font Engine.

Full Hinting Spacing is not related to text Kerning, where the space between a specific pair of characters is adjusted using data in the font Kerning tables.

isDevKernText

Deprecated.


setDevKernText

Deprecated.


Filter Quality Methods

Filter Quality trades speed for image filtering when the image is scaled. A lower Filter Quality draws faster, but has less fidelity. A higher Filter Quality draws slower, but looks better. If the image is drawn without scaling, the Filter Quality choice will not result in a noticeable difference.

Filter Quality is used in Paint passed as a parameter to

and when Paint has a Shader specialization that uses Image or Bitmap.

Filter Quality is kNone_SkFilterQuality by default.

Example

getFilterQuality

Returns Filter Quality, the image filtering level. A lower setting draws faster; a higher setting looks better when the image is scaled.

Return Value

one of: kNone_SkFilterQuality, kLow_SkFilterQuality, kMedium_SkFilterQuality, kHigh_SkFilterQuality

Example

Example Output

kNone_SkFilterQuality == paint.getFilterQuality()


setFilterQuality

Sets Filter Quality, the image filtering level. A lower setting draws faster; a higher setting looks better when the image is scaled. Does not check to see if quality is valid.

Parameters

Example

Example Output

kHigh_SkFilterQuality == paint.getFilterQuality()

See Also

SkFilterQuality Image Scaling


Color Methods

namedescription
getColorreturns Color Alpha and RGB, one drawing color
setColorsets Color Alpha and RGB, one drawing color

Color specifies the red, blue, green, and Color Alpha values used to draw a filled or stroked shape in a 32-bit value. Each component occupies 8-bits, ranging from zero: no contribution; to 255: full intensity. All values in any combination are valid.

Color is not Premultiplied; Color Alpha sets the transparency independent of RGB: red, blue, and green.

The bit positions of Color Alpha and RGB are independent of the bit positions on the output device, which may have more or fewer bits, and may have a different arrangement.

bit positionsColor Alpharedbluegreen
31 - 2423 - 1615 - 87 - 0

Example

getColor

Retrieves Alpha and RGB, Unpremultiplied, packed into 32 bits. Use helpers SkColorGetA, SkColorGetR, SkColorGetG, and SkColorGetB to extract a color component.

Return Value

Unpremultiplied ARGB

Example

Example Output

Yellow is 100% red, 100% green, and 0% blue.

See Also

SkColor


setColor

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

Example

Example Output

green1 == green2

See Also

SkColor setARGB SkColorSetARGB


Alpha Methods

Color Alpha sets the transparency independent of RGB: red, blue, and green.

getAlpha

Retrieves Alpha from the Color used when stroking and filling.

Return Value

Alpha ranging from zero, fully transparent, to 255, fully opaque

Example

Example Output

255 == paint.getAlpha()


setAlpha

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

Parameters

Example

Example Output

0x44112233 == paint.getColor()


setARGB

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

Example

Example Output

transRed1 == transRed2

See Also

setColor SkColorSetARGB


Style

Style specifies if the geometry is filled, stroked, or both filled and stroked. Some shapes ignore Style and are always drawn filled or stroked.

Set Style to kFill Style to fill the shape. The fill covers the area inside the geometry for most shapes.

Set Style to kStroke Style to stroke the shape.

Style Fill

See Also

Path Fill Type

Style Stroke

The stroke covers the area described by following the shape edge with a pen or brush of Stroke Width. The area covered where the shape starts and stops is described by Stroke Cap. The area covered where the shape turns a corner is described by Stroke Join. The stroke is centered on the shape; it extends equally on either side of the shape edge.

As Stroke Width gets smaller, the drawn path frame is thinner. Stroke Width less than one may have gaps, and if kAntiAlias Flag is set, Color Alpha will increase to visually decrease coverage.

Style Hairline

Stroke Width of zero has a special meaning and switches drawing to use Hairline. Hairline draws the thinnest continuous frame. If kAntiAlias Flag is clear, adjacent pixels flow horizontally, vertically,or diagonally.

Path drawing with Hairline may hit the same pixel more than once. For instance, Path containing two lines in one Path Contour will draw the corner point once, but may both lines may draw the adjacent pixel. If kAntiAlias Flag is set, transparency is applied twice, resulting in a darker pixel. Some GPU-backed implementations apply transparency at a later drawing stage, avoiding double hit pixels while stroking.

Enum SkPaint::Style

Set Style to fill, stroke, or both fill and stroke geometry. The stroke and fill share all paint attributes; for instance, they are drawn with the same color.

Use kStrokeAndFill Style to avoid hitting the same pixels twice with a stroke draw and a fill draw.

Constants

getStyle

Whether the geometry is filled, stroked, or filled and stroked.

Return Value

one of:kFill Style, kStroke Style, kStrokeAndFill Style

Example

Example Output

SkPaint::kFill_Style == paint.getStyle()

See Also

Style setStyle


setStyle

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

Parameters

Example

See Also

Style getStyle


See Also

Path Fill Type Path Effect Style Fill Style Stroke

Stroke Width

Stroke Width sets the width for stroking. The width is the thickness of the stroke perpendicular to the path direction when the paint style is set to kStroke Style or kStrokeAndFill Style.

When width is greater than zero, the stroke encompasses as many pixels partially or fully as needed. When the width equals zero, the paint enables hairlines; the stroke is always one pixel wide.

The stroke dimensions are scaled by the canvas matrix, but Hairline stroke remains one pixel wide regardless of scaling.

The default width for the paint is zero.

Example

getStrokeWidth

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

Return Value

zero for Hairline, greater than zero for pen thickness

Example

Example Output

0 == paint.getStrokeWidth()


setStrokeWidth

Sets the thickness of the pen used by the paint to outline the shape. Has no effect if width is less than zero.

Parameters

Example

Example Output

5 == paint.getStrokeWidth()


Miter Limit

Miter Limit specifies the maximum miter length, relative to the stroke width.

Miter Limit is used when the Stroke Join is set to kMiter Join, and the Style is either kStroke Style or kStrokeAndFill Style.

If the miter at a corner exceeds this limit, kMiter Join is replaced with kBevel Join.

Miter Limit can be computed from the corner angle:

miter limit = 1 / sin ( angle / 2 )Miter Limit default value is 4. The default may be changed at compile time by setting SkPaintDefaults MiterLimit in "SkUserConfig.h" or as a define supplied by the build environment.

Here are some miter limits and the angles that triggers them.

miter limitangle in degrees
1011.48
912.76
814.36
716.43
619.19
523.07
428.96
338.94
260
1180

Example

getStrokeMiter

The limit at which a sharp corner is drawn beveled.

Return Value

zero and greater Miter Limit

Example

Example Output

default miter limit == 4

See Also

Miter Limit setStrokeMiter Join


setStrokeMiter

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

Example

Example Output

default miter limit == 8

See Also

Miter Limit getStrokeMiter Join


Stroke Cap

Enum SkPaint::Cap

Stroke Cap draws at the beginning and end of an open Path Contour.

Constants

Stroke describes the area covered by a pen of Stroke Width as it follows the Path Contour, moving parallel to the contour direction.

If the Path Contour is not terminated by SkPath::kClose Verb, the contour has a visible beginning and end.

Path Contour may start and end at the same point; defining Zero Length Contour.

kButt Cap and Zero Length Contour is not drawn. kRound Cap and Zero Length Contour draws a circle of diameter Stroke Width at the contour point. kSquare Cap and Zero Length Contour draws an upright square with a side of Stroke Width at the contour point.

Stroke Cap is kButt Cap by default.

Example

getStrokeCap

The geometry drawn at the beginning and end of strokes.

Return Value

one of: kButt Cap, kRound Cap, kSquare Cap

Example

Example Output

kButt_Cap == default stroke cap

See Also

Stroke Cap setStrokeCap


setStrokeCap

The geometry drawn at the beginning and end of strokes.

Parameters

Example

Example Output

kRound_Cap == paint.getStrokeCap()

See Also

Stroke Cap getStrokeCap


Stroke Join

Stroke Join draws at the sharp corners of an open or closed Path Contour.

Stroke describes the area covered by a pen of Stroke Width as it follows the Path Contour, moving parallel to the contour direction.

If the contour direction changes abruptly, because the tangent direction leading to the end of a curve within the contour does not match the tangent direction of the following curve, the pair of curves meet at Stroke Join.

Example

Enum SkPaint::Join

Join specifies how corners are drawn when a shape is stroked. Join affects the four corners of a stroked rectangle, and the connected segments in a stroked path.

Choose miter join to draw sharp corners. Choose round join to draw a circle with a radius equal to the stroke width on top of the corner. Choose bevel join to minimally connect the thick strokes.

The fill path constructed to describe the stroked path respects the join setting but may not contain the actual join. For instance, a fill path constructed with round joins does not necessarily include circles at each connected segment.

Constants

Example

See Also

setStrokeJoin getStrokeJoin setStrokeMiter getStrokeMiter

getStrokeJoin

The geometry drawn at the corners of strokes.

Return Value

one of: kMiter Join, kRound Join, kBevel Join

Example

Example Output

kMiter_Join == default stroke join

See Also

Stroke Join setStrokeJoin


setStrokeJoin

The geometry drawn at the corners of strokes.

Parameters

Example

Example Output

kMiter_Join == paint.getStrokeJoin()

See Also

Stroke Join getStrokeJoin


See Also

Miter Limit

Fill Path

Fill Path creates a Path by applying the Path Effect, followed by the Style Stroke.

If Paint contains Path Effect, Path Effect operates on the source Path; the result replaces the destination Path. Otherwise, the source Path is replaces the destination Path.

Fill Path can request the Path Effect to restrict to a culling rectangle, but the Path Effect is not required to do so.

If Style is kStroke Style or kStrokeAndFill Style, and Stroke Width is greater than zero, the Stroke Width, Stroke Cap, Stroke Join, and Miter Limit operate on the destination Path, replacing it.

Fill Path can specify the precision used by Stroke Width to approximate the stroke geometry.

If the Style is kStroke Style and the Stroke Width is zero, getFillPath returns false since Hairline has no filled equivalent.

getFillPath

The filled equivalent of the stroked path.

Parameters

Return Value

true if the path represents Style Fill, or false if it represents Hairline

Example


The filled equivalent of the stroked path.

Replaces dst with the src path modified by Path Effect and Style Stroke. Path Effect, if any, is not culled. Stroke Width is created with default precision.

Parameters

Return Value

true if the path represents Style Fill, or false if it represents Hairline

Example


See Also

Style Stroke Stroke Width Path Effect

Shader Methods

Shader defines the colors used when drawing a shape. Shader may be an image, a gradient, or a computed fill. If Paint has no Shader, then Color fills the shape.

Shader is modulated by Color Alpha component of Color. If Shader object defines only Color Alpha, then Color modulated by Color Alpha describes the fill.

The drawn transparency can be modified without altering Shader, by changing Color Alpha.

Example

If Shader generates only Color Alpha then all components of Color modulate the output.

Example

getShader

Optional colors used when filling a path, such as a gradient.

Does not alter Shader Reference Count.

Return Value

Shader if previously set, nullptr otherwise

Example

Example Output

nullptr == shader
nullptr != shader


refShader

Optional colors used when filling a path, such as a gradient.

Increases Shader Reference Count by one.

Return Value

Shader if previously set, nullptr otherwise

Example

Example Output

shader unique: true
shader unique: false


setShader

Optional colors used when filling a path, such as a gradient.

Sets Shader to shader, decreasing Reference Count of the previous Shader. Increments shader Reference Count by one.

Parameters

Example


Color Filter Methods

Color Filter alters the color used when drawing a shape. Color Filter may apply Blend Mode, transform the color through a matrix, or composite multiple filters. If Paint has no Color Filter, the color is unaltered.

The drawn transparency can be modified without altering Color Filter, by changing Color Alpha.

Example

getColorFilter

Returns Color Filter if set, or nullptr. Does not alter Color Filter Reference Count.

Return Value

Color Filter if previously set, nullptr otherwise

Example

Example Output

nullptr == color filter
nullptr != color filter


refColorFilter

Returns Color Filter if set, or nullptr. Increases Color Filter Reference Count by one.

Return Value

Color Filter if set, or nullptr

Example

Example Output

color filter unique: true
color filter unique: false


setColorFilter

Sets Color Filter to filter, decreasing Reference Count of the previous Color Filter. Pass nullptr to clear Color Filter.

Increments filter Reference Count by one.

Parameters

Example


Blend Mode Methods

Blend Mode describes how Color combines with the destination color. The default setting, SkBlendMode::kSrcOver, draws the source color over the destination color.

Example

See Also

Blend Mode

getBlendMode

Returns Blend Mode. By default, returns SkBlendMode::kSrcOver.

Return Value

mode used to combine source color with destination color

Example

Example Output

kSrcOver == getBlendMode
kSrcOver != getBlendMode


isSrcOver

Returns true if Blend Mode is SkBlendMode::kSrcOver, the default.

Return Value

true if Blend Mode is SkBlendMode::kSrcOver

Example

Example Output

isSrcOver == true
isSrcOver != true


setBlendMode

Sets Blend Mode to mode. Does not check for valid input.

Parameters

Example

Example Output

isSrcOver == true
isSrcOver != true


Path Effect Methods

Path Effect modifies the path geometry before drawing it. Path Effect may implement dashing, custom fill effects and custom stroke effects. If Paint has no Path Effect, the path geometry is unaltered when filled or stroked.

Example

See Also

Path Effect

getPathEffect

Returns Path Effect if set, or nullptr. Does not alter Path Effect Reference Count.

Return Value

Path Effect if previously set, nullptr otherwise

Example

Example Output

nullptr == path effect
nullptr != path effect


refPathEffect

Returns Path Effect if set, or nullptr. Increases Path Effect Reference Count by one.

Return Value

Path Effect if previously set, nullptr otherwise

Example

Example Output

path effect unique: true
path effect unique: false


setPathEffect

Sets Path Effect to pathEffect, decreasing Reference Count of the previous Path Effect. Pass nullptr to leave the path geometry unaltered.

Increments pathEffect Reference Count by one.

Parameters

Example


Mask Filter Methods

Mask Filter uses coverage of the shape drawn to create Mask Alpha. Mask Filter takes a Mask, and returns a Mask.

Mask Filter may change the geometry and transparency of the shape, such as creating a blur effect. Set Mask Filter to nullptr to prevent Mask Filter from modifying the draw.

Example

getMaskFilter

Returns Mask Filter if set, or nullptr. Does not alter Mask Filter Reference Count.

Return Value

Mask Filter if previously set, nullptr otherwise

Example

Example Output

nullptr == mask filter
nullptr != mask filter


refMaskFilter

Returns Mask Filter if set, or nullptr.

Increases Mask Filter Reference Count by one.

Return Value

Mask Filter if previously set, nullptr otherwise

Example

Example Output

mask filter unique: true
mask filter unique: false


setMaskFilter

Sets Mask Filter to maskFilter, decreasing Reference Count of the previous Mask Filter. Pass nullptr to clear Mask Filter and leave Mask Filter effect on Mask Alpha unaltered.

Increments maskFilter Reference Count by one.

Parameters

Example


Typeface Methods

Typeface identifies the font used when drawing and measuring text. Typeface may be specified by name, from a file, or from a data stream. The default Typeface defers to the platform-specific default font implementation.

Example

getTypeface

Returns Typeface if set, or nullptr. Does not alter Typeface Reference Count.

Return Value

Typeface if previously set, nullptr otherwise

Example

Example Output

nullptr == typeface
nullptr != typeface


refTypeface

Increases Typeface Reference Count by one.

Return Value

Typeface if previously set, nullptr otherwise

Example

Example Output

typeface1 != typeface2
typeface1 == typeface2


setTypeface

Sets Typeface to typeface, decreasing Reference Count of the previous Typeface. Pass nullptr to clear Typeface and use the default typeface. Increments typeface Reference Count by one.

Parameters

Example


Image Filter Methods

Image Filter operates on the pixel representation of the shape, as modified by Paint with Blend Mode set to SkBlendMode::kSrcOver. Image Filter creates a new bitmap, which is drawn to the device using the set Blend Mode.

Image Filter is higher level than Mask Filter; for instance, an Image Filter can operate on all channels of Color, while Mask Filter generates Alpha only. Image Filter operates independently of and can be used in combination with Mask Filter.

Example

getImageFilter

Returns Image Filter if set, or nullptr. Does not alter Image Filter Reference Count.

Return Value

Image Filter if previously set, nullptr otherwise

Example

Example Output

nullptr == image filter
nullptr != image filter


refImageFilter

Returns Image Filter if set, or nullptr. Increases Image Filter Reference Count by one.

Return Value

Image Filter if previously set, nullptr otherwise

Example

Example Output

image filter unique: true
image filter unique: false


setImageFilter

Sets Image Filter to imageFilter, decreasing Reference Count of the previous Image Filter. Pass nullptr to clear Image Filter, and remove Image Filter effect on drawing.

Increments imageFilter Reference Count by one.

Parameters

Example


Draw Looper Methods

Draw Looper sets a modifier that communicates state from one Draw Layer to another to construct the draw.

Draw Looper draws one or more times, modifying the canvas and paint each time. Draw Looper may be used to draw multiple colors or create a colored shadow. Set Draw Looper to nullptr to prevent Draw Looper from modifying the draw.

Example

getDrawLooper

Returns Draw Looper if set, or nullptr. Does not alter Draw Looper Reference Count.

Return Value

Draw Looper if previously set, nullptr otherwise

Example

Example Output

nullptr == draw looper
nullptr != draw looper


refDrawLooper

Returns Draw Looper if set, or nullptr. Increases Draw Looper Reference Count by one.

Return Value

Draw Looper if previously set, nullptr otherwise

Example

Example Output

draw looper unique: true
draw looper unique: false


getLooper

Deprecated.


setDrawLooper

Sets Draw Looper to drawLooper, decreasing Reference Count of the previous drawLooper. Pass nullptr to clear Draw Looper and leave Draw Looper effect on drawing unaltered.

Increments drawLooper Reference Count by one.

Parameters

Example


setLooper

Deprecated.


Text Align

Enum SkPaint::Align

Align adjusts the text relative to the text position. Align affects Glyphs drawn with: SkCanvas::drawText, SkCanvas::drawPosText, SkCanvas::drawPosTextH, SkCanvas::drawTextOnPath, SkCanvas::drawTextOnPathHV, SkCanvas::drawTextRSXform, SkCanvas::drawTextBlob, and SkCanvas::drawString; as well as calls that place text Glyphs like getTextWidths and getTextPath.

The text position is set by the font for both horizontal and vertical text. Typically, for horizontal text, the position is to the left side of the glyph on the base line; and for vertical text, the position is the horizontal center of the glyph at the caps height.

Align adjusts the glyph position to center it or move it to abut the position using the metrics returned by the font.

Align defaults to kLeft Align.

Constants

Example

Example

getTextAlign

Returns Text Align. Returns kLeft Align if Text Align has not been set.

Return Value

text placement relative to position

Example

Example Output

kLeft_Align == default


setTextAlign

Sets Text Align to align. Has no effect if align is an invalid value.

Parameters

Example


Text Size

Text Size adjusts the overall text size in points. Text Size can be set to any positive value or zero. Text Size defaults to 12. Set SkPaintDefaults TextSize at compile time to change the default setting.

Example

getTextSize

Returns Text Size in points.

Return Value

typographic height of text

Example


setTextSize

Sets Text Size in points. Has no effect if textSize is not greater than or equal to zero.

Parameters

Example


Text Scale X

Text Scale X adjusts the text horizontal scale. Text scaling approximates condensed and expanded type faces when the actual face is not available. Text Scale X can be set to any value. Text Scale X defaults to 1.

Example

getTextScaleX

Returns Text Scale X. Default value is 1.

Return Value

text horizontal scale

Example


setTextScaleX

Sets Text Scale X. Default value is 1.

Parameters

Example


Text Skew X

Text Skew X adjusts the text horizontal slant. Text skewing approximates italic and oblique type faces when the actual face is not available. Text Skew X can be set to any value. Text Skew X defaults to 0.

Example

getTextSkewX

Returns Text Skew X. Default value is zero.

Return Value

additional shear in x-axis relative to y-axis

Example


setTextSkewX

Sets Text Skew X. Default value is zero.

Parameters

Example


Text Encoding

Enum SkPaint::TextEncoding

TextEncoding determines whether text specifies character codes and their encoded size, or glyph indices. Characters are encoded as specified by the Unicode standard .

Character codes encoded size are specified by UTF-8, UTF-16, or UTF-32. All character code formats are able to represent all of Unicode, differing only in the total storage required.

UTF-8 (RFC 3629) encodes each character as one or more 8-bit bytes.

UTF-16 (RFC 2781) encodes each character as one or two 16-bit words.

UTF-32 encodes each character as one 32-bit word.

Font Manager uses font data to convert character code points into glyph indices. A glyph index is a 16-bit word.

TextEncoding is set to kUTF8 TextEncoding by default.

Constants

Example

getTextEncoding

Returns Text Encoding. Text Encoding determines how character code points are mapped to font glyph indices.

Return Value

one of: kUTF8 TextEncoding, kUTF16 TextEncoding, kUTF32 TextEncoding, or kGlyphID TextEncoding

Example

Example Output

kUTF8_TextEncoding == text encoding
kGlyphID_TextEncoding == text encoding


setTextEncoding

Sets Text Encoding to encoding. Text Encoding determines how character code points are mapped to font glyph indices. Invalid values for encoding are ignored.

Parameters

Example

Example Output

4 != text encoding


Font Metrics

Font Metrics describe dimensions common to the Glyphs in Typeface. The dimensions are computed by Font Manager from font data and do not take Paint settings other than Text Size into account.

Font dimensions specify the anchor to the left of the glyph at baseline as the origin. X-axis values to the left of the glyph are negative, and to the right of the left glyph edge are positive. Y-axis values above the baseline are negative, and below the baseline are positive.

Example

Struct SkPaint::FontMetrics

Constant

SkPaint related constants are defined by enum, enum class, #define, const, and constexpr.

Member_Function

SkPaint member functions read and modify the structure properties.

Member

SkPaint members may be read and written directly without using a member function.

FontMetrics is filled out by getFontMetrics. FontMetrics contents reflect the values computed by Font Manager using Typeface. Values are set to zero if they are not available.

All vertical values are relative to the baseline, on a y-axis pointing down. Zero is on the baseline, negative values are above the baseline, and positive values are below the baseline.

fUnderlineThickness and fUnderlinePosition have a bit set in fFlags if their values are valid, since their value may be zero.

fStrikeoutThickness and fStrikeoutPosition have a bit set in fFlags if their values are valid, since their value may be zero.

Enum SkPaint::FontMetrics::FontMetricsFlags

FontMetricsFlags are set in fFlags when underline and strikeout metrics are valid; the underline or strikeout metric may be valid and zero. Fonts with embedded bitmaps may not have valid underline or strikeout metrics.

Constants

Members

If the metric is valid, the kUnderlinePositionIsValid Flag is set in fFlags. If kUnderlinePositionIsValid Flag is clear, fUnderlinePosition is zero.

If the metric is valid, the kStrikeoutPositionIsValid Flag is set in fFlags. If kStrikeoutPositionIsValid Flag is clear, fStrikeoutPosition is zero.

hasUnderlineThickness

If Font Metrics has a valid underline thickness, return true, and set thickness to that value. If the underline thickness is not valid, return false, and ignore thickness.

Parameters

Return Value

true if font specifies underline width


hasUnderlinePosition

If Font Metrics has a valid underline position, return true, and set position to that value. If the underline position is not valid, return false, and ignore position.

Parameters

Return Value

true if font specifies underline position


hasStrikeoutThickness

If Font Metrics has a valid strikeout thickness, return true, and set thickness to that value. If the underline thickness is not valid, return false, and ignore thickness.

Parameters

Return Value

true if font specifies strikeout width


hasStrikeoutPosition

If Font Metrics has a valid strikeout position, return true, and set position to that value. If the underline position is not valid, return false, and ignore position.

Parameters

Return Value

true if font specifies strikeout position


getFontMetrics

Returns Font Metrics associated with Typeface. The return value is the recommended spacing between lines: the sum of metrics descent, ascent, and leading. If metrics is not nullptr, Font Metrics is copied to metrics. Results are scaled by Text Size but does not take into account dimensions required by Text Scale X, Text Skew X, Fake Bold, Style Stroke, and Path Effect. Results can be additionally scaled by scale; a scale of zero is ignored.

Parameters

Return Value

recommended spacing between lines

Example

See Also

Text Size Typeface Typeface Methods


getFontSpacing

Returns the recommended spacing between lines: the sum of metrics descent, ascent, and leading. Result is scaled by Text Size but does not take into account dimensions required by stroking and Path Effect. Returns the same result as getFontMetrics.

Return Value

recommended spacing between lines

Example

Example Output

textSize: 12 fontSpacing: 13.9688
textSize: 18 fontSpacing: 20.9531
textSize: 24 fontSpacing: 27.9375
textSize: 32 fontSpacing: 37.25


getFontBounds

Returns the union of bounds of all Glyphs. Returned dimensions are computed by Font Manager from font data, ignoring Hinting. Includes Text Size, Text Scale X, and Text Skew X, but not Fake Bold or Path Effect.

If Text Size is large, Text Scale X is one, and Text Skew X is zero, returns the same bounds as Font Metrics { FontMetrics::fXMin, FontMetrics::fTop, FontMetrics::fXMax, FontMetrics::fBottom }.

Return Value

union of bounds of all Glyphs

Example

Example Output

metrics bounds = { -12.2461, -14.7891, 21.5215, 5.55469 }
font bounds    = { -12.2461, -14.7891, 21.5215, 5.55469 }


textToGlyphs

Converts text into glyph indices. Returns the number of glyph indices represented by text. Text Encoding specifies how text represents characters or glyphs. glyphs may be nullptr, to compute the glyph count.

Does not check text for valid character codes or valid glyph indices.

If byteLength equals zero, returns zero. If byteLength includes a partial character, the partial character is ignored.

If Text Encoding is kUTF8 TextEncoding and text contains an invalid UTF-8 sequence, zero is returned.

Parameters

Return Value

number of glyphs represented by text of length byteLength

Example


countText

Returns the number of Glyphs in text. Uses Text Encoding to count the Glyphs. Returns the same result as textToGlyphs.

Parameters

Return Value

number of Glyphs represented by text of length byteLength

Example

Example Output

count = 5


containsText

Returns true if all text corresponds to a non-zero glyph index. Returns false if any characters in text are not supported in Typeface.

If Text Encoding is kGlyphID TextEncoding, returns true if all glyph indices in text are non-zero; does not check to see if text contains valid glyph indices for Typeface.

Returns true if byteLength is zero.

Parameters

Return Value

true if all text corresponds to a non-zero glyph index

Example Output

0x00b0 == has char
0xd800 != has char

Example

Example Output

0x01ff == has glyph
0x0000 != has glyph
0xffff == has glyph

See Also

setTextEncoding Typeface


glyphsToUnichars

Converts glyphs into text if possible. Glyph values without direct Unicode equivalents are mapped to zero. Uses the Typeface, but is unaffected by Text Encoding; the text values returned are equivalent to kUTF32 TextEncoding.

Only supported on platforms that use FreeType as the Font Engine.

Parameters

Example


Measure Text

measureText

Returns the advance width of text if kVerticalText Flag is clear, and the height of text if kVerticalText Flag is set. The advance is the normal distance to move before drawing additional text. Uses Text Encoding to decode text, Typeface to get the font metrics, and Text Size, Text Scale X, Text Skew X, Stroke Width, and Path Effect to scale the metrics and bounds. Returns the bounding box of text if bounds is not nullptr. The bounding box is computed as if the text was drawn at the origin.

Parameters

Return Value

advance width or height

Example


Returns the advance width of text if kVerticalText Flag is clear, and the height of text if kVerticalText Flag is set. The advance is the normal distance to move before drawing additional text. Uses Text Encoding to decode text, Typeface to get the font metrics, and Text Size to scale the metrics. Does not scale the advance or bounds by Fake Bold or Path Effect.

Parameters

Return Value

advance width or height

Example

Example Output

default width = 5
double width = 10


breakText

Returns the bytes of text that fit within maxWidth. If kVerticalText Flag is clear, the text fragment fits if its advance width is less than or equal to maxWidth. If kVerticalText Flag is set, the text fragment fits if its advance height is less than or equal to maxWidth. Measures only while the advance is less than or equal to maxWidth. Returns the advance or the text fragment in measuredWidth if it not nullptr. Uses Text Encoding to decode text, Typeface to get the font metrics, and Text Size to scale the metrics. Does not scale the advance or bounds by Fake Bold or Path Effect.

Parameters

Return Value

bytes of text that fit, always less than or equal to length

Example


getTextWidths

Retrieves the advance and bounds for each glyph in text, and returns the glyph count in text. Both widths and bounds may be nullptr. If widths is not nullptr, widths must be an array of glyph count entries. if bounds is not nullptr, bounds must be an array of glyph count entries. If kVerticalText Flag is clear, widths returns the horizontal advance. If kVerticalText Flag is set, widths returns the vertical advance. Uses Text Encoding to decode text, Typeface to get the font metrics, and Text Size to scale the widths and bounds. Does not scale the advance by Fake Bold or Path Effect. Does include Fake Bold and Path Effect in the bounds.

Parameters

Return Value

glyph count in text

Example


Text Path

Text Path describes the geometry of Glyphs used to draw text.

getTextPath

Returns the geometry as Path equivalent to the drawn text. Uses Text Encoding to decode text, Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. All of the glyph paths are stored in path. Uses x, y, and Text Align to position path.

Parameters

Example


getPosTextPath

Returns the geometry as Path equivalent to the drawn text. Uses Text Encoding to decode text, Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. All of the glyph paths are stored in path. Uses pos array and Text Align to position path. pos contains a position for each glyph.

Parameters

Example


Text Intercepts

Text Intercepts describe the intersection of drawn text Glyphs with a pair of lines parallel to the text advance. Text Intercepts permits creating a underline that skips Descenders.

getTextIntercepts

Returns the number of intervals that intersect bounds. bounds describes a pair of lines parallel to the text advance. The return count is zero or a multiple of two, and is at most twice the number of Glyphs in the string. Uses Text Encoding to decode text, Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. Uses x, y, and Text Align to position intervals.

Pass nullptr for intervals to determine the size of the interval array.

intervals are cached to improve performance for multiple calls.

Parameters

Return Value

number of intersections; may be zero

Example


getPosTextIntercepts

Returns the number of intervals that intersect bounds. bounds describes a pair of lines parallel to the text advance. The return count is zero or a multiple of two, and is at most twice the number of Glyphs in the string. Uses Text Encoding to decode text, Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. Uses pos array and Text Align to position intervals.

Pass nullptr for intervals to determine the size of the interval array.

intervals are cached to improve performance for multiple calls.

Parameters

Return Value

number of intersections; may be zero

Example


getPosTextHIntercepts

Returns the number of intervals that intersect bounds. bounds describes a pair of lines parallel to the text advance. The return count is zero or a multiple of two, and is at most twice the number of Glyphs in the string. Uses Text Encoding to decode text, Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. Uses xpos array, constY, and Text Align to position intervals.

Pass nullptr for intervals to determine the size of the interval array.

intervals are cached to improve performance for multiple calls.

Parameters

Return Value

number of intersections; may be zero

Example


getTextBlobIntercepts

Returns the number of intervals that intersect bounds. bounds describes a pair of lines parallel to the text advance. The return count is zero or a multiple of two, and is at most twice the number of Glyphs in the string. Uses Typeface to get the glyph paths, and Text Size, Fake Bold, and Path Effect to scale and modify the glyph paths. Uses run array and Text Align to position intervals.

Text Encoding must be set to SkPaint::kGlyphID TextEncoding.

Pass nullptr for intervals to determine the size of the interval array.

intervals are cached to improve performance for multiple calls.

Parameters

Return Value

number of intersections; may be zero

Example


nothingToDraw

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

Returns true if, for example, Blend Mode combined with Color Alpha computes a new Alpha of zero.

Return Value

true if Paint prevents all drawing

Example

Example Output

initial nothing to draw: false
blend dst nothing to draw: true
blend src over nothing to draw: false
alpha 0 nothing to draw: true


Fast Bounds

Fast Bounds functions conservatively outset a drawing bounds by additional area Paint may draw to.

canComputeFastBounds

Returns true if Paint does not include elements requiring extensive computation to compute Device bounds of drawn geometry. For instance, Paint with Path Effect always returns false.

Return Value

true if Paint allows for fast computation of bounds


computeFastBounds

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 Rect 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 Rect.

Parameters

Return Value

fast computed bounds


computeFastStrokeBounds

Parameters

Return Value

fast computed bounds


doComputeFastBounds

Computes the bounds, overriding the Paint Style. This can be used to account for additional width required by stroking orig, without altering Style set to fill.

Parameters

Return Value

fast computed bounds


Utility