1SkPaint Reference 2=== 3 4 5<a name='SkPaint'></a> 6 7--- 8 9<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 10class <a href='SkPaint_Reference#SkPaint'>SkPaint</a> { 11 12 <a href='#SkPaint_empty_constructor'>SkPaint()</a>; 13 <a href='#SkPaint_copy_const_SkPaint'>SkPaint</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='SkPaint_Reference#Paint'>paint</a>); 14 <a href='#SkPaint_move_SkPaint'>SkPaint</a>(<a href='SkPaint_Reference#SkPaint'>SkPaint</a>&& <a href='SkPaint_Reference#Paint'>paint</a>); 15 <a href='#SkPaint_destructor'>~SkPaint()</a>; 16 <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_copy_operator'>operator=</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='SkPaint_Reference#Paint'>paint</a>); 17 <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_move_operator'>operator=</a>(<a href='SkPaint_Reference#SkPaint'>SkPaint</a>&& <a href='SkPaint_Reference#Paint'>paint</a>); 18 friend bool <a href='#SkPaint_equal_operator'>operator==</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& a, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& b); 19 friend bool <a href='#SkPaint_notequal_operator'>operator!=</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& a, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& b); 20 uint32_t <a href='#SkPaint_getHash'>getHash</a>() const; 21 void <a href='#SkPaint_reset'>reset()</a>; 22 void <a href='#SkPaint_setHinting'>setHinting</a>(<a href='undocumented#SkFontHinting'>SkFontHinting</a> hintingLevel); 23 <a href='undocumented#SkFontHinting'>SkFontHinting</a> <a href='#SkPaint_getHinting'>getHinting</a>() const; 24 25 enum <a href='#SkPaint_Flags'>Flags</a> { 26 <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> = 0x01, 27 <a href='#SkPaint_kDither_Flag'>kDither_Flag</a> = 0x04, 28 <a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a> = 0x20, 29 <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a> = 0x40, 30 <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> = 0x80, 31 <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> = 0x200, 32 <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> = 0x400, 33 <a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a> = 0x800, 34 <a href='#SkPaint_kAllFlags'>kAllFlags</a> = 0xFFFF, 35 }; 36 37 uint32_t <a href='#SkPaint_getFlags'>getFlags</a>() const; 38 void <a href='#SkPaint_setFlags'>setFlags</a>(uint32_t flags); 39 bool <a href='#SkPaint_isAntiAlias'>isAntiAlias</a>() const; 40 void <a href='#SkPaint_setAntiAlias'>setAntiAlias</a>(bool aa); 41 bool <a href='#SkPaint_isDither'>isDither</a>() const; 42 void <a href='#SkPaint_setDither'>setDither</a>(bool dither); 43 bool <a href='#SkPaint_isLinearText'>isLinearText</a>() const; 44 void <a href='#SkPaint_setLinearText'>setLinearText</a>(bool linearText); 45 bool <a href='#SkPaint_isSubpixelText'>isSubpixelText</a>() const; 46 void <a href='#SkPaint_setSubpixelText'>setSubpixelText</a>(bool subpixelText); 47 bool <a href='#SkPaint_isLCDRenderText'>isLCDRenderText</a>() const; 48 void <a href='#SkPaint_setLCDRenderText'>setLCDRenderText</a>(bool lcdText); 49 bool <a href='#SkPaint_isEmbeddedBitmapText'>isEmbeddedBitmapText</a>() const; 50 void <a href='#SkPaint_setEmbeddedBitmapText'>setEmbeddedBitmapText</a>(bool useEmbeddedBitmapText); 51 bool <a href='#SkPaint_isAutohinted'>isAutohinted</a>() const; 52 void <a href='#SkPaint_setAutohinted'>setAutohinted</a>(bool useAutohinter); 53 bool <a href='#SkPaint_isFakeBoldText'>isFakeBoldText</a>() const; 54 void <a href='#SkPaint_setFakeBoldText'>setFakeBoldText</a>(bool fakeBoldText); 55 <a href='undocumented#SkFilterQuality'>SkFilterQuality</a> <a href='#SkPaint_getFilterQuality'>getFilterQuality</a>() const; 56 void <a href='#SkPaint_setFilterQuality'>setFilterQuality</a>(<a href='undocumented#SkFilterQuality'>SkFilterQuality</a> quality); 57 58 enum <a href='#SkPaint_Style'>Style</a> : uint8_t { 59 <a href='#SkPaint_kFill_Style'>kFill_Style</a>, 60 <a href='#SkPaint_kStroke_Style'>kStroke_Style</a>, 61 <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a>, 62 }; 63 64 static constexpr int <a href='#SkPaint_kStyleCount'>kStyleCount</a> = <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a> + 1 65 <a href='#SkPaint_Style'>Style</a> <a href='#SkPaint_getStyle'>getStyle</a>() const; 66 void <a href='#SkPaint_setStyle'>setStyle</a>(<a href='#SkPaint_Style'>Style</a> style); 67 <a href='SkColor_Reference#SkColor'>SkColor</a> <a href='#SkPaint_getColor'>getColor</a>() const; 68 <a href='SkColor4f_Reference#SkColor4f'>SkColor4f</a> <a href='#SkPaint_getColor4f'>getColor4f</a>() const; 69 void <a href='#SkPaint_setColor'>setColor</a>(<a href='SkColor_Reference#SkColor'>SkColor</a> <a href='SkColor_Reference#Color'>color</a>); 70 void <a href='#SkPaint_setColor4f'>setColor4f</a>(const <a href='SkColor4f_Reference#SkColor4f'>SkColor4f</a>& <a href='SkColor_Reference#Color'>color</a>, <a href='undocumented#SkColorSpace'>SkColorSpace</a>* colorSpace); 71 uint8_t <a href='#SkPaint_getAlpha'>getAlpha</a>() const; 72 void <a href='#SkPaint_setAlpha'>setAlpha</a>(<a href='undocumented#U8CPU'>U8CPU</a> a); 73 void <a href='#SkPaint_setARGB'>setARGB</a>(<a href='undocumented#U8CPU'>U8CPU</a> a, <a href='undocumented#U8CPU'>U8CPU</a> r, <a href='undocumented#U8CPU'>U8CPU</a> g, <a href='undocumented#U8CPU'>U8CPU</a> b); 74 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getStrokeWidth'>getStrokeWidth</a>() const; 75 void <a href='#SkPaint_setStrokeWidth'>setStrokeWidth</a>(<a href='undocumented#SkScalar'>SkScalar</a> width); 76 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getStrokeMiter'>getStrokeMiter</a>() const; 77 void <a href='#SkPaint_setStrokeMiter'>setStrokeMiter</a>(<a href='undocumented#SkScalar'>SkScalar</a> miter); 78 79 enum <a href='#SkPaint_Cap'>Cap</a> { 80 <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, 81 <a href='#SkPaint_kRound_Cap'>kRound_Cap</a>, 82 <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a>, 83 <a href='#SkPaint_kLast_Cap'>kLast_Cap</a> = <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a>, 84 <a href='#SkPaint_kDefault_Cap'>kDefault_Cap</a> = <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, 85 }; 86 87 static constexpr int <a href='#SkPaint_kCapCount'>kCapCount</a> = <a href='#SkPaint_kLast_Cap'>kLast_Cap</a> + 1 88 enum <a href='#SkPaint_Join'>Join</a> : uint8_t { 89 <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, 90 <a href='#SkPaint_kRound_Join'>kRound_Join</a>, 91 <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>, 92 <a href='#SkPaint_kLast_Join'>kLast_Join</a> = <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>, 93 <a href='#SkPaint_kDefault_Join'>kDefault_Join</a> = <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, 94 }; 95 96 static constexpr int <a href='#SkPaint_kJoinCount'>kJoinCount</a> = <a href='#SkPaint_kLast_Join'>kLast_Join</a> + 1 97 <a href='#SkPaint_Cap'>Cap</a> <a href='#SkPaint_getStrokeCap'>getStrokeCap</a>() const; 98 void <a href='#SkPaint_setStrokeCap'>setStrokeCap</a>(<a href='#SkPaint_Cap'>Cap</a> cap); 99 <a href='#SkPaint_Join'>Join</a> <a href='#SkPaint_getStrokeJoin'>getStrokeJoin</a>() const; 100 void <a href='#SkPaint_setStrokeJoin'>setStrokeJoin</a>(<a href='#SkPaint_Join'>Join</a> join); 101 bool <a href='#SkPaint_getFillPath'>getFillPath</a>(const <a href='SkPath_Reference#SkPath'>SkPath</a>& src, <a href='SkPath_Reference#SkPath'>SkPath</a>* dst, const <a href='SkRect_Reference#SkRect'>SkRect</a>* cullRect, 102 <a href='undocumented#SkScalar'>SkScalar</a> resScale = 1) const; 103 bool <a href='#SkPaint_getFillPath'>getFillPath</a>(const <a href='SkPath_Reference#SkPath'>SkPath</a>& src, <a href='SkPath_Reference#SkPath'>SkPath</a>* dst) const; 104 <a href='undocumented#SkShader'>SkShader</a>* <a href='#SkPaint_getShader'>getShader</a>() const; 105 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkShader'>SkShader</a>> <a href='#SkPaint_refShader'>refShader</a>() const; 106 void <a href='#SkPaint_setShader'>setShader</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkShader'>SkShader</a>> <a href='undocumented#Shader'>shader</a>); 107 <a href='undocumented#SkColorFilter'>SkColorFilter</a>* <a href='#SkPaint_getColorFilter'>getColorFilter</a>() const; 108 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkColorFilter'>SkColorFilter</a>> <a href='#SkPaint_refColorFilter'>refColorFilter</a>() const; 109 void <a href='#SkPaint_setColorFilter'>setColorFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkColorFilter'>SkColorFilter</a>> colorFilter); 110 <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> <a href='#SkPaint_getBlendMode'>getBlendMode</a>() const; 111 bool <a href='#SkPaint_isSrcOver'>isSrcOver</a>() const; 112 void <a href='#SkPaint_setBlendMode'>setBlendMode</a>(<a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> mode); 113 <a href='undocumented#SkPathEffect'>SkPathEffect</a>* <a href='#SkPaint_getPathEffect'>getPathEffect</a>() const; 114 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkPathEffect'>SkPathEffect</a>> <a href='#SkPaint_refPathEffect'>refPathEffect</a>() const; 115 void <a href='#SkPaint_setPathEffect'>setPathEffect</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkPathEffect'>SkPathEffect</a>> pathEffect); 116 <a href='undocumented#SkMaskFilter'>SkMaskFilter</a>* <a href='#SkPaint_getMaskFilter'>getMaskFilter</a>() const; 117 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>> <a href='#SkPaint_refMaskFilter'>refMaskFilter</a>() const; 118 void <a href='#SkPaint_setMaskFilter'>setMaskFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>> maskFilter); 119 <a href='undocumented#SkTypeface'>SkTypeface</a>* <a href='#SkPaint_getTypeface'>getTypeface</a>() const; 120 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkTypeface'>SkTypeface</a>> <a href='#SkPaint_refTypeface'>refTypeface</a>() const; 121 void <a href='#SkPaint_setTypeface'>setTypeface</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkTypeface'>SkTypeface</a>> <a href='undocumented#Typeface'>typeface</a>); 122 <a href='undocumented#SkImageFilter'>SkImageFilter</a>* <a href='#SkPaint_getImageFilter'>getImageFilter</a>() const; 123 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkImageFilter'>SkImageFilter</a>> <a href='#SkPaint_refImageFilter'>refImageFilter</a>() const; 124 void <a href='#SkPaint_setImageFilter'>setImageFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkImageFilter'>SkImageFilter</a>> imageFilter); 125 <a href='undocumented#SkDrawLooper'>SkDrawLooper</a>* <a href='#SkPaint_getDrawLooper'>getDrawLooper</a>() const; 126 <a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>> <a href='#SkPaint_refDrawLooper'>refDrawLooper</a>() const; 127 void <a href='#SkPaint_setDrawLooper'>setDrawLooper</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>> drawLooper); 128 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextSize'>getTextSize</a>() const; 129 void <a href='#SkPaint_setTextSize'>setTextSize</a>(<a href='undocumented#SkScalar'>SkScalar</a> textSize); 130 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextScaleX'>getTextScaleX</a>() const; 131 void <a href='#SkPaint_setTextScaleX'>setTextScaleX</a>(<a href='undocumented#SkScalar'>SkScalar</a> scaleX); 132 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextSkewX'>getTextSkewX</a>() const; 133 void <a href='#SkPaint_setTextSkewX'>setTextSkewX</a>(<a href='undocumented#SkScalar'>SkScalar</a> skewX); 134 <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> <a href='#SkPaint_getTextEncoding'>getTextEncoding</a>() const; 135 void <a href='#SkPaint_setTextEncoding'>setTextEncoding</a>(<a href='undocumented#SkTextEncoding'>SkTextEncoding</a> encoding); 136 137 typedef <a href='undocumented#SkFontMetrics'>SkFontMetrics</a> <a href='#SkPaint_FontMetrics'>FontMetrics</a>; 138 139 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getFontMetrics'>getFontMetrics</a>(<a href='undocumented#SkFontMetrics'>SkFontMetrics</a>* metrics) const; 140 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getFontSpacing'>getFontSpacing</a>() const; 141 int <a href='#SkPaint_textToGlyphs'>textToGlyphs</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength, 142 <a href='undocumented#SkGlyphID'>SkGlyphID</a> <a href='undocumented#Glyph'>glyphs</a>[]) const; 143 bool <a href='#SkPaint_containsText'>containsText</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength) const; 144 void <a href='#SkPaint_glyphsToUnichars'>glyphsToUnichars</a>(const <a href='undocumented#SkGlyphID'>SkGlyphID</a> <a href='undocumented#Glyph'>glyphs</a>[], int count, <a href='undocumented#SkUnichar'>SkUnichar</a> <a href='undocumented#Text'>text</a>[]) const; 145 int <a href='#SkPaint_countText'>countText</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength) const; 146 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_measureText'>measureText</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, <a href='SkRect_Reference#SkRect'>SkRect</a>* bounds) const; 147 <a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_measureText'>measureText</a>(const void* <a href='undocumented#Text'>text</a>, size_t length) const; 148 int <a href='#SkPaint_getTextWidths'>getTextWidths</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength, <a href='undocumented#SkScalar'>SkScalar</a> widths[], 149 <a href='SkRect_Reference#SkRect'>SkRect</a> bounds[] = nullptr) const; 150 void <a href='#SkPaint_getTextPath'>getTextPath</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, <a href='undocumented#SkScalar'>SkScalar</a> x, <a href='undocumented#SkScalar'>SkScalar</a> y, 151 <a href='SkPath_Reference#SkPath'>SkPath</a>* <a href='SkPath_Reference#Path'>path</a>) const; 152 void <a href='#SkPaint_getPosTextPath'>getPosTextPath</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, 153 const <a href='SkPoint_Reference#SkPoint'>SkPoint</a> pos[], <a href='SkPath_Reference#SkPath'>SkPath</a>* <a href='SkPath_Reference#Path'>path</a>) const; 154 bool <a href='#SkPaint_nothingToDraw'>nothingToDraw</a>() const; 155}; 156 157</pre> 158 159<a href='SkPaint_Reference#Paint'>Paint</a> controls options applied when drawing and measuring. <a href='SkPaint_Reference#Paint'>Paint</a> collects all 160options outside of the <a href='#Canvas_Clip'>Canvas_Clip</a> and <a href='#Canvas_Matrix'>Canvas_Matrix</a>. 161 162Various options apply to <a href='undocumented#Text'>text</a>, strokes and fills, and images. 163 164Some options may not be implemented on all platforms; in these cases, setting 165the option has no effect. Some options are conveniences that duplicate <a href='SkCanvas_Reference#Canvas'>Canvas</a> 166functionality; for instance, <a href='#Text_Size'>text size</a> is identical to <a href='SkMatrix_Reference#Matrix'>matrix</a> scale. 167 168<a href='SkPaint_Reference#Paint'>Paint</a> options are rarely exclusive; each option modifies a stage of the drawing 169pipeline and multiple pipeline stages may be affected by a single <a href='SkPaint_Reference#Paint'>Paint</a>. 170 171<a href='SkPaint_Reference#Paint'>Paint</a> collects effects and filters that describe single-pass and multiple-pass 172algorithms that alter the drawing geometry, <a href='SkColor_Reference#Color'>color</a>, and transparency. For instance, 173<a href='SkPaint_Reference#Paint'>Paint</a> does not directly implement dashing or blur, but contains the objects that do so. 174 175The objects contained by <a href='SkPaint_Reference#Paint'>Paint</a> are opaque, and cannot be edited outside of the <a href='SkPaint_Reference#Paint'>Paint</a> 176to affect it. The implementation is free to defer computations associated with the 177<a href='SkPaint_Reference#Paint'>Paint</a>, or ignore them altogether. For instance, some GPU implementations draw all 178<a href='SkPath_Reference#Path'>Path</a> geometries with <a href='#Paint_Anti_Alias'>Anti_Aliasing</a>, regardless of how <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> 179is set in <a href='SkPaint_Reference#Paint'>Paint</a>. 180 181<a href='SkPaint_Reference#Paint'>Paint</a> describes a single <a href='SkColor_Reference#Color'>color</a>, a single <a href='SkFont_Reference#Font'>font</a>, a single <a href='SkImage_Reference#Image'>image</a> quality, and so on. 182Multiple colors are drawn either by using multiple paints or with objects like 183<a href='undocumented#Shader'>Shader</a> attached to <a href='SkPaint_Reference#Paint'>Paint</a>. 184 185<a name='SkPaint_empty_constructor'></a> 186 187--- 188 189<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 190<a href='#SkPaint_empty_constructor'>SkPaint()</a> 191</pre> 192 193Constructs <a href='SkPaint_Reference#Paint'>Paint</a> with default values. 194 195| attribute | default value | 196| --- | --- | 197| <a href='#Paint_Anti_Alias'>Anti_Alias</a> | false | 198| <a href='#Blend_Mode'>Blend_Mode</a> | <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a> | 199| <a href='SkColor_Reference#Color'>Color</a> | <a href='SkColor_Reference#SK_ColorBLACK'>SK_ColorBLACK</a> | 200| <a href='#Color_Alpha'>Color_Alpha</a> | 255 | 201| <a href='#Color_Filter'>Color_Filter</a> | nullptr | 202| Dither | false | 203| <a href='#Draw_Looper'>Draw_Looper</a> | nullptr | 204| <a href='#Filter_Quality'>Filter_Quality</a> | <a href='undocumented#kNone_SkFilterQuality'>kNone_SkFilterQuality</a> | 205| <a href='#Font_Force_Hinting'>Font_Force_Hinting</a> | false | 206| <a href='#Font_Embedded_Bitmaps'>Font_Embedded_Bitmaps</a> | false | 207| <a href='#Font_Embolden'>Font_Embolden</a> | false | 208| <a href='#Font_Hinting'>Font_Hinting</a> | <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a> | 209| <a href='#Font_Hinting_Spacing'>Font_Hinting_Spacing</a> | false | 210| <a href='#Font_Anti_Alias'>Font_Anti_Alias</a> | false | 211| <a href='#Font_Linear'>Font_Linear</a> | false | 212| <a href='#Font_Scale_X'>Font_Scale_X</a> | 1 | 213| <a href='#Font_Size'>Font_Size</a> | 12 | 214| <a href='#Font_Skew_X'>Font_Skew_X</a> | 0 | 215| <a href='#Font_Subpixel'>Font_Subpixel</a> | false | 216| <a href='#Image_Filter'>Image_Filter</a> | nullptr | 217| <a href='#Paint_Miter_Limit'>Miter_Limit</a> | 4 | 218| <a href='#Mask_Filter'>Mask_Filter</a> | nullptr | 219| <a href='#Path_Effect'>Path_Effect</a> | nullptr | 220| <a href='undocumented#Shader'>Shader</a> | nullptr | 221| <a href='#SkPaint_Style'>Style</a> | <a href='#SkPaint_kFill_Style'>kFill_Style</a> | 222| <a href='#Text_Encoding'>Text_Encoding</a> | <a href='undocumented#SkTextEncoding::kUTF8'>SkTextEncoding::kUTF8</a> | 223| <a href='undocumented#Typeface'>Typeface</a> | nullptr | 224| <a href='#Paint_Stroke_Cap'>Stroke_Cap</a> | <a href='#SkPaint_kButt_Cap'>kButt_Cap</a> | 225| <a href='#Paint_Stroke_Join'>Stroke_Join</a> | <a href='#SkPaint_kMiter_Join'>kMiter_Join</a> | 226| <a href='#Paint_Stroke_Width'>Stroke_Width</a> | 0 | 227 228The flags, <a href='undocumented#Text'>text</a> <a href='undocumented#Size'>size</a>, hinting, and miter limit may be overridden at compile time by defining 229<a href='SkPaint_Reference#Paint'>paint</a> default values. The overrides may be included in "SkUserConfig.h" or predefined by the 230build system. 231 232### Return Value 233 234default initialized <a href='SkPaint_Reference#Paint'>Paint</a> 235 236### Example 237 238<div><fiddle-embed name="c4b2186d85c142a481298f7144295ffd"></fiddle-embed></div> 239 240<a name='SkPaint_copy_const_SkPaint'></a> 241 242--- 243 244<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 245<a href='#SkPaint_copy_const_SkPaint'>SkPaint</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='SkPaint_Reference#Paint'>paint</a>) 246</pre> 247 248Makes a shallow copy of <a href='SkPaint_Reference#SkPaint'>SkPaint</a>. <a href='undocumented#SkTypeface'>SkTypeface</a>, <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, 249<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, <a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, and <a href='undocumented#SkImageFilter'>SkImageFilter</a> are shared 250between the original <a href='#SkPaint_copy_const_SkPaint_paint'>paint</a> and the copy. Objects containing <a href='undocumented#SkRefCnt'>SkRefCnt</a> increment 251their references by one. 252 253The referenced objects <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, <a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, 254<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, and <a href='undocumented#SkImageFilter'>SkImageFilter</a> cannot be modified after they are created. 255This prevents objects with <a href='undocumented#SkRefCnt'>SkRefCnt</a> from being modified once <a href='SkPaint_Reference#SkPaint'>SkPaint</a> refers to them. 256 257### Parameters 258 259<table> <tr> <td><a name='SkPaint_copy_const_SkPaint_paint'><code><strong>paint</strong></code></a></td> 260 <td>original to copy</td> 261 </tr> 262</table> 263 264### Return Value 265 266shallow copy of <a href='#SkPaint_copy_const_SkPaint_paint'>paint</a> 267 268### Example 269 270<div><fiddle-embed name="b99971ad0ef243d617925289d963b62d"> 271 272#### Example Output 273 274~~~~ 275SK_ColorRED == paint1.getColor() 276SK_ColorBLUE == paint2.getColor() 277~~~~ 278 279</fiddle-embed></div> 280 281<a name='SkPaint_move_SkPaint'></a> 282 283--- 284 285<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 286<a href='#SkPaint_move_SkPaint'>SkPaint</a>(<a href='SkPaint_Reference#SkPaint'>SkPaint</a>&& <a href='SkPaint_Reference#Paint'>paint</a>) 287</pre> 288 289Implements a move constructor to avoid increasing the reference counts 290of objects referenced by the <a href='#SkPaint_move_SkPaint_paint'>paint</a>. 291 292After the call, <a href='#SkPaint_move_SkPaint_paint'>paint</a> is undefined, and can be safely destructed. 293 294### Parameters 295 296<table> <tr> <td><a name='SkPaint_move_SkPaint_paint'><code><strong>paint</strong></code></a></td> 297 <td>original to move</td> 298 </tr> 299</table> 300 301### Return Value 302 303content of <a href='#SkPaint_move_SkPaint_paint'>paint</a> 304 305### Example 306 307<div><fiddle-embed name="8ed1488a503cd5282b86a51614aa90b1"> 308 309#### Example Output 310 311~~~~ 312path effect unique: true 313~~~~ 314 315</fiddle-embed></div> 316 317<a name='SkPaint_reset'></a> 318 319--- 320 321<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 322void <a href='#SkPaint_reset'>reset()</a> 323</pre> 324 325Sets all <a href='SkPaint_Reference#SkPaint'>SkPaint</a> contents to their initial values. This is equivalent to replacing 326<a href='SkPaint_Reference#SkPaint'>SkPaint</a> with the result of <a href='#SkPaint_empty_constructor'>SkPaint()</a>. 327 328### Example 329 330<div><fiddle-embed name="ef269937ade7e7353635121d9a64f9f7"> 331 332#### Example Output 333 334~~~~ 335paint1 == paint2 336~~~~ 337 338</fiddle-embed></div> 339 340<a name='SkPaint_destructor'></a> 341 342--- 343 344<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 345<a href='#SkPaint_destructor'>~SkPaint()</a> 346</pre> 347 348Decreases <a href='SkPaint_Reference#SkPaint'>SkPaint</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> of owned objects: <a href='undocumented#SkTypeface'>SkTypeface</a>, <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, 349<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, <a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, and <a href='undocumented#SkImageFilter'>SkImageFilter</a>. If the 350objects containing <a href='undocumented#SkRefCnt'>SkRefCnt</a> go to zero, they are deleted. 351 352<a name='Management'></a> 353 354<a name='SkPaint_copy_operator'></a> 355 356--- 357 358<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 359<a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_copy_operator'>operator=</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='SkPaint_Reference#Paint'>paint</a>) 360</pre> 361 362Makes a shallow copy of <a href='SkPaint_Reference#SkPaint'>SkPaint</a>. <a href='undocumented#SkTypeface'>SkTypeface</a>, <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, 363<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, <a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, and <a href='undocumented#SkImageFilter'>SkImageFilter</a> are shared 364between the original <a href='#SkPaint_copy_operator_paint'>paint</a> and the copy. Objects containing <a href='undocumented#SkRefCnt'>SkRefCnt</a> in the 365prior destination are decreased by one, and the referenced objects are deleted if the 366resulting count is zero. Objects containing <a href='undocumented#SkRefCnt'>SkRefCnt</a> in the parameter <a href='#SkPaint_copy_operator_paint'>paint</a> 367are increased by one. <a href='#SkPaint_copy_operator_paint'>paint</a> is unmodified. 368 369### Parameters 370 371<table> <tr> <td><a name='SkPaint_copy_operator_paint'><code><strong>paint</strong></code></a></td> 372 <td>original to copy</td> 373 </tr> 374</table> 375 376### Return Value 377 378content of <a href='#SkPaint_copy_operator_paint'>paint</a> 379 380### Example 381 382<div><fiddle-embed name="b476a9088f80dece176ed577807d3992"> 383 384#### Example Output 385 386~~~~ 387SK_ColorRED == paint1.getColor() 388SK_ColorRED == paint2.getColor() 389~~~~ 390 391</fiddle-embed></div> 392 393<a name='SkPaint_move_operator'></a> 394 395--- 396 397<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 398<a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_move_operator'>operator=</a>(<a href='SkPaint_Reference#SkPaint'>SkPaint</a>&& <a href='SkPaint_Reference#Paint'>paint</a>) 399</pre> 400 401Moves the <a href='#SkPaint_move_operator_paint'>paint</a> to avoid increasing the reference counts 402of objects referenced by the <a href='#SkPaint_move_operator_paint'>paint</a> parameter. Objects containing <a href='undocumented#SkRefCnt'>SkRefCnt</a> in the 403prior destination are decreased by one; those objects are deleted if the resulting count 404is zero. 405 406After the call, <a href='#SkPaint_move_operator_paint'>paint</a> is undefined, and can be safely destructed. 407 408### Parameters 409 410<table> <tr> <td><a name='SkPaint_move_operator_paint'><code><strong>paint</strong></code></a></td> 411 <td>original to move</td> 412 </tr> 413</table> 414 415### Return Value 416 417content of <a href='#SkPaint_move_operator_paint'>paint</a> 418 419### Example 420 421<div><fiddle-embed name="9fb7459b097d713f5f1fe5675afe14f5"> 422 423#### Example Output 424 425~~~~ 426SK_ColorRED == paint2.getColor() 427~~~~ 428 429</fiddle-embed></div> 430 431<a name='SkPaint_equal_operator'></a> 432 433--- 434 435<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 436bool <a href='#SkPaint_equal_operator'>operator==</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& a, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& b) 437</pre> 438 439Compares <a href='#SkPaint_equal_operator_a'>a</a> and <a href='#SkPaint_equal_operator_b'>b</a>, and returns true if <a href='#SkPaint_equal_operator_a'>a</a> and <a href='#SkPaint_equal_operator_b'>b</a> are equivalent. May return false 440if <a href='undocumented#SkTypeface'>SkTypeface</a>, <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, <a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, 441<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, or <a href='undocumented#SkImageFilter'>SkImageFilter</a> have identical contents but different pointers. 442 443### Parameters 444 445<table> <tr> <td><a name='SkPaint_equal_operator_a'><code><strong>a</strong></code></a></td> 446 <td><a href='SkPaint_Reference#SkPaint'>SkPaint</a> to compare</td> 447 </tr> 448 <tr> <td><a name='SkPaint_equal_operator_b'><code><strong>b</strong></code></a></td> 449 <td><a href='SkPaint_Reference#SkPaint'>SkPaint</a> to compare</td> 450 </tr> 451</table> 452 453### Return Value 454 455true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a> pair are equivalent 456 457### Example 458 459<div><fiddle-embed name="7481a948e34672720337a631830586dd"> 460 461#### Example Output 462 463~~~~ 464paint1 == paint2 465paint1 != paint2 466~~~~ 467 468</fiddle-embed></div> 469 470### See Also 471 472<a href='#SkPaint_notequal_operator'>operator!=</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_equal_operator_a'>a</a>, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_equal_operator_b'>b</a>) 473 474<a name='SkPaint_notequal_operator'></a> 475 476--- 477 478<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 479bool <a href='#SkPaint_notequal_operator'>operator!=</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& a, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& b) 480</pre> 481 482Compares <a href='#SkPaint_notequal_operator_a'>a</a> and <a href='#SkPaint_notequal_operator_b'>b</a>, and returns true if <a href='#SkPaint_notequal_operator_a'>a</a> and <a href='#SkPaint_notequal_operator_b'>b</a> are not equivalent. May return true 483if <a href='undocumented#SkTypeface'>SkTypeface</a>, <a href='undocumented#SkPathEffect'>SkPathEffect</a>, <a href='undocumented#SkShader'>SkShader</a>, <a href='undocumented#SkMaskFilter'>SkMaskFilter</a>, <a href='undocumented#SkColorFilter'>SkColorFilter</a>, 484<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>, or <a href='undocumented#SkImageFilter'>SkImageFilter</a> have identical contents but different pointers. 485 486### Parameters 487 488<table> <tr> <td><a name='SkPaint_notequal_operator_a'><code><strong>a</strong></code></a></td> 489 <td><a href='SkPaint_Reference#SkPaint'>SkPaint</a> to compare</td> 490 </tr> 491 <tr> <td><a name='SkPaint_notequal_operator_b'><code><strong>b</strong></code></a></td> 492 <td><a href='SkPaint_Reference#SkPaint'>SkPaint</a> to compare</td> 493 </tr> 494</table> 495 496### Return Value 497 498true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a> pair are not equivalent 499 500### Example 501 502<div><fiddle-embed name="b6c8484b1187f555b435ad5369833be4"> 503 504#### Example Output 505 506~~~~ 507paint1 == paint2 508paint1 == paint2 509~~~~ 510 511</fiddle-embed></div> 512 513### See Also 514 515<a href='#SkPaint_equal_operator'>operator==</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_notequal_operator_a'>a</a>, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& <a href='#SkPaint_notequal_operator_b'>b</a>) 516 517<a name='SkPaint_getHash'></a> 518 519--- 520 521<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 522uint32_t <a href='#SkPaint_getHash'>getHash</a>()const 523</pre> 524 525Returns a hash generated from <a href='SkPaint_Reference#SkPaint'>SkPaint</a> values and pointers. 526Identical hashes guarantee that the paints are 527equivalent, but differing hashes do not guarantee that the paints have differing 528contents. 529 530If <a href='#SkPaint_equal_operator'>operator==</a>(const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& a, const <a href='SkPaint_Reference#SkPaint'>SkPaint</a>& b) returns true for two paints, 531their hashes are also equal. 532 533The hash returned is platform and implementation specific. 534 535### Return Value 536 537a shallow hash 538 539### Example 540 541<div><fiddle-embed name="7f7e1b701361912b344f90ae6b530393"> 542 543#### Example Output 544 545~~~~ 546paint1 == paint2 547paint1.getHash() == paint2.getHash() 548~~~~ 549 550</fiddle-embed></div> 551 552<a name='Hinting'></a> 553 554<a name='SkPaint_setHinting'></a> 555 556--- 557 558<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 559void <a href='#SkPaint_setHinting'>setHinting</a>(<a href='undocumented#SkFontHinting'>SkFontHinting</a> hintingLevel) 560</pre> 561 562Sets level of <a href='undocumented#Glyph'>glyph</a> outline adjustment. 563Does not check for valid values of <a href='#SkPaint_setHinting_hintingLevel'>hintingLevel</a>. 564 565### Parameters 566 567<table> <tr> <td><a name='SkPaint_setHinting_hintingLevel'><code><strong>hintingLevel</strong></code></a></td> 568 <td>one of: <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNone'>kNone</a>, <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kSlight'>kSlight</a>,</td> 569 </tr> 570</table> 571 572<a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a>, <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kFull'>kFull</a> 573 574### Example 575 576<div><fiddle-embed name="bb179ec5698ec1398ff18f3657ab73f7"> 577 578#### Example Output 579 580~~~~ 581paint1 == paint2 582~~~~ 583 584</fiddle-embed></div> 585 586<a name='SkPaint_getHinting'></a> 587 588--- 589 590<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 591<a href='undocumented#SkFontHinting'>SkFontHinting</a> <a href='#SkPaint_getHinting'>getHinting</a>()const 592</pre> 593 594Returns level of <a href='undocumented#Glyph'>glyph</a> outline adjustment. 595 596### Return Value 597 598one of: <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNone'>kNone</a>, <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kSlight'>kSlight</a>, <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a>, 599 600<a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kFull'>kFull</a> 601 602### Example 603 604<div><fiddle-embed name="b56b70c7ea2453c41bfa58b626953bed"> 605 606#### Example Output 607 608~~~~ 609SkFontHinting::kNormal == paint.getHinting() 610~~~~ 611 612</fiddle-embed></div> 613 614### Constants 615 616<table style='border-collapse: collapse; width: 62.5em'> 617 <tr><th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Const</th> 618<th style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>Value</th> 619<th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Description</th></tr> 620 <tr style='background-color: #f0f0f0; '> 621 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kAntiAlias_Flag'><code>SkPaint::kAntiAlias_Flag</code></a></td> 622 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0001</td> 623 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 624mask for setting Anti_Alias</td> 625 </tr> 626 <tr> 627 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kDither_Flag'><code>SkPaint::kDither_Flag</code></a></td> 628 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0004</td> 629 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 630mask for setting Dither</td> 631 </tr> 632 <tr style='background-color: #f0f0f0; '> 633 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kFakeBoldText_Flag'><code>SkPaint::kFakeBoldText_Flag</code></a></td> 634 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0020</td> 635 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 636mask for setting Font_Embolden</td> 637 </tr> 638 <tr> 639 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kLinearText_Flag'><code>SkPaint::kLinearText_Flag</code></a></td> 640 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0040</td> 641 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 642mask for setting Font_Linear</td> 643 </tr> 644 <tr style='background-color: #f0f0f0; '> 645 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kSubpixelText_Flag'><code>SkPaint::kSubpixelText_Flag</code></a></td> 646 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0080</td> 647 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 648mask for setting Font_Subpixel</td> 649 </tr> 650 <tr> 651 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kLCDRenderText_Flag'><code>SkPaint::kLCDRenderText_Flag</code></a></td> 652 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0200</td> 653 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 654mask for setting Font_Anti_Alias</td> 655 </tr> 656 <tr style='background-color: #f0f0f0; '> 657 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kEmbeddedBitmapText_Flag'><code>SkPaint::kEmbeddedBitmapText_Flag</code></a></td> 658 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0400</td> 659 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 660mask for setting Font_Embedded_Bitmaps</td> 661 </tr> 662 <tr> 663 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kAutoHinting_Flag'><code>SkPaint::kAutoHinting_Flag</code></a></td> 664 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0x0800</td> 665 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 666mask for setting Font_Force_Hinting</td> 667 </tr> 668 <tr style='background-color: #f0f0f0; '> 669 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kAllFlags'><code>SkPaint::kAllFlags</code></a></td> 670 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0xFFFF</td> 671 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 672mask of all <a href='#SkPaint_Flags'>Flags</a>, including private flags and flags reserved for future use 673</td> 674 </tr> 675<a href='#SkPaint_Flags'>Flags</a> default to all flags clear, disabling the associated feature. 676</table> 677 678<a name='SkPaint_getFlags'></a> 679 680--- 681 682<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 683uint32_t <a href='#SkPaint_getFlags'>getFlags</a>()const 684</pre> 685 686Returns <a href='SkPaint_Reference#Paint'>paint</a> settings described by <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a>. Each setting uses one 687bit, and can be tested with <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> members. 688 689### Return Value 690 691zero, one, or more bits described by <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> 692 693### Example 694 695<div><fiddle-embed name="8a3f8c309533388b01aa66e1267f322d"> 696 697#### Example Output 698 699~~~~ 700(SkPaint::kAntiAlias_Flag & paint.getFlags()) != 0 701~~~~ 702 703</fiddle-embed></div> 704 705<a name='SkPaint_setFlags'></a> 706 707--- 708 709<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 710void <a href='#SkPaint_setFlags'>setFlags</a>(uint32_t flags) 711</pre> 712 713Replaces <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> with <a href='#SkPaint_setFlags_flags'>flags</a>, the union of the <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> members. 714All <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> members may be cleared, or one or more may be set. 715 716### Parameters 717 718<table> <tr> <td><a name='SkPaint_setFlags_flags'><code><strong>flags</strong></code></a></td> 719 <td>union of <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> for <a href='SkPaint_Reference#SkPaint'>SkPaint</a></td> 720 </tr> 721</table> 722 723### Example 724 725<div><fiddle-embed name="54baed3f6bc4b9c31ba664e27767fdc7"> 726 727#### Example Output 728 729~~~~ 730paint.isAntiAlias() 731paint.isDither() 732~~~~ 733 734</fiddle-embed></div> 735 736<a name='Anti_Alias'></a> 737 738--- 739 740<a href='#Paint_Anti_Alias'>Anti_Alias</a> drawing approximates partial <a href='undocumented#Pixel'>pixel</a> coverage with transparency. 741If <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> is clear, <a href='undocumented#Pixel'>pixel</a> centers contained by the shape edge are drawn opaque. 742If <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> is set, pixels are drawn with <a href='#Color_Alpha'>Color_Alpha</a> equal to their coverage. 743 744The rule for <a href='undocumented#Alias'>Aliased</a> pixels is inconsistent across platforms. A shape edge 745passing through the <a href='undocumented#Pixel'>pixel</a> center may, but is not required to, draw the <a href='undocumented#Pixel'>pixel</a>. 746 747<a href='#Raster_Engine'>Raster_Engine</a> draws <a href='undocumented#Alias'>Aliased</a> pixels whose centers are on or to the right of the start of an 748active <a href='SkPath_Reference#Path'>Path</a> edge, and whose center is to the left of the end of the active <a href='SkPath_Reference#Path'>Path</a> edge. 749 750A platform may only support <a href='#Paint_Anti_Alias'>Anti_Aliased</a> drawing. Some GPU-backed platforms use 751<a href='undocumented#Supersampling'>Supersampling</a> to <a href='#Paint_Anti_Alias'>Anti_Alias</a> all drawing, and have no mechanism to selectively 752<a href='undocumented#Alias'>Alias</a>. 753 754The amount of coverage computed for <a href='#Paint_Anti_Alias'>Anti_Aliased</a> pixels also varies across platforms. 755 756<a href='#Paint_Anti_Alias'>Anti_Alias</a> is disabled by default. 757<a href='#Paint_Anti_Alias'>Anti_Alias</a> can be enabled by default by setting <a href='undocumented#SkPaintDefaults_Flags'>SkPaintDefaults_Flags</a> to <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> 758at compile time. 759 760### Example 761 762<div><fiddle-embed name="a6575a49467ce8d28bb01cc7638fa04d"><div>A red <a href='undocumented#Line'>line</a> is drawn with transparency on the edges to make it look smoother. 763A blue <a href='undocumented#Line'>line</a> draws only where the <a href='undocumented#Pixel'>pixel</a> centers are contained. 764The <a href='undocumented#Line'>lines</a> are drawn into <a href='SkBitmap_Reference#Bitmap'>Bitmap</a>, then drawn magnified to make the 765<a href='undocumented#Alias'>Aliasing</a> easier to see. 766</div></fiddle-embed></div> 767 768<a name='SkPaint_isAntiAlias'></a> 769 770--- 771 772<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 773bool <a href='#SkPaint_isAntiAlias'>isAntiAlias</a>()const 774</pre> 775 776Returns true if pixels on the active edges of <a href='SkPath_Reference#SkPath'>SkPath</a> may be drawn with partial transparency. 777 778Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a>. 779 780### Return Value 781 782<a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> state 783 784### Example 785 786<div><fiddle-embed name="d7d5f4f7da7acd5104a652f490c6f7b8"> 787 788#### Example Output 789 790~~~~ 791paint.isAntiAlias() == !!(paint.getFlags() & SkPaint::kAntiAlias_Flag) 792paint.isAntiAlias() == !!(paint.getFlags() & SkPaint::kAntiAlias_Flag) 793~~~~ 794 795</fiddle-embed></div> 796 797<a name='SkPaint_setAntiAlias'></a> 798 799--- 800 801<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 802void <a href='#SkPaint_setAntiAlias'>setAntiAlias</a>(bool aa) 803</pre> 804 805Requests, but does not require, that edge pixels draw opaque or with 806partial transparency. 807 808Sets <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> if <a href='#SkPaint_setAntiAlias_aa'>aa</a> is true. 809Clears <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> if <a href='#SkPaint_setAntiAlias_aa'>aa</a> is false. 810 811### Parameters 812 813<table> <tr> <td><a name='SkPaint_setAntiAlias_aa'><code><strong>aa</strong></code></a></td> 814 <td>setting for <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a></td> 815 </tr> 816</table> 817 818### Example 819 820<div><fiddle-embed name="c2ff148374d01cbef845b223e725905c"> 821 822#### Example Output 823 824~~~~ 825paint1 == paint2 826~~~~ 827 828</fiddle-embed></div> 829 830<a name='Dither'></a> 831 832--- 833 834Dither increases fidelity by adjusting the <a href='SkColor_Reference#Color'>color</a> of adjacent pixels. 835This can help to smooth <a href='SkColor_Reference#Color'>color</a> transitions and reducing banding in gradients. 836Dithering lessens visible banding from <a href='SkImageInfo_Reference#kRGB_565_SkColorType'>kRGB_565_SkColorType</a> 837and <a href='SkImageInfo_Reference#kRGBA_8888_SkColorType'>kRGBA_8888_SkColorType</a> gradients, 838and improves rendering into a <a href='SkImageInfo_Reference#kRGB_565_SkColorType'>kRGB_565_SkColorType</a> <a href='SkSurface_Reference#Surface'>Surface</a>. 839 840Dithering is always enabled for linear gradients drawing into 841<a href='SkImageInfo_Reference#kRGB_565_SkColorType'>kRGB_565_SkColorType</a> <a href='SkSurface_Reference#Surface'>Surface</a> and <a href='SkImageInfo_Reference#kRGBA_8888_SkColorType'>kRGBA_8888_SkColorType</a> <a href='SkSurface_Reference#Surface'>Surface</a>. 842Dither cannot be enabled for <a href='SkImageInfo_Reference#kAlpha_8_SkColorType'>kAlpha_8_SkColorType</a> <a href='SkSurface_Reference#Surface'>Surface</a> and 843<a href='SkImageInfo_Reference#kRGBA_F16_SkColorType'>kRGBA_F16_SkColorType</a> <a href='SkSurface_Reference#Surface'>Surface</a>. 844 845Dither is disabled by default. 846Dither can be enabled by default by setting <a href='undocumented#SkPaintDefaults_Flags'>SkPaintDefaults_Flags</a> to <a href='#SkPaint_kDither_Flag'>kDither_Flag</a> 847at compile time. 848 849Some platform implementations may ignore dithering. Set <code>SK_IGNORE_GPU_DITHER</code>to ignore Dither on <a href='#GPU_Surface'>GPU_Surface</a>. 850 851### Example 852 853<div><fiddle-embed name="8b26507690b71462f44642b911890bbf"><div>Dithering in the bottom half more closely approximates the requested <a href='SkColor_Reference#Color'>color</a> by 854alternating nearby colors from <a href='undocumented#Pixel'>pixel</a> to <a href='undocumented#Pixel'>pixel</a>. 855</div></fiddle-embed></div> 856 857### Example 858 859<div><fiddle-embed name="76d4d4a7931a48495e4d5f54e073be53"><div>Dithering introduces subtle adjustments to <a href='SkColor_Reference#Color'>color</a> to smooth gradients. 860Drawing the gradient repeatedly with <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kPlus'>kPlus</a> exaggerates the 861dither, making it easier to see. 862</div></fiddle-embed></div> 863 864### See Also 865 866Gradient <a href='SkImageInfo_Reference#kRGB_565_SkColorType'>kRGB_565_SkColorType</a> 867 868<a name='SkPaint_isDither'></a> 869 870--- 871 872<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 873bool <a href='#SkPaint_isDither'>isDither</a>()const 874</pre> 875 876Returns true if <a href='SkColor_Reference#Color'>color</a> error may be distributed to smooth <a href='SkColor_Reference#Color'>color</a> transition. 877 878Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kDither_Flag'>kDither_Flag</a>. 879 880### Return Value 881 882<a href='#SkPaint_kDither_Flag'>kDither_Flag</a> state 883 884### Example 885 886<div><fiddle-embed name="f4ce93f6c5e7335436a985377fd980c0"> 887 888#### Example Output 889 890~~~~ 891paint.isDither() == !!(paint.getFlags() & SkPaint::kDither_Flag) 892paint.isDither() == !!(paint.getFlags() & SkPaint::kDither_Flag) 893~~~~ 894 895</fiddle-embed></div> 896 897<a name='SkPaint_setDither'></a> 898 899--- 900 901<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 902void <a href='#SkPaint_setDither'>setDither</a>(bool dither) 903</pre> 904 905Requests, but does not require, to distribute <a href='SkColor_Reference#Color'>color</a> error. 906 907Sets <a href='#SkPaint_kDither_Flag'>kDither_Flag</a> if <a href='#SkPaint_setDither_dither'>dither</a> is true. 908Clears <a href='#SkPaint_kDither_Flag'>kDither_Flag</a> if <a href='#SkPaint_setDither_dither'>dither</a> is false. 909 910### Parameters 911 912<table> <tr> <td><a name='SkPaint_setDither_dither'><code><strong>dither</strong></code></a></td> 913 <td>setting for <a href='#SkPaint_kDither_Flag'>kDither_Flag</a></td> 914 </tr> 915</table> 916 917### Example 918 919<div><fiddle-embed name="69b7162e8324d9239dd02dd9ada2bdff"> 920 921#### Example Output 922 923~~~~ 924paint1 == paint2 925~~~~ 926 927</fiddle-embed></div> 928 929### See Also 930 931<a href='SkImageInfo_Reference#kRGB_565_SkColorType'>kRGB_565_SkColorType</a> 932 933<a name='Device_Text'></a> 934 935--- 936 937<a href='#Font_Anti_Alias'>Font_Anti_Alias</a> and <a href='#Font_Subpixel'>Font_Subpixel</a> increase the precision of <a href='undocumented#Glyph'>glyph</a> position. 938 939When set, <a href='#SkPaint_Flags'>Flags</a> <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> takes advantage of the organization of RGB stripes that 940create a <a href='SkColor_Reference#Color'>color</a>, and relies 941on the small <a href='undocumented#Size'>size</a> of the stripe and visual perception to make the <a href='SkColor_Reference#Color'>color</a> fringing imperceptible. 942<a href='#Font_Anti_Alias'>Font_Anti_Alias</a> can be enabled on devices that orient stripes horizontally or vertically, and that order 943the <a href='SkColor_Reference#Color'>color</a> components as RGB or BGR. 944 945<a href='#SkPaint_Flags'>Flags</a> <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> uses the <a href='undocumented#Pixel'>pixel</a> transparency to represent a fractional offset. 946As the opaqueness 947of the <a href='SkColor_Reference#Color'>color</a> increases, the edge of the <a href='undocumented#Glyph'>glyph</a> appears to move towards the outside of the <a href='undocumented#Pixel'>pixel</a>. 948 949Either or both techniques can be enabled. 950<a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> and <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> are clear by default. 951<a href='#Font_Anti_Alias'>Font_Anti_Alias</a> or <a href='#Font_Subpixel'>Font_Subpixel</a> can be enabled by default by setting <a href='undocumented#SkPaintDefaults_Flags'>SkPaintDefaults_Flags</a> to 952<a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> or <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> (or both) at compile time. 953 954### Example 955 956<div><fiddle-embed name="4606ae1be792d6bc46d496432f050ee9"><div>Four commas are drawn normally and with combinations of <a href='#Font_Anti_Alias'>Font_Anti_Alias</a> and <a href='#Font_Subpixel'>Font_Subpixel</a>. 957When <a href='#Font_Subpixel'>Font_Subpixel</a> is disabled, the comma <a href='undocumented#Glyph'>Glyphs</a> are identical, but not evenly spaced. 958When <a href='#Font_Subpixel'>Font_Subpixel</a> is enabled, the comma <a href='undocumented#Glyph'>Glyphs</a> are unique, but appear evenly spaced. 959</div></fiddle-embed></div> 960 961<a name='Linear_Text'></a> 962 963<a href='#Font_Linear'>Font_Linear</a> selects whether <a href='undocumented#Text'>text</a> is rendered as a <a href='undocumented#Glyph'>Glyph</a> or as a <a href='SkPath_Reference#Path'>Path</a>. 964If <a href='#Font_Linear'>Font_Linear</a> is set, it has the same effect as setting Hinting to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a>. 965If <a href='#Font_Linear'>Font_Linear</a> is clear, it is the same as setting Hinting to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNone'>kNone</a>. 966 967<a name='SkPaint_isLinearText'></a> 968 969--- 970 971<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 972bool <a href='#SkPaint_isLinearText'>isLinearText</a>()const 973</pre> 974 975Returns true if <a href='undocumented#Text'>text</a> is converted to <a href='SkPath_Reference#SkPath'>SkPath</a> before drawing and measuring. 976 977Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a>. 978 979### Return Value 980 981<a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a> state 982 983### Example 984 985<div><fiddle-embed name="2890ad644f980637837e6fcb386fb462"></fiddle-embed></div> 986 987### See Also 988 989<a href='#SkPaint_setLinearText'>setLinearText</a> Hinting 990 991<a name='SkPaint_setLinearText'></a> 992 993--- 994 995<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 996void <a href='#SkPaint_setLinearText'>setLinearText</a>(bool linearText) 997</pre> 998 999Requests, but does not require, that <a href='undocumented#Glyph'>glyphs</a> are converted to <a href='SkPath_Reference#SkPath'>SkPath</a> 1000before drawing and measuring. 1001By default, <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a> is clear. 1002 1003Sets <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a> if <a href='#SkPaint_setLinearText_linearText'>linearText</a> is true. 1004Clears <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a> if <a href='#SkPaint_setLinearText_linearText'>linearText</a> is false. 1005 1006### Parameters 1007 1008<table> <tr> <td><a name='SkPaint_setLinearText_linearText'><code><strong>linearText</strong></code></a></td> 1009 <td>setting for <a href='#SkPaint_kLinearText_Flag'>kLinearText_Flag</a></td> 1010 </tr> 1011</table> 1012 1013### Example 1014 1015<div><fiddle-embed name="c93bb912f3bddfb4d96d3ad70ada552b"></fiddle-embed></div> 1016 1017### See Also 1018 1019<a href='#SkPaint_isLinearText'>isLinearText</a> Hinting 1020 1021<a name='Subpixel_Text'></a> 1022 1023<a href='#SkPaint_Flags'>Flags</a> <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> uses the <a href='undocumented#Pixel'>pixel</a> transparency to represent a fractional offset. 1024As the opaqueness 1025of the <a href='SkColor_Reference#Color'>color</a> increases, the edge of the <a href='undocumented#Glyph'>glyph</a> appears to move towards the outside of the <a href='undocumented#Pixel'>pixel</a>. 1026 1027<a name='SkPaint_isSubpixelText'></a> 1028 1029--- 1030 1031<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1032bool <a href='#SkPaint_isSubpixelText'>isSubpixelText</a>()const 1033</pre> 1034 1035Returns true if <a href='undocumented#Glyph'>glyphs</a> at different <a href='SkFont_Reference#Subpixel'>sub-pixel</a> positions may differ on <a href='undocumented#Pixel'>pixel</a> edge coverage. 1036 1037Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a>. 1038 1039### Return Value 1040 1041<a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> state 1042 1043### Example 1044 1045<div><fiddle-embed name="abe9afc0932e2199324ae6cbb396e67c"> 1046 1047#### Example Output 1048 1049~~~~ 1050paint.isSubpixelText() == !!(paint.getFlags() & SkPaint::kSubpixelText_Flag) 1051paint.isSubpixelText() == !!(paint.getFlags() & SkPaint::kSubpixelText_Flag) 1052~~~~ 1053 1054</fiddle-embed></div> 1055 1056<a name='SkPaint_setSubpixelText'></a> 1057 1058--- 1059 1060<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1061void <a href='#SkPaint_setSubpixelText'>setSubpixelText</a>(bool subpixelText) 1062</pre> 1063 1064Requests, but does not require, that <a href='undocumented#Glyph'>glyphs</a> respect <a href='SkFont_Reference#Subpixel'>sub-pixel</a> positioning. 1065 1066Sets <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> if <a href='#SkPaint_setSubpixelText_subpixelText'>subpixelText</a> is true. 1067Clears <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a> if <a href='#SkPaint_setSubpixelText_subpixelText'>subpixelText</a> is false. 1068 1069### Parameters 1070 1071<table> <tr> <td><a name='SkPaint_setSubpixelText_subpixelText'><code><strong>subpixelText</strong></code></a></td> 1072 <td>setting for <a href='#SkPaint_kSubpixelText_Flag'>kSubpixelText_Flag</a></td> 1073 </tr> 1074</table> 1075 1076### Example 1077 1078<div><fiddle-embed name="a77bbc1a4e3be9a8ab0f842f877c5ee4"> 1079 1080#### Example Output 1081 1082~~~~ 1083paint1 == paint2 1084~~~~ 1085 1086</fiddle-embed></div> 1087 1088<a name='LCD_Text'></a> 1089 1090When set, <a href='#Font_Anti_Alias'>Font_Anti_Alias</a> takes advantage of the organization of RGB stripes that 1091create a <a href='SkColor_Reference#Color'>color</a>, and relies 1092on the small <a href='undocumented#Size'>size</a> of the stripe and visual perception to make the <a href='SkColor_Reference#Color'>color</a> fringing imperceptible. 1093<a href='#Font_Anti_Alias'>Font_Anti_Alias</a> can be enabled on devices that orient stripes horizontally or vertically, and that order 1094the <a href='SkColor_Reference#Color'>color</a> components as RGB or BGR. 1095 1096<a name='SkPaint_isLCDRenderText'></a> 1097 1098--- 1099 1100<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1101bool <a href='#SkPaint_isLCDRenderText'>isLCDRenderText</a>()const 1102</pre> 1103 1104Returns true if <a href='undocumented#Glyph'>glyphs</a> may use LCD striping to improve <a href='undocumented#Glyph'>glyph</a> edges. 1105 1106Returns true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Flags'>Flags</a> <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> is set. 1107 1108### Return Value 1109 1110<a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> state 1111 1112### Example 1113 1114<div><fiddle-embed name="68e1fd95dd2fd06a333899d2bd2396b9"> 1115 1116#### Example Output 1117 1118~~~~ 1119paint.isLCDRenderText() == !!(paint.getFlags() & SkPaint::kLCDRenderText_Flag) 1120paint.isLCDRenderText() == !!(paint.getFlags() & SkPaint::kLCDRenderText_Flag) 1121~~~~ 1122 1123</fiddle-embed></div> 1124 1125<a name='SkPaint_setLCDRenderText'></a> 1126 1127--- 1128 1129<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1130void <a href='#SkPaint_setLCDRenderText'>setLCDRenderText</a>(bool lcdText) 1131</pre> 1132 1133Requests, but does not require, that <a href='undocumented#Glyph'>glyphs</a> use LCD striping for <a href='undocumented#Glyph'>glyph</a> edges. 1134 1135Sets <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> if <a href='#SkPaint_setLCDRenderText_lcdText'>lcdText</a> is true. 1136Clears <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a> if <a href='#SkPaint_setLCDRenderText_lcdText'>lcdText</a> is false. 1137 1138### Parameters 1139 1140<table> <tr> <td><a name='SkPaint_setLCDRenderText_lcdText'><code><strong>lcdText</strong></code></a></td> 1141 <td>setting for <a href='#SkPaint_kLCDRenderText_Flag'>kLCDRenderText_Flag</a></td> 1142 </tr> 1143</table> 1144 1145### Example 1146 1147<div><fiddle-embed name="50dedf8450159571a3edaf4f0050defe"> 1148 1149#### Example Output 1150 1151~~~~ 1152paint1 == paint2 1153~~~~ 1154 1155</fiddle-embed></div> 1156 1157<a name='Embedded_Bitmaps'></a> 1158 1159--- 1160 1161<a href='#Font_Embedded_Bitmaps'>Font_Embedded_Bitmaps</a> allows selecting custom sized <a href='SkBitmap_Reference#Bitmap'>bitmap</a> <a href='undocumented#Glyph'>Glyphs</a>. 1162<a href='#SkPaint_Flags'>Flags</a> <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> when set chooses an embedded <a href='SkBitmap_Reference#Bitmap'>bitmap</a> <a href='undocumented#Glyph'>glyph</a> over an outline contained 1163in a <a href='SkFont_Reference#Font'>font</a> if the platform supports this option. 1164 1165FreeType selects the <a href='SkBitmap_Reference#Bitmap'>bitmap</a> <a href='undocumented#Glyph'>glyph</a> if available when <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> is set, and selects 1166the outline <a href='undocumented#Glyph'>glyph</a> if <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> is clear. 1167Windows may select the <a href='SkBitmap_Reference#Bitmap'>bitmap</a> <a href='undocumented#Glyph'>glyph</a> but is not required to do so. 1168<a href='#OS_X'>OS_X</a> and iOS do not support this option. 1169 1170<a href='#Font_Embedded_Bitmaps'>Font_Embedded_Bitmaps</a> is disabled by default. 1171<a href='#Font_Embedded_Bitmaps'>Font_Embedded_Bitmaps</a> can be enabled by default by setting <a href='undocumented#SkPaintDefaults_Flags'>SkPaintDefaults_Flags</a> to 1172<a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> at compile time. 1173 1174### Example 1175 1176<pre style="padding: 1em 1em 1em 1em; font-size: 13px width: 62.5em; background-color: #f0f0f0"> 1177<div>The "hintgasp" TrueType font in the Skia resources/fonts directory 1178 includes an embedded bitmap Glyph at odd font sizes. This example works 1179 on platforms that use FreeType as their Font_Engine. 1180 Windows may, but is not required to, return a bitmap glyph if 1181 kEmbeddedBitmapText_Flag is set.</div>SkBitmap bitmap; 1182 bitmap.allocN32Pixels(30, 15); 1183 bitmap.eraseColor(0); 1184 SkCanvas offscreen(bitmap); 1185 SkPaint paint; 1186 paint.setAntiAlias(true); 1187 paint.setTextSize(13); 1188 paint.setTypeface(MakeResourceAsTypeface("fonts/hintgasp.ttf")); 1189 for (bool embedded : { false, true}) { 1190 paint.setEmbeddedBitmapText(embedded); 1191 offscreen.drawString("A", embedded ? 5 : 15, 15, paint); 1192 } 1193 canvas->drawBitmap(bitmap, 0, 0); 1194 canvas->scale(10, 10); 1195 canvas->drawBitmap(bitmap, -2, 1); 1196 1197</pre> 1198 1199<a name='SkPaint_isEmbeddedBitmapText'></a> 1200 1201--- 1202 1203<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1204bool <a href='#SkPaint_isEmbeddedBitmapText'>isEmbeddedBitmapText</a>()const 1205</pre> 1206 1207Returns true if <a href='SkFont_Reference#Font'>font</a> engine may return <a href='undocumented#Glyph'>glyphs</a> from <a href='SkFont_Reference#Font'>font</a> <a href='SkBitmap_Reference#Bitmap'>bitmaps</a> instead of from outlines. 1208 1209Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a>. 1210 1211### Return Value 1212 1213<a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> state 1214 1215### Example 1216 1217<div><fiddle-embed name="eba10b27b790e87183ae451b3fc5c4b1"> 1218 1219#### Example Output 1220 1221~~~~ 1222paint.isEmbeddedBitmapText() == !!(paint.getFlags() & SkPaint::kEmbeddedBitmapText_Flag) 1223paint.isEmbeddedBitmapText() == !!(paint.getFlags() & SkPaint::kEmbeddedBitmapText_Flag) 1224~~~~ 1225 1226</fiddle-embed></div> 1227 1228<a name='SkPaint_setEmbeddedBitmapText'></a> 1229 1230--- 1231 1232<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1233void <a href='#SkPaint_setEmbeddedBitmapText'>setEmbeddedBitmapText</a>(bool useEmbeddedBitmapText) 1234</pre> 1235 1236Requests, but does not require, to use <a href='SkBitmap_Reference#Bitmap'>bitmaps</a> in fonts instead of outlines. 1237 1238Sets <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> if <a href='#SkPaint_setEmbeddedBitmapText_useEmbeddedBitmapText'>useEmbeddedBitmapText</a> is true. 1239Clears <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a> if <a href='#SkPaint_setEmbeddedBitmapText_useEmbeddedBitmapText'>useEmbeddedBitmapText</a> is false. 1240 1241### Parameters 1242 1243<table> <tr> <td><a name='SkPaint_setEmbeddedBitmapText_useEmbeddedBitmapText'><code><strong>useEmbeddedBitmapText</strong></code></a></td> 1244 <td>setting for <a href='#SkPaint_kEmbeddedBitmapText_Flag'>kEmbeddedBitmapText_Flag</a></td> 1245 </tr> 1246</table> 1247 1248### Example 1249 1250<div><fiddle-embed name="246dffdd93a484ba4ad7ecf71198a5d4"> 1251 1252#### Example Output 1253 1254~~~~ 1255paint1 == paint2 1256~~~~ 1257 1258</fiddle-embed></div> 1259 1260<a name='Automatic_Hinting'></a> 1261 1262If Hinting is set to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a> or <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kFull'>kFull</a>, <a href='#Font_Force_Hinting'>Font_Force_Hinting</a> 1263instructs the <a href='#Font_Manager'>Font_Manager</a> to always hint <a href='undocumented#Glyph'>Glyphs</a>. 1264<a href='#Font_Force_Hinting'>Font_Force_Hinting</a> has no effect if Hinting is set to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNone'>kNone</a> or 1265<a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kSlight'>kSlight</a>. 1266 1267<a href='#Font_Force_Hinting'>Font_Force_Hinting</a> only affects platforms that use FreeType as the <a href='#Font_Manager'>Font_Manager</a>. 1268 1269<a name='SkPaint_isAutohinted'></a> 1270 1271--- 1272 1273<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1274bool <a href='#SkPaint_isAutohinted'>isAutohinted</a>()const 1275</pre> 1276 1277Returns true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::Hinting is set to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a> or 1278<a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kFull'>kFull</a>, and if platform uses FreeType as the <a href='SkFont_Reference#Font'>font</a> manager. 1279If true, instructs the <a href='SkFont_Reference#Font'>font</a> manager to always hint <a href='undocumented#Glyph'>glyphs</a>. 1280 1281Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a>. 1282 1283### Return Value 1284 1285<a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a> state 1286 1287### Example 1288 1289<div><fiddle-embed name="aa4781afbe3b90e7ef56a287e5b9ce1e"> 1290 1291#### Example Output 1292 1293~~~~ 1294paint.isAutohinted() == !!(paint.getFlags() & SkPaint::kAutoHinting_Flag) 1295paint.isAutohinted() == !!(paint.getFlags() & SkPaint::kAutoHinting_Flag) 1296~~~~ 1297 1298</fiddle-embed></div> 1299 1300### See Also 1301 1302<a href='#SkPaint_setAutohinted'>setAutohinted</a> Hinting 1303 1304<a name='SkPaint_setAutohinted'></a> 1305 1306--- 1307 1308<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1309void <a href='#SkPaint_setAutohinted'>setAutohinted</a>(bool useAutohinter) 1310</pre> 1311 1312Sets whether to always hint <a href='undocumented#Glyph'>glyphs</a>. 1313If <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::Hinting is set to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNormal'>kNormal</a> or <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kFull'>kFull</a> 1314and <a href='#SkPaint_setAutohinted_useAutohinter'>useAutohinter</a> is set, instructs the <a href='undocumented#Font_Manager'>font manager</a> to always hint <a href='undocumented#Glyph'>glyphs</a>. 1315<a href='#SkPaint_setAutohinted_useAutohinter'>useAutohinter</a> has no effect if <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::Hinting is set to <a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kNone'>kNone</a> or 1316<a href='undocumented#SkFontHinting'>SkFontHinting</a>::<a href='#SkFontHinting_kSlight'>kSlight</a>. 1317 1318Only affects platforms that use FreeType as the <a href='undocumented#Font_Manager'>font manager</a>. 1319 1320Sets <a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a> if <a href='#SkPaint_setAutohinted_useAutohinter'>useAutohinter</a> is true. 1321Clears <a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a> if <a href='#SkPaint_setAutohinted_useAutohinter'>useAutohinter</a> is false. 1322 1323### Parameters 1324 1325<table> <tr> <td><a name='SkPaint_setAutohinted_useAutohinter'><code><strong>useAutohinter</strong></code></a></td> 1326 <td>setting for <a href='#SkPaint_kAutoHinting_Flag'>kAutoHinting_Flag</a></td> 1327 </tr> 1328</table> 1329 1330### Example 1331 1332<div><fiddle-embed name="4e185306d7de9390fe8445eed0139309"></fiddle-embed></div> 1333 1334### See Also 1335 1336<a href='#SkPaint_isAutohinted'>isAutohinted</a> Hinting 1337 1338<a name='Fake_Bold'></a> 1339 1340--- 1341 1342<a href='#Font_Embolden'>Font_Embolden</a> approximates the bold <a href='SkFont_Reference#Font'>font</a> style accompanying a normal <a href='SkFont_Reference#Font'>font</a> when a bold <a href='SkFont_Reference#Font'>font</a> face 1343is not available. Skia does not provide <a href='SkFont_Reference#Font'>font</a> substitution; it is up to the client to find the 1344bold <a href='SkFont_Reference#Font'>font</a> face using the platform <a href='#Font_Manager'>Font_Manager</a>. 1345 1346Use <a href='#Paint_Text_Skew_X'>Text_Skew_X</a> to approximate an italic <a href='SkFont_Reference#Font'>font</a> style when the italic <a href='SkFont_Reference#Font'>font</a> face 1347is not available. 1348 1349A FreeType based port may define SK_USE_FREETYPE_EMBOLDEN at compile time to direct 1350the <a href='SkFont_Reference#Font_Engine'>font engine</a> to create the bold <a href='undocumented#Glyph'>Glyphs</a>. Otherwise, the extra bold is computed 1351by increasing the <a href='#Stroke_Width'>stroke width</a> and setting the <a href='#SkPaint_Style'>Style</a> to <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a> as needed. 1352 1353<a href='#Font_Embolden'>Font_Embolden</a> is disabled by default. 1354 1355### Example 1356 1357<div><fiddle-embed name="e811f4829a2daaaeaad3795504a7e02a"></fiddle-embed></div> 1358 1359<a name='SkPaint_isFakeBoldText'></a> 1360 1361--- 1362 1363<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1364bool <a href='#SkPaint_isFakeBoldText'>isFakeBoldText</a>()const 1365</pre> 1366 1367Returns true if approximate bold by increasing the stroke width when creating <a href='undocumented#Glyph'>glyph</a> <a href='SkBitmap_Reference#Bitmap'>bitmaps</a> 1368from outlines. 1369 1370Equivalent to <a href='#SkPaint_getFlags'>getFlags</a>() masked with <a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a>. 1371 1372### Return Value 1373 1374<a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a> state 1375 1376### Example 1377 1378<div><fiddle-embed name="f54d1f85b16073b80b9eef2e1a1d151d"> 1379 1380#### Example Output 1381 1382~~~~ 1383paint.isFakeBoldText() == !!(paint.getFlags() & SkPaint::kFakeBoldText_Flag) 1384paint.isFakeBoldText() == !!(paint.getFlags() & SkPaint::kFakeBoldText_Flag) 1385~~~~ 1386 1387</fiddle-embed></div> 1388 1389<a name='SkPaint_setFakeBoldText'></a> 1390 1391--- 1392 1393<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1394void <a href='#SkPaint_setFakeBoldText'>setFakeBoldText</a>(bool fakeBoldText) 1395</pre> 1396 1397Increases <a href='#Stroke_Width'>stroke width</a> when creating <a href='undocumented#Glyph'>glyph</a> <a href='SkBitmap_Reference#Bitmap'>bitmaps</a> to approximate a bold <a href='undocumented#Typeface'>typeface</a>. 1398 1399Sets <a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a> if <a href='#SkPaint_setFakeBoldText_fakeBoldText'>fakeBoldText</a> is true. 1400Clears <a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a> if <a href='#SkPaint_setFakeBoldText_fakeBoldText'>fakeBoldText</a> is false. 1401 1402### Parameters 1403 1404<table> <tr> <td><a name='SkPaint_setFakeBoldText_fakeBoldText'><code><strong>fakeBoldText</strong></code></a></td> 1405 <td>setting for <a href='#SkPaint_kFakeBoldText_Flag'>kFakeBoldText_Flag</a></td> 1406 </tr> 1407</table> 1408 1409### Example 1410 1411<div><fiddle-embed name="594d47858eb11028cb626515a520910a"> 1412 1413#### Example Output 1414 1415~~~~ 1416paint1 == paint2 1417~~~~ 1418 1419</fiddle-embed></div> 1420 1421<a name='Filter_Quality_Methods'></a> 1422 1423--- 1424 1425<a href='#Filter_Quality'>Filter_Quality</a> trades speed for <a href='SkImage_Reference#Image'>image</a> filtering when the <a href='SkImage_Reference#Image'>image</a> is scaled. 1426A lower <a href='#Filter_Quality'>Filter_Quality</a> draws faster, but has less fidelity. 1427A higher <a href='#Filter_Quality'>Filter_Quality</a> draws slower, but looks better. 1428If the <a href='SkImage_Reference#Image'>image</a> is drawn without scaling, the <a href='#Filter_Quality'>Filter_Quality</a> choice will not result 1429in a noticeable difference. 1430 1431<a href='#Filter_Quality'>Filter_Quality</a> is used in <a href='SkPaint_Reference#Paint'>Paint</a> passed as a parameter to 1432 1433<table> <tr> 1434 <td><a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawBitmap'>drawBitmap</a></td> 1435 </tr> <tr> 1436 <td><a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawBitmapRect'>drawBitmapRect</a></td> 1437 </tr> <tr> 1438 <td><a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawImage'>drawImage</a></td> 1439 </tr> <tr> 1440 <td><a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawImageRect'>drawImageRect</a></td> 1441 </tr> 1442</table> 1443 1444and when <a href='SkPaint_Reference#Paint'>Paint</a> has a <a href='undocumented#Shader'>Shader</a> specialization that uses <a href='SkImage_Reference#Image'>Image</a> or <a href='SkBitmap_Reference#Bitmap'>Bitmap</a>. 1445 1446<a href='#Filter_Quality'>Filter_Quality</a> is <a href='undocumented#kNone_SkFilterQuality'>kNone_SkFilterQuality</a> by default. 1447 1448### Example 1449 1450<div><fiddle-embed name="69369cff2f5b145a6f616092513266a0"></fiddle-embed></div> 1451 1452<a name='SkPaint_getFilterQuality'></a> 1453 1454--- 1455 1456<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1457<a href='undocumented#SkFilterQuality'>SkFilterQuality</a> <a href='#SkPaint_getFilterQuality'>getFilterQuality</a>()const 1458</pre> 1459 1460Returns <a href='undocumented#SkFilterQuality'>SkFilterQuality</a>, the <a href='SkImage_Reference#Image'>image</a> filtering level. A lower setting 1461draws faster; a higher setting looks better when the <a href='SkImage_Reference#Image'>image</a> is scaled. 1462 1463### Return Value 1464 1465one of: <a href='undocumented#kNone_SkFilterQuality'>kNone_SkFilterQuality</a>, <a href='undocumented#kLow_SkFilterQuality'>kLow_SkFilterQuality</a>, 1466 1467<a href='undocumented#kMedium_SkFilterQuality'>kMedium_SkFilterQuality</a>, <a href='undocumented#kHigh_SkFilterQuality'>kHigh_SkFilterQuality</a> 1468 1469### Example 1470 1471<div><fiddle-embed name="d4ca1f23809b6835c4ba46ea98a86900"> 1472 1473#### Example Output 1474 1475~~~~ 1476kNone_SkFilterQuality == paint.getFilterQuality() 1477~~~~ 1478 1479</fiddle-embed></div> 1480 1481<a name='SkPaint_setFilterQuality'></a> 1482 1483--- 1484 1485<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1486void <a href='#SkPaint_setFilterQuality'>setFilterQuality</a>(<a href='undocumented#SkFilterQuality'>SkFilterQuality</a> quality) 1487</pre> 1488 1489Sets <a href='undocumented#SkFilterQuality'>SkFilterQuality</a>, the <a href='SkImage_Reference#Image'>image</a> filtering level. A lower setting 1490draws faster; a higher setting looks better when the <a href='SkImage_Reference#Image'>image</a> is scaled. 1491Does not check to see if <a href='#SkPaint_setFilterQuality_quality'>quality</a> is valid. 1492 1493### Parameters 1494 1495<table> <tr> <td><a name='SkPaint_setFilterQuality_quality'><code><strong>quality</strong></code></a></td> 1496 <td>one of: <a href='undocumented#kNone_SkFilterQuality'>kNone_SkFilterQuality</a>, <a href='undocumented#kLow_SkFilterQuality'>kLow_SkFilterQuality</a>,</td> 1497 </tr> 1498</table> 1499 1500<a href='undocumented#kMedium_SkFilterQuality'>kMedium_SkFilterQuality</a>, <a href='undocumented#kHigh_SkFilterQuality'>kHigh_SkFilterQuality</a> 1501 1502### Example 1503 1504<div><fiddle-embed name="e4288fabf24ee60b645e8bb6ea0afadf"> 1505 1506#### Example Output 1507 1508~~~~ 1509kHigh_SkFilterQuality == paint.getFilterQuality() 1510~~~~ 1511 1512</fiddle-embed></div> 1513 1514### See Also 1515 1516<a href='undocumented#SkFilterQuality'>SkFilterQuality</a> <a href='#Image_Scaling'>Image_Scaling</a> 1517 1518<a name='Color_Methods'></a> 1519 1520--- 1521 1522| name | description | 1523| --- | --- | 1524| <a href='#SkPaint_getColor'>getColor</a> | returns <a href='#Color_Alpha'>Color_Alpha</a> and RGB, one drawing <a href='SkColor_Reference#Color'>color</a> | 1525| <a href='#SkPaint_setColor'>setColor</a> | sets <a href='#Color_Alpha'>Color_Alpha</a> and RGB, one drawing <a href='SkColor_Reference#Color'>color</a> | 1526 1527<a href='SkColor_Reference#Color'>Color</a> specifies the red, blue, green, and <a href='#Color_Alpha'>Color_Alpha</a> 1528values used to draw a filled or stroked shape in a 32-bit value. Each component 1529occupies 8-bits, ranging from zero: no contribution; to 255: full intensity. 1530All values in any combination are valid. 1531 1532<a href='SkColor_Reference#Color'>Color</a> is not <a href='undocumented#Premultiply'>Premultiplied</a>; <a href='#Color_Alpha'>Color_Alpha</a> sets the transparency independent of 1533RGB: red, blue, and green. 1534 1535The bit positions of <a href='#Color_Alpha'>Color_Alpha</a> and RGB are independent of the bit 1536positions on the output <a href='undocumented#Device'>device</a>, which may have more or fewer bits, and may have 1537a different arrangement. 1538 1539| bit positions | <a href='#Color_Alpha'>Color_Alpha</a> | red | blue | green | 1540| --- | --- | --- | --- | --- | 1541| | 31 - 24 | 23 - 16 | 15 - 8 | 7 - 0 | 1542 1543### Example 1544 1545<div><fiddle-embed name="214b559d75c65a7bef6ef4be1f860053"></fiddle-embed></div> 1546 1547<a name='SkPaint_getColor'></a> 1548 1549--- 1550 1551<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1552<a href='SkColor_Reference#SkColor'>SkColor</a> <a href='#SkPaint_getColor'>getColor</a>()const 1553</pre> 1554 1555Retrieves <a href='SkColor_Reference#Alpha'>alpha</a> and RGB, <a href='undocumented#Unpremultiply'>unpremultiplied</a>, packed into 32 bits. 1556Use helpers <a href='SkColor_Reference#SkColorGetA'>SkColorGetA</a>(), <a href='SkColor_Reference#SkColorGetR'>SkColorGetR</a>(), <a href='SkColor_Reference#SkColorGetG'>SkColorGetG</a>(), and <a href='SkColor_Reference#SkColorGetB'>SkColorGetB</a>() to extract 1557a <a href='SkColor_Reference#Color'>color</a> component. 1558 1559### Return Value 1560 1561<a href='undocumented#Unpremultiply'>unpremultiplied</a> ARGB 1562 1563### Example 1564 1565<div><fiddle-embed name="72d41f890203109a41f589a7403acae9"> 1566 1567#### Example Output 1568 1569~~~~ 1570Yellow is 100% red, 100% green, and 0% blue. 1571~~~~ 1572 1573</fiddle-embed></div> 1574 1575### See Also 1576 1577<a href='#SkPaint_getColor4f'>getColor4f</a> <a href='SkColor_Reference#SkColor'>SkColor</a> 1578 1579<a name='SkPaint_getColor4f'></a> 1580 1581--- 1582 1583<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1584<a href='SkColor4f_Reference#SkColor4f'>SkColor4f</a> <a href='#SkPaint_getColor4f'>getColor4f</a>()const 1585</pre> 1586 1587Retrieves <a href='SkColor_Reference#Alpha'>alpha</a> and RGB, <a href='undocumented#Unpremultiply'>unpremultiplied</a>, as four floating <a href='SkPoint_Reference#Point'>point</a> values. RGB are 1588are extended sRGB values (sRGB gamut, and encoded with the sRGB transfer function). 1589 1590### Return Value 1591 1592<a href='undocumented#Unpremultiply'>unpremultiplied</a> RGBA 1593 1594### Example 1595 1596<div><fiddle-embed name="8512ea2176f36e8f1aeef311ff228790"> 1597 1598#### Example Output 1599 1600~~~~ 1601Yellow is 100% red, 100% green, and 0% blue. 1602~~~~ 1603 1604</fiddle-embed></div> 1605 1606### See Also 1607 1608<a href='#SkPaint_getColor'>getColor</a> <a href='SkColor_Reference#SkColor'>SkColor</a> 1609 1610<a name='SkPaint_setColor'></a> 1611 1612--- 1613 1614<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1615void <a href='#SkPaint_setColor'>setColor</a>(<a href='SkColor_Reference#SkColor'>SkColor</a> <a href='SkColor_Reference#Color'>color</a>) 1616</pre> 1617 1618Sets <a href='SkColor_Reference#Alpha'>alpha</a> and RGB used when stroking and filling. The <a href='#SkPaint_setColor_color'>color</a> is a 32-bit value, 1619<a href='undocumented#Unpremultiply'>unpremultiplied</a>, packing 8-bit components for <a href='SkColor_Reference#Alpha'>alpha</a>, red, blue, and green. 1620 1621### Parameters 1622 1623<table> <tr> <td><a name='SkPaint_setColor_color'><code><strong>color</strong></code></a></td> 1624 <td><a href='undocumented#Unpremultiply'>unpremultiplied</a> ARGB</td> 1625 </tr> 1626</table> 1627 1628### Example 1629 1630<div><fiddle-embed name="6e70f18300bd676a3c056ceb6b62f8df"> 1631 1632#### Example Output 1633 1634~~~~ 1635green1 == green2 1636~~~~ 1637 1638</fiddle-embed></div> 1639 1640### See Also 1641 1642<a href='SkColor_Reference#SkColor'>SkColor</a> <a href='#SkPaint_setColor4f'>setColor4f</a> <a href='#SkPaint_setARGB'>setARGB</a> <a href='SkColor_Reference#SkColorSetARGB'>SkColorSetARGB</a> 1643 1644<a name='SkPaint_setColor4f'></a> 1645 1646--- 1647 1648<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1649void <a href='#SkPaint_setColor4f'>setColor4f</a>(const <a href='SkColor4f_Reference#SkColor4f'>SkColor4f</a>& <a href='SkColor_Reference#Color'>color</a>, <a href='undocumented#SkColorSpace'>SkColorSpace</a>* colorSpace) 1650</pre> 1651 1652Sets <a href='SkColor_Reference#Alpha'>alpha</a> and RGB used when stroking and filling. The <a href='#SkPaint_setColor4f_color'>color</a> is four floating 1653<a href='SkPoint_Reference#Point'>point</a> values, <a href='undocumented#Unpremultiply'>unpremultiplied</a>. The <a href='#SkPaint_setColor4f_color'>color</a> values are interpreted as being in 1654the <a href='#SkPaint_setColor4f_colorSpace'>colorSpace</a>. If <a href='#SkPaint_setColor4f_colorSpace'>colorSpace</a> is nullptr, then <a href='#SkPaint_setColor4f_color'>color</a> is assumed to be in the 1655sRGB <a href='undocumented#Color_Space'>color space</a>. 1656 1657### Parameters 1658 1659<table> <tr> <td><a name='SkPaint_setColor4f_color'><code><strong>color</strong></code></a></td> 1660 <td><a href='undocumented#Unpremultiply'>unpremultiplied</a> RGBA</td> 1661 </tr> 1662 <tr> <td><a name='SkPaint_setColor4f_colorSpace'><code><strong>colorSpace</strong></code></a></td> 1663 <td><a href='undocumented#SkColorSpace'>SkColorSpace</a> describing the encoding of <a href='#SkPaint_setColor4f_color'>color</a></td> 1664 </tr> 1665</table> 1666 1667### Example 1668 1669<div><fiddle-embed name="fa60859e3d03bdc117a05b32e093a8f1"> 1670 1671#### Example Output 1672 1673~~~~ 1674green1 == green2 1675~~~~ 1676 1677</fiddle-embed></div> 1678 1679### See Also 1680 1681<a href='SkColor_Reference#SkColor'>SkColor</a> <a href='#SkPaint_setColor'>setColor</a> <a href='#SkPaint_setARGB'>setARGB</a> <a href='SkColor_Reference#SkColorSetARGB'>SkColorSetARGB</a> 1682 1683<a name='Alpha_Methods'></a> 1684 1685<a href='#Color_Alpha'>Color_Alpha</a> sets the transparency independent of RGB: red, blue, and green. 1686 1687<a name='SkPaint_getAlpha'></a> 1688 1689--- 1690 1691<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1692uint8_t <a href='#SkPaint_getAlpha'>getAlpha</a>()const 1693</pre> 1694 1695Retrieves <a href='SkColor_Reference#Alpha'>alpha</a> from the <a href='SkColor_Reference#Color'>color</a> used when stroking and filling. 1696 1697### Return Value 1698 1699<a href='SkColor_Reference#Alpha'>alpha</a> ranging from zero, fully transparent, to 255, fully opaque 1700 1701### Example 1702 1703<div><fiddle-embed name="9a85bb62fe3d877b18fb7f952c4fa7f7"> 1704 1705#### Example Output 1706 1707~~~~ 1708255 == paint.getAlpha() 1709~~~~ 1710 1711</fiddle-embed></div> 1712 1713<a name='SkPaint_setAlpha'></a> 1714 1715--- 1716 1717<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1718void <a href='#SkPaint_setAlpha'>setAlpha</a>(<a href='undocumented#U8CPU'>U8CPU</a> a) 1719</pre> 1720 1721Replaces <a href='SkColor_Reference#Alpha'>alpha</a>, leaving RGB 1722unchanged. An out of range value triggers an assert in the debug 1723build. <a href='#SkPaint_setAlpha_a'>a</a> is <a href='#SkPaint_setAlpha_a'>a</a> value from zero to 255. 1724<a href='#SkPaint_setAlpha_a'>a</a> set to zero makes <a href='SkColor_Reference#Color'>color</a> fully transparent; <a href='#SkPaint_setAlpha_a'>a</a> set to 255 makes <a href='SkColor_Reference#Color'>color</a> 1725fully opaque. 1726 1727### Parameters 1728 1729<table> <tr> <td><a name='SkPaint_setAlpha_a'><code><strong>a</strong></code></a></td> 1730 <td><a href='SkColor_Reference#Alpha'>alpha</a> component of <a href='SkColor_Reference#Color'>color</a></td> 1731 </tr> 1732</table> 1733 1734### Example 1735 1736<div><fiddle-embed name="6ddc0360512dfb9947e75c17e6a8103d"> 1737 1738#### Example Output 1739 1740~~~~ 17410x44112233 == paint.getColor() 1742~~~~ 1743 1744</fiddle-embed></div> 1745 1746<a name='SkPaint_setARGB'></a> 1747 1748--- 1749 1750<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1751void <a href='#SkPaint_setARGB'>setARGB</a>(<a href='undocumented#U8CPU'>U8CPU</a> a, <a href='undocumented#U8CPU'>U8CPU</a> r, <a href='undocumented#U8CPU'>U8CPU</a> g, <a href='undocumented#U8CPU'>U8CPU</a> b) 1752</pre> 1753 1754Sets <a href='SkColor_Reference#Color'>color</a> used when drawing solid fills. The <a href='SkColor_Reference#Color'>color</a> components range from 0 to 255. 1755The <a href='SkColor_Reference#Color'>color</a> is <a href='undocumented#Unpremultiply'>unpremultiplied</a>; <a href='SkColor_Reference#Alpha'>alpha</a> sets the transparency independent of RGB. 1756 1757### Parameters 1758 1759<table> <tr> <td><a name='SkPaint_setARGB_a'><code><strong>a</strong></code></a></td> 1760 <td>amount of <a href='SkColor_Reference#Alpha'>alpha</a>, from fully transparent (0) to fully opaque (255)</td> 1761 </tr> 1762 <tr> <td><a name='SkPaint_setARGB_r'><code><strong>r</strong></code></a></td> 1763 <td>amount of red, from no red (0) to full red (255)</td> 1764 </tr> 1765 <tr> <td><a name='SkPaint_setARGB_g'><code><strong>g</strong></code></a></td> 1766 <td>amount of green, from no green (0) to full green (255)</td> 1767 </tr> 1768 <tr> <td><a name='SkPaint_setARGB_b'><code><strong>b</strong></code></a></td> 1769 <td>amount of blue, from no blue (0) to full blue (255)</td> 1770 </tr> 1771</table> 1772 1773### Example 1774 1775<div><fiddle-embed name="cb62e4755789ed32f7120dc55984959d"> 1776 1777#### Example Output 1778 1779~~~~ 1780transRed1 == transRed2 1781~~~~ 1782 1783</fiddle-embed></div> 1784 1785### See Also 1786 1787<a href='#SkPaint_setColor'>setColor</a> <a href='SkColor_Reference#SkColorSetARGB'>SkColorSetARGB</a> 1788 1789<a name='Style'></a> 1790 1791--- 1792 1793<a href='#SkPaint_Style'>Style</a> specifies if the geometry is filled, stroked, or both filled and stroked. 1794Some shapes ignore <a href='#SkPaint_Style'>Style</a> and are always drawn filled or stroked. 1795 1796<a name='Style_Fill'></a> 1797 1798Set <a href='#SkPaint_Style'>Style</a> to <a href='#SkPaint_kFill_Style'>kFill_Style</a> to fill the shape. 1799The fill covers the area inside the geometry for most shapes. 1800 1801<a name='Style_Stroke'></a> 1802 1803Set <a href='#SkPaint_Style'>Style</a> to <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> to stroke the shape. 1804 1805The stroke covers the area described by following the shape edge with a pen or brush of 1806<a href='#Paint_Stroke_Width'>Stroke_Width</a>. The area covered where the shape starts and stops is described by <a href='#Paint_Stroke_Cap'>Stroke_Cap</a>. 1807The area covered where the shape turns a corner is described by <a href='#Paint_Stroke_Join'>Stroke_Join</a>. 1808The stroke is centered on the shape; it extends equally on either side of the shape edge.As <a href='#Paint_Stroke_Width'>Stroke_Width</a> gets smaller, the drawn <a href='SkPath_Reference#Path'>path</a> frame is thinner. <a href='#Paint_Stroke_Width'>Stroke_Width</a> less than one 1809may have gaps, and if <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> is set, <a href='#Color_Alpha'>Color_Alpha</a> will increase to visually decrease coverage. 1810 1811### See Also 1812 1813<a href='#Path_Fill_Type'>Path_Fill_Type</a> <a href='#Path_Effect'>Path_Effect</a> <a href='#Paint_Style_Fill'>Style_Fill</a> <a href='#Paint_Style_Stroke'>Style_Stroke</a> 1814 1815<a name='Hairline'></a> 1816 1817--- 1818 1819<a href='#Paint_Stroke_Width'>Stroke_Width</a> of zero has a special meaning and switches drawing to use Hairline. 1820Hairline draws the thinnest continuous frame. If <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> is clear, adjacent pixels 1821flow horizontally, vertically,or diagonally. 1822 1823<a href='SkPath_Reference#Path'>Path</a> drawing with Hairline may hit the same <a href='undocumented#Pixel'>pixel</a> more than once. For instance, <a href='SkPath_Reference#Path'>Path</a> containing 1824two <a href='undocumented#Line'>lines</a> in one <a href='#Path_Overview_Contour'>Path_Contour</a> will draw the corner <a href='SkPoint_Reference#Point'>point</a> once, but may both <a href='undocumented#Line'>lines</a> may draw the adjacent 1825<a href='undocumented#Pixel'>pixel</a>. If <a href='#SkPaint_kAntiAlias_Flag'>kAntiAlias_Flag</a> is set, transparency is applied twice, resulting in a darker <a href='undocumented#Pixel'>pixel</a>. Some 1826GPU-backed implementations apply transparency at a later drawing stage, avoiding double hit pixels 1827while stroking. 1828 1829### See Also 1830 1831<a href='#Path_Fill_Type'>Path_Fill_Type</a> <a href='#Path_Effect'>Path_Effect</a> <a href='#Paint_Style_Fill'>Style_Fill</a> <a href='#Paint_Style_Stroke'>Style_Stroke</a> 1832 1833<a name='SkPaint_Style'></a> 1834 1835--- 1836 1837<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 1838 enum <a href='#SkPaint_Style'>Style</a> : uint8_t { 1839 <a href='#SkPaint_kFill_Style'>kFill_Style</a>, 1840 <a href='#SkPaint_kStroke_Style'>kStroke_Style</a>, 1841 <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a>, 1842 }; 1843 1844</pre> 1845 1846<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 1847 static constexpr int <a href='#SkPaint_kStyleCount'>kStyleCount</a> = <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a> + 1; 1848</pre> 1849 1850Set <a href='#SkPaint_Style'>Style</a> to fill, stroke, or both fill and stroke geometry. 1851The stroke and fill 1852share all <a href='SkPaint_Reference#Paint'>paint</a> attributes; for instance, they are drawn with the same <a href='SkColor_Reference#Color'>color</a>. 1853 1854Use <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a> to avoid hitting the same pixels twice with a stroke draw and 1855a fill draw. 1856 1857### Constants 1858 1859<table style='border-collapse: collapse; width: 62.5em'> 1860 <tr><th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Const</th> 1861<th style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>Value</th> 1862<th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Description</th></tr> 1863 <tr style='background-color: #f0f0f0; '> 1864 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kFill_Style'><code>SkPaint::kFill_Style</code></a></td> 1865 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0</td> 1866 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 1867Applies to <a href='SkRect_Reference#Rect'>Rect</a>, <a href='SkRegion_Reference#Region'>Region</a>, <a href='#RRect'>Round_Rect</a>, <a href='undocumented#Circle'>Circles</a>, <a href='undocumented#Oval'>Ovals</a>, <a href='SkPath_Reference#Path'>Path</a>, and <a href='undocumented#Text'>Text</a>. 1868<a href='SkBitmap_Reference#Bitmap'>Bitmap</a>, <a href='SkImage_Reference#Image'>Image</a>, <a href='undocumented#Patch'>Patches</a>, <a href='SkRegion_Reference#Region'>Region</a>, <a href='undocumented#Sprite'>Sprites</a>, and <a href='undocumented#Vertices'>Vertices</a> are painted as if 1869<a href='#SkPaint_kFill_Style'>kFill_Style</a> is set, and ignore the set <a href='#SkPaint_Style'>Style</a>. 1870The <a href='#Path_Fill_Type'>Path_Fill_Type</a> specifies additional rules to fill the area outside the <a href='SkPath_Reference#Path'>path</a> edge, 1871and to create an unfilled hole inside the shape. 1872<a href='#SkPaint_Style'>Style</a> is set to <a href='#SkPaint_kFill_Style'>kFill_Style</a> by default. 1873</td> 1874 </tr> 1875 <tr> 1876 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kStroke_Style'><code>SkPaint::kStroke_Style</code></a></td> 1877 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>1</td> 1878 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 1879Applies to <a href='SkRect_Reference#Rect'>Rect</a>, <a href='SkRegion_Reference#Region'>Region</a>, <a href='#RRect'>Round_Rect</a>, <a href='undocumented#Arc'>Arcs</a>, <a href='undocumented#Circle'>Circles</a>, <a href='undocumented#Oval'>Ovals</a>, <a href='SkPath_Reference#Path'>Path</a>, and <a href='undocumented#Text'>Text</a>. 1880<a href='undocumented#Arc'>Arcs</a>, <a href='undocumented#Line'>Lines</a>, and <a href='SkPoint_Reference#Point'>points</a>, are always drawn as if <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> is set, 1881and ignore the set <a href='#SkPaint_Style'>Style</a>. 1882The stroke construction is unaffected by the <a href='#Path_Fill_Type'>Path_Fill_Type</a>. 1883</td> 1884 </tr> 1885 <tr style='background-color: #f0f0f0; '> 1886 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kStrokeAndFill_Style'><code>SkPaint::kStrokeAndFill_Style</code></a></td> 1887 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>2</td> 1888 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 1889Applies to <a href='SkRect_Reference#Rect'>Rect</a>, <a href='SkRegion_Reference#Region'>Region</a>, <a href='#RRect'>Round_Rect</a>, <a href='undocumented#Circle'>Circles</a>, <a href='undocumented#Oval'>Ovals</a>, <a href='SkPath_Reference#Path'>Path</a>, and <a href='undocumented#Text'>Text</a>. 1890<a href='SkPath_Reference#Path'>Path</a> is treated as if it is set to <a href='SkPath_Reference#SkPath'>SkPath</a>::<a href='#SkPath_kWinding_FillType'>kWinding_FillType</a>, 1891and the set <a href='#Path_Fill_Type'>Path_Fill_Type</a> is ignored. 1892</td> 1893 </tr> 1894 <tr> 1895 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kStyleCount'><code>SkPaint::kStyleCount</code></a></td> 1896 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>3</td> 1897 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 1898May be used to verify that <a href='#SkPaint_Style'>Style</a> is a legal value. 1899</td> 1900 </tr> 1901</table> 1902 1903<a name='SkPaint_getStyle'></a> 1904 1905--- 1906 1907<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1908<a href='#SkPaint_Style'>Style</a> <a href='#SkPaint_getStyle'>getStyle</a>()const 1909</pre> 1910 1911Returns whether the geometry is filled, stroked, or filled and stroked. 1912 1913### Return Value 1914 1915one of:<a href='#SkPaint_kFill_Style'>kFill_Style</a>, <a href='#SkPaint_kStroke_Style'>kStroke_Style</a>, <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a> 1916 1917### Example 1918 1919<div><fiddle-embed name="1c5e18c3c0102d2dac86a78ba8c8ce01"> 1920 1921#### Example Output 1922 1923~~~~ 1924SkPaint::kFill_Style == paint.getStyle() 1925~~~~ 1926 1927</fiddle-embed></div> 1928 1929### See Also 1930 1931<a href='#SkPaint_Style'>Style</a> <a href='#SkPaint_setStyle'>setStyle</a> 1932 1933<a name='SkPaint_setStyle'></a> 1934 1935--- 1936 1937<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1938void <a href='#SkPaint_setStyle'>setStyle</a>(<a href='#SkPaint_Style'>Style</a> style) 1939</pre> 1940 1941Sets whether the geometry is filled, stroked, or filled and stroked. 1942Has no effect if <a href='#SkPaint_setStyle_style'>style</a> is not a legal <a href='SkPaint_Reference#SkPaint'>SkPaint</a>::<a href='#SkPaint_Style'>Style</a> value. 1943 1944### Parameters 1945 1946<table> <tr> <td><a name='SkPaint_setStyle_style'><code><strong>style</strong></code></a></td> 1947 <td>one of: <a href='#SkPaint_kFill_Style'>kFill_Style</a>, <a href='#SkPaint_kStroke_Style'>kStroke_Style</a>, <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a></td> 1948 </tr> 1949</table> 1950 1951### Example 1952 1953<div><fiddle-embed name="c7bb6248e4735b8d1a32d02fba40d344"></fiddle-embed></div> 1954 1955### See Also 1956 1957<a href='#SkPaint_Style'>Style</a> <a href='#SkPaint_getStyle'>getStyle</a> 1958 1959<a name='Stroke_Width'></a> 1960 1961--- 1962 1963<a href='#Paint_Stroke_Width'>Stroke_Width</a> sets the width for stroking. The width is the thickness 1964of the stroke perpendicular to the <a href='SkPath_Reference#Path_Direction'>path direction</a> when the <a href='SkPaint_Reference#Paint'>paint style</a> is 1965set to <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> or <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a>. 1966 1967When width is greater than zero, the stroke encompasses as many pixels partially 1968or fully as needed. When the width equals zero, the <a href='SkPaint_Reference#Paint'>paint</a> enables hairlines; 1969the stroke is always one <a href='undocumented#Pixel'>pixel</a> wide. 1970 1971The stroke dimensions are scaled by the <a href='SkCanvas_Reference#Canvas_Matrix'>canvas matrix</a>, but Hairline stroke 1972remains one <a href='undocumented#Pixel'>pixel</a> wide regardless of scaling. 1973 1974The default width for the <a href='SkPaint_Reference#Paint'>paint</a> is zero. 1975 1976### Example 1977 1978<div><fiddle-embed name="5112c7209a19e035c61cef33a624a652" gpu="true"><div>The pixels hit to represent thin <a href='undocumented#Line'>lines</a> vary with the angle of the 1979<a href='undocumented#Line'>line</a> and the platform implementation. 1980</div></fiddle-embed></div> 1981 1982<a name='SkPaint_getStrokeWidth'></a> 1983 1984--- 1985 1986<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 1987<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getStrokeWidth'>getStrokeWidth</a>()const 1988</pre> 1989 1990Returns the thickness of the pen used by <a href='SkPaint_Reference#SkPaint'>SkPaint</a> to 1991outline the shape. 1992 1993### Return Value 1994 1995zero for hairline, greater than zero for pen thickness 1996 1997### Example 1998 1999<div><fiddle-embed name="99aa73f64df8bbf06e656cd891a81b9e"> 2000 2001#### Example Output 2002 2003~~~~ 20040 == paint.getStrokeWidth() 2005~~~~ 2006 2007</fiddle-embed></div> 2008 2009<a name='SkPaint_setStrokeWidth'></a> 2010 2011--- 2012 2013<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2014void <a href='#SkPaint_setStrokeWidth'>setStrokeWidth</a>(<a href='undocumented#SkScalar'>SkScalar</a> width) 2015</pre> 2016 2017Sets the thickness of the pen used by the <a href='SkPaint_Reference#Paint'>paint</a> to 2018outline the shape. 2019Has no effect if <a href='#SkPaint_setStrokeWidth_width'>width</a> is less than zero. 2020 2021### Parameters 2022 2023<table> <tr> <td><a name='SkPaint_setStrokeWidth_width'><code><strong>width</strong></code></a></td> 2024 <td>zero thickness for hairline; greater than zero for pen thickness</td> 2025 </tr> 2026</table> 2027 2028### Example 2029 2030<div><fiddle-embed name="0c4446c0870b5c7b5a2efe77ff92afb8"> 2031 2032#### Example Output 2033 2034~~~~ 20355 == paint.getStrokeWidth() 2036~~~~ 2037 2038</fiddle-embed></div> 2039 2040<a name='Miter_Limit'></a> 2041 2042--- 2043 2044<a href='#Paint_Miter_Limit'>Miter_Limit</a> specifies the maximum miter length, 2045relative to the <a href='#Stroke_Width'>stroke width</a>. 2046 2047<a href='#Paint_Miter_Limit'>Miter_Limit</a> is used when the <a href='#Paint_Stroke_Join'>Stroke_Join</a> 2048is set to <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, and the <a href='#SkPaint_Style'>Style</a> is either <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> 2049or <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a>. 2050 2051If the miter at a corner exceeds this limit, <a href='#SkPaint_kMiter_Join'>kMiter_Join</a> 2052is replaced with <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>. 2053 2054<a href='#Paint_Miter_Limit'>Miter_Limit</a> can be computed from the corner angle using: 2055<code><a href='#Miter_Limit'>miter limit</a> = 1 / sin ( angle / 2 )</code>. 2056 2057<a href='#Paint_Miter_Limit'>Miter_Limit</a> default value is 4. 2058The default may be changed at compile time by setting <a href='undocumented#SkPaintDefaults_MiterLimit'>SkPaintDefaults_MiterLimit</a> 2059in "SkUserConfig.h" or as a define supplied by the build environment. 2060 2061Here are some miter limits and the angles that triggers them. 2062 2063| <a href='#Miter_Limit'>miter limit</a> | angle in degrees | 2064| --- | --- | 2065| 10 | 11.48 | 2066| 9 | 12.76 | 2067| 8 | 14.36 | 2068| 7 | 16.43 | 2069| 6 | 19.19 | 2070| 5 | 23.07 | 2071| 4 | 28.96 | 2072| 3 | 38.94 | 2073| 2 | 60 | 2074| 1 | 180 | 2075 2076### Example 2077 2078<div><fiddle-embed name="5de2de0f00354e59074a9bb1a42d5a63"><div>This example draws a stroked corner and the miter length beneath. 2079When the <a href='#Miter_Limit'>miter limit</a> is decreased slightly, the miter join is replaced 2080by a bevel join. 2081</div></fiddle-embed></div> 2082 2083<a name='SkPaint_getStrokeMiter'></a> 2084 2085--- 2086 2087<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2088<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getStrokeMiter'>getStrokeMiter</a>()const 2089</pre> 2090 2091Returns the limit at which a sharp corner is drawn beveled. 2092 2093### Return Value 2094 2095zero and greater miter limit 2096 2097### Example 2098 2099<div><fiddle-embed name="50da74a43b725f07a914df588c867d36"> 2100 2101#### Example Output 2102 2103~~~~ 2104default miter limit == 4 2105~~~~ 2106 2107</fiddle-embed></div> 2108 2109### See Also 2110 2111<a href='#Paint_Miter_Limit'>Miter_Limit</a> <a href='#SkPaint_setStrokeMiter'>setStrokeMiter</a> <a href='#SkPaint_Join'>Join</a> 2112 2113<a name='SkPaint_setStrokeMiter'></a> 2114 2115--- 2116 2117<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2118void <a href='#SkPaint_setStrokeMiter'>setStrokeMiter</a>(<a href='undocumented#SkScalar'>SkScalar</a> miter) 2119</pre> 2120 2121Sets the limit at which a sharp corner is drawn beveled. 2122Valid values are zero and greater. 2123Has no effect if <a href='#SkPaint_setStrokeMiter_miter'>miter</a> is less than zero. 2124 2125### Parameters 2126 2127<table> <tr> <td><a name='SkPaint_setStrokeMiter_miter'><code><strong>miter</strong></code></a></td> 2128 <td>zero and greater <a href='#Miter_Limit'>miter limit</a></td> 2129 </tr> 2130</table> 2131 2132### Example 2133 2134<div><fiddle-embed name="700b284dbc97785c6a9c9636088713ad"> 2135 2136#### Example Output 2137 2138~~~~ 2139default miter limit == 8 2140~~~~ 2141 2142</fiddle-embed></div> 2143 2144### See Also 2145 2146<a href='#Paint_Miter_Limit'>Miter_Limit</a> <a href='#SkPaint_getStrokeMiter'>getStrokeMiter</a> <a href='#SkPaint_Join'>Join</a> 2147 2148<a name='Stroke_Cap'></a> 2149 2150<a name='SkPaint_Cap'></a> 2151 2152--- 2153 2154<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 2155 enum <a href='#SkPaint_Cap'>Cap</a> { 2156 <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, 2157 <a href='#SkPaint_kRound_Cap'>kRound_Cap</a>, 2158 <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a>, 2159 <a href='#SkPaint_kLast_Cap'>kLast_Cap</a> = <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a>, 2160 <a href='#SkPaint_kDefault_Cap'>kDefault_Cap</a> = <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, 2161 }; 2162 2163</pre> 2164 2165<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 2166 static constexpr int <a href='#SkPaint_kCapCount'>kCapCount</a> = <a href='#SkPaint_kLast_Cap'>kLast_Cap</a> + 1; 2167</pre> 2168 2169<a href='#Paint_Stroke_Cap'>Stroke_Cap</a> draws at the beginning and end of an open <a href='#Path_Overview_Contour'>Path_Contour</a>. 2170 2171### Constants 2172 2173<table style='border-collapse: collapse; width: 62.5em'> 2174 <tr><th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Const</th> 2175<th style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>Value</th> 2176<th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Description</th></tr> 2177 <tr style='background-color: #f0f0f0; '> 2178 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kButt_Cap'><code>SkPaint::kButt_Cap</code></a></td> 2179 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0</td> 2180 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2181Does not extend the stroke past the beginning or the end. 2182</td> 2183 </tr> 2184 <tr> 2185 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kRound_Cap'><code>SkPaint::kRound_Cap</code></a></td> 2186 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>1</td> 2187 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2188Adds a <a href='undocumented#Circle'>circle</a> with a diameter equal to <a href='#Paint_Stroke_Width'>Stroke_Width</a> at the beginning 2189and end. 2190</td> 2191 </tr> 2192 <tr style='background-color: #f0f0f0; '> 2193 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kSquare_Cap'><code>SkPaint::kSquare_Cap</code></a></td> 2194 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>2</td> 2195 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2196Adds a square with sides equal to <a href='#Paint_Stroke_Width'>Stroke_Width</a> at the beginning 2197and end. The square sides are parallel to the initial and final direction 2198of the stroke. 2199</td> 2200 </tr> 2201 <tr> 2202 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kLast_Cap'><code>SkPaint::kLast_Cap</code></a></td> 2203 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>2</td> 2204 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2205Equivalent to the largest value for <a href='#Paint_Stroke_Cap'>Stroke_Cap</a>. 2206</td> 2207 </tr> 2208 <tr style='background-color: #f0f0f0; '> 2209 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kDefault_Cap'><code>SkPaint::kDefault_Cap</code></a></td> 2210 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0</td> 2211 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2212<a href='#Paint_Stroke_Cap'>Stroke_Cap</a> is set to <a href='#SkPaint_kButt_Cap'>kButt_Cap</a> by default. 2213</td> 2214 </tr> 2215 <tr> 2216 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kCapCount'><code>SkPaint::kCapCount</code></a></td> 2217 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>3</td> 2218 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2219May be used to verify that <a href='#Paint_Stroke_Cap'>Stroke_Cap</a> is a legal value. 2220</td> 2221 </tr> 2222</table> 2223 2224Stroke describes the area covered by a pen of <a href='#Paint_Stroke_Width'>Stroke_Width</a> as it 2225follows the <a href='#Path_Overview_Contour'>Path_Contour</a>, moving parallel to the <a href='SkPath_Overview#Contour'>contour</a> direction. 2226 2227If the <a href='#Path_Overview_Contour'>Path_Contour</a> is not terminated by <a href='SkPath_Reference#SkPath'>SkPath</a>::<a href='#SkPath_kClose_Verb'>kClose_Verb</a>, the <a href='SkPath_Overview#Contour'>contour</a> has a 2228visible beginning and end. 2229 2230<a href='#Path_Overview_Contour'>Path_Contour</a> may start and end at the same <a href='SkPoint_Reference#Point'>point</a>; defining <a href='#Path_Overview_Contour_Zero_Length'>Zero_Length_Contour</a>. 2231 2232<a href='#SkPaint_kButt_Cap'>kButt_Cap</a> and <a href='#Path_Overview_Contour_Zero_Length'>Zero_Length_Contour</a> is not drawn. 2233<a href='#SkPaint_kRound_Cap'>kRound_Cap</a> and <a href='#Path_Overview_Contour_Zero_Length'>Zero_Length_Contour</a> draws a <a href='undocumented#Circle'>circle</a> of diameter <a href='#Paint_Stroke_Width'>Stroke_Width</a> 2234at the <a href='SkPath_Overview#Contour'>contour</a> <a href='SkPoint_Reference#Point'>point</a>. 2235<a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a> and <a href='#Path_Overview_Contour_Zero_Length'>Zero_Length_Contour</a> draws an upright square with a side of 2236<a href='#Paint_Stroke_Width'>Stroke_Width</a> at the <a href='SkPath_Overview#Contour'>contour</a> <a href='SkPoint_Reference#Point'>point</a>. 2237 2238<a href='#Paint_Stroke_Cap'>Stroke_Cap</a> is <a href='#SkPaint_kButt_Cap'>kButt_Cap</a> by default. 2239 2240### Example 2241 2242<div><fiddle-embed name="2bffb6384cc20077e632e7d01da045ca"></fiddle-embed></div> 2243 2244<a name='SkPaint_getStrokeCap'></a> 2245 2246--- 2247 2248<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2249<a href='#SkPaint_Cap'>Cap</a> <a href='#SkPaint_getStrokeCap'>getStrokeCap</a>()const 2250</pre> 2251 2252Returns the geometry drawn at the beginning and end of strokes. 2253 2254### Return Value 2255 2256one of: <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, <a href='#SkPaint_kRound_Cap'>kRound_Cap</a>, <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a> 2257 2258### Example 2259 2260<div><fiddle-embed name="aabf9baee8e026fae36fca30e955512b"> 2261 2262#### Example Output 2263 2264~~~~ 2265kButt_Cap == default stroke cap 2266~~~~ 2267 2268</fiddle-embed></div> 2269 2270### See Also 2271 2272<a href='#Paint_Stroke_Cap'>Stroke_Cap</a> <a href='#SkPaint_setStrokeCap'>setStrokeCap</a> 2273 2274<a name='SkPaint_setStrokeCap'></a> 2275 2276--- 2277 2278<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2279void <a href='#SkPaint_setStrokeCap'>setStrokeCap</a>(<a href='#SkPaint_Cap'>Cap</a> cap) 2280</pre> 2281 2282Sets the geometry drawn at the beginning and end of strokes. 2283 2284### Parameters 2285 2286<table> <tr> <td><a name='SkPaint_setStrokeCap_cap'><code><strong>cap</strong></code></a></td> 2287 <td>one of: <a href='#SkPaint_kButt_Cap'>kButt_Cap</a>, <a href='#SkPaint_kRound_Cap'>kRound_Cap</a>, <a href='#SkPaint_kSquare_Cap'>kSquare_Cap</a>;</td> 2288 </tr> 2289</table> 2290 2291has no effect if <a href='#SkPaint_setStrokeCap_cap'>cap</a> is not valid 2292 2293### Example 2294 2295<div><fiddle-embed name="de83fbd848a4625345b4b87a6e55d98a"> 2296 2297#### Example Output 2298 2299~~~~ 2300kRound_Cap == paint.getStrokeCap() 2301~~~~ 2302 2303</fiddle-embed></div> 2304 2305### See Also 2306 2307<a href='#Paint_Stroke_Cap'>Stroke_Cap</a> <a href='#SkPaint_getStrokeCap'>getStrokeCap</a> 2308 2309<a name='Stroke_Join'></a> 2310 2311<a href='#Paint_Stroke_Join'>Stroke_Join</a> draws at the sharp corners of an open or closed <a href='#Path_Overview_Contour'>Path_Contour</a>. 2312 2313Stroke describes the area covered by a pen of <a href='#Paint_Stroke_Width'>Stroke_Width</a> as it 2314follows the <a href='#Path_Overview_Contour'>Path_Contour</a>, moving parallel to the <a href='SkPath_Overview#Contour'>contour</a> direction. 2315 2316If the <a href='SkPath_Overview#Contour'>contour</a> direction changes abruptly, because the tangent direction leading 2317to the end of a <a href='undocumented#Curve'>curve</a> within the <a href='SkPath_Overview#Contour'>contour</a> does not match the tangent direction of 2318the following <a href='undocumented#Curve'>curve</a>, the pair of <a href='undocumented#Curve'>curves</a> meet at <a href='#Paint_Stroke_Join'>Stroke_Join</a>. 2319 2320### Example 2321 2322<div><fiddle-embed name="917c44b504d3f9308571fd3835d90a0d"></fiddle-embed></div> 2323 2324<a name='SkPaint_Join'></a> 2325 2326--- 2327 2328<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 2329 enum <a href='#SkPaint_Join'>Join</a> : uint8_t { 2330 <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, 2331 <a href='#SkPaint_kRound_Join'>kRound_Join</a>, 2332 <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>, 2333 <a href='#SkPaint_kLast_Join'>kLast_Join</a> = <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>, 2334 <a href='#SkPaint_kDefault_Join'>kDefault_Join</a> = <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, 2335 }; 2336 2337</pre> 2338 2339<pre style="padding: 1em 1em 1em 1em;width: 62.5em; background-color: #f0f0f0"> 2340 static constexpr int <a href='#SkPaint_kJoinCount'>kJoinCount</a> = <a href='#SkPaint_kLast_Join'>kLast_Join</a> + 1; 2341</pre> 2342 2343<a href='#SkPaint_Join'>Join</a> specifies how corners are drawn when a shape is stroked. <a href='#SkPaint_Join'>Join</a> 2344affects the four corners of a stroked rectangle, and the connected segments in a 2345stroked <a href='SkPath_Reference#Path'>path</a>. 2346 2347Choose miter join to draw sharp corners. Choose round join to draw a <a href='undocumented#Circle'>circle</a> with a 2348radius equal to the <a href='#Stroke_Width'>stroke width</a> on top of the corner. Choose bevel join to minimally 2349connect the thick strokes. 2350 2351The <a href='#Fill_Path'>fill path</a> constructed to describe the stroked <a href='SkPath_Reference#Path'>path</a> respects the join setting but may 2352not contain the actual join. For instance, a <a href='#Fill_Path'>fill path</a> constructed with round joins does 2353not necessarily include <a href='undocumented#Circle'>circles</a> at each connected segment. 2354 2355### Constants 2356 2357<table style='border-collapse: collapse; width: 62.5em'> 2358 <tr><th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Const</th> 2359<th style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>Value</th> 2360<th style='text-align: left; border: 2px solid #dddddd; padding: 8px; '>Description</th></tr> 2361 <tr style='background-color: #f0f0f0; '> 2362 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kMiter_Join'><code>SkPaint::kMiter_Join</code></a></td> 2363 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>0</td> 2364 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2365Extends the outside corner to the extent allowed by <a href='#Paint_Miter_Limit'>Miter_Limit</a>. 2366If the extension exceeds <a href='#Paint_Miter_Limit'>Miter_Limit</a>, <a href='#SkPaint_kBevel_Join'>kBevel_Join</a> is used instead. 2367</td> 2368 </tr> 2369 <tr> 2370 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kRound_Join'><code>SkPaint::kRound_Join</code></a></td> 2371 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>1</td> 2372 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2373Adds a <a href='undocumented#Circle'>circle</a> with a diameter of <a href='#Paint_Stroke_Width'>Stroke_Width</a> at the sharp corner. 2374</td> 2375 </tr> 2376 <tr style='background-color: #f0f0f0; '> 2377 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kBevel_Join'><code>SkPaint::kBevel_Join</code></a></td> 2378 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>2</td> 2379 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2380Connects the outside edges of the sharp corner. 2381</td> 2382 </tr> 2383 <tr> 2384 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kLast_Join'><code>SkPaint::kLast_Join</code></a></td> 2385 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>2</td> 2386 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2387equivalent to the largest value for Stroke_Join</td> 2388 </tr> 2389 <tr style='background-color: #f0f0f0; '> 2390 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kDefault_Join'><code>SkPaint::kDefault_Join</code></a></td> 2391 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>1</td> 2392 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2393<a href='#Paint_Stroke_Join'>Stroke_Join</a> is set to <a href='#SkPaint_kMiter_Join'>kMiter_Join</a> by default. 2394</td> 2395 </tr> 2396 <tr> 2397 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '><a name='SkPaint_kJoinCount'><code>SkPaint::kJoinCount</code></a></td> 2398 <td style='text-align: center; border: 2px solid #dddddd; padding: 8px; '>3</td> 2399 <td style='text-align: left; border: 2px solid #dddddd; padding: 8px; '> 2400May be used to verify that <a href='#Paint_Stroke_Join'>Stroke_Join</a> is a legal value. 2401</td> 2402 </tr> 2403</table> 2404 2405### Example 2406 2407<div><fiddle-embed name="3b1aebacc21c1836a52876b9b0b3905e"></fiddle-embed></div> 2408 2409### See Also 2410 2411<a href='#SkPaint_setStrokeJoin'>setStrokeJoin</a> <a href='#SkPaint_getStrokeJoin'>getStrokeJoin</a> <a href='#SkPaint_setStrokeMiter'>setStrokeMiter</a> <a href='#SkPaint_getStrokeMiter'>getStrokeMiter</a> 2412 2413<a name='SkPaint_getStrokeJoin'></a> 2414 2415--- 2416 2417<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2418<a href='#SkPaint_Join'>Join</a> <a href='#SkPaint_getStrokeJoin'>getStrokeJoin</a>()const 2419</pre> 2420 2421Returns the geometry drawn at the corners of strokes. 2422 2423### Return Value 2424 2425one of: <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, <a href='#SkPaint_kRound_Join'>kRound_Join</a>, <a href='#SkPaint_kBevel_Join'>kBevel_Join</a> 2426 2427### Example 2428 2429<div><fiddle-embed name="31bf751d0a8ddf176b871810820d8199"> 2430 2431#### Example Output 2432 2433~~~~ 2434kMiter_Join == default stroke join 2435~~~~ 2436 2437</fiddle-embed></div> 2438 2439### See Also 2440 2441<a href='#Paint_Stroke_Join'>Stroke_Join</a> <a href='#SkPaint_setStrokeJoin'>setStrokeJoin</a> 2442 2443<a name='SkPaint_setStrokeJoin'></a> 2444 2445--- 2446 2447<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2448void <a href='#SkPaint_setStrokeJoin'>setStrokeJoin</a>(<a href='#SkPaint_Join'>Join</a> join) 2449</pre> 2450 2451Sets the geometry drawn at the corners of strokes. 2452 2453### Parameters 2454 2455<table> <tr> <td><a name='SkPaint_setStrokeJoin_join'><code><strong>join</strong></code></a></td> 2456 <td>one of: <a href='#SkPaint_kMiter_Join'>kMiter_Join</a>, <a href='#SkPaint_kRound_Join'>kRound_Join</a>, <a href='#SkPaint_kBevel_Join'>kBevel_Join</a>;</td> 2457 </tr> 2458</table> 2459 2460otherwise, has no effect 2461 2462### Example 2463 2464<div><fiddle-embed name="48d963ad4286eddf680f9c511eb6da91"> 2465 2466#### Example Output 2467 2468~~~~ 2469kMiter_Join == paint.getStrokeJoin() 2470~~~~ 2471 2472</fiddle-embed></div> 2473 2474### See Also 2475 2476<a href='#Paint_Stroke_Join'>Stroke_Join</a> <a href='#SkPaint_getStrokeJoin'>getStrokeJoin</a> 2477 2478### See Also 2479 2480<a href='#Paint_Miter_Limit'>Miter_Limit</a> 2481 2482<a name='Fill_Path'></a> 2483 2484--- 2485 2486<a href='#Paint_Fill_Path'>Fill_Path</a> creates a <a href='SkPath_Reference#Path'>Path</a> by applying the <a href='#Path_Effect'>Path_Effect</a>, followed by the <a href='#Paint_Style_Stroke'>Style_Stroke</a>. 2487 2488If <a href='SkPaint_Reference#Paint'>Paint</a> contains <a href='#Path_Effect'>Path_Effect</a>, <a href='#Path_Effect'>Path_Effect</a> operates on the source <a href='SkPath_Reference#Path'>Path</a>; the result 2489replaces the destination <a href='SkPath_Reference#Path'>Path</a>. Otherwise, the source <a href='SkPath_Reference#Path'>Path</a> is replaces the 2490destination <a href='SkPath_Reference#Path'>Path</a>. 2491 2492Fill <a href='SkPath_Reference#Path'>Path</a> can request the <a href='#Path_Effect'>Path_Effect</a> to restrict to a culling rectangle, but 2493the <a href='#Path_Effect'>Path_Effect</a> is not required to do so. 2494 2495If <a href='#SkPaint_Style'>Style</a> is <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> or <a href='#SkPaint_kStrokeAndFill_Style'>kStrokeAndFill_Style</a>, 2496and <a href='#Paint_Stroke_Width'>Stroke_Width</a> is greater than zero, the <a href='#Paint_Stroke_Width'>Stroke_Width</a>, <a href='#Paint_Stroke_Cap'>Stroke_Cap</a>, <a href='#Paint_Stroke_Join'>Stroke_Join</a>, 2497and <a href='#Paint_Miter_Limit'>Miter_Limit</a> operate on the destination <a href='SkPath_Reference#Path'>Path</a>, replacing it. 2498 2499Fill <a href='SkPath_Reference#Path'>Path</a> can specify the precision used by <a href='#Paint_Stroke_Width'>Stroke_Width</a> to approximate the stroke geometry. 2500 2501If the <a href='#SkPaint_Style'>Style</a> is <a href='#SkPaint_kStroke_Style'>kStroke_Style</a> and the <a href='#Paint_Stroke_Width'>Stroke_Width</a> is zero, <a href='#SkPaint_getFillPath'>getFillPath</a> 2502returns false since Hairline has no filled equivalent. 2503 2504### See Also 2505 2506<a href='#Paint_Style_Stroke'>Style_Stroke</a> <a href='#Paint_Stroke_Width'>Stroke_Width</a> <a href='#Path_Effect'>Path_Effect</a> 2507 2508<a name='SkPaint_getFillPath'></a> 2509 2510--- 2511 2512<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2513bool <a href='#SkPaint_getFillPath'>getFillPath</a>(const <a href='SkPath_Reference#SkPath'>SkPath</a>& src, <a href='SkPath_Reference#SkPath'>SkPath</a>* dst, const <a href='SkRect_Reference#SkRect'>SkRect</a>* cullRect, <a href='undocumented#SkScalar'>SkScalar</a> resScale = 1)const 2514</pre> 2515 2516Returns the filled equivalent of the stroked <a href='SkPath_Reference#Path'>path</a>. 2517 2518### Parameters 2519 2520<table> <tr> <td><a name='SkPaint_getFillPath_src'><code><strong>src</strong></code></a></td> 2521 <td><a href='SkPath_Reference#SkPath'>SkPath</a> read to create a filled version</td> 2522 </tr> 2523 <tr> <td><a name='SkPaint_getFillPath_dst'><code><strong>dst</strong></code></a></td> 2524 <td>resulting <a href='SkPath_Reference#SkPath'>SkPath</a>; may be the same as <a href='#SkPaint_getFillPath_src'>src</a>, but may not be nullptr</td> 2525 </tr> 2526 <tr> <td><a name='SkPaint_getFillPath_cullRect'><code><strong>cullRect</strong></code></a></td> 2527 <td>optional limit passed to <a href='undocumented#SkPathEffect'>SkPathEffect</a></td> 2528 </tr> 2529 <tr> <td><a name='SkPaint_getFillPath_resScale'><code><strong>resScale</strong></code></a></td> 2530 <td>if > 1, increase precision, else if (0 < <a href='#SkPaint_getFillPath_resScale'>resScale</a> < 1) reduce precision</td> 2531 </tr> 2532</table> 2533 2534to favor speed and <a href='undocumented#Size'>size</a> 2535 2536### Return Value 2537 2538true if the <a href='SkPath_Reference#Path'>path</a> represents <a href='#Style_Fill'>style fill</a>, or false if it represents hairline 2539 2540### Example 2541 2542<div><fiddle-embed name="cedd6233848198e1fca4d1e14816baaf"><div>A very small <a href='SkPath_Reference#Quad'>Quad</a> stroke is turned into a filled <a href='SkPath_Reference#Path'>path</a> with increasing levels of precision. 2543At the lowest precision, the <a href='SkPath_Reference#Quad'>Quad</a> stroke is approximated by a rectangle. 2544At the highest precision, the filled <a href='SkPath_Reference#Path'>path</a> has high fidelity compared to the original stroke. 2545</div></fiddle-embed></div> 2546 2547<a name='SkPaint_getFillPath_2'></a> 2548 2549--- 2550 2551<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2552bool <a href='#SkPaint_getFillPath'>getFillPath</a>(const <a href='SkPath_Reference#SkPath'>SkPath</a>& src, <a href='SkPath_Reference#SkPath'>SkPath</a>* dst)const 2553</pre> 2554 2555Returns the filled equivalent of the stroked <a href='SkPath_Reference#Path'>path</a>. 2556 2557Replaces <a href='#SkPaint_getFillPath_2_dst'>dst</a> with the <a href='#SkPaint_getFillPath_2_src'>src</a> <a href='SkPath_Reference#Path'>path</a> modified by <a href='undocumented#SkPathEffect'>SkPathEffect</a> and <a href='#Style_Stroke'>style stroke</a>. 2558<a href='undocumented#SkPathEffect'>SkPathEffect</a>, if any, is not culled. <a href='#Stroke_Width'>stroke width</a> is created with default precision. 2559 2560### Parameters 2561 2562<table> <tr> <td><a name='SkPaint_getFillPath_2_src'><code><strong>src</strong></code></a></td> 2563 <td><a href='SkPath_Reference#SkPath'>SkPath</a> read to create a filled version</td> 2564 </tr> 2565 <tr> <td><a name='SkPaint_getFillPath_2_dst'><code><strong>dst</strong></code></a></td> 2566 <td>resulting <a href='SkPath_Reference#SkPath'>SkPath</a> <a href='#SkPaint_getFillPath_2_dst'>dst</a> may be the same as <a href='#SkPaint_getFillPath_2_src'>src</a>, but may not be nullptr</td> 2567 </tr> 2568</table> 2569 2570### Return Value 2571 2572true if the <a href='SkPath_Reference#Path'>path</a> represents <a href='#Style_Fill'>style fill</a>, or false if it represents hairline 2573 2574### Example 2575 2576<div><fiddle-embed name="e6d8ca0cc17e0b475bd54dd995825468"></fiddle-embed></div> 2577 2578<a name='Shader_Methods'></a> 2579 2580--- 2581 2582<a href='undocumented#Shader'>Shader</a> defines the colors used when drawing a shape. 2583<a href='undocumented#Shader'>Shader</a> may be an <a href='SkImage_Reference#Image'>image</a>, a gradient, or a computed fill. 2584If <a href='SkPaint_Reference#Paint'>Paint</a> has no <a href='undocumented#Shader'>Shader</a>, then <a href='SkColor_Reference#Color'>Color</a> fills the shape. 2585 2586<a href='undocumented#Shader'>Shader</a> is modulated by <a href='#Color_Alpha'>Color_Alpha</a> component of <a href='SkColor_Reference#Color'>Color</a>. 2587If <a href='undocumented#Shader'>Shader</a> object defines only <a href='#Color_Alpha'>Color_Alpha</a>, then <a href='SkColor_Reference#Color'>Color</a> modulated by <a href='#Color_Alpha'>Color_Alpha</a> describes 2588the fill. 2589 2590The drawn transparency can be modified without altering <a href='undocumented#Shader'>Shader</a>, by changing <a href='#Color_Alpha'>Color_Alpha</a>. 2591 2592### Example 2593 2594<div><fiddle-embed name="c015dc2010c15e1c00b4f7330232b0f7"></fiddle-embed></div> 2595 2596If <a href='undocumented#Shader'>Shader</a> generates only <a href='#Color_Alpha'>Color_Alpha</a> then all components of <a href='SkColor_Reference#Color'>Color</a> modulate the output. 2597 2598### Example 2599 2600<div><fiddle-embed name="fe80fd80b98a20823db7fb9a077243c7"></fiddle-embed></div> 2601 2602<a name='SkPaint_getShader'></a> 2603 2604--- 2605 2606<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2607<a href='undocumented#SkShader'>SkShader</a>* <a href='#SkPaint_getShader'>getShader</a>()const 2608</pre> 2609 2610Returns optional colors used when filling a <a href='SkPath_Reference#Path'>path</a>, such as a gradient. 2611 2612Does not alter <a href='undocumented#SkShader'>SkShader</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 2613 2614### Return Value 2615 2616<a href='undocumented#SkShader'>SkShader</a> if previously set, nullptr otherwise 2617 2618### Example 2619 2620<div><fiddle-embed name="09f15b9fd88882850da2d235eb86292f"> 2621 2622#### Example Output 2623 2624~~~~ 2625nullptr == shader 2626nullptr != shader 2627~~~~ 2628 2629</fiddle-embed></div> 2630 2631<a name='SkPaint_refShader'></a> 2632 2633--- 2634 2635<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2636<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkShader'>SkShader</a>> <a href='#SkPaint_refShader'>refShader</a>()const 2637</pre> 2638 2639Returns optional colors used when filling a <a href='SkPath_Reference#Path'>path</a>, such as a gradient. 2640 2641Increases <a href='undocumented#SkShader'>SkShader</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2642 2643### Return Value 2644 2645<a href='undocumented#SkShader'>SkShader</a> if previously set, nullptr otherwise 2646 2647### Example 2648 2649<div><fiddle-embed name="53da0295972a418cbc9607bbb17feaa8"> 2650 2651#### Example Output 2652 2653~~~~ 2654shader unique: true 2655shader unique: false 2656~~~~ 2657 2658</fiddle-embed></div> 2659 2660<a name='SkPaint_setShader'></a> 2661 2662--- 2663 2664<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2665void <a href='#SkPaint_setShader'>setShader</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkShader'>SkShader</a>> <a href='undocumented#Shader'>shader</a>) 2666</pre> 2667 2668Sets optional colors used when filling a <a href='SkPath_Reference#Path'>path</a>, such as a gradient. 2669 2670Sets <a href='undocumented#SkShader'>SkShader</a> to <a href='#SkPaint_setShader_shader'>shader</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous <a href='undocumented#SkShader'>SkShader</a>. 2671Increments <a href='#SkPaint_setShader_shader'>shader</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2672 2673### Parameters 2674 2675<table> <tr> <td><a name='SkPaint_setShader_shader'><code><strong>shader</strong></code></a></td> 2676 <td>how geometry is filled with <a href='SkColor_Reference#Color'>color</a>; if nullptr, <a href='SkColor_Reference#Color'>color</a> is used instead</td> 2677 </tr> 2678</table> 2679 2680### Example 2681 2682<div><fiddle-embed name="77e64d5bae9b1ba037fd99252bb4aa58"></fiddle-embed></div> 2683 2684<a name='Color_Filter_Methods'></a> 2685 2686--- 2687 2688<a href='#Color_Filter'>Color_Filter</a> alters the <a href='SkColor_Reference#Color'>color</a> used when drawing a shape. 2689<a href='#Color_Filter'>Color_Filter</a> may apply <a href='#Blend_Mode'>Blend_Mode</a>, transform the <a href='SkColor_Reference#Color'>color</a> through a <a href='SkMatrix_Reference#Matrix'>matrix</a>, or composite multiple filters. 2690If <a href='SkPaint_Reference#Paint'>Paint</a> has no <a href='#Color_Filter'>Color_Filter</a>, the <a href='SkColor_Reference#Color'>color</a> is unaltered. 2691 2692The drawn transparency can be modified without altering <a href='#Color_Filter'>Color_Filter</a>, by changing <a href='#Color_Alpha'>Color_Alpha</a>. 2693 2694### Example 2695 2696<div><fiddle-embed name="5abde56ca2f89a18b8e231abd1b57c56"></fiddle-embed></div> 2697 2698<a name='SkPaint_getColorFilter'></a> 2699 2700--- 2701 2702<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2703<a href='undocumented#SkColorFilter'>SkColorFilter</a>* <a href='#SkPaint_getColorFilter'>getColorFilter</a>()const 2704</pre> 2705 2706Returns <a href='undocumented#SkColorFilter'>SkColorFilter</a> if set, or nullptr. 2707Does not alter <a href='undocumented#SkColorFilter'>SkColorFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 2708 2709### Return Value 2710 2711<a href='undocumented#SkColorFilter'>SkColorFilter</a> if previously set, nullptr otherwise 2712 2713### Example 2714 2715<div><fiddle-embed name="093bdc627d6b59002670fd290931f6c9"> 2716 2717#### Example Output 2718 2719~~~~ 2720nullptr == color filter 2721nullptr != color filter 2722~~~~ 2723 2724</fiddle-embed></div> 2725 2726<a name='SkPaint_refColorFilter'></a> 2727 2728--- 2729 2730<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2731<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkColorFilter'>SkColorFilter</a>> <a href='#SkPaint_refColorFilter'>refColorFilter</a>()const 2732</pre> 2733 2734Returns <a href='undocumented#SkColorFilter'>SkColorFilter</a> if set, or nullptr. 2735Increases <a href='undocumented#SkColorFilter'>SkColorFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2736 2737### Return Value 2738 2739<a href='undocumented#SkColorFilter'>SkColorFilter</a> if set, or nullptr 2740 2741### Example 2742 2743<div><fiddle-embed name="b588c95fa4c86ddbc4b0546762f08297"> 2744 2745#### Example Output 2746 2747~~~~ 2748color filter unique: true 2749color filter unique: false 2750~~~~ 2751 2752</fiddle-embed></div> 2753 2754<a name='SkPaint_setColorFilter'></a> 2755 2756--- 2757 2758<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2759void <a href='#SkPaint_setColorFilter'>setColorFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkColorFilter'>SkColorFilter</a>> colorFilter) 2760</pre> 2761 2762Sets <a href='undocumented#SkColorFilter'>SkColorFilter</a> to filter, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous 2763<a href='undocumented#SkColorFilter'>SkColorFilter</a>. Pass nullptr to clear <a href='undocumented#SkColorFilter'>SkColorFilter</a>. 2764 2765Increments filter <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2766 2767### Parameters 2768 2769<table> <tr> <td><a name='SkPaint_setColorFilter_colorFilter'><code><strong>colorFilter</strong></code></a></td> 2770 <td><a href='undocumented#SkColorFilter'>SkColorFilter</a> to apply to subsequent draw</td> 2771 </tr> 2772</table> 2773 2774### Example 2775 2776<div><fiddle-embed name="c7b786dc9b3501cd0eaba47494b6fa31"></fiddle-embed></div> 2777 2778<a name='Blend_Mode_Methods'></a> 2779 2780--- 2781 2782<a href='#Blend_Mode'>Blend_Mode</a> describes how <a href='SkColor_Reference#Color'>Color</a> combines with the destination <a href='SkColor_Reference#Color'>color</a>. 2783The default setting, <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a>, draws the source <a href='SkColor_Reference#Color'>color</a> 2784over the destination <a href='SkColor_Reference#Color'>color</a>. 2785 2786### Example 2787 2788<div><fiddle-embed name="73092d4d06faecea3c204d852a4dd8a8"></fiddle-embed></div> 2789 2790### See Also 2791 2792<a href='#Blend_Mode'>Blend_Mode</a> 2793 2794<a name='SkPaint_getBlendMode'></a> 2795 2796--- 2797 2798<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2799<a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> <a href='#SkPaint_getBlendMode'>getBlendMode</a>()const 2800</pre> 2801 2802Returns <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>. 2803By default, returns <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a>. 2804 2805### Return Value 2806 2807mode used to combine source <a href='SkColor_Reference#Color'>color</a> with destination <a href='SkColor_Reference#Color'>color</a> 2808 2809### Example 2810 2811<div><fiddle-embed name="a1e059c8f6740fa2044cc64152b39dda"> 2812 2813#### Example Output 2814 2815~~~~ 2816kSrcOver == getBlendMode 2817kSrcOver != getBlendMode 2818~~~~ 2819 2820</fiddle-embed></div> 2821 2822<a name='SkPaint_isSrcOver'></a> 2823 2824--- 2825 2826<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2827bool <a href='#SkPaint_isSrcOver'>isSrcOver</a>()const 2828</pre> 2829 2830Returns true if <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> is <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a>, the default. 2831 2832### Return Value 2833 2834true if <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> is <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a> 2835 2836### Example 2837 2838<div><fiddle-embed name="257c9473db7a2b3a0fb2b9e2431e59a6"> 2839 2840#### Example Output 2841 2842~~~~ 2843isSrcOver == true 2844isSrcOver != true 2845~~~~ 2846 2847</fiddle-embed></div> 2848 2849<a name='SkPaint_setBlendMode'></a> 2850 2851--- 2852 2853<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2854void <a href='#SkPaint_setBlendMode'>setBlendMode</a>(<a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> mode) 2855</pre> 2856 2857Sets <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> to <a href='#SkPaint_setBlendMode_mode'>mode</a>. 2858Does not check for valid input. 2859 2860### Parameters 2861 2862<table> <tr> <td><a name='SkPaint_setBlendMode_mode'><code><strong>mode</strong></code></a></td> 2863 <td><a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> used to combine source <a href='SkColor_Reference#Color'>color</a> and destination</td> 2864 </tr> 2865</table> 2866 2867### Example 2868 2869<div><fiddle-embed name="257c9473db7a2b3a0fb2b9e2431e59a6"> 2870 2871#### Example Output 2872 2873~~~~ 2874isSrcOver == true 2875isSrcOver != true 2876~~~~ 2877 2878</fiddle-embed></div> 2879 2880<a name='Path_Effect_Methods'></a> 2881 2882--- 2883 2884<a href='#Path_Effect'>Path_Effect</a> modifies the <a href='SkPath_Reference#Path'>path</a> geometry before drawing it. 2885<a href='#Path_Effect'>Path_Effect</a> may implement dashing, custom fill effects and custom stroke effects. 2886If <a href='SkPaint_Reference#Paint'>Paint</a> has no <a href='#Path_Effect'>Path_Effect</a>, the <a href='SkPath_Reference#Path'>path</a> geometry is unaltered when filled or stroked. 2887 2888### Example 2889 2890<div><fiddle-embed name="8cf5684b187d60f09e11c4a48993ea39"></fiddle-embed></div> 2891 2892### See Also 2893 2894<a href='#Path_Effect'>Path_Effect</a> 2895 2896<a name='SkPaint_getPathEffect'></a> 2897 2898--- 2899 2900<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2901<a href='undocumented#SkPathEffect'>SkPathEffect</a>* <a href='#SkPaint_getPathEffect'>getPathEffect</a>()const 2902</pre> 2903 2904Returns <a href='undocumented#SkPathEffect'>SkPathEffect</a> if set, or nullptr. 2905Does not alter <a href='undocumented#SkPathEffect'>SkPathEffect</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 2906 2907### Return Value 2908 2909<a href='undocumented#SkPathEffect'>SkPathEffect</a> if previously set, nullptr otherwise 2910 2911### Example 2912 2913<div><fiddle-embed name="211a1b14bfa6c4332082c8eab4fbc5fd"> 2914 2915#### Example Output 2916 2917~~~~ 2918nullptr == path effect 2919nullptr != path effect 2920~~~~ 2921 2922</fiddle-embed></div> 2923 2924<a name='SkPaint_refPathEffect'></a> 2925 2926--- 2927 2928<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2929<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkPathEffect'>SkPathEffect</a>> <a href='#SkPaint_refPathEffect'>refPathEffect</a>()const 2930</pre> 2931 2932Returns <a href='undocumented#SkPathEffect'>SkPathEffect</a> if set, or nullptr. 2933Increases <a href='undocumented#SkPathEffect'>SkPathEffect</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2934 2935### Return Value 2936 2937<a href='undocumented#SkPathEffect'>SkPathEffect</a> if previously set, nullptr otherwise 2938 2939### Example 2940 2941<div><fiddle-embed name="f56039b94c702c2704c8c5100e623aca"> 2942 2943#### Example Output 2944 2945~~~~ 2946path effect unique: true 2947path effect unique: false 2948~~~~ 2949 2950</fiddle-embed></div> 2951 2952<a name='SkPaint_setPathEffect'></a> 2953 2954--- 2955 2956<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2957void <a href='#SkPaint_setPathEffect'>setPathEffect</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkPathEffect'>SkPathEffect</a>> pathEffect) 2958</pre> 2959 2960Sets <a href='undocumented#SkPathEffect'>SkPathEffect</a> to <a href='#SkPaint_setPathEffect_pathEffect'>pathEffect</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous 2961<a href='undocumented#SkPathEffect'>SkPathEffect</a>. Pass nullptr to leave the <a href='SkPath_Reference#Path'>path</a> geometry unaltered. 2962 2963Increments <a href='#SkPaint_setPathEffect_pathEffect'>pathEffect</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 2964 2965### Parameters 2966 2967<table> <tr> <td><a name='SkPaint_setPathEffect_pathEffect'><code><strong>pathEffect</strong></code></a></td> 2968 <td>replace <a href='SkPath_Reference#SkPath'>SkPath</a> with a modification when drawn</td> 2969 </tr> 2970</table> 2971 2972### Example 2973 2974<div><fiddle-embed name="52dd55074ca0b7d520d04e750ca2a0d7"></fiddle-embed></div> 2975 2976<a name='Mask_Filter_Methods'></a> 2977 2978--- 2979 2980<a href='#Mask_Filter'>Mask_Filter</a> uses coverage of the shape drawn to create <a href='#Mask_Alpha'>Mask_Alpha</a>. 2981<a href='#Mask_Filter'>Mask_Filter</a> takes a Mask, and returns a Mask. 2982 2983<a href='#Mask_Filter'>Mask_Filter</a> may change the geometry and transparency of the shape, such as 2984creating a blur effect. Set <a href='#Mask_Filter'>Mask_Filter</a> to nullptr to prevent <a href='#Mask_Filter'>Mask_Filter</a> from 2985modifying the draw. 2986 2987### Example 2988 2989<div><fiddle-embed name="55d7b9d482ac8e17a6153f555a8adb8d"></fiddle-embed></div> 2990 2991<a name='SkPaint_getMaskFilter'></a> 2992 2993--- 2994 2995<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 2996<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>* <a href='#SkPaint_getMaskFilter'>getMaskFilter</a>()const 2997</pre> 2998 2999Returns <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> if set, or nullptr. 3000Does not alter <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 3001 3002### Return Value 3003 3004<a href='undocumented#SkMaskFilter'>SkMaskFilter</a> if previously set, nullptr otherwise 3005 3006### Example 3007 3008<div><fiddle-embed name="5ac4b31371726da87bb7390b385e9fee"> 3009 3010#### Example Output 3011 3012~~~~ 3013nullptr == mask filter 3014nullptr != mask filter 3015~~~~ 3016 3017</fiddle-embed></div> 3018 3019<a name='SkPaint_refMaskFilter'></a> 3020 3021--- 3022 3023<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3024<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>> <a href='#SkPaint_refMaskFilter'>refMaskFilter</a>()const 3025</pre> 3026 3027Returns <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> if set, or nullptr. 3028 3029Increases <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3030 3031### Return Value 3032 3033<a href='undocumented#SkMaskFilter'>SkMaskFilter</a> if previously set, nullptr otherwise 3034 3035### Example 3036 3037<div><fiddle-embed name="084b0dc3cebd78718c651d58f257f799"> 3038 3039#### Example Output 3040 3041~~~~ 3042mask filter unique: true 3043mask filter unique: false 3044~~~~ 3045 3046</fiddle-embed></div> 3047 3048<a name='SkPaint_setMaskFilter'></a> 3049 3050--- 3051 3052<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3053void <a href='#SkPaint_setMaskFilter'>setMaskFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>> maskFilter) 3054</pre> 3055 3056Sets <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> to <a href='#SkPaint_setMaskFilter_maskFilter'>maskFilter</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous 3057<a href='undocumented#SkMaskFilter'>SkMaskFilter</a>. Pass nullptr to clear <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> and leave <a href='undocumented#SkMaskFilter'>SkMaskFilter</a> effect on 3058<a href='undocumented#Mask_Alpha'>mask alpha</a> unaltered. 3059 3060Increments <a href='#SkPaint_setMaskFilter_maskFilter'>maskFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3061 3062### Parameters 3063 3064<table> <tr> <td><a name='SkPaint_setMaskFilter_maskFilter'><code><strong>maskFilter</strong></code></a></td> 3065 <td>modifies clipping mask generated from drawn geometry</td> 3066 </tr> 3067</table> 3068 3069### Example 3070 3071<div><fiddle-embed name="a993831c40f3e134f809134e3b74e4a6"></fiddle-embed></div> 3072 3073<a name='Typeface_Methods'></a> 3074 3075--- 3076 3077<a href='undocumented#Typeface'>Typeface</a> identifies the <a href='SkFont_Reference#Font'>font</a> used when drawing and measuring <a href='undocumented#Text'>text</a>. 3078<a href='undocumented#Typeface'>Typeface</a> may be specified by name, from a file, or from a <a href='undocumented#Data'>data</a> <a href='SkStream_Reference#Stream'>stream</a>. 3079The default <a href='undocumented#Typeface'>Typeface</a> defers to the platform-specific default <a href='SkFont_Reference#Font'>font</a> 3080implementation. 3081 3082### Example 3083 3084<div><fiddle-embed name="1a7a5062725139760962582f599f1b97"></fiddle-embed></div> 3085 3086<a name='SkPaint_getTypeface'></a> 3087 3088--- 3089 3090<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3091<a href='undocumented#SkTypeface'>SkTypeface</a>* <a href='#SkPaint_getTypeface'>getTypeface</a>()const 3092</pre> 3093 3094Returns <a href='undocumented#SkTypeface'>SkTypeface</a> if set, or nullptr. 3095Does not alter <a href='undocumented#SkTypeface'>SkTypeface</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 3096 3097### Return Value 3098 3099<a href='undocumented#SkTypeface'>SkTypeface</a> if previously set, nullptr otherwise 3100 3101### Example 3102 3103<div><fiddle-embed name="5ce718e5a184baaac80e7098d7dad67b"> 3104 3105#### Example Output 3106 3107~~~~ 3108nullptr == typeface 3109nullptr != typeface 3110~~~~ 3111 3112</fiddle-embed></div> 3113 3114<a name='SkPaint_refTypeface'></a> 3115 3116--- 3117 3118<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3119<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkTypeface'>SkTypeface</a>> <a href='#SkPaint_refTypeface'>refTypeface</a>()const 3120</pre> 3121 3122Increases <a href='undocumented#SkTypeface'>SkTypeface</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3123 3124### Return Value 3125 3126<a href='undocumented#SkTypeface'>SkTypeface</a> if previously set, nullptr otherwise 3127 3128### Example 3129 3130<div><fiddle-embed name="8b5aa7e555a0dc31be69db7cadf471a1"> 3131 3132#### Example Output 3133 3134~~~~ 3135typeface1 != typeface2 3136typeface1 == typeface2 3137~~~~ 3138 3139</fiddle-embed></div> 3140 3141<a name='SkPaint_setTypeface'></a> 3142 3143--- 3144 3145<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3146void <a href='#SkPaint_setTypeface'>setTypeface</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkTypeface'>SkTypeface</a>> <a href='undocumented#Typeface'>typeface</a>) 3147</pre> 3148 3149Sets <a href='undocumented#SkTypeface'>SkTypeface</a> to <a href='#SkPaint_setTypeface_typeface'>typeface</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous <a href='undocumented#SkTypeface'>SkTypeface</a>. 3150Pass nullptr to clear <a href='undocumented#SkTypeface'>SkTypeface</a> and use the default <a href='#SkPaint_setTypeface_typeface'>typeface</a>. Increments 3151<a href='#SkPaint_setTypeface_typeface'>typeface</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3152 3153### Parameters 3154 3155<table> <tr> <td><a name='SkPaint_setTypeface_typeface'><code><strong>typeface</strong></code></a></td> 3156 <td><a href='SkFont_Reference#Font'>font</a> and style used to draw <a href='undocumented#Text'>text</a></td> 3157 </tr> 3158</table> 3159 3160### Example 3161 3162<div><fiddle-embed name="0e6fbb7773cd925b274552f4cd1abef2"></fiddle-embed></div> 3163 3164<a name='Image_Filter_Methods'></a> 3165 3166--- 3167 3168<a href='#Image_Filter'>Image_Filter</a> operates on the <a href='undocumented#Pixel'>pixel</a> representation of the shape, as modified by <a href='SkPaint_Reference#Paint'>Paint</a> 3169with <a href='#Blend_Mode'>Blend_Mode</a> set to <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a>::<a href='#SkBlendMode_kSrcOver'>kSrcOver</a>. <a href='#Image_Filter'>Image_Filter</a> creates a new <a href='SkBitmap_Reference#Bitmap'>bitmap</a>, 3170which is drawn to the <a href='undocumented#Device'>device</a> using the set <a href='#Blend_Mode'>Blend_Mode</a>. 3171 3172<a href='#Image_Filter'>Image_Filter</a> is higher level than <a href='#Mask_Filter'>Mask_Filter</a>; for instance, an <a href='#Image_Filter'>Image_Filter</a> 3173can operate on all channels of <a href='SkColor_Reference#Color'>Color</a>, while <a href='#Mask_Filter'>Mask_Filter</a> generates <a href='SkColor_Reference#Alpha'>Alpha</a> only. 3174<a href='#Image_Filter'>Image_Filter</a> operates independently of and can be used in combination with 3175<a href='#Mask_Filter'>Mask_Filter</a>. 3176 3177### Example 3178 3179<div><fiddle-embed name="ece04ee3d3761e3425f37c8f06f054c1"></fiddle-embed></div> 3180 3181<a name='SkPaint_getImageFilter'></a> 3182 3183--- 3184 3185<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3186<a href='undocumented#SkImageFilter'>SkImageFilter</a>* <a href='#SkPaint_getImageFilter'>getImageFilter</a>()const 3187</pre> 3188 3189Returns <a href='undocumented#SkImageFilter'>SkImageFilter</a> if set, or nullptr. 3190Does not alter <a href='undocumented#SkImageFilter'>SkImageFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 3191 3192### Return Value 3193 3194<a href='undocumented#SkImageFilter'>SkImageFilter</a> if previously set, nullptr otherwise 3195 3196### Example 3197 3198<div><fiddle-embed name="c11f8eaa1dd149bc18db21e23ce26904"> 3199 3200#### Example Output 3201 3202~~~~ 3203nullptr == image filter 3204nullptr != image filter 3205~~~~ 3206 3207</fiddle-embed></div> 3208 3209<a name='SkPaint_refImageFilter'></a> 3210 3211--- 3212 3213<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3214<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkImageFilter'>SkImageFilter</a>> <a href='#SkPaint_refImageFilter'>refImageFilter</a>()const 3215</pre> 3216 3217Returns <a href='undocumented#SkImageFilter'>SkImageFilter</a> if set, or nullptr. 3218Increases <a href='undocumented#SkImageFilter'>SkImageFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3219 3220### Return Value 3221 3222<a href='undocumented#SkImageFilter'>SkImageFilter</a> if previously set, nullptr otherwise 3223 3224### Example 3225 3226<div><fiddle-embed name="13f09088b569251547107d14ae989dc1"> 3227 3228#### Example Output 3229 3230~~~~ 3231image filter unique: true 3232image filter unique: false 3233~~~~ 3234 3235</fiddle-embed></div> 3236 3237<a name='SkPaint_setImageFilter'></a> 3238 3239--- 3240 3241<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3242void <a href='#SkPaint_setImageFilter'>setImageFilter</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkImageFilter'>SkImageFilter</a>> imageFilter) 3243</pre> 3244 3245Sets <a href='undocumented#SkImageFilter'>SkImageFilter</a> to <a href='#SkPaint_setImageFilter_imageFilter'>imageFilter</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous 3246<a href='undocumented#SkImageFilter'>SkImageFilter</a>. Pass nullptr to clear <a href='undocumented#SkImageFilter'>SkImageFilter</a>, and remove <a href='undocumented#SkImageFilter'>SkImageFilter</a> effect 3247on drawing. 3248 3249Increments <a href='#SkPaint_setImageFilter_imageFilter'>imageFilter</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3250 3251### Parameters 3252 3253<table> <tr> <td><a name='SkPaint_setImageFilter_imageFilter'><code><strong>imageFilter</strong></code></a></td> 3254 <td>how <a href='SkImage_Reference#SkImage'>SkImage</a> is sampled when transformed</td> 3255 </tr> 3256</table> 3257 3258### Example 3259 3260<div><fiddle-embed name="6679d6e4ec632715ee03e68391bd7f9a"></fiddle-embed></div> 3261 3262<a name='Draw_Looper_Methods'></a> 3263 3264--- 3265 3266<a href='#Draw_Looper'>Draw_Looper</a> sets a modifier that communicates state from one <a href='#Draw_Layer'>Draw_Layer</a> 3267to another to construct the draw. 3268 3269<a href='#Draw_Looper'>Draw_Looper</a> draws one or more times, modifying the <a href='SkCanvas_Reference#Canvas'>canvas</a> and <a href='SkPaint_Reference#Paint'>paint</a> each time. 3270<a href='#Draw_Looper'>Draw_Looper</a> may be used to draw multiple colors or create a colored shadow. 3271Set <a href='#Draw_Looper'>Draw_Looper</a> to nullptr to prevent <a href='#Draw_Looper'>Draw_Looper</a> from modifying the draw. 3272 3273### Example 3274 3275<div><fiddle-embed name="84ec12a36e50df5ac565cc7a75ffbe9f"></fiddle-embed></div> 3276 3277<a name='SkPaint_getDrawLooper'></a> 3278 3279--- 3280 3281<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3282<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>* <a href='#SkPaint_getDrawLooper'>getDrawLooper</a>()const 3283</pre> 3284 3285Returns <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> if set, or nullptr. 3286Does not alter <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a>. 3287 3288### Return Value 3289 3290<a href='undocumented#SkDrawLooper'>SkDrawLooper</a> if previously set, nullptr otherwise 3291 3292### Example 3293 3294<div><fiddle-embed name="af4c5acc7a91e7f23c2af48018903ad4"> 3295 3296#### Example Output 3297 3298~~~~ 3299nullptr == draw looper 3300nullptr != draw looper 3301~~~~ 3302 3303</fiddle-embed></div> 3304 3305<a name='SkPaint_refDrawLooper'></a> 3306 3307--- 3308 3309<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3310<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>> <a href='#SkPaint_refDrawLooper'>refDrawLooper</a>()const 3311</pre> 3312 3313Returns <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> if set, or nullptr. 3314Increases <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3315 3316### Return Value 3317 3318<a href='undocumented#SkDrawLooper'>SkDrawLooper</a> if previously set, nullptr otherwise 3319 3320### Example 3321 3322<div><fiddle-embed name="2a3782c33f04ed17a725d0e449c6f7c3"> 3323 3324#### Example Output 3325 3326~~~~ 3327draw looper unique: true 3328draw looper unique: false 3329~~~~ 3330 3331</fiddle-embed></div> 3332 3333<a name='SkPaint_setDrawLooper'></a> 3334 3335--- 3336 3337<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3338void <a href='#SkPaint_setDrawLooper'>setDrawLooper</a>(<a href='undocumented#sk_sp'>sk_sp</a><<a href='undocumented#SkDrawLooper'>SkDrawLooper</a>> drawLooper) 3339</pre> 3340 3341Sets <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> to <a href='#SkPaint_setDrawLooper_drawLooper'>drawLooper</a>, decreasing <a href='undocumented#SkRefCnt'>SkRefCnt</a> of the previous 3342<a href='#SkPaint_setDrawLooper_drawLooper'>drawLooper</a>. Pass nullptr to clear <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> and leave <a href='undocumented#SkDrawLooper'>SkDrawLooper</a> effect on 3343drawing unaltered. 3344 3345Increments <a href='#SkPaint_setDrawLooper_drawLooper'>drawLooper</a> <a href='undocumented#SkRefCnt'>SkRefCnt</a> by one. 3346 3347### Parameters 3348 3349<table> <tr> <td><a name='SkPaint_setDrawLooper_drawLooper'><code><strong>drawLooper</strong></code></a></td> 3350 <td>iterates through drawing one or more time, altering <a href='SkPaint_Reference#SkPaint'>SkPaint</a></td> 3351 </tr> 3352</table> 3353 3354### Example 3355 3356<div><fiddle-embed name="bf10f838b330f0a3a3266d42ea68a638"></fiddle-embed></div> 3357 3358<a name='Text_Size'></a> 3359 3360--- 3361 3362<a href='#Paint_Text_Size'>Text_Size</a> adjusts the overall <a href='#Text_Size'>text size</a> in <a href='SkPoint_Reference#Point'>points</a>. 3363<a href='#Paint_Text_Size'>Text_Size</a> can be set to any positive value or zero. 3364<a href='#Paint_Text_Size'>Text_Size</a> defaults to 12. 3365Set <a href='undocumented#SkPaintDefaults_TextSize'>SkPaintDefaults_TextSize</a> at compile time to change the default setting. 3366 3367### Example 3368 3369<div><fiddle-embed name="91c9a3e498bb9412e4522a95d076ed5f"></fiddle-embed></div> 3370 3371<a name='SkPaint_getTextSize'></a> 3372 3373--- 3374 3375<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3376<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextSize'>getTextSize</a>()const 3377</pre> 3378 3379Returns <a href='undocumented#Text'>text</a> <a href='undocumented#Size'>size</a> in <a href='SkPoint_Reference#Point'>points</a>. 3380 3381### Return Value 3382 3383typographic height of <a href='undocumented#Text'>text</a> 3384 3385### Example 3386 3387<div><fiddle-embed name="983e2a71ba72d4ba8c945420040b8f1c"></fiddle-embed></div> 3388 3389<a name='SkPaint_setTextSize'></a> 3390 3391--- 3392 3393<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3394void <a href='#SkPaint_setTextSize'>setTextSize</a>(<a href='undocumented#SkScalar'>SkScalar</a> textSize) 3395</pre> 3396 3397Sets <a href='#Text_Size'>text size</a> in <a href='SkPoint_Reference#Point'>points</a>. 3398Has no effect if <a href='#SkPaint_setTextSize_textSize'>textSize</a> is not greater than or equal to zero. 3399 3400### Parameters 3401 3402<table> <tr> <td><a name='SkPaint_setTextSize_textSize'><code><strong>textSize</strong></code></a></td> 3403 <td>typographic height of <a href='undocumented#Text'>text</a></td> 3404 </tr> 3405</table> 3406 3407### Example 3408 3409<div><fiddle-embed name="6510c9e2f57b83c47e67829e7a68d493"></fiddle-embed></div> 3410 3411<a name='Text_Scale_X'></a> 3412 3413--- 3414 3415<a href='#Paint_Text_Scale_X'>Text_Scale_X</a> adjusts the <a href='undocumented#Text'>text</a> horizontal scale. 3416<a href='undocumented#Text'>Text</a> scaling approximates condensed and expanded type faces when the actual face 3417is not available. 3418<a href='#Paint_Text_Scale_X'>Text_Scale_X</a> can be set to any value. 3419<a href='#Paint_Text_Scale_X'>Text_Scale_X</a> defaults to 1. 3420 3421### Example 3422 3423<div><fiddle-embed name="d13d787c1e36f515319fc998411c1d91"></fiddle-embed></div> 3424 3425<a name='SkPaint_getTextScaleX'></a> 3426 3427--- 3428 3429<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3430<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextScaleX'>getTextScaleX</a>()const 3431</pre> 3432 3433Returns <a href='undocumented#Text'>text</a> scale on x-axis. 3434Default value is 1. 3435 3436### Return Value 3437 3438<a href='undocumented#Text'>text</a> horizontal scale 3439 3440### Example 3441 3442<div><fiddle-embed name="5dc8e58f6910cb8e4de9ed60f888188b"></fiddle-embed></div> 3443 3444<a name='SkPaint_setTextScaleX'></a> 3445 3446--- 3447 3448<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3449void <a href='#SkPaint_setTextScaleX'>setTextScaleX</a>(<a href='undocumented#SkScalar'>SkScalar</a> scaleX) 3450</pre> 3451 3452Sets <a href='undocumented#Text'>text scale</a> on x-axis. 3453Default value is 1. 3454 3455### Parameters 3456 3457<table> <tr> <td><a name='SkPaint_setTextScaleX_scaleX'><code><strong>scaleX</strong></code></a></td> 3458 <td><a href='undocumented#Text'>text</a> horizontal scale</td> 3459 </tr> 3460</table> 3461 3462### Example 3463 3464<div><fiddle-embed name="a75bbdb8bb866b125c4c1dd5e967d470"></fiddle-embed></div> 3465 3466<a name='Text_Skew_X'></a> 3467 3468--- 3469 3470<a href='#Paint_Text_Skew_X'>Text_Skew_X</a> adjusts the <a href='undocumented#Text'>text</a> horizontal slant. 3471<a href='undocumented#Text'>Text</a> skewing approximates italic and oblique type faces when the actual face 3472is not available. 3473<a href='#Paint_Text_Skew_X'>Text_Skew_X</a> can be set to any value. 3474<a href='#Paint_Text_Skew_X'>Text_Skew_X</a> defaults to 0. 3475 3476### Example 3477 3478<div><fiddle-embed name="aff208b0aab265f273045b27e683c17c"></fiddle-embed></div> 3479 3480<a name='SkPaint_getTextSkewX'></a> 3481 3482--- 3483 3484<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3485<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getTextSkewX'>getTextSkewX</a>()const 3486</pre> 3487 3488Returns <a href='undocumented#Text'>text</a> skew on x-axis. 3489Default value is zero. 3490 3491### Return Value 3492 3493additional shear on x-axis relative to y-axis 3494 3495### Example 3496 3497<div><fiddle-embed name="11c10f466dae0d1639dbb9f6a0040218"></fiddle-embed></div> 3498 3499<a name='SkPaint_setTextSkewX'></a> 3500 3501--- 3502 3503<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3504void <a href='#SkPaint_setTextSkewX'>setTextSkewX</a>(<a href='undocumented#SkScalar'>SkScalar</a> skewX) 3505</pre> 3506 3507Sets <a href='undocumented#Text'>text skew</a> on x-axis. 3508Default value is zero. 3509 3510### Parameters 3511 3512<table> <tr> <td><a name='SkPaint_setTextSkewX_skewX'><code><strong>skewX</strong></code></a></td> 3513 <td>additional shear on x-axis relative to y-axis</td> 3514 </tr> 3515</table> 3516 3517### Example 3518 3519<div><fiddle-embed name="6bd705a6e0c5f8ee24f302fe531bfabc"></fiddle-embed></div> 3520 3521<a name='Text_Encoding'></a> 3522 3523--- 3524 3525### Example 3526 3527<div><fiddle-embed name="767fa4e7b6300e16a419f9881f0f9d3d"><div>First <a href='undocumented#Line'>line</a> is encoded in UTF-8. 3528Second <a href='undocumented#Line'>line</a> is encoded in UTF-16. 3529Third <a href='undocumented#Line'>line</a> is encoded in UTF-32. 3530Fourth <a href='undocumented#Line'>line</a> has 16-bit <a href='undocumented#Glyph'>glyph</a> indices. 3531</div></fiddle-embed></div> 3532 3533<a name='SkPaint_getTextEncoding'></a> 3534 3535--- 3536 3537<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3538<a href='undocumented#SkTextEncoding'>SkTextEncoding</a> <a href='#SkPaint_getTextEncoding'>getTextEncoding</a>()const 3539</pre> 3540 3541Returns the <a href='undocumented#Text'>text</a> encoding. <a href='undocumented#Text'>Text</a> encoding describes how to interpret the <a href='undocumented#Text'>text</a> bytes pass 3542to methods like <a href='#SkPaint_measureText'>measureText</a>() and <a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawText'>drawText</a>(). 3543 3544### Return Value 3545 3546the <a href='undocumented#Text'>text</a> encoding 3547 3548### Example 3549 3550<div><fiddle-embed name="0d21e968e9a4c78c902ae3ef494941a0"> 3551 3552#### Example Output 3553 3554~~~~ 3555SkTextEncoding::kUTF8 == text encoding 3556SkTextEncoding::kGlyphID == text encoding 3557~~~~ 3558 3559</fiddle-embed></div> 3560 3561<a name='SkPaint_setTextEncoding'></a> 3562 3563--- 3564 3565<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3566void <a href='#SkPaint_setTextEncoding'>setTextEncoding</a>(<a href='undocumented#SkTextEncoding'>SkTextEncoding</a> encoding) 3567</pre> 3568 3569Sets the <a href='#Text_Encoding'>text encoding</a>. <a href='undocumented#Text'>Text</a> <a href='#SkPaint_setTextEncoding_encoding'>encoding</a> describes how to interpret the <a href='undocumented#Text'>text</a> bytes pass 3570to methods like <a href='#SkPaint_measureText'>measureText</a>() and <a href='SkCanvas_Reference#SkCanvas'>SkCanvas</a>::<a href='#SkCanvas_drawText'>drawText</a>(). 3571 3572### Parameters 3573 3574<table> <tr> <td><a name='SkPaint_setTextEncoding_encoding'><code><strong>encoding</strong></code></a></td> 3575 <td>the new <a href='#Text_Encoding'>text encoding</a></td> 3576 </tr> 3577</table> 3578 3579### Example 3580 3581<div><fiddle-embed name="a5d1ba0dbf42afb797ffdb07647b5cb9"> 3582 3583#### Example Output 3584 3585~~~~ 35864 != text encoding 3587~~~~ 3588 3589</fiddle-embed></div> 3590 3591<a name='SkPaint_FontMetrics'></a> 3592 3593--- 3594 3595<a name='Font_Metrics'></a> 3596 3597<a name='SkPaint_getFontMetrics'></a> 3598 3599--- 3600 3601<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3602<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getFontMetrics'>getFontMetrics</a>(<a href='undocumented#SkFontMetrics'>SkFontMetrics</a>* metrics)const 3603</pre> 3604 3605Returns <a href='undocumented#SkFontMetrics'>SkFontMetrics</a> associated with <a href='undocumented#SkTypeface'>SkTypeface</a>. 3606The return value is the recommended spacing between <a href='undocumented#Line'>lines</a>: the sum of <a href='#SkPaint_getFontMetrics_metrics'>metrics</a> 3607descent, ascent, and leading. 3608If <a href='#SkPaint_getFontMetrics_metrics'>metrics</a> is not nullptr, <a href='undocumented#SkFontMetrics'>SkFontMetrics</a> is copied to <a href='#SkPaint_getFontMetrics_metrics'>metrics</a>. 3609Results are scaled by <a href='#Text_Size'>text size</a> but does not take into account 3610dimensions required by <a href='#Text_Scale_X'>text scale x</a>, <a href='#Text_Skew_X'>text skew x</a>, <a href='#Fake_Bold'>fake bold</a>, 3611<a href='#Style_Stroke'>style stroke</a>, and <a href='undocumented#SkPathEffect'>SkPathEffect</a>. 3612 3613### Parameters 3614 3615<table> <tr> <td><a name='SkPaint_getFontMetrics_metrics'><code><strong>metrics</strong></code></a></td> 3616 <td>storage for <a href='undocumented#SkFontMetrics'>SkFontMetrics</a>; may be nullptr</td> 3617 </tr> 3618</table> 3619 3620### Return Value 3621 3622recommended spacing between <a href='undocumented#Line'>lines</a> 3623 3624### Example 3625 3626<div><fiddle-embed name="59d9b8249afa1c2af6186711250ce240"></fiddle-embed></div> 3627 3628### See Also 3629 3630<a href='#Font_Size'>Font_Size</a> <a href='undocumented#Typeface'>Typeface</a> <a href='#Paint_Typeface_Methods'>Typeface_Methods</a> 3631 3632<a name='SkPaint_getFontSpacing'></a> 3633 3634--- 3635 3636<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3637<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_getFontSpacing'>getFontSpacing</a>()const 3638</pre> 3639 3640Returns the recommended spacing between <a href='undocumented#Line'>lines</a>: the sum of metrics 3641descent, ascent, and leading. 3642Result is scaled by <a href='undocumented#Text'>text</a> <a href='undocumented#Size'>size</a> but does not take into account 3643dimensions required by stroking and <a href='undocumented#SkPathEffect'>SkPathEffect</a>. 3644Returns the same result as <a href='#SkPaint_getFontMetrics'>getFontMetrics</a>(). 3645 3646### Return Value 3647 3648recommended spacing between <a href='undocumented#Line'>lines</a> 3649 3650### Example 3651 3652<div><fiddle-embed name="424741e26e1b174e43087d67422ce14f"> 3653 3654#### Example Output 3655 3656~~~~ 3657textSize: 12 fontSpacing: 13.9688 3658textSize: 18 fontSpacing: 20.9531 3659textSize: 24 fontSpacing: 27.9375 3660textSize: 32 fontSpacing: 37.25 3661~~~~ 3662 3663</fiddle-embed></div> 3664 3665<a name='SkPaint_textToGlyphs'></a> 3666 3667--- 3668 3669<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3670int <a href='#SkPaint_textToGlyphs'>textToGlyphs</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength, <a href='undocumented#SkGlyphID'>SkGlyphID</a> <a href='undocumented#Glyph'>glyphs</a>[])const 3671</pre> 3672 3673Converts <a href='#SkPaint_textToGlyphs_text'>text</a> into <a href='undocumented#Glyph'>glyph</a> indices. 3674Returns the number of <a href='undocumented#Glyph'>glyph</a> indices represented by <a href='#SkPaint_textToGlyphs_text'>text</a>. 3675<a href='undocumented#SkTextEncoding'>SkTextEncoding</a> specifies how <a href='#SkPaint_textToGlyphs_text'>text</a> represents characters or <a href='#SkPaint_textToGlyphs_glyphs'>glyphs</a>. 3676<a href='#SkPaint_textToGlyphs_glyphs'>glyphs</a> may be nullptr, to compute the <a href='undocumented#Glyph'>glyph</a> count. 3677 3678Does not check <a href='#SkPaint_textToGlyphs_text'>text</a> for valid character codes or valid <a href='undocumented#Glyph'>glyph</a> indices. 3679 3680If <a href='#SkPaint_textToGlyphs_byteLength'>byteLength</a> equals zero, returns zero. 3681If <a href='#SkPaint_textToGlyphs_byteLength'>byteLength</a> includes a partial character, the partial character is ignored. 3682 3683If <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> is <a href='undocumented#SkTextEncoding::kUTF8'>SkTextEncoding::kUTF8</a> and 3684<a href='#SkPaint_textToGlyphs_text'>text</a> contains an invalid UTF-8 sequence, zero is returned. 3685 3686### Parameters 3687 3688<table> <tr> <td><a name='SkPaint_textToGlyphs_text'><code><strong>text</strong></code></a></td> 3689 <td>character storage encoded with <a href='undocumented#SkTextEncoding'>SkTextEncoding</a></td> 3690 </tr> 3691 <tr> <td><a name='SkPaint_textToGlyphs_byteLength'><code><strong>byteLength</strong></code></a></td> 3692 <td>length of character storage in bytes</td> 3693 </tr> 3694 <tr> <td><a name='SkPaint_textToGlyphs_glyphs'><code><strong>glyphs</strong></code></a></td> 3695 <td>storage for <a href='undocumented#Glyph'>glyph</a> indices; may be nullptr</td> 3696 </tr> 3697</table> 3698 3699### Return Value 3700 3701number of <a href='#SkPaint_textToGlyphs_glyphs'>glyphs</a> represented by <a href='#SkPaint_textToGlyphs_text'>text</a> of length <a href='#SkPaint_textToGlyphs_byteLength'>byteLength</a> 3702 3703### Example 3704 3705<div><fiddle-embed name="d11136d8a74f63009da2a7f550710823"></fiddle-embed></div> 3706 3707<a name='SkPaint_countText'></a> 3708 3709--- 3710 3711<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3712int <a href='#SkPaint_countText'>countText</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength)const 3713</pre> 3714 3715Returns the number of <a href='undocumented#Glyph'>glyphs</a> in <a href='#SkPaint_countText_text'>text</a>. 3716Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to count the <a href='undocumented#Glyph'>glyphs</a>. 3717Returns the same result as <a href='#SkPaint_textToGlyphs'>textToGlyphs</a>(). 3718 3719### Parameters 3720 3721<table> <tr> <td><a name='SkPaint_countText_text'><code><strong>text</strong></code></a></td> 3722 <td>character storage encoded with <a href='undocumented#SkTextEncoding'>SkTextEncoding</a></td> 3723 </tr> 3724 <tr> <td><a name='SkPaint_countText_byteLength'><code><strong>byteLength</strong></code></a></td> 3725 <td>length of character storage in bytes</td> 3726 </tr> 3727</table> 3728 3729### Return Value 3730 3731number of <a href='undocumented#Glyph'>glyphs</a> represented by <a href='#SkPaint_countText_text'>text</a> of length <a href='#SkPaint_countText_byteLength'>byteLength</a> 3732 3733### Example 3734 3735<div><fiddle-embed name="85436c71aab5410767fc688ab0573e09"> 3736 3737#### Example Output 3738 3739~~~~ 3740count = 5 3741~~~~ 3742 3743</fiddle-embed></div> 3744 3745<a name='SkPaint_containsText'></a> 3746 3747--- 3748 3749<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3750bool <a href='#SkPaint_containsText'>containsText</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength)const 3751</pre> 3752 3753Returns true if all <a href='#SkPaint_containsText_text'>text</a> corresponds to a non-zero <a href='undocumented#Glyph'>glyph</a> index. 3754Returns false if any characters in <a href='#SkPaint_containsText_text'>text</a> are not supported in 3755<a href='undocumented#SkTypeface'>SkTypeface</a>. 3756 3757If <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> is <a href='undocumented#SkTextEncoding::kGlyphID'>SkTextEncoding::kGlyphID</a>, 3758returns true if all <a href='undocumented#Glyph'>glyph</a> indices in <a href='#SkPaint_containsText_text'>text</a> are non-zero; 3759does not check to see if <a href='#SkPaint_containsText_text'>text</a> contains valid <a href='undocumented#Glyph'>glyph</a> indices for <a href='undocumented#SkTypeface'>SkTypeface</a>. 3760 3761Returns true if <a href='#SkPaint_containsText_byteLength'>byteLength</a> is zero. 3762 3763### Parameters 3764 3765<table> <tr> <td><a name='SkPaint_containsText_text'><code><strong>text</strong></code></a></td> 3766 <td>array of characters or <a href='undocumented#Glyph'>glyphs</a></td> 3767 </tr> 3768 <tr> <td><a name='SkPaint_containsText_byteLength'><code><strong>byteLength</strong></code></a></td> 3769 <td>number of bytes in <a href='#SkPaint_containsText_text'>text</a> array</td> 3770 </tr> 3771</table> 3772 3773### Return Value 3774 3775true if all <a href='#SkPaint_containsText_text'>text</a> corresponds to a non-zero <a href='undocumented#Glyph'>glyph</a> index 3776 3777<div><a href='#SkPaint_containsText'>containsText</a> succeeds for degree symbol, but cannot find a <a href='undocumented#Glyph'>glyph</a> index 3778corresponding to the Unicode surrogate code <a href='SkPoint_Reference#Point'>point</a>. 3779</div> 3780 3781#### Example Output 3782 3783~~~~ 37840x00b0 == has char 37850xd800 != has char 3786~~~~ 3787 3788### Example 3789 3790<div><fiddle-embed name="6a68cb3c8b81a5976c81ee004f559247"><div><a href='#SkPaint_containsText'>containsText</a> returns true that <a href='undocumented#Glyph'>glyph</a> index is greater than zero, not 3791that it corresponds to an entry in <a href='undocumented#Typeface'>Typeface</a>. 3792</div> 3793 3794#### Example Output 3795 3796~~~~ 37970x01ff == has glyph 37980x0000 != has glyph 37990xffff == has glyph 3800~~~~ 3801 3802</fiddle-embed></div> 3803 3804### See Also 3805 3806<a href='#SkPaint_setTextEncoding'>setTextEncoding</a> <a href='undocumented#Typeface'>Typeface</a> 3807 3808<a name='SkPaint_glyphsToUnichars'></a> 3809 3810--- 3811 3812<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3813void <a href='#SkPaint_glyphsToUnichars'>glyphsToUnichars</a>(const <a href='undocumented#SkGlyphID'>SkGlyphID</a> <a href='undocumented#Glyph'>glyphs</a>[], int count, <a href='undocumented#SkUnichar'>SkUnichar</a> <a href='undocumented#Text'>text</a>[])const 3814</pre> 3815 3816Converts <a href='#SkPaint_glyphsToUnichars_glyphs'>glyphs</a> into <a href='#SkPaint_glyphsToUnichars_text'>text</a> if possible. 3817<a href='undocumented#Glyph'>Glyph</a> values without direct Unicode equivalents are mapped to zero. 3818Uses the <a href='undocumented#SkTypeface'>SkTypeface</a>, but is unaffected 3819by <a href='undocumented#SkTextEncoding'>SkTextEncoding</a>; the <a href='#SkPaint_glyphsToUnichars_text'>text</a> values returned are equivalent to <a href='undocumented#SkTextEncoding::kUTF32'>SkTextEncoding::kUTF32</a>. 3820 3821Only supported on platforms that use FreeType as the <a href='SkFont_Reference#Font_Engine'>font engine</a>. 3822 3823### Parameters 3824 3825<table> <tr> <td><a name='SkPaint_glyphsToUnichars_glyphs'><code><strong>glyphs</strong></code></a></td> 3826 <td>array of indices into <a href='SkFont_Reference#Font'>font</a></td> 3827 </tr> 3828 <tr> <td><a name='SkPaint_glyphsToUnichars_count'><code><strong>count</strong></code></a></td> 3829 <td>length of <a href='undocumented#Glyph'>glyph</a> array</td> 3830 </tr> 3831 <tr> <td><a name='SkPaint_glyphsToUnichars_text'><code><strong>text</strong></code></a></td> 3832 <td>storage for character codes, one per <a href='undocumented#Glyph'>glyph</a></td> 3833 </tr> 3834</table> 3835 3836<div>Convert UTF-8 <a href='#SkPaint_glyphsToUnichars_text'>text</a> to <a href='#SkPaint_glyphsToUnichars_glyphs'>glyphs</a>; then convert <a href='#SkPaint_glyphsToUnichars_glyphs'>glyphs</a> to Unichar code <a href='SkPoint_Reference#Point'>points</a>. 3837</div> 3838 3839<a name='Measure_Text'></a> 3840 3841<a name='SkPaint_measureText'></a> 3842 3843--- 3844 3845<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3846<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_measureText'>measureText</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, <a href='SkRect_Reference#SkRect'>SkRect</a>* bounds)const 3847</pre> 3848 3849Returns the advance width of <a href='#SkPaint_measureText_text'>text</a>. 3850The advance is the normal distance to move before drawing additional <a href='#SkPaint_measureText_text'>text</a>. 3851Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to decode <a href='#SkPaint_measureText_text'>text</a>, <a href='undocumented#SkTypeface'>SkTypeface</a> to get the <a href='#Font_Metrics'>font metrics</a>, 3852and <a href='#Text_Size'>text size</a>, <a href='#Text_Scale_X'>text scale x</a>, <a href='#Text_Skew_X'>text skew x</a>, <a href='#Stroke_Width'>stroke width</a>, and 3853<a href='undocumented#SkPathEffect'>SkPathEffect</a> to scale the metrics and <a href='#SkPaint_measureText_bounds'>bounds</a>. 3854Returns the bounding box of <a href='#SkPaint_measureText_text'>text</a> if <a href='#SkPaint_measureText_bounds'>bounds</a> is not nullptr. 3855The bounding box is computed as if the <a href='#SkPaint_measureText_text'>text</a> was drawn at the origin. 3856 3857### Parameters 3858 3859<table> <tr> <td><a name='SkPaint_measureText_text'><code><strong>text</strong></code></a></td> 3860 <td>character codes or <a href='undocumented#Glyph'>glyph</a> indices to be measured</td> 3861 </tr> 3862 <tr> <td><a name='SkPaint_measureText_length'><code><strong>length</strong></code></a></td> 3863 <td>number of bytes of <a href='#SkPaint_measureText_text'>text</a> to measure</td> 3864 </tr> 3865 <tr> <td><a name='SkPaint_measureText_bounds'><code><strong>bounds</strong></code></a></td> 3866 <td>returns bounding box relative to (0, 0) if not nullptr</td> 3867 </tr> 3868</table> 3869 3870### Return Value 3871 3872advance width or height 3873 3874### Example 3875 3876<div><fiddle-embed name="06084f609184470135a9cd9ebc5af149"></fiddle-embed></div> 3877 3878<a name='SkPaint_measureText_2'></a> 3879 3880--- 3881 3882<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3883<a href='undocumented#SkScalar'>SkScalar</a> <a href='#SkPaint_measureText'>measureText</a>(const void* <a href='undocumented#Text'>text</a>, size_t length)const 3884</pre> 3885 3886Returns the advance width of <a href='#SkPaint_measureText_2_text'>text</a>. 3887The advance is the normal distance to move before drawing additional <a href='#SkPaint_measureText_2_text'>text</a>. 3888Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to decode <a href='#SkPaint_measureText_2_text'>text</a>, <a href='undocumented#SkTypeface'>SkTypeface</a> to get the <a href='#Font_Metrics'>font metrics</a>, 3889and <a href='#Text_Size'>text size</a> to scale the metrics. 3890Does not scale the advance or bounds by <a href='#Fake_Bold'>fake bold</a> or <a href='undocumented#SkPathEffect'>SkPathEffect</a>. 3891 3892### Parameters 3893 3894<table> <tr> <td><a name='SkPaint_measureText_2_text'><code><strong>text</strong></code></a></td> 3895 <td>character codes or <a href='undocumented#Glyph'>glyph</a> indices to be measured</td> 3896 </tr> 3897 <tr> <td><a name='SkPaint_measureText_2_length'><code><strong>length</strong></code></a></td> 3898 <td>number of bytes of <a href='#SkPaint_measureText_2_text'>text</a> to measure</td> 3899 </tr> 3900</table> 3901 3902### Return Value 3903 3904advance width or height 3905 3906### Example 3907 3908<div><fiddle-embed name="f1139a5ddd17fd47c2f45f6e642cac76"> 3909 3910#### Example Output 3911 3912~~~~ 3913default width = 5 3914double width = 10 3915~~~~ 3916 3917</fiddle-embed></div> 3918 3919<a name='SkPaint_getTextWidths'></a> 3920 3921--- 3922 3923<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3924int <a href='#SkPaint_getTextWidths'>getTextWidths</a>(const void* <a href='undocumented#Text'>text</a>, size_t byteLength, <a href='undocumented#SkScalar'>SkScalar</a> widths[], <a href='SkRect_Reference#SkRect'>SkRect</a> bounds[] = nullptr)const 3925</pre> 3926 3927Retrieves the advance and <a href='#SkPaint_getTextWidths_bounds'>bounds</a> for each <a href='undocumented#Glyph'>glyph</a> in <a href='#SkPaint_getTextWidths_text'>text</a>, and returns 3928the <a href='undocumented#Glyph'>glyph</a> count in <a href='#SkPaint_getTextWidths_text'>text</a>. 3929Both <a href='#SkPaint_getTextWidths_widths'>widths</a> and <a href='#SkPaint_getTextWidths_bounds'>bounds</a> may be nullptr. 3930If <a href='#SkPaint_getTextWidths_widths'>widths</a> is not nullptr, <a href='#SkPaint_getTextWidths_widths'>widths</a> must be an array of <a href='undocumented#Glyph'>glyph</a> count entries. 3931if <a href='#SkPaint_getTextWidths_bounds'>bounds</a> is not nullptr, <a href='#SkPaint_getTextWidths_bounds'>bounds</a> must be an array of <a href='undocumented#Glyph'>glyph</a> count entries. 3932Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to decode <a href='#SkPaint_getTextWidths_text'>text</a>, <a href='undocumented#SkTypeface'>SkTypeface</a> to get the <a href='#Font_Metrics'>font metrics</a>, 3933and <a href='#Text_Size'>text size</a> to scale the <a href='#SkPaint_getTextWidths_widths'>widths</a> and <a href='#SkPaint_getTextWidths_bounds'>bounds</a>. 3934Does not scale the advance by <a href='#Fake_Bold'>fake bold</a> or <a href='undocumented#SkPathEffect'>SkPathEffect</a>. 3935Does include <a href='#Fake_Bold'>fake bold</a> and <a href='undocumented#SkPathEffect'>SkPathEffect</a> in the <a href='#SkPaint_getTextWidths_bounds'>bounds</a>. 3936 3937### Parameters 3938 3939<table> <tr> <td><a name='SkPaint_getTextWidths_text'><code><strong>text</strong></code></a></td> 3940 <td>character codes or <a href='undocumented#Glyph'>glyph</a> indices to be measured</td> 3941 </tr> 3942 <tr> <td><a name='SkPaint_getTextWidths_byteLength'><code><strong>byteLength</strong></code></a></td> 3943 <td>number of bytes of <a href='#SkPaint_getTextWidths_text'>text</a> to measure</td> 3944 </tr> 3945 <tr> <td><a name='SkPaint_getTextWidths_widths'><code><strong>widths</strong></code></a></td> 3946 <td>returns <a href='#SkPaint_getTextWidths_text'>text</a> advances for each <a href='undocumented#Glyph'>glyph</a>; may be nullptr</td> 3947 </tr> 3948 <tr> <td><a name='SkPaint_getTextWidths_bounds'><code><strong>bounds</strong></code></a></td> 3949 <td>returns <a href='#SkPaint_getTextWidths_bounds'>bounds</a> for each <a href='undocumented#Glyph'>glyph</a> relative to (0, 0); may be nullptr</td> 3950 </tr> 3951</table> 3952 3953### Return Value 3954 3955<a href='undocumented#Glyph'>glyph</a> count in <a href='#SkPaint_getTextWidths_text'>text</a> 3956 3957### Example 3958 3959<div><fiddle-embed name="6b9e101f49e9c2c28755c5bdcef64dfb"><div>Bounds of <a href='undocumented#Glyph'>Glyphs</a> increase for stroked <a href='#SkPaint_getTextWidths_text'>text</a>, but <a href='#SkPaint_getTextWidths_text'>text</a> advance remains the same. 3960The underlines show the <a href='#SkPaint_getTextWidths_text'>text</a> advance, spaced to keep them distinct. 3961</div></fiddle-embed></div> 3962 3963<a name='Text_Path'></a> 3964 3965<a href='#Paint_Text_Path'>Text_Path</a> describes the geometry of <a href='undocumented#Glyph'>Glyphs</a> used to draw <a href='undocumented#Text'>text</a>. 3966 3967<a name='SkPaint_getTextPath'></a> 3968 3969--- 3970 3971<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 3972void <a href='#SkPaint_getTextPath'>getTextPath</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, <a href='undocumented#SkScalar'>SkScalar</a> x, <a href='undocumented#SkScalar'>SkScalar</a> y, <a href='SkPath_Reference#SkPath'>SkPath</a>* <a href='SkPath_Reference#Path'>path</a>)const 3973</pre> 3974 3975Returns the geometry as <a href='SkPath_Reference#SkPath'>SkPath</a> equivalent to the drawn <a href='#SkPaint_getTextPath_text'>text</a>. 3976Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to decode <a href='#SkPaint_getTextPath_text'>text</a>, <a href='undocumented#SkTypeface'>SkTypeface</a> to get the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a>, 3977and <a href='#Text_Size'>text size</a>, <a href='#Fake_Bold'>fake bold</a>, and <a href='undocumented#SkPathEffect'>SkPathEffect</a> to scale and modify the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a>. 3978All of the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a> are stored in <a href='#SkPaint_getTextPath_path'>path</a>. 3979Uses <a href='#SkPaint_getTextPath_x'>x</a>, <a href='#SkPaint_getTextPath_y'>y</a>, to position <a href='#SkPaint_getTextPath_path'>path</a>. 3980 3981### Parameters 3982 3983<table> <tr> <td><a name='SkPaint_getTextPath_text'><code><strong>text</strong></code></a></td> 3984 <td>character codes or <a href='undocumented#Glyph'>glyph</a> indices</td> 3985 </tr> 3986 <tr> <td><a name='SkPaint_getTextPath_length'><code><strong>length</strong></code></a></td> 3987 <td>number of bytes of <a href='#SkPaint_getTextPath_text'>text</a></td> 3988 </tr> 3989 <tr> <td><a name='SkPaint_getTextPath_x'><code><strong>x</strong></code></a></td> 3990 <td>x-axis value of the origin of the <a href='#SkPaint_getTextPath_text'>text</a></td> 3991 </tr> 3992 <tr> <td><a name='SkPaint_getTextPath_y'><code><strong>y</strong></code></a></td> 3993 <td>y-axis value of the origin of the <a href='#SkPaint_getTextPath_text'>text</a></td> 3994 </tr> 3995 <tr> <td><a name='SkPaint_getTextPath_path'><code><strong>path</strong></code></a></td> 3996 <td>geometry of the <a href='undocumented#Glyph'>glyphs</a></td> 3997 </tr> 3998</table> 3999 4000### Example 4001 4002<div><fiddle-embed name="7c9e6a399f898d68026c1f0865e6f73e"><div><a href='undocumented#Text'>Text</a> is added to <a href='SkPath_Reference#Path'>Path</a>, offset, and subtracted from <a href='SkPath_Reference#Path'>Path</a>, then added at 4003the offset location. The result is rendered with one draw call. 4004</div></fiddle-embed></div> 4005 4006<a name='SkPaint_getPosTextPath'></a> 4007 4008--- 4009 4010<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 4011void <a href='#SkPaint_getPosTextPath'>getPosTextPath</a>(const void* <a href='undocumented#Text'>text</a>, size_t length, const <a href='SkPoint_Reference#SkPoint'>SkPoint</a> pos[], <a href='SkPath_Reference#SkPath'>SkPath</a>* <a href='SkPath_Reference#Path'>path</a>)const 4012</pre> 4013 4014Returns the geometry as <a href='SkPath_Reference#SkPath'>SkPath</a> equivalent to the drawn <a href='#SkPaint_getPosTextPath_text'>text</a>. 4015Uses <a href='undocumented#SkTextEncoding'>SkTextEncoding</a> to decode <a href='#SkPaint_getPosTextPath_text'>text</a>, <a href='undocumented#SkTypeface'>SkTypeface</a> to get the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a>, 4016and <a href='#Text_Size'>text size</a>, <a href='#Fake_Bold'>fake bold</a>, and <a href='undocumented#SkPathEffect'>SkPathEffect</a> to scale and modify the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a>. 4017All of the <a href='undocumented#Glyph'>glyph</a> <a href='SkPath_Reference#Path'>paths</a> are stored in <a href='#SkPaint_getPosTextPath_path'>path</a>. 4018Uses <a href='#SkPaint_getPosTextPath_pos'>pos</a> array to position <a href='#SkPaint_getPosTextPath_path'>path</a>. 4019<a href='#SkPaint_getPosTextPath_pos'>pos</a> contains a position for each <a href='undocumented#Glyph'>glyph</a>. 4020 4021### Parameters 4022 4023<table> <tr> <td><a name='SkPaint_getPosTextPath_text'><code><strong>text</strong></code></a></td> 4024 <td>character codes or <a href='undocumented#Glyph'>glyph</a> indices</td> 4025 </tr> 4026 <tr> <td><a name='SkPaint_getPosTextPath_length'><code><strong>length</strong></code></a></td> 4027 <td>number of bytes of <a href='#SkPaint_getPosTextPath_text'>text</a></td> 4028 </tr> 4029 <tr> <td><a name='SkPaint_getPosTextPath_pos'><code><strong>pos</strong></code></a></td> 4030 <td>positions of each <a href='undocumented#Glyph'>glyph</a></td> 4031 </tr> 4032 <tr> <td><a name='SkPaint_getPosTextPath_path'><code><strong>path</strong></code></a></td> 4033 <td>geometry of the <a href='undocumented#Glyph'>glyphs</a></td> 4034 </tr> 4035</table> 4036 4037### Example 4038 4039<div><fiddle-embed name="7f27c93472aa99a7542fb3493076f072"><div>Simplifies three <a href='undocumented#Glyph'>Glyphs</a> to eliminate overlaps, and strokes the result. 4040</div></fiddle-embed></div> 4041 4042<a name='SkPaint_nothingToDraw'></a> 4043 4044--- 4045 4046<pre style="padding: 1em 1em 1em 1em; width: 62.5em;background-color: #f0f0f0"> 4047bool <a href='#SkPaint_nothingToDraw'>nothingToDraw</a>()const 4048</pre> 4049 4050Returns true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a> prevents all drawing; 4051otherwise, the <a href='SkPaint_Reference#SkPaint'>SkPaint</a> may or may not allow drawing. 4052 4053Returns true if, for example, <a href='SkBlendMode_Reference#SkBlendMode'>SkBlendMode</a> combined with <a href='SkColor_Reference#Alpha'>alpha</a> computes a 4054new <a href='SkColor_Reference#Alpha'>alpha</a> of zero. 4055 4056### Return Value 4057 4058true if <a href='SkPaint_Reference#SkPaint'>SkPaint</a> prevents all drawing 4059 4060### Example 4061 4062<div><fiddle-embed name="2973b05bfbb6b4c29332c8ac4fcf3995"> 4063 4064#### Example Output 4065 4066~~~~ 4067initial nothing to draw: false 4068blend dst nothing to draw: true 4069blend src over nothing to draw: false 4070alpha 0 nothing to draw: true 4071~~~~ 4072 4073</fiddle-embed></div> 4074 4075<a name='Utility'></a> 4076 4077