Canvas绘制文字的方式
drawText (String text, float x, float y, Paint paint)
其中,x,y 这个坐标并不是文字的左上角,而是一个与左下角比较接近的位置
这种设计其实是有道理的。drawText() 参数中的 y ,指的是文字的基线( baseline ) 的位置。也就是这条线:
用竖线标记出边界后的文字
drawTextOnPath(String text,Path path,float hOffset,float vOffset,Paint paint)
drawTextOnPath() 使用的 Path ,拐弯处全用圆角,别用尖角。
参数里,需要解释的只有两个: hOffset 和 vOffset。它们是文字相对于 Path 的水平偏移量和竖直偏移量,利用它们可以调整文字的位置。例如你设置 hOffset 为 5, vOffset 为 10,文字就会右移 5 像素和下移 10 像素
StaticLayout
解决drawText()不能自动换行的问题(即使加了换行符)。这个类纯粹是用来绘制文字的,它既可以为文字设置宽度上限来让文字自动换行,也会在 \n 处主动换行。如果你需要进行多行文字的绘制,并且对文字的排列和样式没有太复杂的花式要求,那么使用 StaticLayout 就好。
Paint对绘制文字的辅助
设置显示效果类
设置字体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);
设置粗体setFakeBoldText(boolean fakeBoldText)
删除线setStrikeThruText(boolean strikeThruText)
下划线setUnderlineText(boolean underlineText)
文字倾斜度setTextSkewX(float skewX)
设置文字变胖变瘦setTextScaleX(float scaleX)
设置文字字符间距,setLetterSpacing(float letterSpacing)
默认值为0。
setFontFeatureSettings(String settings)
用 CSS 的 font-feature-settings 的方式来设置文字。
设置文字对齐方setTextAlign(Paint.Align align)
setTextLocale(Locale locale) / setTextLocales(LocaleList locales)
设置绘制所使用的Locale
测量文字尺寸类
获取推荐的行距getFontSpacing()
即推荐的两行文字的 baseline 的距离。
FontMetircs getFontMetrics()
获取 Paint 的 FontMetrics。
leading: 这个词在上图中没有标记出来,因为它并不是指的某条线和 baseline 的相对位移。 leading 指的是行的额外间距,即对于上下相邻的两行,上行的 bottom 线和下行的 top 线的距离,也就是上图中第一行的红线和第二行的蓝线的距离(对,就是那个小细缝)
如果你要对文字手动换行绘制,多数时候应该选取 getFontSpacing() 来得到行距,不但使用更简单,显示效果也会更好。
getTextBounds(String text, int start, int end, Rect bounds)
获取文字的显示范围
注意与测量文字宽度的measureText(String text)的区别,measureText() 比 getTextBounds() 测量出的宽度要大一些
getTextWidths(String text, float[] widths)
测量每个字符的宽度
int breakText(String text, boolean measureForwards, float maxWidth, float[] measuredWidth)
这个方法也是用来测量文字宽度的。但和 measureText() 的区别是, breakText() 是在给出宽度上限的前提下测量文字的宽度。如果文字的宽度超出了上限,那么在临近超限的位置截断文字。
光标相关
getRunAdvance(CharSequence text, int start, int end, int contextStart, int contextEnd, boolean isRtl, int offset)
对于一段文字,计算出某个字符处光标的 x 坐标。
getOffsetForAdvance(CharSequence text, int start, int end, int contextStart, int contextEnd, boolean isRtl, float advance)
给出一个位置的像素值,计算出文字中最接近这个位置的字符偏移量(即第几个字符最接近这个坐标)。给出一个位置的像素值,计算出文字中最接近这个位置的字符偏移量(即第几个字符最接近这个坐标)。
hasGlyph(String string)
检查指定的字符串中是否是一个单独的字形 (glyph)。最简单的情况是,string 只有一个字母(比如 a)