Android Canvas.drawTextOnPath缩放画布时文本模糊问题求解

问题表现 #

沿曲线路径绘制文本时，对Canvas执行scale放大操作后，drawTextOnPath绘制的曲线文本会出现明显模糊；相同缩放逻辑下，调用canvas.drawText绘制的普通文本显示完全正常。

复现代码 #

public void draw(Canvas canvas) {
    float midX = (maxX + minX) / 2;
    float midY = (maxY + minY) / 2;
    canvas.save();
    canvas.translate(minX, minY);
    canvas.scale(this.scaleX, this.scaleY);
    if (curvingAngle != 0) {
        drawCurveText(canvas, 0f, 0f, 1f);
    } else {
        canvas.drawText(text, mOrigin[0], mOrigin[1], textPaint);
    }
    canvas.restore();
}

private void drawCurveText(Canvas canvas,float offsetX, float offsetY, float scale) {
    // 路径计算逻辑
    Path textPath;
    canvas.drawTextOnPath(text, this.textPath, hOffset, 0.0f, this.getPaint());
}

效果对比 #

• 缩放前（清晰）
  
• 缩放后（模糊）
  

问题根因 #

两种文本绘制方法的底层渲染逻辑存在差异：

• 普通drawText为矢量渲染逻辑，会读取Canvas当前完整的变换矩阵，按最终显示的实际尺寸栅格化文本，任意缩放下都能保持边缘清晰。
• 硬件加速模式下的drawTextOnPath会先在1倍缩放基准下，将文本沿路径变形、栅格化为固定分辨率的位图，再将该位图应用Canvas的缩放、位移等变换绘制到画布。放大画布时本质是拉伸低分辨率位图，必然出现模糊。

可行解决方案 #

方案1：手动缩放路径与画笔参数（推荐，清晰度最优） #

移除Canvas上的scale变换，将缩放值直接应用到路径坐标、画笔字号、偏移量参数上，保证drawTextOnPath执行时Canvas处于1倍原生缩放状态，所有尺寸参数提前换算为实际像素值，从根源避免位图拉伸问题。

public void draw(Canvas canvas) {
    float midX = (maxX + minX) / 2;
    float midY = (maxY + minY) / 2;
    canvas.save();
    canvas.translate(minX, minY);
    if (curvingAngle != 0) {
        // 传入实际缩放值，方法内部处理尺寸换算
        drawCurveText(canvas, 0f, 0f, this.scaleX, this.scaleY);
    } else {
        // 普通文本同步做尺寸换算，保持显示大小一致
        Paint paint = getPaint();
        float originTextSize = paint.getTextSize();
        paint.setTextSize(originTextSize * scaleX);
        canvas.drawText(text, mOrigin[0] * scaleX, mOrigin[1] * scaleY, paint);
        paint.setTextSize(originTextSize);
    }
    canvas.restore();
}

private void drawCurveText(Canvas canvas, float offsetX, float offsetY, float scaleX, float scaleY) {
    // 生成对应缩放比的实际绘制路径
    Matrix scaleMatrix = new Matrix();
    scaleMatrix.setScale(scaleX, scaleY);
    Path scaledPath = new Path();
    this.textPath.transform(scaleMatrix, scaledPath);

    // 同步缩放画笔字号
    Paint paint = getPaint();
    float originTextSize = paint.getTextSize();
    paint.setTextSize(originTextSize * scaleX);

    // 1倍缩放下直接绘制，偏移量同步缩放
    canvas.drawTextOnPath(text, scaledPath, hOffset * scaleX, 0.0f, paint);

    // 恢复画笔原始参数，避免影响其他绘制逻辑
    paint.setTextSize(originTextSize);
}

该方案渲染清晰度与普通drawText完全一致，无额外性能损耗，适配所有安卓系统版本。

方案2：关闭硬件加速（兼容性备选） #

部分安卓系统版本的软件渲染实现中，drawTextOnPath会正确按Canvas矩阵做矢量栅格化，可临时对当前绘制View关闭硬件加速：

// View初始化时调用即可
setLayerType(LAYER_TYPE_SOFTWARE, null);

注意：软件渲染模式下复杂路径、大文本量的绘制性能会低于硬件加速，仅适合简单场景使用。

方案3：开启位图过滤（仅缓解模糊，不推荐） #

如果必须保留canvas.scale的写法，可给Canvas设置位图过滤标志，一定程度缓解拉伸后的锯齿感，但无法达到矢量文本的清晰度：

// 绘制前调用
canvas.setDrawFilter(new PaintFlagsDrawFilter(0, Paint.ANTI_ALIAS_FLAG | Paint.FILTER_BITMAP_FLAG));

内容的提问来源于stack exchange，提问作者Bhupesh