接入指南 API 工具 其他

图片

qg.createImageData(Number width, Number height)

这里有两种使用方法,一种是指定 ImageData 的宽和高,另外一种是使用 ImageData,通过它本身的宽高尺寸来构建新的对象。

参数

Number width 使用像素描述 ImageData 的实际宽度

Number height 使用像素描述 ImageData 的实际高度

返回值 ImageData

图片数据对象

属性

Number width 使用像素描述 ImageData 的实际宽度

Number height 使用像素描述 ImageData 的实际高度

Uint8ClampedArray data 一维数组,包含以 RGBA 顺序的数据,数据使用 0 至 255(包含)的整数表示

示例代码

const imageData1 = qg.createImageData(100, 100);
const imageData2 = qg.createImageData(imageData1);

Image qg.createImage()

创建一个图片对象

返回值 Image

图片对象

属性

String src

图片的 URL

Number width

图片的真实宽度

Number height

图片的真实高度

Function onload

图片加载完成后触发的回调函数

Function onerror

图片加载发生错误后触发的回调函数

qg.saveImageToPhotosAlbum(Object object)

保存图片到系统相册。

参数

Object object

属性类型默认值必填说明
filePathString图片文件路径,可以是临时文件路径或永久文件路径 (本地路径) ,不支持网络路径
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

qg.saveImageToPhotosAlbum({
  success(res) {}
});

qg.chooseImage(Object object)

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

参数

Object object

属性类型默认值必填说明
countNumber9最多可以选择的图片张数
sizeTypeArray['original', 'compressed']所选的图片的尺寸
sourceTypeArray['album', 'camera']选择图片的来源
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

sizeType(所选的图片的尺寸)

合法值说明
original原图
compressed压缩图

sourceType(选择图片的来源)

合法值说明
album从相册选图
camera使用相机
object.success(Object res) 回调函数
属性类型说明
tempFilePathsArray图片的本地临时文件路径列表 (本地路径)
tempFilesArray图片的本地临时文件列表

tempFiles (图片的本地临时文件列表)

结构属性类型说明
pathString本地临时文件路径 (本地路径)
sizeNumber本地临时文件大小,单位 B

示例代码

qg.chooseImage({
  count: 1,
  sizeType: ["original", "compressed"],
  sourceType: ["album", "camera"],
  success(res) {
    // tempFilePath可以作为img标签的src属性显示图片
    const tempFilePaths = res.tempFilePaths;
  }
});

qg.previewImage(Object object)

在新页面中全屏预览图片。

参数

Object object

属性类型默认值必填说明
urlsArray需要预览的图片链接列表。
showmenuBooleantrue是否显示长按菜单。
currentStringurls 的第一张当前显示图片的链接
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

qg.previewImage({
  current: "", // 当前显示图片的http链接
  urls: [] // 需要预览的图片http链接列表
});

qg.saveImageTemp(Object)

异步将二进制图像数据保存为本地临时图片文件。

参数

object

属性类型是否必填说明
dataUint8Array像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组
widthNumber写入图片的宽度,最大宽度为 4096,单位 px。
heightNumber写入图片的高度,最大高度为 4096,单位 px。
fileTypeString写入图片的格式,支持的类形为 jpg、png
reverseBoolean是否需要将写入的数据按 y 轴反转,默认为 false
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数

success(res) 回调函数

属性类型说明
tempFilePathString保存完成后,本地临时文件路径
errMsgString错误信息

示例代码

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) {}
});

qg.saveImageTempSync(Object)

同步将二进制图像数据保存为本地临时图片文件。

参数

属性类型是否必填说明
dataUint8Array像素数据,数据类型为 RGBA8888 格式的 Uint8Array 数组
widthNumber写入图片的宽度,最大宽度为 4096,单位 px。
heightNumber写入图片的高度,最大高度为 4096,单位 px。
fileTypeString写入图片的格式,支持的类行为 jpg、png
reverseBoolean是否需要将写入的数据按 y 轴反转,默认为 false

返回值

String

保存完成后,本地临时文件路径

示例代码

var result = qg.saveImageTempSync({
  data: [],
  width: 666,
  height: 666,
  fileType: "jpg",
  reverse: false
});

支持的 image 的图片格式

PNG、JPG、TIFF、WEBP、PVG、ETC、S3TC、CCImage

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容