最近的一个模块正好用到字体的相关内容,整理出来。

(一) 字体的几个参数 ,以Android API文档定义为准,见下图

要点如下:

1. 基准点是baseline

2. Ascent是baseline之上至字符最高处的距离

3. Descent是baseline之下至字符最低处的距离

4. Leading文档说的很含糊,其实是上一行字符的descent到下一行的ascent之间的距离

5. Top指的是指的是最高字符到baseline的值,即ascent的最大值

6. 同上,bottom指的是最下字符到baseline的值,即descent的最大值

 

Note:网上有很多错误的图,如果有疑问,就参看文档,区分对错。

 

为了帮助理解,我特此搜索了不同的示意图。对照示意图,会很容易理解FontMetrics的参数。

pic-1

 

pic-2

 

pic-3

 

pic-4

 

pic-5

pic-6

(二) 测试

 1,测试的代码直接使用网上的代码,因为重复着众多,无所给出原始出处,故不注出。

我增加了Bitmap作为输出显示,完整代码如下:

 
  
  1. public class FontMetricsDemoActivity extends Activity { 
  2.     private Canvas canvas; 
  3.  
  4.     /** Called when the activity is first created. */ 
  5.     @Override 
  6.     public void onCreate(Bundle savedInstanceState) { 
  7.         super.onCreate(savedInstanceState); 
  8.         setContentView(R.layout.main); 
  9.          
  10.         Paint textPaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  11.         textPaint.setTextSize( 55); 
  12.         textPaint.setColor( Color.WHITE); 
  13.  
  14.         // FontMetrics对象 
  15.         FontMetrics fontMetrics = textPaint.getFontMetrics(); 
  16.         String text = "abcdefghijklmnopqrstu"
  17.          
  18.          
  19.  
  20.         // 计算每一个坐标 
  21.         float baseX = 0
  22.         float baseY = 100
  23.         float topY = baseY + fontMetrics.top; 
  24.         float ascentY = baseY + fontMetrics.ascent; 
  25.         float descentY = baseY + fontMetrics.descent; 
  26.         float bottomY = baseY + fontMetrics.bottom; 
  27.         float leading = baseY + fontMetrics.leading; 
  28.          
  29.          
  30.         Log.d("fontMetrics""baseX    is:" + 0); 
  31.         Log.d("fontMetrics""baseY    is:" + 100); 
  32.         Log.d("fontMetrics""topY     is:" + topY); 
  33.         Log.d("fontMetrics""ascentY  is:" + ascentY); 
  34.         Log.d("fontMetrics""descentY is:" + descentY); 
  35.         Log.d("fontMetrics""bottomY  is:" + bottomY); 
  36.         Log.d("fontMetrics""leading  is:" + leading); 
  37.  
  38.          
  39.          
  40.         Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.fontmetrics); 
  41.         Bitmap mutableBitmap = bitmap.copy(Bitmap.Config.ARGB_8888, true); 
  42.          
  43.         canvas  = new Canvas(mutableBitmap); 
  44.          
  45.          
  46.  
  47.         // 绘制文本 
  48.         canvas.drawText(text, baseX, baseY, textPaint); 
  49.  
  50.         // BaseLine描画 
  51.         Paint baseLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  52.          
  53.         baseLinePaint.setColor( Color.RED); 
  54.         canvas.drawLine(0, baseY, canvas.getWidth(), baseY, baseLinePaint); 
  55.  
  56.         // Base描画 
  57.         canvas.drawCircle( baseX, baseY, 5, baseLinePaint); 
  58.  
  59.         // TopLine描画 
  60.         Paint topLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  61.         topLinePaint.setColor( Color.LTGRAY); 
  62.         canvas.drawLine(0, topY, canvas.getWidth(), topY, topLinePaint); 
  63.  
  64.         // AscentLine描画 
  65.         Paint ascentLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  66.         ascentLinePaint.setColor( Color.GREEN); 
  67.         canvas.drawLine(0, ascentY, canvas.getWidth(), ascentY, ascentLinePaint); 
  68.  
  69.         // DescentLine描画 
  70.         Paint descentLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  71.         descentLinePaint.setColor( Color.YELLOW); 
  72.         canvas.drawLine(0, descentY, canvas.getWidth(), descentY, descentLinePaint); 
  73.  
  74.         // ButtomLine描画 
  75.         Paint bottomLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
  76.         bottomLinePaint.setColor( Color.MAGENTA); 
  77.         canvas.drawLine(0, bottomY, canvas.getWidth(), bottomY, bottomLinePaint);  
  78.          
  79.         ImageView imageView = (ImageView) findViewById(R.id.imageView1); 
  80.         imageView.setImageBitmap(mutableBitmap); 
  81.          
  82.     } 

 log显示如下:

Note1:注意到各个数值都是整数,这是建立在baseY=100的情况下,去掉baseY,重新运行代码,log如下:

Note2: 参照线为baseline,即baseline=0的情况下,其他各线的数值。leading = 0,即行间距=0

2,以上是根据paint设置,获取相关的FontMetrics属性,并且只绘制了一行字符串,我们猜想,如果是多行,是否可以获得行间距leanding,代码如下:

 
  
  1. //test_multiply_lines 
  2.         TextView textView = (TextView) findViewById(R.id.textView1); 
  3.         String textMultiLines = "abcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstu"
  4.         textView.setTextSize(55); 
  5.         textView.setText(textMultiLines); 
  6.          
  7.         FontMetrics fontMetrics2 = textView.getPaint().getFontMetrics(); 
  8.          
  9.          
  10.  
  11.         // 计算每一个坐标 
  12.  
  13.         float topY = fontMetrics2.top; 
  14.         float ascentY = fontMetrics2.ascent; 
  15.         float descentY =  fontMetrics2.descent; 
  16.         float bottomY = fontMetrics2.bottom; 
  17.         float leading =  fontMetrics2.leading; 
  18.          
  19.          
  20.  
  21.         Log.d("fontMetrics""topY     is:" + topY); 
  22.         Log.d("fontMetrics""ascentY  is:" + ascentY); 
  23.         Log.d("fontMetrics""descentY is:" + descentY); 
  24.         Log.d("fontMetrics""bottomY  is:" + bottomY); 
  25.         Log.d("fontMetrics""leading  is:" + leading); 

log如下:

Note:显然,即使是多行的情况下,仍不能获得leading。

3,如果text是单行,获得各个属性将会怎样,代码如下:

 
  
  1. String text = "abcdefghijklmnopqrstu"
  2.         TextView textView = (TextView) findViewById(R.id.textView1); 
  3.         textView.setTextSize(55); 
  4.         textView.setText(text); 
  5.          
  6.         FontMetrics fontMetrics = textView.getPaint().getFontMetrics(); 
  7.  
  8.         // 计算每一个坐标 
  9.         float baseX = 0
  10.         float baseY = 100
  11.         float topY = baseY + fontMetrics.top; 
  12.         float ascentY = baseY + fontMetrics.ascent; 
  13.         float descentY = baseY + fontMetrics.descent; 
  14.         float bottomY = baseY + fontMetrics.bottom; 
  15.         float leading =  fontMetrics.leading; 
  16.          
  17.          
  18.  
  19.         Log.d("fontMetrics""topY     is:" + fontMetrics.top); 
  20.         Log.d("fontMetrics""ascentY  is:" + fontMetrics.ascent); 
  21.         Log.d("fontMetrics""descentY is:" + fontMetrics.descent); 
  22.         Log.d("fontMetrics""bottomY  is:" + fontMetrics.bottom); 
  23.         Log.d("fontMetrics""leading  is:" + fontMetrics.leading); 

log如下图所示:

Note:与多行获得的属性都相同。

 

结论:

A:虽然paint和textView所设置的textSize均为55,且为相同的字符串,但是两个获得的FontMetrics属性值并不相同。但是,我们发现,做除法之后,均为1.5倍关系。做出猜测,即Paint下,为mdpi对应的size,而TextView的size已经关联到了显示屏幕本身的320dip。所以获得属性值均为整1.5倍数

B:各种情况下,均未获得leading值。