imageFilter原生插件封装了对图片按照指定效果过滤的功能,过滤后的图片可保存到指定目录
打开图片过滤器
open ({params}, callback(ret, err))
imgPath:
ret:
{
status: //操作成功状态值
id: //打开图片对象的id
}
err:
{
code: //错误描述,取值范围如下:
-1: //未知错误
0: //imgPath为空
1: //imgPath路径下的图片不存在
2: //图片读取失败
3:
}
var imageFilter = api.require('imageFilter');
imageFilter.open({
imgPath: 'widget://res/img/yonbuilder.png'
},function( ret, err ){
if( ret.status ){
alert( JSON.stringify( ret ) );
}else{
alert( JSON.stringify( err ) );
}
});
iOS系统,Android系统
可提供的1.0.0及更高版本
设置图片滤镜效果
filter({params}, callback(ret, err))
type:
value:
id:
ret:
{
status: //操作成功状态值
path: //初步滤镜后的缩略图图片路径,字符串类型缩略图大小为50*50
}
err:
{
code: //错误描述,取值范围如下:
-1: //未知错误
0: //type不支持
1: //value非法
2: //id不存在
}
var imageFilter = api.require('imageFilter');
imageFilter.filter({
id: 1,
type: 'autumn'
},function( ret, err ){
if( ret.status ){
alert( JSON.stringify( ret ) );
}else{
alert( JSON.stringify( err ) );
}
});
iOS系统,Android系统
可提供的1.0.0及更高版本
保存最终处理结果
save({params}, callback(ret, err))
album:
imgPath:
imgName:
id:
ret:
{
status: //操作成功状态值
}
err:
{
code: //错误描述,取值范围如下:
-1://未知错误
0://保存到相册失败,无权限访问系统相册
1://保存到指定路径失败,无指定保存路径
2://id不存在
}
var imageFilter = api.require('imageFilter');
imageFilter.save(function( ret, err ){
if( ret.status ){
alert( JSON.stringify( ret ) );
}else{
alert( JSON.stringify( err ) );
}
});
iOS系统,Android系统
可提供的1.0.0及更高版本
图片压缩处理
compress({params}, callback(ret, err))
img:
isClarityimg:
quality:
scale:
size:
{
w: //压缩后的图片的宽,数字类型,无默认值
h: //压缩后的图片的高,数字类型,无默认值
}
save:
{
album: //(可选项)布尔值,是否保存到系统相册,默认false
imgPath: //(可选项)保存的文件路径,字符串类型,无默认值,不传或传空则不保存,若路径不存在文件夹则创建此目录
imgName: //(可选项)保存的图片名字,支持png和jpg格式,若不指定格式,则默认png,字符串类型,无默认值,不传或传空则不保存
}
ret:
{
status: //操作成功状态值
}
err:
{
code: //错误描述,取值范围如下:
-1://未知错误
0:// 保存到相册失败
1:// 保存到指定路径失败
2:// 保存到相册和指定路径失败
3: // 压缩图片路径不存在
}
var imageFilter = api.require('imageFilter');
imageFilter.compress({
img: 'widget://res/img/yonbuilder.png',
quality: 0.1
},function( ret, err ){
if( ret.status ){
alert( JSON.stringify( ret ) );
}else{
alert( JSON.stringify( err ) );
}
});
iOS系统,Android系统
可提供的1.0.0及更高版本
获取指定路径下的图片信息
getAttr({params}, callback(ret, err))
path:
ret:
{
status: //布尔类型;操作成功状态值
width: //数字类型;获取的图片的宽
height: //数字类型;获取的图片的高
size: //数字类型;获取的图片文件的大小,单位:byte
}
var imageFilter = api.require('imageFilter');
imageFilter.getAttr({
path: 'widget://res/img/yonbuilder.png'
},function( ret, err ){
if( ret.status ){
alert( JSON.stringify( ret ) );
}else{
alert( JSON.stringify( err ) );
}
});
iOS系统,Android系统
可提供的1.0.0及更高版本
图片过滤的效果类型。字符串类型
android特有效果:
ios特有效果: