imageTools

立即使用

compression orientation cornerRadius changeSize compressLocalImage

概述

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

注意：本模块仅支持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

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
      status:true,            //布尔类型；是否成功，true|false
    base64str:'' //字符串类型；图片 base64 字符串
}

示例代码

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

可用性

iOS系统，Android系统

可提供的 1.0.5 及更高版本