# wx.canvasGetImageData(Object object, Object this)
基础库 1.9.0 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:支持
小程序插件:支持,需要小程序基础库版本不低于 1.9.6
相关文档: 画布指南、canvas 组件介绍
# 功能描述
获取 canvas 区域隐含的像素数据。
# 参数
# Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
canvasId | string | 是 | 画布标识,传入 canvas 组件的 canvas-id 属性。 | |
x | number | 是 | 将要被提取的图像数据矩形区域的左上角横坐标 | |
y | number | 是 | 将要被提取的图像数据矩形区域的左上角纵坐标 | |
width | number | 是 | 将要被提取的图像数据矩形区域的宽度 | |
height | number | 是 | 将要被提取的图像数据矩形区域的高度 | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# object.success 回调函数
# 参数
# Object res
属性 | 类型 | 说明 |
---|---|---|
width | number | 图像数据矩形的宽度 |
height | number | 图像数据矩形的高度 |
data | Uint8ClampedArray | 图像像素点数据,一维数组,每四项表示一个像素点的 rgba |
# Object this
在自定义组件下,当前组件实例的this,以操作组件内 canvas 组件
# 示例代码
wx.canvasGetImageData({
canvasId: 'myCanvas',
x: 0,
y: 0,
width: 100,
height: 100,
success(res) {
console.log(res.width) // 100
console.log(res.height) // 100
console.log(res.data instanceof Uint8ClampedArray) // true
console.log(res.data.length) // 100 * 100 * 4
}
})