thumbnailUtil

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

概述

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及更高版本