canvas绘制图片小程序

canvas drawer

源码下载地址:

连接: https://pan.baidu.com/s/1GxnM6XHRpm_sZjpmbbEzqA 提取码: 5s6y 

新增 mpvue_canvas_drawer。以后同步更新。

新增由simmzl开发移植的wepy_canvas_drawer。以后同步更新。

作微信小程序中最好用的 canvas 绘图组件之一。

当前环境下，你们都很是须要分享到朋友圈这个功能，可是实现起来各有心酸（坑比较多），因此才有了以下的 canvas 绘图工具。

具备以下特性：

• 简单易用 —— 一个 json 搞定绘制图片
• 功能全 —— 知足 90% 的使用场景
  • 绘制文本（换行、超出内容省略号、中划线、下划线、文本加粗）
  • 绘制图片
  • 绘制矩形
  • 保存图片
  • 多图绘制
  • ...
• 代码量小

体验

git clone https://github.com/kuckboy1994/mp_canvas_drawer

想在手机上使用配置本身的 appid 便可。

编译模式中已经为你配置比如较经常使用的两种模式：

• 普通绘制，绘制单张分享图。
• 多图绘制，连续绘制分享图

演示

左侧是 canvasdrawer 绘制的，右侧是UI给的图

使用

• git clone https://github.com/kuckboy1994/mp_canvas_drawer 到本地

• 把 components 中的 canvasdrawer 拷贝到本身项目下。

• 在使用页面注册组件

  {
    "usingComponents": {
      "canvasdrawer": "/components/canvasdrawer/canvasdrawer"
    }
  }

• 在页面 **.wxml 文件中加入以下代码

  <canvasdrawer painting="{{painting}}" bind:getImage="eventGetImage"/>

  painting 是须要传入的 json。 getImage 方法是绘图完成以后的回调函数，在 event.detail 中返回绘制完成的图片地址。

• 当前栗子中的 painting 简单展现一下。详细配置请看 API

  painting（点击展开）

API

对象结构一览

数据对象的第一层须要三个参数: width、height、mode、views。配置中全部的数字都是没有单位的。这就意味着 canvas 绘制的是一个比例图。具体显示的大小直接把返回的图片路径放置到 image 标签中便可。

mode 可选值有 same, 默认值为空，常规下尽可能不要使用。如要使用请看 Q&A的第1点。

当前能够绘制3种类型的配置: image、text、rect。配置的属性基本上使用的都是 css 的驼峰名称，仍是比较好理解的。

image（图片）

属性	含义	默认值	可选值
url	绘制的图片地址，能够是本地图片，如：/images/1.jpeg
top	左上角距离画板顶部的距离
left	左上角距离画板左侧的距离
width	要画多宽	0
height	要画多高	0

text（文本）

属性	含义	默认值	可选值
content	绘制文本	''（空字符串）
color	颜色	black
fontSize	字体大小	16
textAlign	文字对齐方式	left	center、right
lineHeight	行高，只有在多行文本中才有用	20
top	文本左上角距离画板顶部的距离	0
left	文本左上角距离画板左侧的距离	0
breakWord	是否须要换行	false	true
MaxLineNumber	最大行数，只有设置 breakWord: true ，当前属性才有效，超出行数内容的显示为...	2
width	和 MaxLineNumber 属性配套使用，width 就是达到换行的宽度
bolder	是否加粗	false	true
textDecoration	显示中划线、下划线效果	none	underline（下划线）、line-through（中划线）

rect (矩形，线条)

属性	含义	默认值	可选值
background	背景颜色	black
top	左上角距离画板顶部的距离
left	左上角距离画板左侧的距离
width	要画多宽	0
height	要画多高	0

Q&A

1. 最佳实践

   绘制操做的时候最好 锁住屏幕 ，例如在点击绘制的时候

   wx.showLoading({
     title: '绘制分享图片中',
     mask: true
   })

   绘制完成以后

   wx.hideLoading()

   具体能够参考项目下的 /pages/multiple

2. [mpvue] 因为 canvasdrawer 不主动呈现绘制内容，而是交给调用者去使用 image 来展现，因此在mpvue更新数据就会render整个组件的，以后 canvasdrawer 又会从新被渲染，致使无限循环，因此默认状况下我把代码改成，传入的 painting 和以前的同样的话，组件就不渲染了。只有出现差别的内容才会更新（触发回调），这种我的认为仍是能够接受的。 增长顶层参数 mode, mode: 'same' 为能够绘制一样的内容。在 mpvue 模式下勿用。

3. 二维码和小程序码如何绘制？

   • 二维码和小程序码能够经过调用微信官方的接口产生，须要后端配合。
   • 而后走 type: image 类型进行绘制便可。

4. 绘制流程相关

   • views 数组中的顺序表明绘画的前后顺序，会有覆盖的现象。请各位使用者注意。

5. 如何实现圆形头像？

   • 因为完成一些效果，例如： 文字下划线 等。必需要使用微信小程序 rect 相关的接口，和 clip 接口感受相处的很差（存在bug）。能够查看 微信小程序社区的帖子。
   • so，提供一种解决方式：使用一张中间镂空的图片盖在头像上。

6. canvas drawer 组件为何不直接显示canvas画板和其内容呢？

   • 考虑到大部分场景，咱们都是用来把图片保存到本地，或用以展现。
   • 保存到本地，返回临时文件给调用者必定是最佳的解决方式。
   • 展现，转化成图片以后，就可使用 image 基础组件的全部显示模式了，还能设置宽高。