这里有两种使用方法,一种是指定 ImageData 的宽和高,另外一种是使用 ImageData,通过它本身的宽高尺寸来构建新的对象。
Number width 使用像素描述 ImageData 的实际宽度
Number height 使用像素描述 ImageData 的实际高度
图片数据对象
Number width 使用像素描述 ImageData 的实际宽度
Number height 使用像素描述 ImageData 的实际高度
Uint8ClampedArray data 一维数组,包含以 RGBA 顺序的数据,数据使用 0 至 255(包含)的整数表示
const imageData1 = qg.createImageData(100, 100);
const imageData2 = qg.createImageData(imageData1);
创建一个图片对象
图片对象
图片的 URL
图片的真实宽度
图片的真实高度
图片加载完成后触发的回调函数
图片加载发生错误后触发的回调函数
保存图片到系统相册。
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
filePath | String | 是 | 图片文件路径,可以是临时文件路径或永久文件路径 (本地路径) ,不支持网络路径 | |
success | Function | 否 | 接口调用成功的回调函数 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
qg.saveImageToPhotosAlbum({
success(res) {}
});
从本地相册选择图片或使用相机拍照。
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
count | Number | 9 | 否 | 最多可以选择的图片张数 |
sizeType | Array | ['original', 'compressed'] | 否 | 所选的图片的尺寸 |
sourceType | Array | ['album', 'camera'] | 否 | 选择图片的来源 |
success | Function | 否 | 接口调用成功的回调函数 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
sizeType(所选的图片的尺寸)
合法值 | 说明 |
---|---|
original | 原图 |
compressed | 压缩图 |
sourceType(选择图片的来源)
合法值 | 说明 |
---|---|
album | 从相册选图 |
camera | 使用相机 |
属性 | 类型 | 说明 |
---|---|---|
tempFilePaths | Array | 图片的本地临时文件路径列表 (本地路径) |
tempFiles | Array | 图片的本地临时文件列表 |
tempFiles (图片的本地临时文件列表)
结构属性 | 类型 | 说明 |
---|---|---|
path | String | 本地临时文件路径 (本地路径) |
size | Number | 本地临时文件大小,单位 B |
qg.chooseImage({
count: 1,
sizeType: ["original", "compressed"],
sourceType: ["album", "camera"],
success(res) {
// tempFilePath可以作为img标签的src属性显示图片
const tempFilePaths = res.tempFilePaths;
}
});
在新页面中全屏预览图片。
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
urls | Array | 是 | 需要预览的图片链接列表。 | |
showmenu | Boolean | true | 否 | 是否显示长按菜单。 |
current | String | urls 的第一张 | 否 | 当前显示图片的链接 |
success | Function | 否 | 接口调用成功的回调函数 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
qg.previewImage({
current: "", // 当前显示图片的http链接
urls: [] // 需要预览的图片http链接列表
});
异步将二进制图像数据保存为本地临时图片文件。
object
属性 | 类型 | 是否必填 | 说明 |
---|---|---|---|
data | Uint8Array | 是 | 像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组 |
width | Number | 是 | 写入图片的宽度,最大宽度为 4096,单位 px。 |
height | Number | 是 | 写入图片的高度,最大高度为 4096,单位 px。 |
fileType | String | 是 | 写入图片的格式,支持的类形为 jpg、png |
reverse | Boolean | 否 | 是否需要将写入的数据按 y 轴反转,默认为 false |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数 |
success(res) 回调函数
属性 | 类型 | 说明 |
---|---|---|
tempFilePath | String | 保存完成后,本地临时文件路径 |
errMsg | String | 错误信息 |
qg.saveImageTemp({
data: data,
width: width,
height: height,
fileType: "png",
reverse: true,
success: function(res) {
qg.saveImageToPhotosAlbum({
filePath: res.tempFilePath,
success: successCb,
fail: function(res) {}
});
},
fail: function(res) {}
});
同步将二进制图像数据保存为本地临时图片文件。
属性 | 类型 | 是否必填 | 说明 |
---|---|---|---|
data | Uint8Array | 是 | 像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组 |
width | Number | 是 | 写入图片的宽度,最大宽度为 4096,单位 px。 |
height | Number | 是 | 写入图片的高度,最大高度为 4096,单位 px。 |
fileType | String | 是 | 写入图片的格式,支持的类行为 jpg、png |
reverse | Boolean | 否 | 是否需要将写入的数据按 y 轴反转,默认为 false |
String
保存完成后,本地临时文件路径
var result = qg.saveImageTempSync({
data: [],
width: 666,
height: 666,
fileType: "jpg",
reverse: false
});
PNG、JPG、TIFF、WEBP、PVG、ETC、S3TC、CCImage