thumbnailUtil

来自于：AC模块工作室立即使用

Method

size transform clearCache

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码、知识点讲解、注意事项等，供您参考。

概述

thumbnailUtil封装了大图生成缩略图功能。使用者需要自定义裁剪尺寸,模块会将原始图片等比例放大或缩小至填满自定义尺寸，并以原始图片中心为中心点，将超出自定义尺寸之外的部分裁减掉。

size

获取原始图片尺寸

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

params

srcPath：

类型：字符串
描述：原始图片所在路径

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    w:                //原始图片宽度
    h:                  //原始图片高度
}

示例代码

 var demo = api.require('thumbnailUtil');
    demo.size({
        srcPath: 'widget://res/123.png',
    },function(ret, err){
        var msg = "宽" + ret.w + "高" + ret.h;
        api.toast({
            msg: msg
        });
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

transform

裁剪图片并返回

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

params

size：

类型：JSON 对象
描述：（可选项）图片裁剪尺寸
默认值：原始图片尺寸
内部字段：

{
    w:100,       //（可选项）数字类型；裁剪宽度；默认：原始图片宽度
    h:100        //（可选项）数字类型；裁剪高度；默认：原始图片高度
}

srcPath：

类型：字符串
描述：原始图片所在路径

destPath：

类型：字符串
说明：（可选项）裁剪图片保存路径
备注：若不传则默认保存到沙盒的Cache文件夹下的thumbnailUtil文件夹中。若传，则clearCache接口应保持一致

imgName：

类型：字符串
说明：（可选项）裁剪图片保存的名称
备注：若不传则默认以当前时间戳命名。

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    destPath:       //返回的裁剪图片保存路径
}

示例代码

var demo = api.require('thumbnailUtil');
    demo.transform({
        size: {
            w:1000,
            h:500
        },
        srcPath: 'widget://res/123.png',
    },function(ret, err){
        var msg = "路径" + ret.destPath;
        api.toast({
            msg: msg
        });
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

clearCache

清除裁剪图片保存路径的图片缓存

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

params

destPath：

类型：字符串
说明：（可选项）图片缓存的路径
备注：若不传则默认清除沙盒的Cache文件夹下的thumbnailUtil文件夹。若传，则transform接口应保持一致

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    status:                   //操作完成标记
}

示例代码

  var demo = api.require('thumbnailUtil');
    demo.clearCache(function(ret, err){
        var msg = "清理完成" + ret.status;
        api.toast({
            msg: msg
        });
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本