HenCoder Android 开发进阶：自定义 View 1-3 文字的绘制

这期是 HenCoder 自定义绘制的第三期：文字的绘制。

以前的内容在这里：
HenCoder Android 开发进阶 自定义 View 1-1 绘制基础
HenCoder Android 开发进阶 自定义 View 1-2 Paint 详解

若是你没据说过 HenCoder，能够先看看这个：
HenCoder：给高级 Android 工程师的进阶手册

简介

上期的 Paint 详解里已经说过，文字的绘制所能控制的内容太多太细，必须拆成单独的一期专门来说。今天这期，就是来把这些细节讲清楚的。

须要说明的有两点：

1. 和上期同样，这期讲的是细节，其中有一部份内容并非很经常使用，因此这期你没必要要求本身把内容所有背会，而只要作到所有理解，知道都有什么东西，大概怎么用就好，到你真正须要用的时候再拐回来看就是；
2. 除了经常使用和不经常使用的内容，本期还会讲到一些比较偏门的细节。这些偏门几乎永远不会用到，我讲这些偏门的目的也只是为了作到知识的全覆盖，帮你破开迷雾解开谜团，把那些「始终没有搞懂，也不知道有没有用」的 API 解释出来。有的时候，同样东西你肯定了它确实没用，也就够了。因此若是遇到这些偏门的内容，你感兴趣，看看就好；不感兴趣，不看也罢——总之，不要把太多精力放在它们身上。

下面进入正题。

1 Canvas 绘制文字的方式

Canvas 的文字绘制方法有三个：drawText() drawTextRun() 和 drawTextOnPath()。

1.1 drawText(String text, float x, float y, Paint paint)

drawText() 是 Canvas 最基本的绘制文字的方法：给出文字的内容和位置， Canvas 按要求去绘制文字。

String text = "Hello HenCoder";

...

canvas.drawText(text, 200, 100, paint);复制代码

方法的参数很简单： text 是文字内容，x 和 y 是文字的坐标。但须要注意：这个坐标并非文字的左上角，而是一个与左下角比较接近的位置。大概在这里：

而若是你像绘制其余内容同样，在绘制文字的时候把坐标填成 (0, 0)，文字并不会显示在 View 的左上角，而是会几乎彻底显示在 View 的上方，到了 View 外部看不到的位置：

canvas.drawText(text, 0, 0, paint);复制代码

↑ 这里没有贴错图哦

再附上一张图，应该能更清楚地表达：

这是为何？为何其它的 Canvas.drawXXX() 方法，都是以左上角做为基准点的，而 drawText() 倒是文字左下方？

先别以为日了狗，这种设计实际上是有道理的。drawText() 参数中的 y ，指的是文字的基线（ baseline ） 的位置。也就是这条线：

众所周知，不一样的语言和文字，每一个字符的高度和上下位置都是不同的。要让不一样的文字并排显示的时候总体看起来妥当，须要让它们上下对齐。但这个对齐的方式，不能是简单的「底部对齐」或「顶部对齐」或「中间对齐」，而应该是一种相似于「重心对齐」的方式。就像电线上的小鸟同样：

每只小鸟的最高点和最低点都不同，但画面很平衡

而这个用来让全部文字互相对齐的基准线，就是基线( baseline )。 drawText() 方法参数中的 y 值，就是指定的基线的位置。

说完 y 值，再说说 x 值。从前面图中的标记能够看出来，「Hello HenCoder」绘制出来以后的 x 点并非字母 "H" 左边的位置，而是比它的左边再往左一点点。那么这个「往左的一点点」是什么呢？

它是字母 "H" 的左边的空隙。绝大多数的字符，它们的宽度都是要略微大于实际显示的宽度的。字符的左右两边会留出一部分空隙，用于文字之间的间隔，以及文字和边框的间隔。就像这样：

用竖线标记出边界后的文字。

因此，明白为何 x 坐标在 "H" 的左边再往左一点点的位置，而不是紧贴着 "H" 的左边线了吗？就是由于 "H" 的这个留出的空隙。

除了 drawText(text, x, y, paint) 以外， drawText() 还有几个重载方法，使用方式跟这个都差很少，我就不说了，你本身看吧。

1.2 drawTextRun()

声明：这个方法对中国人没用。因此若是你有兴趣，能够继续看；而若是你想省时间，直接跳过这个方法看后面的就行了，没有任何毒反作用。

drawTextRun() 是在 API 23 新加入的方法。它和 drawText() 同样都是绘制文字，但加入了两项额外的设置——上下文和文字方向——用于辅助一些文字结构比较特殊的语言的绘制。

• 额外设置一：上下文。

  有些语言的文字，字符的形状会互相之间影响：一个字你单独写是一个样，和别的字放在一块儿写又是另一个样。不过因为咱们最熟悉的语言——汉语和英语——都没有这种状况，因此只靠说可能不太好理解，我就用图说明一下吧。

  以阿拉伯文为例。阿拉伯文里的「عربى（阿拉伯）」是一个四字词，它的中间两个字符「رب」在这个词里的样子，和单独写的时候的样子是不一样的。也就是说，当这四个字写在一块儿的时候，中间两个字因为受到两边的字的影响，形状被改变了。看图吧：

  上面第二行和第三行的文字是彻底同样的俩字，你敢信？

  哇塞，是否是特别神奇？

  不过咱们就不用管它为何这么神奇了，也不用替阿拉伯人操心这么复杂的文字他们使用起来会不会很痛苦，人家都已经用了几百上千年了。我还说回到 drawTextRun()。 drawTextRun() 除了文字的内容和位置以外，还能够设置文字的上下文（也就是要绘制的文字的左边和右边是什么文字，虽然这些文字并不会被绘制出来），从而让一样的文字能够按需表现出不一样的显示效果。

• 额外设置二：文字方向。

  除了上下文， drawTextRun() 还能够设置文字的方向，即文字是从左到右仍是从右到左排列的。

介绍完这两类额外设置，来看一下具体的方法吧：

drawTextRun(CharSequence text, int start, int end, int contextStart, int contextEnd, float x, float y, boolean isRtl, Paint paint)

参数：
text：要绘制的文字
start：从那个字开始绘制
end：绘制到哪一个字结束
contextStart：上下文的起始位置。contextStart 须要小于等于 start
contextEnd：上下文的结束位置。contextEnd 须要大于等于 end
x：文字左边的坐标
y：文字的基线坐标
isRtl：是不是 RTL（Right-To-Left，从右向左）

要实现上面图中的「一样的字有不一样的显示」效果，调节 contextStart 和 contextEnd 就能够了，至于具体的实现，你有兴趣的话就本身试试吧。

这就是 drawTextRun() ，一个增长了「上下文」和「RTL」支持的加强版本的 drawText() 。不过就像刚才说过的，这个方法对中国人其实没什么用……

1.3 drawTextOnPath()

沿着一条 Path 来绘制文字。这是一个耍杂技的方法。

canvas.drawPath(path, paint); // 把 Path 也绘制出来，理解起来更方便
canvas.drawTextOnPath("Hello HeCoder", path, 0, 0, paint);复制代码

吁，拐角处的文字怎么那么难看？

因此记住一条原则： drawTextOnPath() 使用的 Path ，拐弯处全用圆角，别用尖角。

具体的方法很简单：

drawTextOnPath(String text, Path path, float hOffset, float vOffset, Paint paint)

参数里，须要解释的只有两个： hOffset 和 vOffset。它们是文字相对于 Path 的水平偏移量和竖直偏移量，利用它们能够调整文字的位置。例如你设置 hOffset 为 5， vOffset 为 10，文字就会右移 5 像素和下移 10 像素。

1.4 StaticLayout

额外讲一个 StaticLayout。这个也是使用 Canvas 来进行文字的绘制，不过并非使用 Canvas 的方法。

Canvas.drawText() 只能绘制单行的文字，而不能换行。它：

• 不能在 View 的边缘自动折行

  String text = "Lorem Ipsum is simply dummy text of the printing and typesetting industry.";
  
  ...
  
  canvas.drawText(text, 50, 100, paint);复制代码

  到了 View 的边缘处，文字继续向后绘制到看不见的地方，而不是自动换行

• 不能在换行符 \n 处换行

  String text = "a\nbc\ndefghi\njklm\nnopqrst\nuvwx\nyz";
  
  ...
  
  canvas.drawText(text, 50, 100, paint);复制代码

  在换行符 \n 的位置并无换行，而只是加了个空格

若是须要绘制多行的文字，你必须自行把文字切断后分屡次使用 drawText() 来绘制，或者——使用 StaticLayout 。

StaticLayout 并非一个 View 或者 ViewGroup ，而是 android.text.Layout 的子类，它是纯粹用来绘制文字的。 StaticLayout 支持换行，它既能够为文字设置宽度上限来让文字自动换行，也会在 \n 处主动换行。

String text1 = "Lorem Ipsum is simply dummy text of the printing and typesetting industry.";
StaticLayout staticLayout1 = new StaticLayout(text1, paint, 600,
        Layout.Alignment.ALIGN_NORMAL, 1, 0, true);
String text2 = "a\nbc\ndefghi\njklm\nnopqrst\nuvwx\nyz";
StaticLayout staticLayout2 = new StaticLayout(text2, paint, 600,
        Layout.Alignment.ALIGN_NORMAL, 1, 0, true);

...

canvas.save();
canvas.translate(50, 100);
staticLayout1.draw(canvas);
canvas.translate(0, 200);
staticLayout2.draw(canvas);
canvas.restore();复制代码

上面代码中出现的 Canvas.save() Canvas.translate() Canvas.restore() 配合起来能够对绘制的内容进行移动。它们的具体用法我会在下期讲，这期你就先依葫芦画瓢照搬着用吧。

StaticLayout 的构造方法是 StaticLayout(CharSequence source, TextPaint paint, int width, Layout.Alignment align, float spacingmult, float spacingadd, boolean includepad)，其中参数里：

width 是文字区域的宽度，文字到达这个宽度后就会自动换行；
align 是文字的对齐方向；
spacingmult 是行间距的倍数，一般状况下填 1 就好；
spacingadd 是行间距的额外增长值，一般状况下填 0 就好；
includeadd 是指是否在文字上下添加额外的空间，来避免某些太高的字符的绘制出现越界。

若是你须要进行多行文字的绘制，而且对文字的排列和样式没有太复杂的花式要求，那么使用 StaticLayout 就好。

2 Paint 对文字绘制的辅助

Paint 对文字绘制的辅助，有两类方法：设置显示效果的和测量文字尺寸的。

2.1 设置显示效果类

2.1.1 setTextSize(float textSize)

设置文字大小。

paint.setTextSize(18);
canvas.drawText(text, 100, 25, paint);
paint.setTextSize(36);
canvas.drawText(text, 100, 70, paint);
paint.setTextSize(60);
canvas.drawText(text, 100, 145, paint);
paint.setTextSize(84);
canvas.drawText(text, 100, 240, paint);复制代码

很简单，再也不详细解释。

2.1.2 setTypeface(Typeface typeface)

设置字体。

paint.setTypeface(Typeface.DEFAULT);
canvas.drawText(text, 100, 150, paint);
paint.setTypeface(Typeface.SERIF);
canvas.drawText(text, 100, 300, paint);
paint.setTypeface(Typeface.createFromAsset(getContext().getAssets(), "Satisfy-Regular.ttf"));
canvas.drawText(text, 100, 450, paint);复制代码

设置不一样的 Typeface 就能够显示不一样的字体。咱们中国人谈到「字体」，比较熟悉的词是 font， typeface 和 font 是一个意思，都表示字体。 Typeface 这个类的具体用法，须要了解的话能够直接看文档，很简单。

严格地说，其实 typeface 和 font 意思不彻底同样。typeface 指的是某套字体（即 font family ），而 font 指的是一个 typeface 具体的某个 weight 和 size 的分支。不过无所谓啦~作人最紧要系开心啦。

2.1.3 setFakeBoldText(boolean fakeBoldText)

是否使用伪粗体。

paint.setFakeBoldText(false);
canvas.drawText(text, 100, 150, paint);
paint.setFakeBoldText(true);
canvas.drawText(text, 100, 230, paint);复制代码

之因此叫伪粗体（ fake bold ），由于它并非经过选用更高 weight 的字体让文字变粗，而是经过程序在运行时把文字给「描粗」了。

2.1.4 setStrikeThruText(boolean strikeThruText)

是否加删除线。

paint.setStrikeThruText(true);
canvas.drawText(text, 100, 150, paint);复制代码

2.1.5 setUnderlineText(boolean underlineText)

是否加下划线。

paint.setUnderlineText(true);
canvas.drawText(text, 100, 150, paint);复制代码

2.1.6 setTextSkewX(float skewX)

设置文字横向错切角度。其实就是文字倾斜度的啦。

paint.setTextSkewX(-0.5f);
canvas.drawText(text, 100, 150, paint);复制代码

2.1.7 setTextScaleX(float scaleX)

设置文字横向放缩。也就是文字变胖变瘦。

paint.setTextScaleX(1);
canvas.drawText(text, 100, 150, paint);
paint.setTextScaleX(0.8f);
canvas.drawText(text, 100, 230, paint);
paint.setTextScaleX(1.2f);
canvas.drawText(text, 100, 310, paint);复制代码

2.1.8 setLetterSpacing(float letterSpacing)

设置字符间距。默认值是 0。

paint.setLetterSpacing(0.2f);
canvas.drawText(text, 100, 150, paint);复制代码

为何在默认的字符间距为 0 的状况下，字符和字符之间也没有牢牢贴着，这个我在前面讲 Canvas.drawText() 的 x 参数的时候已经说过了，在这里应该没有疑问吧？

2.1.9 setFontFeatureSettings(String settings)

用 CSS 的 font-feature-settings 的方式来设置文字。

paint.setFontFeatureSettings("smcp"); // 设置 "small caps"
canvas.drawText("Hello HenCoder", 100, 150, paint);复制代码

CSS 全称是 Cascading Style Sheets ，是网页开发用来设置页面各类元素的样式的。咦，网页开发的设置怎么会出如今 Android 的 API 里？

大多数 Android 开发者都不了解这个 CSS 的 font-feature-settings 属性，不过不要紧，这个属性设置的都是文字的一些次要特性，因此不用着急了解这个方法。固然有兴趣的话也能够看一看哈，文档在这里。

2.1.10 setTextAlign(Paint.Align align)

设置文字的对齐方式。一共有三个值：LEFT CETNER 和 RIGHT。默认值为 LEFT。

paint.setTextAlign(Paint.Align.LEFT);
canvas.drawText(text, 500, 150, paint);
paint.setTextAlign(Paint.Align.CENTER);
canvas.drawText(text, 500, 150 + textHeight, paint);
paint.setTextAlign(Paint.Align.RIGHT);
canvas.drawText(text, 500, 150 + textHeight * 2, paint);复制代码

2.1.11 setTextLocale(Locale locale) / setTextLocales(LocaleList locales)

设置绘制所使用的 Locale。

Locale 直译是「地域」，其实就是你在系统里设置的「语言」或「语言区域」（具体名称取决于你用的是什么手机），好比「简体中文（中国）」「English (US)」「English (UK)」。有些同源的语言，在文化发展过程当中对一些相同的字衍生出了不一样的写法（好比中国大陆和日本对于某些汉字的写法就有细微差异。注意，不是繁体和简体这种同音同义不一样字，而真的是一样的一个字有两种写法）。系统语言不一样，一样的一个字的显示就有可能不一样。你能够试一下把本身手机的语言改为日文，而后打开微信看看聊天记录，你会明显发现文字的显示发生了不少细微的变化，这就是因为系统的 Locale 改变所致使的。

Canvas 绘制的时候，默认使用的是系统设置里的 Locale。而经过 Paint.setTextLocale(Locale locale) 就能够在不改变系统设置的状况下，直接修改绘制时的 Locale。

paint.setTextLocale(Locale.CHINA); // 简体中文
canvas.drawText(text, 150, 150, paint);
paint.setTextLocale(Locale.TAIWAN); // 繁体中文
canvas.drawText(text, 150, 150 + textHeight, paint);
paint.setTextLocale(Locale.JAPAN); // 日语
canvas.drawText(text, 150, 150 + textHeight * 2, paint);复制代码

有意思吧？

另外，因为 Android 7.0 ( API v24) 加入了多语言区域的支持，因此在 API v24 以及更高版本上，还可使用 setTextLocales(LocaleList locales) 来为绘制设置多个语言区域。

2.1.12 setHinting(int mode)

设置是否启用字体的 hinting （字体微调）。

如今的 Android 设备大多数都是是用的矢量字体。矢量字体的原理是对每一个字体给出一个字形的矢量描述，而后使用这一个矢量来对全部的尺寸的字体来生成对应的字形。因为没必要为全部字号都设计它们的字体形状，因此在字号较大的时候，矢量字体也可以保持字体的圆润，这是矢量字体的优点。不过当文字的尺寸太小（好比高度小于 16 像素），有些文字会因为失去过多细节而变得不太好看。 hinting 技术就是为了解决这种问题的：经过向字体中加入 hinting 信息，让矢量字体在尺寸太小的时候获得针对性的修正，从而提升显示效果。效果图盗一张维基百科的：

功能很强，效果很赞。不过在如今（ 2017 年），手机屏幕的像素密度已经很是高，几乎不会再出现字体尺寸小到须要靠 hinting 来修正的状况，因此这个方法其实……没啥用了。能够忽略。

2.1.13 setElegantTextHeight(boolean elegant)

声明：这个方法对中国人没用，不想看的话能够直接跳过，无毒反作用。

设置是否开启文字的 elegant height 。开启以后，文字的高度就变优雅了（误）。下面解释一下所谓的 elegant height：

在有些语言中，可能会出现一些很是高的字形：

左边那几个泰文文字，挺高的吧？但其实它们已是被压缩过了的，它们原本比这还要高。

这些比较高的文字，一般都有两个版本的字体：一个原始版本，一个压缩了高度的版本。压缩版本能够保证让这些「大高个」文字在和普通文字（例如拉丁文字）放在一块儿的时候看起来不会显得太奇怪。事实上，Paint 绘制文字时是用的默认版本就是压缩版本，就像上图这样。

不过有的时候，开发者会须要使用它们的原始（优雅）版本。使用 setElegantTextHeight() 就能够切换到原始版本：

paint.setElegantTextHeight(true);复制代码

这字得有多高？2 米 26 ？

那么，setElegantTextHeight() 的做用到这里就很清晰了：

1. 把「大高个」文字的高度恢复为原始高度；
2. 增大每行文字的上下边界，来容纳被加高了的文字。

其实这个问题我已经在 stackoverflow 回答过一次，原回答在这里。

不过就像前面说的，因为中国人经常使用的汉语和英语的文字并不会达到这种高度，因此这个方法对于中国人基本上是没用的。

2.1.14 setSubpixelText(boolean subpixelText)

是否开启次像素级的抗锯齿（ sub-pixel anti-aliasing ）。

次像素级抗锯齿这个功能解释起来很麻烦，简单说就是根据程序所运行的设备的屏幕类型，来进行针对性的次像素级的抗锯齿计算，从而达到更好的抗锯齿效果。更详细的解释能够看这篇文章。

不过，和前面讲的字体 hinting 同样，因为如今手机屏幕像素密度已经很高，因此默认抗锯齿效果就已经足够好了，通常不必开启次像素级抗锯齿，因此这个方法基本上没有必要使用。

2.1.15 setLinearText(boolean linearText)

这个方法老实说我从没用过，也始终没有搞懂它是什么意思，就不强行装逼了。把文档中的解释照搬过来，各位本身研究吧。

Helper for setFlags(), setting or clearing the LINEAR_TEXT_FLAG bit

上面这句中提到的 LINEAR_TEXT_FLAG:

Paint flag that enables smooth linear scaling of text.

Enabling this flag does not actually scale text, but rather adjusts text draw operations to deal gracefully with smooth adjustment of scale. When this flag is enabled, font hinting is disabled to prevent shape deformation between scale factors, and glyph caching is disabled due to the large number of glyph images that will be generated.

SUBPIXEL_TEXT_FLAG should be used in conjunction with this flag to prevent glyph positions from snapping to whole pixel values as scale factor is adjusted.

以上就是 Paint 的对文字的显示效果设置类方法。下面介绍它的第二类方法：测量文字尺寸类。

2.2 测量文字尺寸类

不管是文字，仍是图形或 Bitmap，只有知道了尺寸，才能更好地肯定应该摆放的位置。因为文字的绘制和图形或 Bitmap 的绘制比起来，尺寸的计算复杂得多，因此它有一整套的方法来计算文字尺寸。

2.2.1 float getFontSpacing()

获取推荐的行距。

即推荐的两行文字的 baseline 的距离。这个值是系统根据文字的字体和字号自动计算的。它的做用是当你要手动绘制多行文字（而不是使用 StaticLayout）的时候，能够在换行的时候给 y 坐标加上这个值来下移文字。

canvas.drawText(texts[0], 100, 150, paint);
canvas.drawText(texts[1], 100, 150 + paint.getFontSpacing, paint);
canvas.drawText(texts[2], 100, 150 + paint.getFontSpacing * 2, paint);复制代码

2.2.2 FontMetircs getFontMetrics()

获取 Paint 的 FontMetrics。

FontMetrics 是个相对专业的工具类，它提供了几个文字排印方面的数值：ascent, descent, top, bottom, leading。

如图，图中有两行文字，每一行都有 5 条线：top, ascent, baseline, descent, bottom。（leading 并无画出来，由于画不出来，下面会给出解释）

• baseline: 上图中黑色的线。前面已经讲过了，它的做用是做为文字显示的基准线。

• ascent / descent: 上图中绿色和橙色的线，它们的做用是限制普通字符的顶部和底部范围。
  普通的字符，上不会高过 ascent ，下不会低过 descent ，例如上图中大部分的字形都显示在 ascent 和 descent 两条线的范围内。具体到 Android 的绘制中， ascent 的值是图中绿线和 baseline 的相对位移，它的值为负（由于它在 baseline 的上方）； descent 的值是图中橙线和 baseline 相对位移，值为正（由于它在 baseline 的下方）。

• top / bottom: 上图中蓝色和红色的线，它们的做用是限制全部字形（ glyph ）的顶部和底部范围。
  除了普通字符，有些字形的显示范围是会超过 ascent 和 descent 的，而 top 和 bottom 则限制的是全部字形的显示范围，包括这些特殊字形。例如上图的第二行文字里，就有两个泰文的字形分别超过了 ascent 和 descent 的限制，但它们都在 top 和 bottom 两条线的范围内。具体到 Android 的绘制中， top 的值是图中蓝线和 baseline 的相对位移，它的值为负（由于它在 baseline 的上方）； bottom 的值是图中红线和 baseline 相对位移，值为正（由于它在 baseline 的下方）。

• leading: 这个词在上图中没有标记出来，由于它并非指的某条线和 baseline 的相对位移。 leading 指的是行的额外间距，即对于上下相邻的两行，上行的 bottom 线和下行的 top 线的距离，也就是上图中第一行的红线和第二行的蓝线的距离（对，就是那个小细缝）。

leading 这个词的本意其实并非行的额外间距，而是行距，即两个相邻行的 baseline 之间的距离。不过对于不少非专业领域，leading 的意思被改变了，被你们当作行的额外间距来用；而 Android 里的 leading ，一样也是行的额外间距的意思。

另外，leading 在这里应该读做 "ledding" 而不是 "leeding" 哦。缘由就不说了，我这越扯越远没边了。

FontMetrics 提供的就是 Paint 根据当前字体和字号，得出的这些值的推荐值。它把这些值以变量的形式存储，供开发者须要时使用。

• FontMetrics.ascent：float 类型。
• FontMetrics.descent：float 类型。
• FontMetrics.top：float 类型。
• FontMetrics.bottom：float 类型。
• FontMetrics.leading：float 类型。

另外，ascent 和 descent 这两个值还能够经过 Paint.ascent() 和 Paint.descent() 来快捷获取。

FontMetrics 和 getFontSpacing()：

从定义能够看出，上图中两行文字的 font spacing (即相邻两行的 baseline 的距离) 能够经过 bottom - top + leading (top 的值为负，前面刚说过，记得吧？）来计算得出。

但你真的运行一下会发现， bottom - top + leading 的结果是要大于 getFontSpacing() 的返回值的。

两个方法计算得出的 font spacing 居然不同？

这并非 bug，而是由于 getFontSpacing() 的结果并非经过 FontMetrics 的标准值计算出来的，而是另外计算出来的一个值，它可以作到在两行文字不显得拥挤的前提下缩短行距，以此来获得更好的显示效果。因此若是你要对文字手动换行绘制，多数时候应该选取 getFontSpacing() 来获得行距，不但使用更简单，显示效果也会更好。

getFontMetrics() 的返回值是 FontMetrics 类型。它还有一个重载方法 getFontMetrics(FontMetrics fontMetrics) ，计算结果会直接填进传入的 FontMetrics 对象，而不是从新建立一个对象。这种用法在须要频繁获取 FontMetrics 的时候性能会好些。

另外，这两个方法还有一对一样结构的对应的方法 getFontMetricsInt() 和 getFontMetricsInt(FontMetricsInt fontMetrics) ，用于获取 FontMetricsInt 类型的结果。

2.2.3 getTextBounds(String text, int start, int end, Rect bounds)

获取文字的显示范围。

参数里，text 是要测量的文字，start 和 end 分别是文字的起始和结束位置，bounds 是存储文字显示范围的对象，方法在测算完成以后会把结果写进 bounds。

paint.setStyle(Paint.Style.FILL);
canvas.drawText(text, offsetX, offsetY, paint);

paint.getTextBounds(text, 0, text.length(), bounds);
bounds.left += offsetX;
bounds.top += offsetY;
bounds.right += offsetX;
bounds.bottom += offsetY;
paint.setStyle(Paint.Style.STROKE);
canvas.drawRect(bounds, paint);复制代码

它有一个重载方法 getTextBounds(char[] text, int index, int count, Rect bounds)，用法很是类似，再也不介绍。

2.2.4 float measureText(String text)

测量文字的宽度并返回。

canvas.drawText(text, offsetX, offsetY, paint);
float textWidth = paint.measureText(text);
canvas.drawLine(offsetX, offsetY, offsetX + textWidth, offsetY, paint);复制代码

咦，前面有了 getTextBounds()，这里怎么又有一个 measureText()？

若是你用代码分别使用 getTextBounds() 和 measureText() 来测量文字的宽度，你会发现 measureText() 测出来的宽度老是比 getTextBounds() 大一点点。这是由于这两个方法其实测量的是两个不同的东西。

• getTextBounds: 它测量的是文字的显示范围（关键词：显示）。形象点来讲，你这段文字外放置一个可变的矩形，而后把矩形尽量地缩小，一直小到这个矩形刚好牢牢包裹住文字，那么这个矩形的范围，就是这段文字的 bounds。

• measureText(): 它测量的是文字绘制时所占用的宽度（关键词：占用）。前面已经讲过，一个文字在界面中，每每须要占用比他的实际显示宽度更多一点的宽度，以此来让文字和文字之间保留一些间距，不会显得过于拥挤。上面的这幅图，我并无设置 setLetterSpacing() ，这里的 letter spacing 是默认值 0，但你能够看到，图中每两个字母之间都是有空隙的。另外，下方那条用于表示文字宽度的横线，在左边超出了第一个字母 H 一段距离的，在右边也超出了最后一个字母 r（虽然右边这里用肉眼不太容易分辨），而就是两边的这两个「超出」，致使了 measureText() 比 getTextBounds() 测量出的宽度要大一些。

在实际的开发中，测量宽度要用 measureText() 仍是 getTextBounds() ，须要根据状况而定。不过你只要掌握了上面我所说的它们的本质，在选择的时候就不会为难和疑惑了。

measureText(String text) 也有几个重载方法，用法和它大同小异，再也不介绍。

2.2.5 getTextWidths(String text, float[] widths)

获取字符串中每一个字符的宽度，并把结果填入参数 widths。

这至关于 measureText() 的一个快捷方法，它的计算等价于对字符串中的每一个字符分别调用 measureText() ，并把它们的计算结果分别填入 widths 的不一样元素。

getTextWidths() 一样也有好几个变种，使用大同小异，再也不介绍。

2.2.6 int breakText(String text, boolean measureForwards, float maxWidth, float[] measuredWidth)

这个方法也是用来测量文字宽度的。但和 measureText() 的区别是， breakText() 是在给出宽度上限的前提下测量文字的宽度。若是文字的宽度超出了上限，那么在临近超限的位置截断文字。

int measuredCount;
float[] measuredWidth = {0};

// 宽度上限 300 （不够用，截断）
measuredCount = paint.breakText(text, 0, text.length(), true, 300, measuredWidth);
canvas.drawText(text, 0, measuredCount, 150, 150, paint);

// 宽度上限 400 （不够用，截断）
measuredCount = paint.breakText(text, 0, text.length(), true, 400, measuredWidth);
canvas.drawText(text, 0, measuredCount, 150, 150 + fontSpacing, paint);

// 宽度上限 500 （够用）
measuredCount = paint.breakText(text, 0, text.length(), true, 500, measuredWidth);
canvas.drawText(text, 0, measuredCount, 150, 150 + fontSpacing * 2, paint);

// 宽度上限 600 （够用）
measuredCount = paint.breakText(text, 0, text.length(), true, 600, measuredWidth);
canvas.drawText(text, 0, measuredCount, 150, 150 + fontSpacing * 3, paint);复制代码

breakText() 的返回值是截取的文字个数（若是宽度没有超限，则是文字的总个数）。参数中， text 是要测量的文字；measureForwards 表示文字的测量方向，true 表示由左往右测量；maxWidth 是给出的宽度上限；measuredWidth 是用于接受数据，而不是用于提供数据的：方法测量完成后会把截取的文字宽度（若是宽度没有超限，则为文字总宽度）赋值给 measuredWidth[0]。

这个方法能够用于多行文字的折行计算。

breakText() 也有几个重载方法，使用大同小异，再也不介绍。

2.2.7 光标相关

对于 EditText 以及相似的场景，会须要绘制光标。光标的计算很麻烦，不过 API 23 引入了两个新的方法，有了这两个方法后，计算光标就方便了不少。

2.2.7.1 getRunAdvance(CharSequence text, int start, int end, int contextStart, int contextEnd, boolean isRtl, int offset)

对于一段文字，计算出某个字符处光标的 x 坐标。 start end 是文字的起始和结束坐标；contextStart contextEnd 是上下文的起始和结束坐标；isRtl 是文字的方向；offset 是字数的偏移，即计算第几个字符处的光标。

int length = text.length();
float advance = paint.getRunAdvance(text, 0, length, 0, length, false, length);
canvas.drawText(text, offsetX, offsetY, paint);
canvas.drawLine(offsetX + advance, offsetY - 50, offsetX + advance, offsetY + 10, paint);复制代码

其实，说是测量光标位置的，本质上这也是一个测量文字宽度的方法。上面这个例子中，start 和 contextStart 都是 0， end contextEnd 和 offset 都等于 text.length()。在这种状况下，它是等价于 measureText(text) 的，即完整测量一段文字的宽度。而对于更复杂的需求，getRunAdvance() 能作的事就比 measureText() 多了。

// 包含特殊符号的绘制（如 emoji 表情）
String text = "Hello HenCoder \uD83C\uDDE8\uD83C\uDDF3" // "Hello HenCoder 🇨🇳"

...

float advance1 = paint.getRunAdvance(text, 0, length, 0, length, false, length);
float advance2 = paint.getRunAdvance(text, 0, length, 0, length, false, length - 1);
float advance3 = paint.getRunAdvance(text, 0, length, 0, length, false, length - 2);
float advance4 = paint.getRunAdvance(text, 0, length, 0, length, false, length - 3);
float advance5 = paint.getRunAdvance(text, 0, length, 0, length, false, length - 4);
float advance6 = paint.getRunAdvance(text, 0, length, 0, length, false, length - 5);

...复制代码

如上图，🇨🇳 虽然占了 4 个字符（\uD83C\uDDE8\uD83C\uDDF3），但当 offset 是表情中间处时， getRunAdvance() 得出的结果并不会在表情的中间处。为何？由于这是用来计算光标的方法啊，光标固然不能出如今符号中间啦。

2.2.7.2 getOffsetForAdvance(CharSequence text, int start, int end, int contextStart, int contextEnd, boolean isRtl, float advance)

给出一个位置的像素值，计算出文字中最接近这个位置的字符偏移量（即第几个字符最接近这个坐标）。

方法的参数很简单： text 是要测量的文字；start end 是文字的起始和结束坐标；contextStart contextEnd 是上下文的起始和结束坐标；isRtl 是文字方向；advance 是给出的位置的像素值。填入参数，对应的字符偏移量将做为返回值返回。

getOffsetForAdvance() 配合上 getRunAdvance() 一块儿使用，就能够实现「获取用户点击处的文字坐标」的需求。

2.2.8 hasGlyph(String string)

检查指定的字符串中是不是一个单独的字形 (glyph）。最简单的状况是，string 只有一个字母（好比 a）。

以上这些内容，就是文字绘制的相关知识。它们有的经常使用，有的不经常使用，有的甚至能够说是在某些状况下没用，不过你把它们所有搞懂了，在实际的开发中，就知道哪些事情能够作到，哪些事情作不到，以及应该怎么作了。

练习项目

为了不转头就忘，强烈建议你趁热打铁，作一下这个练习项目：HenCoderPracticeDraw3

下期预告

基本绘制（Canvas.drawXXX()）以及高级绘制（Paint）都讲完了，下节的内容是 Canvas 对绘制的辅助：范围裁切和几何变换：

感谢

感谢参与这期预发布内测的读者：

林子洋、Rookie run、showwiki、孙志帅、Tim Aimee、明天，你好、Mr.Coder、特伦特、承香墨影&version=12020810&lang=zh_CN&nettype=WIFI&a8scene=0&fontScale=100&pass_ticket=3ZSTFlOd8P3j6MV7KWW3Yz6Vk%2FG9MLwZDkm668BrQCc%3D)、HanDongFizz、停停走走、Vinctor

以为赞？

若是你看完以为有收获，把文章转发到你的微博、微信群、朋友圈、公众号，让其余须要的人也看到吧。