跳转至

DrawBoard

Image

Download MavenCentral JitPack CircleCI API License

DrawBoard 是一个自定义 View实现的画板;方便对图片进行编辑和各种涂鸦相关操作。

  • 主要支持的一些操作:撤销、恢复、清空、缩放;
  • 主要支持的绘制模式:画路径、画点、画直线、画矩形、画椭圆、画圆、画文字、画图片、橡皮擦、马赛克等。

Gif 展示

Image

你也可以直接下载 演示App 体验效果

引入

Gradle:

  1. 在Project的 build.gradlesetting.gradle 中添加远程仓库

    repositories {
        //...
        mavenCentral()
    }
    
  2. 在Module的 build.gradle 里面添加引入依赖项

    implementation 'com.github.jenly1314:drawboard:1.1.0'
    

    使用

DrawBoardView自定义属性说明

属性 属性类型 默认值 属性说明
dbvMinZoom float 1.0 支持最小的放大倍数
dbvMaxZoom float 4.0 支持最大的放大倍数
dbvFit boolean true 是否自适应
dbvDrawEnabled boolean true 是否启用绘图
dbvZoomEnabled boolean true 是否启用缩放
dbvShowTouchPoint boolean true 是否显示触摸点
dbvShowSelectedBox boolean false 是否显示选中框
android:src drawable 设置源图片(画板背景图层)
dbvPaintColor color #FFFF0000 画笔的颜色
dbvSelectedBoxColor color #AFFF0000 选中框颜色
dbvTouchPointColor color #AFCCCCCC 触摸点的颜色
dbvLineStrokeWidth dimension 2dp 画笔线条笔划宽度
dbvSelectedStrokeWidth dimension 1dp 选中时边框笔划宽度
dbvEraserStrokeWidth dimension 10dp 橡皮擦笔划宽度
dbvMosaicStrokeWidth dimension 10dp 马赛克比笔划宽度
dbvZoomPointStrokeWidth dimension 6dp 缩放点笔划宽度
dbvDrawTextSize dimension 15sp 绘制文本的字体大小
dbvDrawTextBold boolean false 绘制文本是否是粗体
dbvDrawTextUnderline boolean false 绘制文本是否需要下划线
dbvTouchTolerance float 4.0 触摸时允许的容差值
dbvTouchPointRatio float 1.2 触摸点的比例
dbvDrawLineArrow boolean false 绘制直线时是否带箭头
dbvLineArrowSize dimension 6dp 绘制直线时的箭头大小

示例

布局示例

    <com.king.drawboard.view.DrawBoardView
        android:id="@+id/drawBoardView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

说明

主要支持的绘制模式

/**
 * 绘制路径
 */
DrawMode.DRAW_PATH
/**
 * 绘制点
 */
DrawMode.DRAW_POINT
/**
 * 绘制线
 */
DrawMode.DRAW_LINE
/**
 * 绘制矩形
 */
DrawMode.DRAW_RECT
/**
 * 绘制椭圆
 */
DrawMode.DRAW_OVAL
/**
 * 绘制圆
 */
DrawMode.DRAW_CIRCLE
/**
 * 绘制文本
 */
DrawMode.DRAW_TEXT
/**
 * 绘制图片
 */
DrawMode.DRAW_BITMAP
/**
 * 橡皮擦
 */
DrawMode.ERASER
/**
 * 马赛克
 */
DrawMode.MOSAIC

如果以上操作不完全满足你的需求,DrawBoard对外还提供了很多可定制化的配置(例如:自实现一个 Draw)。

/**
 * 如设置绘制模式为:DrawMode.DRAW_PATH
 */
drawBoardView.setDrawMode(DrawMode.DRAW_PATH)

主要常用的一些方法

/**
 * 撤销一步
 */
drawBoardView.undo()
/**
 * 恢复一步
 */
drawBoardView.redo()
/**
 * 清除画布
 */
drawBoardView.clear()
/**
 * 改变绘制模式
 */
drawBoardView.setDrawMode(drawMode)
/**
 * 设置画笔颜色
 */
drawBoardView.setPaintColor(paintColor)
/**
 * 设置画笔线条笔划宽度
 */
drawBoardView.setLineStrokeWidth(lineStrokeWidth)
/**
 * 设置橡皮擦笔划宽度
 */
drawBoardView.setEraserStrokeWidth(eraserStrokeWidth)
/**
 * 设置马赛克笔划宽度
 */
drawBoardView.setMosaicStrokeWidth(mosaicStrokeWidth)
/**
 * 通过代码进行绘制
 */
drawBoardView.draw(draw)
/**
 * 设置图片(画板背景图层)
 */
drawBoardView.setImageBitmap(bitmap)
/**
 * 获取结果图片(画板背景图层和画板图层合并后的图片)
 */
drawBoardView.getResultBitmap()

更多使用详情,请查看app中的源码使用示例或直接查看API帮助文档

相关推荐

  • ImageViewer 一个图片查看器,一般用来查看图片详情或查看大图时使用。