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){
    api.alert({
            msg: 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){
    api.alert({
            msg: 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){
    api.alert({
            msg: 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){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

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