pictureWatermark

论坛示例

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

概述

pictureWatermark 是一个给图片添加水印的插件。支持给任意位置添加水印。可以满足开发者比如给自己的照片加版权,打水印等功能。

getPictureSize

获取原图的大小

getPictureSize({params}, callback(ret))

params

path:

  • 类型:字符串
  • 描述:需要添加水印的图片路径,要求本地路径( fs://、 widget://)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
   w:100,            //数字类型;图片的宽度
   h:100             //数字类型;图片的高度
}

示例代码

var pictureWatermark = api.require('pictureWatermark');
pictureWatermark.getPictureSize({

    path:'widget//:a.png'
    
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

mark

添加图片水印

mark({params}, callback(ret))

params

watermark:

  • 类型:JSON 对象
  • 描述:水印配置
  • 默认值:见内部字段
  • 内部字段:
 {
    rect: {                   //(可选项)JSON对象;水印的大小
         x: 0,                //(可选项)数字类型;水印左上角的 x 坐标(相对于所属的原始图片的位置);默认:0
         y: 0,                //(可选项)数字类型;水印左上角的 y 坐标(相对于所属的原始图片的位置);默认:0
         w:50,                //(可选项)数字类型;水印图片的宽度;默认:50
         h:30                 //(可选项)数字类型;水印图片的高度;默认:30
    },
    image: 'widget://b.png',  //(可选项)字符串类型;水印图标路径(本地路径,支持fs://、widget://);(不传则不添加)
    text:'',                  //(可选项)字符串类型;文字描述(不传则不添加)	
    textAttribute:{          //(可选项)JSON对象;水印文字
         point:{
             x:30,           //(可选项)数字类型;文字水印左上角的 x 坐标(相对于所属的原始图片的位置);默认:0
             y:30            //(可选项)数字类型;文字水印左上角的 y 坐标(相对于所属的原始图片的位置);默认:0
           },
        textSize:14,         //(可选项)数字类型;文字大小;默认:14
        textColor:'#fff'     //(可选项)字符串类型;文字颜色;默认:'#fff'
    },
    fileName:'name'          //(可选项) 字符串类型;保存的文件名 (仅支持iOS)
 }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
   status: true          //布尔类型;是否成功添加水印,true|false
   path:''               //字符串类型;添加水印成功后的图片的绝对路径; 仅当 status 为 true 时有效。
}

示例代码

var pictureWatermark = api.require('pictureWatermark');
            pictureWatermark.mark({
                watermark : {
                    rect : {
                        x : 200,
                        y : 200,
                        w : 50,
                        h : 30
                    },
                    image : 'widget://image/2.png'
                },
            }, function(ret, err) {
                if (ret) {
                    api.alert({msg: JSON.stringify(ret)});
                }
            });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

clearCache

清除本地缓存的水印图片,本接口只清除本插件缓存的数据,若要清除本 app 缓存的所有数据则调用 api.clearCache

clearCache()

示例代码

var pictureWatermark = api.require('pictureWatermark');
pictureWatermark.clearCache();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

论坛示例

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

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/31