devbox
寸_铁
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

小说阅读器开发（二）文本的排版与分页_用canvas实现小说阅读

作者：寸_铁 | 2024-07-13 17:39:29

赞

踩

用canvas实现小说阅读

一个最简单的小说阅读器，也离不开文本的显示。起初，我以为这是件十分容易完成的事，慢慢的，我才意识到其中的复杂性。很多时候，对于文本的显示，一个文本框便能解决。但是，兼顾着排版与分页等复杂的功能，常用的UI控件就显得力不从心了。为了实现这些较为特殊的功能，就需要通过自定义View来解决。本文将从认识View的概念讲起。

View的概念

  我们对一个应用最直观的印象，就是其使用界面，而界面又由一个或多个控件构成。事实上，我们在手机屏幕上所看到的一切元素，都是View的实例，更本质上讲，都是View所描绘出的一个个像素点。View是以矩形的方式显示在屏幕上，View是用户界面控件的基础。一行文字、一个按钮、一张图片，这些看似整体却又相互独立的元素，可以当作View在屏幕上的展示。

从安卓开发文档上可以看到，View的父类是Object类，而子类则包含了比 悉的ImageView、Button、TextView等等。因此，屏幕上呈现在我们眼前的种种元素，都可以抽象成对象。万物皆对象，而对象就有属性。要想更准确的理解View，就不可避免的直面官方的介绍：

  这个类表示用户界面组件的基本构造模块，一个View 在屏幕上占据了一块矩形区域，并负责绘图和事件处理。View是窗口小部件的基类，用于创建交互式UI组件(按钮、文本字段等)。ViewGroup子类是布局的基类，其是不可见的容器，包含着其他View(或其他ViewGroup)，并定义它们的布局属性。


  View的绘制流程是从ViewRoot的performTraversals方法开始的，包含了测量、布局和绘图三个过程，分别是measure、layout和draw。其基本的设计思想是先测量视图的大小，接着设置视图的位置，即视图在屏幕上坐标，最后在所设定的区域描绘出所需的图形。具体的作用如下：

  • measure:判断是否需要重新计算View的大小，需要的话则计算；
  • layout:判断是否需要重新计算View的位置，需要的话则计算；
  • draw:判断是否需要重新绘制View，需要的话则重绘制。

自定义View

  安卓的开发内容各式各样，内置的UI控件往往不能满足我们的需求，正如我们的小说阅读器项目一样，普通的文本框已经无法实现排版和分页的功能，因此，自己定制一个UI控件就成了当务之急。安卓开发也提供可这种方法，允许我们根据自己的需求定义一个UI控件，这便是自定义View。自定义View并不复杂，一个最简单的自定义View需要重写onMeasure()、onDraw()两个函数，onMeasure负责对当前View的尺寸进行测量，onDraw负责把当前这个View绘制出来。完整的自定义Viewch程序还需要写至少写2个构造函数：

  1. public MyView(Context context) {
  2.         super(context);
  3.     }
  4.  
  5.     public MyView(Context context, AttributeSet attrs) {
  6.         super(context, attrs); 
  7.     }
  8.     
  9.     @Override
  10.     protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
  11.         super.onMeasure(widthMeasureSpec, heightMeasureSpec);
  12.     }
  13.     
  14.     @Override
  15.     protected void onDraw(Canvas canvas) {
  16.         super.onDraw(canvas);
  17.     }

 

重写onMeasure方法

  为什么要重写onMeasure方法？重写onMeasure方法又有什么用处呢？我刚开始接触的时候也并不是很懂。回想一下，在xml布局文件中，我们在设置控件的layout_width和layout_height属性时，常常使用wrap_content或match_parent作为参数值，而非具体的数值。这是由于要满足不同手机屏幕尺寸的需求，控件的大小不能写死，应具有一定的弹性。wrap_content的作用是强制性地使视图扩展以显示全部内容，布局元素将根据内容更改UI控件的大小。match_parent则强制性地使控件扩展，以填充布局单元内尽可能多的空间。
  当我们设置布局为wrap_content时，自定义控件并不能为我们处理大小，这时就需要重写onMeasure方法，并在该方法中测量控件大小的具体数值。onMeasure方法提供了widthMeasureSpec和 heightMeasureSpec两个参数，除了带有具体的大小数值外，还携带了布局的模式信息，即UNSPECIFIED，AT_MOST，EXACTLY三种模式，分别对应布局中的wrap_content、match_parent和指定数值。在这里，我们主要是处理UNSPECIFIED模式下的大小，即对具体内容的测量。
小说阅读器重写onMeasure方法的具体代码如下：

  1. @SuppressLint("DrawAllocation")
  2.     @Override
  3.     protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
  4.         super.onMeasure(widthMeasureSpec, heightMeasureSpec);
  5.         int widthMode = MeasureSpec.getMode(widthMeasureSpec);
  6.         int widthSize = MeasureSpec.getSize(widthMeasureSpec);
  7.         int heightMode = MeasureSpec.getMode(heightMeasureSpec);
  8.         int heightSize = MeasureSpec.getSize(heightMeasureSpec);
  9.  
  10.         paddingLeft = getPaddingLeft();
  11.         paddingTop = getPaddingTop();
  12.         paddingRight = getPaddingRight();
  13.         paddingBottom = getPaddingBottom();
  14.  
  15.         viewWidth = widthSize;
  16.         viewHeight = heightSize;
  17.         readWidth = viewWidth - paddingLeft - paddingRight;
  18.         readHeight = viewHeight - paddingTop - paddingBottom;
  19.         setMatrix();
  20.         getStrData(eBook);
  21.  
  22.         int width;
  23.         int height ;
  24.         if (widthMode == MeasureSpec.UNSPECIFIED) {
  25.             width = textWidth;
  26.         } else {
  27.             width = widthSize;
  28.         }
  29.  
  30.         if (heightMode == MeasureSpec.UNSPECIFIED) {
  31.             height = textHeight;
  32.         } else {
  33.             height = heightSize;
  34.         }
  35.  
  36.         setMeasuredDimension(width, height);
  37.     }

重写onDraw方法

  重写onDraw方法比较好理解，我们要在这里把UI控件的内容绘制出来，可以是文本，可以是图形，当然也可以是图片。可以把Canvas当作画布，Paint当作画笔，而我们程序员就是画家，手敲代码就如同手持画笔，双手灵活的在其中作画，灵感所在而随心所欲。在这里我才深切的感受到自定义的真谛，完全可以由需求来定制，不局限于任何限制。
  Canvas提供了几种绘制方法，可以满足大部分的需求：

  • drawLine(s)画直线：前四个参数为直线的起点和终点的 XY 轴坐标。
  • drawRect画矩形：确定矩形四个顶点的位置配上画笔即可。
  • drawText画文本：在 x,y 位置开始画文本其中 y 表示文字的基线(baseline)所在的坐标，而 x坐标就是文字绘制的起始水平坐标，但是每个文字本身两侧都有一定的间隙，故实际文字的位置会比 x 的位置再偏右侧一些。
  • drawBitmap画图片：bitmap:要画在画布上的位图，matrix：构建的矩阵作用于将要画出的位图。
  • drawArc画圆弧：userCenter 若为true表示此弧会和 RectF 中心相连形成扇形，否则，弧的两头直接相连形成图形。startAngle，负数或大于360则对360模除。sweepAngle，大于360，则画出一圈。角度：以 RectF 中心为坐标中心，中心所在直线为水平线，负角度弧斜上走，正角度弧斜下走,或者说以时钟三点钟为0度，顺时针为正，逆时针为负。
  • drawCircle画圆：cx,cy 为所画圆的中心坐标，radius 为圆的半径。当画笔设置了 StrokeWidth 时，圆的半径=内圆的半径+StrokeWidth/2。
  • drawColor,drawRGB画颜色：画整个画布的背景，但若区域受到剪裁，则只绘制剪裁区域的背景。
  • drawOval画椭圆：绘制椭圆，类似drawRect。

  由于小说阅读器要实现页面的排版，根据需要可设置为左对齐、右对齐和两端对齐，我的解决方案是对所有文字进行单独绘制，根据文字的宽度设置对应得坐标，设置对齐方式时，微调其坐标位置即可，而不需要做太大的改动。因为每个文字是单独绘制的，可以十分容易的调整其字间距、行间距以及段与段之间的距离。
  小说阅读器重写onDraw方法的具体代码如下：

  1. @SuppressLint("DrawAllocation")
  2.     @Override
  3.     protected void onDraw(Canvas canvas) {
  4.         super.onDraw(canvas);
  5.  
  6.         PageModel page = chapterModel.getPageModels().get(chapterModel.getIndex());
  7.         canvas.drawBitmap(bitmap,matrix,mPaint);
  8.         for(int i = 0;i<page.getLineModels().size();i++){
  9.             LineModel line= page.getLineModels().get(i);
  10.             int num =line.getStringList().size();
  11.             float spacing;
  12.             if(num == 0){
  13.                 spacing = 0;
  14.             }else {
  15.                 spacing = line.getStrDiff()/(float)(num-1);
  16.             }
  17.             for (int j=0;j<num;j++){
  18.                 mPaint.setColor(line.getStrColors().get(j));
  19.                 canvas.drawText(line.getStringList().get(j), line.getStrX().get(j)+ paddingLeft + j*spacing,
  20.                         (i + 1) * fontSize * 1.5f + paddingTop - 4, mPaint);
  21.             }
  22.         }
  23.     }

自定义布局属性

  在UI控件的使用过程中，我们通常可以通过改变属性值来改变控件的状态，自定义View也一样，为我们提供了一种自定义布局属性的方法。自定义View的构造函数中，提供了带有布局属性的参数，不过在获取这些参数之前，需要在res目录中的values文件夹下新建一个attrs.xml文件。本例中我定义的attrs.xml文件内容如下所示，包含了颜色、字体大小、文本内容、背景颜色或图片等属性。
  值得注意的是，format指定的参数，具有特殊的含义，具体内容如下，使用时需要一一对应，以免出错：

  • reference： 表示引用，参考某一资源ID；
  • string： 表示字符串；
  • color： 表示颜色值；
  • dimension： 表示尺寸值；
  • boolean： 表示布尔值；
  • integer： 表示整型值；
  • float： 表示浮点值；
  • fraction： 表示百分数；
  • enum： 表示枚举值；
  • flag： 表示位运算。

  本例新建的attrs.xml文件内容如下：

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <resources>
  3.     <declare-styleable name="ReadView">
  4.         <attr name="color" format="color"/>
  5.         <attr name="fontSize" format="dimension"/>
  6.         <attr name="text" format="string"/>
  7.         <attr name="background" format="reference"/>
  8.         <attr name="type" format="enum">
  9.             <enum name="common" value="1"/>
  10.             <enum name="material" value="2"/>
  11.         </attr>
  12.         <attr name="flag">
  13.             <flag name="flag1" value="0x01"/>
  14.             <flag name="flag2" value="0x02"/>
  15.             <flag name="flag4" value="0x04"/>
  16.         </attr>
  17.     </declare-styleable>
  18. </resources>

获取属性值代码如下所示：第二个参数是属性的默认值，当在xml文件中不使用该属性时，系统会获取到默认值，做默认处理。

  1. TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.ReadView);
  2.     //获取字体大小,默认大小是24
  3.     fontSize = (int) ta.getDimension(R.styleable.ReadView_fontSize, 24);
  4.     //获取文字内容
  5.     eBook = ta.getString(R.styleable.ReadView_text);
  6.     //获取文字颜色，默认颜色是BLUE
  7.     textColor = ta.getColor(R.styleable.ReadView_color, Color.BLACK);
  8.     //获取背景
  9.     background = ta.getResourceId(R.styleable.ReadView_background,R.drawable.paper);
  10.     ta.recycle();

文本的排版与分页

  文本的排版与分页，是小说阅读器重点解决的问题。排版的引证解释是指按照稿本把铅字、图版等排在一起拼成书报的版子，以供印刷。分页更好理解，是将一本书或者一个章节，按照一定的版面，一张一张的剥离开来。排版与分页看似不同，却基本原理却相差无几。由于这是一个小说阅读器的开发，暂时不考虑图片的显示问题，所有排版均针对文本而言。因此主要体现在三个方面，首行缩进两个字符，自动换行以及文本的两端对齐。至于字间距、行间距、甚至段间距，也可以做相应的调整。
  文本的排版方案，我的思路是首先解决的是文本的自动换行问题，这需要测量字符的宽度，通过累加字符的宽度，然后对比控件宽度，大于时或遇到换行符时就切换下一行。由于每个字符需要单独绘制，这就需要设置每个字符的坐标，这里也比较容易解决，在累加字符宽度时，加入些字间距调整，就是文本在画布上的坐标。至于首行缩进问题，就更简单了，只要判断是段落开始时，加入两个空格符即可。还有一个问题，是解决因为半角全角符号、中英文混排所造成的，文本不对齐现象。我的解决办法是通过计算每行文字的宽度与控件宽度的差值，然后平均加到每个字符的横坐标上作为补充，使得每一行的首尾宽度一致，实现了文本的两端对齐。

 

分页也一样，通过累加字符的高度值和行间距，然后对比控件的高度值，就可以准确的分出每一个页面来。为了提高效率，控件应该减少对大文件的处理，因此该小说阅读器只针对章节进行排版分页。在绘制文本时，出现了比较明显的锯齿而不清晰，刚开始我并不知道什么问题，最后通过加入mPaint.setAntiAlias(true)解决，该函数是用来防止边缘的锯齿。

  1. private void getStrData(String str){
  2.         readTool.init();
  3.         readTool.setStrCaptal(fontSize,textColor);
  4.         int lineWidth = 2*fontSize;
  5.         for(int i=0;i<str.length();i++){
  6.             String subStr;
  7.             if(i < str.length()-1){
  8.                 subStr  = str.substring(i, i + 1);
  9.             }else {
  10.                 subStr = str.substring(i);
  11.             }
  12.             int fontWidth = (int)mPaint.measureText(subStr);
  13.             lineWidth = lineWidth + fontWidth;
  14.             if (subStr.equals("\n")){
  15.                 readTool.addPage(readHeight,fontSize);
  16.                 readTool.addLine(0);
  17.                 readTool.setStrCaptal(fontSize,textColor);
  18.                 lineWidth = 2*fontSize;
  19.             }else if(lineWidth < readWidth){
  20.                 readTool.addStrArr(subStr,fontWidth,lineWidth-fontWidth,textColor);
  21.             }else{
  22.                 readTool.addPage(readHeight,fontSize);
  23.                 readTool.addLine(readWidth-lineWidth+fontWidth);
  24.                 lineWidth = fontWidth;
  25.                 readTool.addStrArr(subStr,lineWidth,0,textColor);
  26.             }
  27.         }
  28.         readTool.addEnd(readHeight,fontSize);
  29.         lineWidth = 0;
  30.         chapterModel.setPageModels(readTool.getPageModels());
  31.         lineNum = readTool.getLineModels().size();
  32.         if (lineNum > 1){
  33.             textWidth = getWidth();
  34.         }else {
  35.             textWidth = lineWidth;
  36.         }
  37.         textHeight = lineNum * (fontSize+lineHeight);
  38.     }

设置背景图片时，由于缩放的缘故，图片十分不清晰。查阅相关资料后，我是通过矩阵Matrix的坐标映射和数值转换来解决。实际上不论2D还是3D，我们要将图形显示在屏幕上，都离不开Matrix，所以说Matrix是一个在背后辛勤工作的劳模。Matrix是一个矩阵，最根本的作用就是坐标转换，其基本原理是:

我们所用到的变换均属于仿射变换，仿射变换是线性变换(缩放，旋转，错切)和平移变换(平移) 的复合。
仿射变换概念：仿射变换其实就是二维坐标到二维坐标的线性变换，保持二维图形的“平直性”（即变换后直线还是直线不会打弯，圆弧还是圆弧）和“平行性”（指保持二维图形间的相对位置关系不变，平行线还是平行线，而直线上点的位置顺序不变)，可以通过一系列的原子变换的复合来实现，原子变换就包括：平移、缩放、翻转、旋转和错切。这里除了透视可以改变z轴以外，其他的变换基本都是上述的原子变换，所以，只要最后一行是0,0,1则是仿射矩阵。

  1.  private void setMatrix(){
  2.         float bitmapWidth = bitmap.getWidth();
  3.         float bitmapHeight = bitmap.getHeight();
  4.         float scaleX = viewWidth / bitmapWidth;
  5.         float scaleY = viewHeight / bitmapHeight;
  6.         matrix = new Matrix();
  7.         matrix.postTranslate(0, 0);
  8.         matrix.preScale(scaleX, scaleY);
  9.     }

文本的排版与分页效果图：

 

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/寸_铁/article/detail/820758
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号