picturesgraffiti


图片涂鸦插件。自定义涂鸦笔像素、颜色,涂鸦完成后可保存图片至本地,涂鸦插件支持手势对图片的缩放和移动。得到PicturesGraffiti调用对象:

     var picturesGraffiti = rd.require('picturesgraffiti');

方法

回调方法:

图片涂鸦全局回调状态(Number):

  • savepicstart: 开始保存图片,数值为0
  • savepicsuccess: 保存图片成功,数值为1
  • savepicfail: 保存图片失败,数值为2
  • picnotexit: 涂鸦加载原图不存在,数值为3(仅Android支持)

init


设置picturesGraffiti涂鸦的加载图片和全局回调函数savePicCallback

 picturesGraffiti.init(path,savePicState);
说明:

初始化完成之后默认为涂鸦为写入状态,写入画笔默认像素5,默认颜色红色,擦除默认像素5。

参数:
  • path:(String) 必选 涂鸦图片加载路径,支持协议路径(不支持网络路径)
  • savePicState:(savePicCallback) 必选 保存图片回调
返回值:

无返回值

示例:
picturesGraffiti.init('/sdcard/dd.png',savePicState);

showPicturesGraffiti


打开picturesGraffiti视图

picturesGraffiti.showPicturesGraffiti(x,y,width,height);            
说明:

打开picturesGraffiti视图。

参数:
  • x:(Number) 必选 显示图片的左上角x坐标,图片保持屏幕居中
  • y:(Number) 必选 显示图片的左上角y坐标,图片保持屏幕居中
  • width:(Number) 必选 显示view的宽度,传入0,表示图片自适应屏幕宽高,图片根据屏幕宽高等比缩放
  • height:(Number) 必选 显示view的高度,传入0,表示图片自适应屏幕宽高,图片根据屏幕宽高等比缩放
返回值:

无返回值

示例:
picturesGraffiti.showPicturesGraffiti(0,0,0,0);

setBrushPixel


设置涂鸦写入画笔像素

picturesGraffiti.setBrushPixel(pixel);
说明:

在初始化之后,通过这个方法可以更改涂鸦写入画笔的像素。

参数:
  • pixel:(Number) 必选 更改像素值
返回值:

无返回值

示例:
picturesGraffiti.setBrushPixel(20);

setBrushColor


设置涂鸦写入画笔的颜色

picturesGraffiti.setBrushColor(color);
说明:

在初始化之后,通过这个方法可以更改涂鸦写入画笔的颜色。

参数:
  • color:(String) 必选 更改颜色字符串
返回值:

无返回值

示例:
picturesGraffiti.setBrushColor('#00ff00');

setEraserPixel


设置涂鸦橡皮擦的像素

picturesGraffiti.setEraserPixel(pixel);
说明:

在初始化之后,通过这个方法可以更改涂鸦橡皮擦的像素值。

参数:
  • pixel:(Number) 必选 更改擦除状态橡皮擦的像素值
返回值:

无返回值

示例:
picturesGraffiti.setEraserPixel(30);

hide


隐藏显示的picturesGraffiti视图

picturesGraffiti.hide();
说明:

隐藏显示的picturesGraffiti视图,通过showPicturesGraffiti 方法打开

参数:

返回值:

无返回值

示例:
picturesGraffiti.hide();

remove


移除picturesGraffiti视图

picturesGraffiti.remove();
说明:

移除picturesGraffiti对象。

参数:

返回值:

无返回值

示例:
picturesGraffiti.remove();

setPicGraType


设置图片涂鸦的状态

picturesGraffiti.setPicGraType('0');
说明:

设置图片涂鸦的状态。

参数:
  • type:(String) 必选 0:表示涂鸦,1:表示擦除
返回值:

无返回值

示例:
picturesGraffiti.setPicGraType('0');

getPicGraType


获得图片涂鸦的状态

picturesGraffiti.getPicGraType();
说明:

获得图片涂鸦的状态。

参数:

返回值:
  • String:0或者1,0:表示涂鸦,1:表示擦除
示例:
picturesGraffiti.getPicGraType();

cleanPicture


清除当前编辑的所有涂鸦内容

picturesGraffiti.cleanPicture();
说明:

清除当前编辑的所有涂鸦内容。

参数:

返回值:

无返回值

示例:
picturesGraffiti.cleanPicture(); 

savePicture


保存完成的涂鸦图片到本地

picturesGraffiti.savePicture();
说明:

保存完成的涂鸦图片到本地,保存图片格式为png,保存图片名称的命名格式为ty+"系统当前时间"。

参数:

返回值:

无返回值

示例:
picturesGraffiti.savePicture();  

savePicCallback


图片涂鸦全局回调方法

function savePicCallback (state,text) {
if(state==picturesGraffiti.savepicstart)
       {
           alert("start"+text)
       }
}
说明:

参数:
  • state:(保存图片状态)
  • text: (String )state为保存成功, 输出保存图片路径;state为保存失败,输出保存失败原因