Android RecyclerBarChart绘制使用教程
cxy107750 人气:0正文
上篇介绍了几种图表的公共组件X、Y轴、背景Board的绘制。这章节介绍柱状图表的绘制,相对其它图表而言简单一些,这里主要介绍图表主体的绘制,以及高亮选中的其中一个的选中框的绘制的相关逻辑。对每个ItemView中的ItemDecoration上进行onDraw的操作,需要将View跟Model进行绑定在一起,单个柱子的一些属性可以通过Model来获取,整体的一些绘制的辅助信息color、size等可以通过Attribute类设置。View 跟Model的绑定不止是BarChart图表,所以的都是一样的。
以下是在BarAdapter中的onBindViewHolder方法中进行关联二者:
根据之前的介绍绘制的逻辑都在ItemDecoration里,我们看下BarChartItemDecoration的onDrawOver, 对于X、Y轴、Board的绘制其实可以沉淀到BaseItemDecoration中的,这里直接写了。
这里我们着重看下drawBarChart、drawHighLight、drawBarChartValues的绘制。
1.drawBarChart
绘制柱状图的主体,通过ItemView拿到对应的Entry对象,根据Entry中的Y值进行Y坐标值的转化,然后绘制单个Item RectF的绘制。
//绘制柱状图, mYAxis这个坐标会实时变动,所以通过 BarChartItemDecoration 传过来的精确值。 final public void drawBarChart(final Canvas canvas, @NonNull final RecyclerView parent, final YAxis mYAxis) { final float parentRight = parent.getWidth() - parent.getPaddingRight(); final float parentLeft = parent.getPaddingLeft(); final int childCount = parent.getChildCount(); for (int i = 0; i < childCount; i++) { View child = parent.getChildAt(i); BarEntry barChart = (BarEntry) child.getTag(); RectF rectF = ChartComputeUtil.getBarChartRectF(child, parent, mYAxis, mBarChartAttrs, barChart); drawChart(canvas, rectF, parentLeft, parentRight); } }
绘制的逻辑具体在 drawChart(canvas, rectF, parentLeft, parentRight) 的方法里,这里我们先看看 RectF 的计算,工具类ChartComputeUtil.getBarChartRectF() 的方法。
public static <T extends BarEntry, V extends BaseYAxis, E extends BaseChartAttrs> RectF getBarChartRectF(View child, final RecyclerView parent, V mYAxis, E chartAttrs, T barEntry) { final RectF rectF = new RectF(); float contentBottom = parent.getHeight() - parent.getPaddingBottom() - chartAttrs.contentPaddingBottom; float realYAxisLabelHeight = contentBottom - parent.getPaddingTop() - chartAttrs.contentPaddingTop; float width = child.getWidth(); float barSpaceWidth = width * chartAttrs.barSpace; float barChartWidth = width - barSpaceWidth;//柱子的宽度 final float left = child.getLeft() + barSpaceWidth / 2; final float right = left + barChartWidth; float height = barEntry.getY() / mYAxis.getAxisMaximum() * realYAxisLabelHeight; if (chartAttrs.yAxisReverse && barEntry.getY() > 0) { float valueTemp = mYAxis.getAxisMaximum() - barEntry.getY(); height = valueTemp / mYAxis.getAxisMaximum() * realYAxisLabelHeight; } final float top = Math.max(contentBottom - height, parent.getPaddingTop()); rectF.set(left, top, right, contentBottom); return rectF; }
柱子RectF 的计算,Width根据 itemView的width 以及每个ItemView的空余所占比例的一个ChartAttrs中的参数
barSpace计算得来,算出RectF的 left、right; height 的计算,涉及到Entry 的Y值以及YAxis 当前显示情况下的getAxisMaximum(),这里默认了Minmum为0,业务逻辑的Y值比例转化成 屏幕Pixel对应的高度,然后根据ItemView的top、bottom计算得到 RectF的 top, bottom. (这里的计算,到时候其它图表高度也可以用)。
获取到 单个ItemView 中BarChart 所占的RectF确定后,画RectF就比较简单了,稍微有点难点的是处理一下边界的问题,边界问题,柱状图相比线形图等简单一些,处于边界的柱子绘制的颜色不一样,交给用户mBarChartAttrs.chartEdgeColor传color值,这里默认设置的是Gray。
private void drawChart(Canvas canvas, RectF rectF, float parentLeft, float parentRight) { float radius = (rectF.right - rectF.left) *mBarChartAttrs.barChartRoundRectRadiusRatio; // 浮点数的 == 比较需要注意 if (DecimalUtil.smallOrEquals(rectF.right, parentLeft)) { //continue 会闪,原因是end == parentLeft 没有过滤掉,显示出来柱状图了。 return; } else if (rectF.left < parentLeft && rectF.right > parentLeft) { //左边部分滑入的时候,处理柱状图的显示 rectF.left = parentLeft; Path path = CanvasUtil.createRectRoundPath(rectF, radius, RoundRectType.TYPE_RIGHT); mBarChartPaint.setColor(mBarChartAttrs.chartEdgeColor); canvas.drawPath(path, mBarChartPaint); } else if (DecimalUtil.bigOrEquals(rectF.left, parentLeft) && DecimalUtil.smallOrEquals(rectF.right, parentRight)) { //中间的; 浮点数的 == 比较需要注意 mBarChartPaint.setColor(mBarChartAttrs.chartColor); Path path = CanvasUtil.createRectRoundPath(rectF, radius); canvas.drawPath(path, mBarChartPaint); } else if (DecimalUtil.smallOrEquals(rectF.left, parentRight) && rectF.right > parentRight) { //右边部分滑出的时候,处理柱状图,文字的显示 float distance = (parentRight - rectF.left); rectF.right = rectF.left + distance; Path path = CanvasUtil.createRectRoundPath(rectF, radius, RoundRectType.TYPE_LEFT); mBarChartPaint.setColor(mBarChartAttrs.chartEdgeColor); canvas.drawPath(path, mBarChartPaint); } }
下面是个步数的周视图:
2.drawHighLight
首先看下这里高亮具体是如何显示的,直观的看些图:
当前的RecyclerView的getChildCount内每个ItemView对应的Entry,设定了一个 selected 的字段来确定显示高亮,至于该字段的值的设定及变化,后续章节会介绍,这里假定已经确定了当前的某一个ItemView的Entry的selected是选中状态的,它有可能在中间,或者在边界需要处理边界绘制的问题,这里分画顶部的矩形框及drawTextValue值,底部绘制drawLine(这个不存在绘制的边界问题)
//绘制选中时 highLight 标线及浮框。 public <E extends BaseYAxis> void drawHighLight(Canvas canvas, @NonNull RecyclerView parent, E yAxis) { if (mBarChartAttrs.enableValueMark) { int childCount = parent.getChildCount(); View child; for (int i = 0; i < childCount; i++) { child = parent.getChildAt(i); T entry = (T) child.getTag(); RectF rectF = ChartComputeUtil.getBarChartRectF(child, parent, yAxis, mBarChartAttrs, entry); float width = child.getWidth(); float childCenter = child.getLeft() + width / 2; String valueStr = mHighLightValueFormatter.getBarLabel(entry); if (entry.isSelected() && !TextUtils.isEmpty(valueStr)) { int chartColor = getChartColor(entry); float rectHeight = drawHighLightValue(canvas, valueStr, childCenter, parent, chartColor);//绘制顶部的poupWindow,高亮矩形框及drawText float[] points = new float[]{childCenter, rectF.top, childCenter, rectHeight}; drawHighLightLine(canvas, points, chartColor);//绘制底部的Line } } } }
以上中 drawHighLightValue 中, 包含了绘制矩形、drawText两项具体的内容:
//绘制柱状图选中浮框 protected float drawHighLightValue(Canvas canvas, String valueStr, float childCenter, RecyclerView parent, int barChartColor) { float parentTop = parent.getPaddingTop(); float contentRight = parent.getWidth() - parent.getPaddingRight(); float contentLeft = parent.getPaddingLeft(); String[] strings = valueStr.split(DefaultHighLightMarkValueFormatter.CONNECT_STR); float leftEdgeDistance = Math.abs(childCenter - contentLeft); float rightEdgeDistance = Math.abs(contentRight - childCenter); float leftPadding = DisplayUtil.dip2px(8); float rightPadding = DisplayUtil.dip2px(8); float centerPadding = DisplayUtil.dip2px(16); float rectBottom = parentTop; float txtTopPadding = DisplayUtil.dip2px(8); String leftStr = strings[0]; String rightStr = strings[1]; float txtLeftWidth = mHighLightValuePaint.measureText(leftStr); float txtRightWidth = mHighLightValuePaint.measureText(rightStr); float rectFHeight = TextUtil.getTxtHeight1(mHighLightValuePaint) + txtTopPadding * 2; float txtWidth = txtLeftWidth + txtRightWidth + leftPadding + rightPadding + centerPadding; float edgeDistance = txtWidth / 2.0f; float rectTop = parentTop - rectFHeight; //绘制RectF RectF rectF = new RectF(); mBarChartPaint.setColor(barChartColor); if (leftEdgeDistance <= edgeDistance) {//矩形框靠左对齐 rectF.set(contentLeft, rectTop, contentLeft + txtWidth, rectBottom); float radius = DisplayUtil.dip2px(8); canvas.drawRoundRect(rectF, radius, radius, mBarChartPaint); } else if (rightEdgeDistance <= edgeDistance) {//矩形框靠右对齐 rectF.set(contentRight - txtWidth, rectTop, contentRight, rectBottom); float radius = DisplayUtil.dip2px(8); canvas.drawRoundRect(rectF, radius, radius, mBarChartPaint); } else {//居中对齐。 rectF.set(childCenter - edgeDistance, rectTop, childCenter + edgeDistance, rectBottom); float radius = DisplayUtil.dip2px(8); canvas.drawRoundRect(rectF, radius, radius, mBarChartPaint); } //绘文字 RectF leftRectF = new RectF(rectF.left + leftPadding, rectTop + txtTopPadding, rectF.left + leftPadding + txtLeftWidth, rectTop + txtTopPadding + rectFHeight); mHighLightValuePaint.setTextAlign(Paint.Align.LEFT); Paint.FontMetrics fontMetrics = mHighLightValuePaint.getFontMetrics(); float top = fontMetrics.top;//为基线到字体上边框的距离,即上图中的top float bottom = fontMetrics.bottom;//为基线到字体下边框的距离,即上图中的bottom int baseLineY = (int) (leftRectF.centerY() + (top + bottom) / 2);//基线中间点的y轴计算公式 canvas.drawText(leftStr, rectF.left + leftPadding, baseLineY, mHighLightValuePaint); float dividerLineStartX = rectF.left + leftPadding + txtLeftWidth + centerPadding / 2.0f; float dividerLineStartY = rectTop + DisplayUtil.dip2px(10); float dividerLineEndX = dividerLineStartX; float dividerLineEndY = rectBottom - DisplayUtil.dip2px(10); float[] lines = new float[]{dividerLineStartX, dividerLineStartY, dividerLineEndX, dividerLineEndY}; canvas.drawLines(lines, mHighLightValuePaint); float rightRectFStart = rectF.left + leftPadding + txtLeftWidth + centerPadding; RectF rightRectF = new RectF(rightRectFStart, rectTop + txtTopPadding, rectF.right - rightPadding, rectBottom - txtTopPadding); canvas.drawText(rightStr, rightRectF.left, baseLineY, mHighLightValuePaint); return rectFHeight; }
具体的文案绘制内容 valueStr 从 ValueFormatter里获取,我这里需要拆分一下ValueStr,然后绘制leftStr, rightStr这里相当于各个项目自己的需求。
加载全部内容