小程序 canvas 生成海报 一次搞掂

14,570 阅读10分钟

小程序 canvas 生成海报 - 解决屏幕图片失真,解决无法使用外网图片

源代码在最下方

最终结果

2019-04-30090218

canvas(画布) 元素用于在网页上绘制图形。画布是一个矩形区域,您可以控制其每一像素。canvas 拥有多种绘制路径、矩形、圆形、字符以及添加图像的方法。

注意

需要注意的是,目前的canvas可以简单分为两种。一种是传统网页中的canvas,一种是小程序中的canvas。两者的功能是完全一样的。只是标签的样式,和 api 略有区别而已。目前我们主要讲解小程序中的canvas。

canvas 的应用场景

  1. 在线游戏

  2. 在线图表

  3. 页面特效

  4. 广告

  5. 图片合成 小程序中常见

    1. 点我加速


      141e77ea75e046709e45115209ba7d9
    2. 头像红旗


      u=1152834417,249646381&fm=11&gp=0

    3. 海报日历


      ceeedd30772bdcbe211c7852f701a4a
    4. 其他


    1569634970242

简单体验

我们来画一条直线

在canvas中,把画直线的步骤分解为以下几步:

  1. 编写标签
  2. 获取画布实例
  3. 定起点
  4. 连接终点
  5. 连线 (也叫描边)
  6. 上色

编写标签

默认的宽高 为 300px * 150 px

不同于普通的标签,必须要提供一个属性 canvas-id,用于在 js中获取该对象(不是dom对象!!!)

<canvas canvas-id="firstCanvas"></canvas>

获取画布实例

通过 canvas-id 来获取

该实例 不是dom元素,可以理解为另一种对象如 Math Date String等即可

index.js

Page({
  onLoad() {
    // 1 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    console.log(context);
  }
})

点起点

在canvas中,存在一个坐标系 如下图:

我们在canvas中所讲的坐标都是相对于canvas内部坐标而言

绘图1

定个起点

    // 定起点
    context.moveTo(10, 10);

定终点

	// 定终点
	context.lineTo(300,150);

连线

	// 连线
    context.stroke();

上色

    // 上色
    context.draw();

完整代码

index.wxml

<!-- 1 写标签 -->
<canvas canvas-id="firstCanvas"></canvas>

index.js

Page({
  onLoad() {
    // 2 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    // 3 定起点
    context.moveTo(10, 10);
    // 4 定终点
    context.lineTo(300,150);
    // 5 连线
    context.stroke();
    // 6 上色
    context.draw();
  }
})

效果

1569657291546

内置的其他规则图形

canvas中还封装了画规则图形的方法,如:

  1. 画空心的矩形

  2. 画圆弧

  3. 画实心的矩形

  4. 画文字(把字符串画上去)

画矩形

CanvasContext.strokeRect(number x, number y, number width, number height)

CanvasContext.strokeRect(画在画布的X,画在画布的Y,画多宽,画多高)

    // 1 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    // 2 调用canvas内置的画“矩形”的方法
    context.strokeRect(10, 10, 100, 100);
    // 3 上色 
    context.draw();

效果

1569657340868

画圆弧

CanvasContext.arc(number x, number y, number r, number sAngle, number eAngle, boolean counterclockwise)

CanvasContext.arc(圆心的横坐标X,圆心的纵坐标Y, 半径的长度, 开始的弧度, 结束的弧度, ?是否反向来画)

代码

  drawArc() {
    // 1 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    // context.arc(圆心的横坐标X,圆心的纵坐标Y, 半径的长度, 开始的弧度, 结束的弧度);
    // 2 调用内置的画 “圆弧” 的方法
    context.arc(100, 100, 100, this.angleToArc(0), this.angleToArc(90));
    // 3 开始描边
    context.stroke();
    // 4 上色
    context.draw();
  },
  /**
   * 将角度转为弧度
   * @param {number} angle 角度
   */
  angleToArc(angle) {
    return angle * Math.PI / 180;
  }

效果

1569657957559

画实心的矩形

CanvasContext.fillRect(number x, number y, number width, number height)

    // 1 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    // 2 调用canvas内置的 画填充 “矩形”的方法
    context.fillRect(10, 10, 100, 100);
    // 3 上色 
    context.draw();

效果

1569658217231

画文字

CanvasContext.strokeText(string text, number x, number y, number maxWidth)

CanvasContext.strokeText(要绘制的文本, 文本起始点的 x 轴坐标, number y, 需要绘制的最大宽度,可选)

代码

    // 1 获取画布上下文对象
    const context = wx.createCanvasContext("firstCanvas");
    // 2 画 “文字”
    context.strokeText("hello world", 100, 100);
    // 3 上色 
    context.draw();

效果

1569658659539


设置样式

经过以上的演示我们也发现,线条的颜色一直是黑色,这肯定是无法满足我们骚跳的心的。现在来学习一下关于设置canvas线条样式相关API。

  1. 设置线条颜色
  2. 设置线条粗细
  3. 设置填充颜色
  4. 设置文本大小

设置线条颜色

**特别要注意 **,setStrokeStyle是个函数,1.9.90版本后停止维护,使用以下的方式来修改。

  1. CanvasContext.setStrokeStyle("red") 已过时,不推荐
  2. CanvasContext.strokeStyle="red"; 正解

代码

    const context = wx.createCanvasContext("firstCanvas");
    context.moveTo(10, 10);
    context.lineTo(300, 150);
    // 5 修改颜色 需要在stroke之前修改
    context.strokeStyle = "red";
    context.stroke();
    context.draw();

效果

1569663241332


设置线条粗细

**特别要注意 **,setLineWidth 是个函数,1.9.90版本后停止维护,使用以下的方式来修改。

  1. CanvasContext.setLineWidth(20) 已过时,不推荐
  2. CanvasContext.lineWidth=20; 正解

代码

    const context = wx.createCanvasContext("firstCanvas");
    context.moveTo(10, 10);
    context.lineTo(300, 150);
    // 设置线条宽度
    context.lineWidth = 20;
    context.stroke();
    context.draw();

效果

1569663745450


设置填充颜色

**特别要注意 **,setFillStyle 是个函数,1.9.90版本后停止维护,使用以下的方式来修改。

  1. CanvasContext.setFillStyle("red") 已过时,不推荐
  2. CanvasContext.fillStyle="red"; 正解

代码

    const context = wx.createCanvasContext("firstCanvas");
    // 设置填充颜色
    context.fillStyle = "red";
    context.fillRect(10, 10, 100, 100);
    context.draw();

效果

1569663956116


设置文本大小

**特别要注意 **,setFontSize 是个函数,1.9.90版本后停止维护,使用以下的方式来修改。

  1. CanvasContext.setFontSize("20") 已过时,不推荐
  2. CanvasContext.font="sans-serif"; 正解
  3. font 当前字体样式的属性。符合 CSS font 语法 的 DOMString 字符串,至少需要提供字体大小和字体族名。默认值为 10px sans-serif。

代码

    const context = wx.createCanvasContext("firstCanvas");
    // 必须要同时提供 字号 和 字体
    context.font="10px  sans-serif";
    context.strokeText("10px", 10, 10);
    // 必须要同时提供 字号 和 字体
    context.font="50px  sans-serif";
    context.strokeText("50px", 50, 100);
    // 必须要同时提供 字号 和 字体
    context.font="80px  sans-serif";
    context.strokeText("80px", 80, 180);
    context.draw();

效果

1569664436438

进阶

在本环节主要讲解稍微复杂一点的功能。要实现以下功能

但是需要先做一点技术铺垫

主要用到的api有:

  1. 获取系统信息
  2. 选择相册图片
  3. 获取网络图片信息
  4. canvas 描绘 图片到画布上
  5. 将画布保存成一张图片
  6. 将图片下载到本地

1569678652709

基本API

以下api是实现以上案例所必须的

获取系统信息

获取屏幕大小、设备像素比等

代码

wx.getSystemInfo({
  success (res) {
    console.log(res.model)
    console.log(res.pixelRatio)
    console.log(res.windowWidth)
    console.log(res.windowHeight)
    console.log(res.language)
    console.log(res.version)
    console.log(res.platform)
  }
})

选择相册图片

从本地相册选择图片或使用相机拍照

代码

wx.chooseImage({
  count: 1,// 最多可以选择的图片张数
  sizeType: ['original', 'compressed'],// 所选的图片的尺寸
  sourceType: ['album', 'camera'],//  选择图片的来源
  success (res) {
    // tempFilePath可以作为img标签的src属性显示图片
    const tempFilePaths = res.tempFilePaths
  }
})

代码

wx.getSystemInfo({
  success (res) {
    console.log(res.model)
    console.log(res.pixelRatio)
    console.log(res.windowWidth)
    console.log(res.windowHeight)
    console.log(res.language)
    console.log(res.version)
    console.log(res.platform)
  }
})

获取网络图片信息

获取图片信息。网络图片需先配置download域名才能生效。

canvas提供了将图片画到画布上的功能,但是要求所提供的图片必须是外网下的图片

因此可以借助该方法将网络图片变成本地图片,同时返回该图片的信息

代码

wx.getImageInfo({
  src: 'cloud://c-73e071.632d-c-73e071/92637.jpg',
  success (res) {
    console.log(res.width)
    console.log(res.height)
  }
})

绘制图像到画布

不能使用本地图片,要使用外网图片的 必须要先 使用 wx.getImageInfo 下载到本地

有三个版本的写法:

  • drawImage(imageResource, dx, dy)
  • drawImage(imageResource, dx, dy, dWidth, dHeight)
  • drawImage(imageResource, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight)
  • 说明drawImage(图片路径, 原图的x, 原图的y, 原图的宽度, 原图的高度, 画布的x, 画布的y, 画多宽, 画多高)

代码

context.drawImage('xxxx.jpg', 0, 0,100, 100);

将画布保存成一张图片

draw() 回调里调用该方法才能保证图片导出成功

代码

wx.canvasToTempFilePath({
  x: 100,
  y: 200,
  width: 50,
  height: 50,
  destWidth: 100,
  destHeight: 100,
  canvasId: 'myCanvas',
  success(res) {
    console.log(res.tempFilePath)
  }
})

将图片下载到本地

保存图片到系统相册

代码

wx.saveImageToPhotosAlbum({
  success(res) { }
})

案例实现

其实要实现一样案例,最麻烦的不是这些API的调用,而是如何根据不同的图片,合成比例合适不模糊的图片

为什么说比例合适

因为在canvas中,只支持 px 单位,那么在使用javascript来描绘图片时,就不存在 rpxvw%这些相对单位了。只能依靠手动来计算。如,在 canvas中,画出一个大小为 屏幕宽的一半 屏幕高的一半的矩形?

为什么说不模糊

问题的原因还是因为 手机的屏幕 都是高清屏,具体的原因可以参照 链接

如我们想要生成图片大小为 100px * 100px,那么就需要将 canvas的大小设置为 width = 图片的宽度 * 设备像素比

height = 图片的高度 * 设备像素比

文件目录

  1. index 首页
  2. result 合成图片的页面

1569681221628

首页 index

index

1569681395410

pages/index/index.wxml

<!-- 用来显示 被选择的图片的 -->
<image mode="widthFix" src="{{src}}"></image>
<!-- 选择相册图片 -->
<button bindtap="handleTap">选择图片</button>
<!-- 跳转到 结果页面 -->
<button bindtap="handleCreateFlag">生成小红旗</button>

pages/index/index.js

主要实现3个功能

  1. 点击 “选择图片” 将选择的图片打印到页面上
  2. 将被 选择的图片 显示的页面上
  3. 点击 “生成红旗”,跳转到结果页面(在结果页面完成生成)
Page({
  data: {
    src: ""
  },
  // 选择图片
  handleTap() {
    wx.chooseImage({
      count: 1,
      sizeType: ['original', 'compressed'],
      sourceType: ['album', 'camera'],
      success: (result) => {
        this.setData({
          src: result.tempFilePaths[0]
        })
        // 保存图片路径
        wx.setStorageSync('src', this.data.src);
      }
    });
  },
  // 生成红旗
  handleCreateFlag() {
    // 跳转到结果页面
    wx.navigateTo({
      url: '/pages/result/index'
    });
  }
})

结果页面 result

result

1569681567259

result/index.wxml

3个标签

  1. canvas 标签,通过定位将其隐藏
  2. image 标签,用来显示合成的图片
  3. button 标签,用来点击 下载图片
<!-- canvas 标签-->
<canvas class="cas" style="width:{{canvasWidth}};height:{{canvasHeight}};" canvas-id="firstCanvas"></canvas>
<!-- 用来显示 合成成功的图片 -->
<image class="res_image" mode="widthFix" src="{{resSrc}}"></image>
<!-- 点击下载图片 -->
<button bindtap="handleSave">下载图片</button>

result/index.wxss

两个样式

  1. 把canvas藏起来(因为是 原生组件,所以它的层级比一般的标签都要高(定位+zindex也无法解决))
  2. 设置图片标签的样式
page {
  overflow-x: hidden;
  overflow-y: auto;
  width: 100vw;
  height: 100vh;
}
.cas {
  position: absolute;
  top: 1000vw;
  left: 1000vh;
  z-index: -1;
  opacity: 0;
}
.res_image {
  width: 100%;
  display: block;
}

result/index.js

易错点:

  1. 外网的图片,需要先将图片服务器添加到白名单中(否则真机调试会失败)
  2. 没有动态设置 canvas的宽和高(参照第29、31行)

import regeneratorRuntime from '../../lib/runtime/runtime';
import { getImageInfo, canvasToTempFilePath, saveImageToPhotosAlbum } from "../../wxAsync/index.js";
Page({
  data: {
    // 默认的canvas的宽度
    canvasWidth: 1,
    // 默认的canvas高度
    canvasHeight: 1,
    // 最终生成的图片路径
    resSrc: ""
  },
  // 全局变量
  saveImgSrc: "",
  async onLoad() {
    // 红旗图片
    const flagSrc = "https://632d-c-73e071-1252056196.tcb.qcloud.la/3434.jpg?sign=a4f1c2106d1e61551829c2f99820c0ba&t=1569678566";
    // const baseSrc = "https://632d-c-73e071-1252056196.tcb.qcloud.la/92637.jpg?sign=8952d1eaa69a35510418fe25dc25d6c5&t=1569678606";
    // 上个页面选择的图片路径 柯南图片
    const baseSrc = wx.getStorageSync("src");
    // 设备像素比
    const { pixelRatio } = wx.getSystemInfoSync();

    // 获取 画布实例
    const context = wx.createCanvasContext('firstCanvas');
    console.log(context);
    // 下载到本地的 柯南图片
    const baseImg = await getImageInfo(baseSrc);
    // 下载到本地的 红旗图片
    const flagImg = await getImageInfo(flagSrc);
    // 将canvas的宽度设置中 图片的宽度
    const canvasWidth = baseImg.width + "px";
    // 将canvas的宽度设置中 图片的高度
    const canvasHeight = baseImg.height + "px";
    //  setData 函数用于将数据从逻辑层发送到视图层(异步),同时改变对应的 this.data 的值(同步)。
    // 因此需要将 描绘 图片的步骤写在回调中,否则 真机调试有bug!
    this.setData({ canvasWidth, canvasHeight }, () => {
      // 如果个别机型出现图片失败错误,可以加上定时器。
      setTimeout(() => {
        // 先将柯南 描绘到画布上
        context.drawImage(baseImg.path, 0, 0, baseImg.width, baseImg.height);
        // 把红旗 描绘到画布上
        context.drawImage(flagImg.path, baseImg.width - (pixelRatio * 50), baseImg.height - (pixelRatio * 50), (pixelRatio * 50), (pixelRatio * 50));
        context.draw(true, async () => {
          // 将 画布生成 成图片
          const res1 = await canvasToTempFilePath({
            canvasId: "firstCanvas"
          });
          // 让图片显示 合成后的效果
          this.setData({ resSrc: res1.tempFilePath })
          // 保存起来,当点击保存图片时调用
          this.saveImgSrc = res1.tempFilePath;
        });
      }, 100);
    });
  },

  // 点击保存图片
  handleSave() {
    saveImageToPhotosAlbum(this.saveImgSrc);
  }
})

github地址

https://github.com/itcastWsy/AppletPoster.git