imageClipTools

概述

本插件封装了图片裁剪功能,本插件为纯功能性接口

插件接口

clip

图片裁剪

clip({params},callback(ret))

params

path:

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

rect:

  • 类型:JSON对象
  • 描述:(可选项)裁剪区域
{
      x: 0,    //(可选项)数字类型;裁剪区域 x 坐标(相对于所属的 Window 或 Frame);默认值:0
      y: 0,    //(可选项)数字类型;裁剪区域 y 坐标(相对于所属的 Window 或 Frame);默认值:0
      w: 50,  //(可选项)数字类型;裁剪区域宽(相对于所属的 Window 或 Frame);默认值:50
      h: 50,  //(可选项)数字类型;裁剪区域高(相对于所属的 Window 或 Frame);默认值:50
}

callback(ret)

ret:

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

示例代码

var imageClipTools = api.require('imageClipTools');
imageClipTools.clip({
  path:'',
  rect:{
    x: 0,
    y: 0,
    w: 50,
    h: 50,
  }
},function(ret){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

getRoundBitmap

获取圆角图片

getRoundBitmap({params},callback(ret))

params

path:

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

radius:

  • 类型:数字类型
  • 描述:图片圆角;(若不传,会返回圆形图片)

callback(ret)

ret:

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

示例代码

var imageClipTools = api.require('imageClipTools');
imageClipTools.getRoundBitmap({
  path:'',
},function(ret){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

getImageSize

获取图片大小

getImageSize({params},callback(ret))

params

path:

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

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    w:0, // 数字类型;图片宽度
    h:0  // 数字类型;图片高度
}

示例代码

var imageClipTools = api.require('imageClipTools');
imageClipTools.getImageSize({
  path:'',
},function(ret){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

clearCache

清除图片缓存(插件处理后的图片保存到了沙盒路径下,调用该接口可全部清除)

clearCache({params},callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true // 布尔类型;是否清空
}

示例代码

var imageClipTools = api.require('imageClipTools');
imageClipTools.clearCache(function(ret){
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

iOS系统,Android系统

可提供的 1.0.0 及更高版本

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