调用示例-牛牛截图
牛牛截图控件浏览器版调用说明
牛牛截图控件浏览器版调用说明1
1.接口初始化接口2
2.参数初始化接口2
3.启动截图接口7
4.截图完成后向浏览器通知的事件8
5.其他接口9
6.调用示例10
本说明文档旨在对截图控件的浏览器控件进行说明,指导调用者顺利的将截图控件集成进第三方网页中,使第三方网页也能拥有完美的牛牛截图功能。
牛牛截图网页演示页面请访问:/testcapture.htm
写在前面的话:牛牛截图控件目前支持的功能比较丰富,接口比较丰富,但能保证基本功能的接口并不复杂,在查看文档时,请自行根据自己的需求查看相应的接口;添加水印、获取剪贴板中的图片属于高级功能,如果不需要,这部分可以忽略。
提醒:牛牛截图的核心的调用代码已经全部封装在了niuniucapture.js中,一般情况下,你不需要修改只文件内容,只需要引用,并且自己另外写JS来与UI集成即可,具体见示例(capturewrapper.js)。
牛牛截图控件浏览器版能在目前所有的主流浏览器上正常工作,以下的接口说明适用于所有浏览器,并且提供相应的Javascript调用示例。控件主要有三个接口:InitCapture,InitParam以及Capture,这些接口均是暴露给浏览器的Javascript调用,具体可以参考调用WebNiuniuCapturedemo_source.zip,接口的具体描述如下:
接口初始化接口
int InitCapture (const char* szAuth);
此接口函数用于初始化截图控件的授权信息,默认的授权码为:"niuniu"。
参数说明:
参数名参数类型参数说明备注szAuth字符串接口调用的授权码默认的授权码为:"niuniu"
参数初始化接口
int InitParam (int flag, unsigned long flagvalue);
此接口函数用于初始化截图各个状态下的界面的显示效果,如果不调用,则以默认值处理。
参数说明:
参数名参数类型参数说明备注flagint要设置的参数项此处对应的枚举ExtendFlagTypeEnum的整形值 flagvalueunsigned long设置的参数值根据不同的枚举来设置不同的值 枚举定义如下:
typedef enum ExtendFlagTypeEnum
{
emPensize = 1, //
emDrawType, //
emTrackColor,//
emEditBorderColor,//
emTransparent, //
emWindowAware,
emDetectSubWindowRect,
emSetSaveName,
emSetMagnifierBkColor, //设置放大镜的背景色,不设置则透明
emSetMagnifierLogoText, //设置放大镜上的LOGO字符,可提示快捷键,如:牛牛截图(CTRL + SHIFT + A)
emSetPreCaptureWindowTitle, //设置网页上截图时弹出窗口的标题
emSetPreCaptureWindowTransparent=18,//设置预截图窗口的透明度
emSetWatermarkPictureType=20,//设置水印的类型
emSetWatermarkPicturePath,//设置水印的路径
emSetWatermarkTextType,//设置水印文字的类型
emSetWatermarkTextValue,//设置水印文字
emSetMosaicType, //设置马赛克的样式
emSetTooltipText,//设置工具栏图标的TOOLTIP及完成按钮的文字
};
枚举项的说明如下:
枚举参数名枚举对应数值参数值说明备注emPensize1设置画笔大小emDrawType2设置是腾讯风格还是360风格emTrackColor3Track及自动识别的边框的颜色RGB(255, 0, 0)emEditBorderColor4文本输入框的边框颜色RGB(0, 174, 255)emTransparent5工具栏的透明度emWindowAware6设置是否禁用随着DPI放大,flagvalue传递任意值均可
浏览器中建议不要调用
emDetectSubWindowRect7是否自动检测子窗口,暂时无用emSetSaveName8设置保存时的文件名称如:
const ch