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
线的距离,也就是上图中第一行的红线和第二行的蓝线的距离(对,就是那个小细缝)。
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 类型的结果。