imageTools

立即使用

概述

本模块封装了图片操作功能,可以对图片进程压缩、旋转、设置圆角和改变大小

注意:本模块仅支持jpg、png格式图片,其他格式图片输出图片会改变其格式

模块接口

compression

图片压缩,png图片会改变图片大小。Android端1.0.4版本压缩jpg采用鲁班压缩,压缩会改变原图的分辨率

compression({params},callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,支持fs、widget

value:

  • 类型:数字
  • 描述:(可选项)压缩数值,iOS端不同图片会存在差异
  • 默认:0.5
  • 注意:Android端1.0.4版本后压缩jpg图片时传此参数无效

fileType:

  • 类型:string
  • 描述:压缩后图片类型,支持png、jpeg、jpg
  • 默认:jpeg

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    path:'' //字符串类型;图片本地路径
}

示例代码

var imageTools = api.require('imageTools');
imageTools.compression({
    path:''
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

orientation

图片旋转

orientation({params},callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,支持fs、widget

value:

  • 类型:数字
  • 描述:(可选项)旋转方向
  • 默认:2
  • 取值范围
  • 0:图片的正常状态
  • 1:图片被翻转180°
  • 2:图片被逆时针翻转90°
  • 3:表示图片被顺时针翻转90°
  • 4:图片的正常状态的镜面图像
  • 5:图片被翻转180°后的镜面图像
  • 6:图片被逆时针翻转90°后的镜面图像
  • 7:图片被顺时针翻转90°后的镜面图像

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    path:'' //字符串类型;图片本地路径
}

示例代码

var imageTools = api.require('imageTools');
imageTools.orientation({
    path:''
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

cornerRadius

设置图片圆角

cornerRadius({params},callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,支持fs、widget

value:

  • 类型:数字
  • 描述:(可选项)圆角大小
  • 默认:5
  • 注意:Android系统设置圆角只支持返回png格式的图片

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    path:'' //字符串类型;图片本地路径
}

示例代码

var imageTools = api.require('imageTools');
imageTools.cornerRadius({
  path:''
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

changeSize

改变图片大小

changeSize({params},callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,支持fs、widget

size:

  • 类型:JSON对象
  • 描述:(可选项)图片长宽
{

      w: 100,  //(可选项)数字类型;播放画面宽(相对于所属的 Window 或 Frame);默认值:100
      h: 100,  //(可选项)数字类型;播放画面高(相对于所属的 Window 或 Frame);默认值:100
}

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    path:'' //字符串类型;图片本地路径
}

示例代码

var imageTools = api.require('imageTools');
imageTools.changeSize({
  path:''
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

compressLocalImage

图片压缩(不支持 gif 压缩)

compressLocalImage({params},callback(ret))

params

imgData:

  • 类型:字符串
  • 描述:图片地址或 base64 数据,支持fs、widget

type:

  • 类型:数字
  • 描述:(可选项)图片数据类型(0 或 1);0:图片 base64 数据,1:图片路径
  • 默认:0

level:

  • 类型:数字
  • 描述:(可选项)压缩的级别,支持 0 ~ 3 的整数;0:不压缩1:低质量,2:中质量,3:高质量
  • 默认:2

quality:

  • 类型:数字
  • 描述:(可选项)压缩的质量,取值范围 0 ~ 100
  • 默认:60

isBackBase64:

  • 类型:布尔
  • 默认值:true
  • 描述:(可选项)是否返回base64数据

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,        //布尔类型;是否成功,true|false
    base64str:'',       //字符串类型;图片 base64 字符串
    size:,              //数字类型;图片文件的大小,单位:字节
    path:               //字符串类型,压缩后的图片路径
}

示例代码

var imageTools = api.require('imageTools');
imageTools.compressLocalImage({
    imgData:''
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的 1.0.5 及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/10/21