小程序画布生成图片wx.canvasToTempFilePath
wx.canvasToTempFilePath(Object object, Object this)
把当前画布指定区域的内容导出生成指定大小的图片。在 draw() 回调里调用该方法才能保证图片导出成功。
以 Promise 风格 调用:支持
小程序插件:支持,需要小程序基础库版本不低于 1.9.6
微信 Mac 版:支持
参数
Object object
属性 类型 默认值 必填 说明 最低版本
x number 0 否 指定的画布区域的左上角横坐标 1.2.0
y number 0 否 指定的画布区域的左上角纵坐标 1.2.0
width number canvas宽度-x 否 指定的画布区域的宽度 1.2.0
height number canvas高度-y 否 指定的画布区域的高度 1.2.0
destWidth number width*屏幕像素密度 否 输出的图片的宽度 1.2.0
destHeight number height*屏幕像素密度 否 输出的图片的高度 1.2.0
canvasId string 否 画布标识,传入 canvas 组件的 canvas-id
canvas Object 否 画布标识,传入 canvas 组件实例 (canvas type="2d" 时使用该属性)。
fileType string png 否 目标文件的类型 1.7.0
合法值 说明
jpg jpg 图片
png png 图片
quality number 否 图片的质量,目前仅对 jpg 有效。取值范围为 (0, 1],不在范围内时当作 1.0 处理。 1.7.0
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数(调用成功、失败都会执行)
object.success 回调函数
参数
Object res
属性 类型 说明
tempFilePath string 生成文件的临时路径 (本地路径)
Object this
在自定义组件下,当前组件实例的this,以操作组件内 canvas 组件
示例代码
wx.canvasToTempFilePath({
x: 100,
y: 200,
width: 50,
height: 50,
destWidth: 100,
destHeight: 100,
canvasId: 'myCanvas',
success(res) {
console.log(res.tempFilePath)
}
})