imageTools

立即使用

概述

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

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

模块接口

compression

图片压缩,png图片会改变图片大小

compression({params},callback(ret))

params

path:

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

value:

  • 类型:数字
  • 描述:(可选项)压缩数值,iOS端不同图片会存在差异
  • 默认:0.5

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 及更高版本