imageClipTools

立即使用

clip getRoundBitmap getImageSize clearCache

概述

本模块封装了图片裁剪功能，本模块为纯功能性接口

模块接口

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

可用性

iOS系统，Android系统

可提供的 1.0.0 及更高版本