imageCutOut

来自于:开发者立即使用

概述

imageCutOut模块封装了 iOS、Android 原生图片剪切的功能。用户可以改变剪切框大小对图片进行剪切(注意:安卓和iOS的剪切框有差异,但是剪切效果一样)。

openCropView

打开剪切预览视图

openCropView({params}, callback(ret, err))

params

rect:

  • 类型:JSON 对象
  • 描述:(必填项)模块的位置及尺寸
  • 内部字段:
{
    x: 0,   //(必填项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认值:0
    y: 0,   //(必填项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认值:0
    w: 320, //(必填项)数字类型;模块的宽度;默认值:所属的 Window 或 Frame 的宽度
    h: 250  //(必填项)数字类型;模块的高度;默认值:250
}

fixedOn:

  • 类型:字符串
  • 描述:(可选项)模块所属 Frame 的名字,若不传则模块归属于当前 Window

fixed:

  • 类型:布尔型
  • 描述:(可选项)模块是否随所属 Window 或 Frame 滚动
  • 默认值:true(不随之滚动)

filePath:

  • 类型:字符串
  • 描述:(必填项)设置需要剪切的本地图片路径(支持fs:// widget://)[备注:安卓不支持widget路径]。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true,      //布尔型;true||false
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('imageCutOut');
demo.openCropView({
    rect : {
        x : 0,
       y : 100,
       w : api.frameWidth,
       h : api.frameHeight*2/3
     },
    fixedOn : api.frameName,
    fixed : true,
    filePath : 'widget://image/timg-3.jpeg'
},function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

hideCropView

隐藏预览剪切视图

hideCropView(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true      //布尔型;true||false
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('gridSlide');
demo.hideCropView(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

showCropView

显示预览剪切视图

showCropView(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true      //布尔型;true||false
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('gridSlide');
demo.showCropView(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

closeCropView

关闭预览剪切视图

closeCropView(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true      //布尔型;true||false
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('gridSlide');
demo.closeCropView(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

clipImage

剪切图片

clipImage(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true      //布尔型;true||false
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('gridSlide');
demo.clipImage(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本

saveImage

保存剪切的图片

saveImage(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true,      //布尔型;true||false
    imagePath : ''
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : '' //错误信息内容
}

示例代码

var demo = api.require('gridSlide');
demo.saveImage(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android、iOS系统

可提供的1.0.0及更高版本