首页 > 美文鉴赏

牛牛截图控件浏览器版调用说明

更新时间:2023-07-25 16:37:08 阅读：评论：0

牛牛截图控件浏览器版调用说明

本说明文档旨在对截图控件的浏览器控件进行说明，指导调用者顺利的将截图控件集成进第三方网页中，使第三方网页也能拥有完美的牛牛截图功能。

牛牛截图网页演示页面请访问：

写在前面的话：牛牛截图控件目前支持的功能比较丰富，接口比较丰富，但能保证基本功能的接口并不复杂，在查看文档时，请自行根据自己的需求查看相应的接口；添加水印、获取剪贴板中的图片属于高级功能，如果不需要，这部分可以忽略。

提醒：牛牛截图的核心的调用代码已经全部封装在了niuniucapture.js中，一般情况下，你不需要修改只文件内容，只需要引用，并且自己另外写JS来与UI集成即可，具体见示例(capturewrapper.js)。

牛牛截图控件浏览器版能在目前所有的主流浏览器上正常工作，以下的接口说明适用于所有浏览器，并且提供相应的Javascript调用示例。控件主要有三个接口：InitCapture，InitPara

m以及Capture，这些接口均是暴露给浏览器的Javascript调用,具体可以参考调用WebNiuniuCapturedemo_source.zip，接口的具体描述如下：

1. 接口初始化接口

intInitCapture(constchar* szAuth);

此接口函数用于初始化截图控件的授权信息，默认的授权码为："niuniu"。

参数说明：

短发造型男

参数名	参数类型	参数说明	备注
szAuth	字符串	接口调用的授权码	默认的授权码为："niuniu"

2. 参数初始化接口

intInitParam(int flag, unsignedlong flagvalue);

此接口函数用于初始化截图各个状态下的界面的显示效果，如果不调用，则以默认值处理。

参数说明：

参数名	参数类型	参数说明	备注
flag	int	要设置的参数项蒸海螃蟹	此处对应的枚举ExtendFlagTypeEnum的整形值
flagvalue	unsignedlong	设置的参数值	根据不同的枚举来设置不同的值

枚举定义如下:

typedefenum 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及完成按钮的文字

};

枚举项的说明如下：

枚举参数名	枚举对应数值	参数值说明	备注
emPensize	1	设置画笔大小	如不设置，默认为2
emDrawType	2	设置是腾讯风格还是360风格	0表示腾讯风格，1表示360风格
emTrackColor	3	Track及自动识别的边框的颜色	如：RGB(255, 0, 0)
emEditBorderColor	4	文本输入框的边框颜色	如：RGB(0, 174, 255)
emTransparent	5	工具栏的透明度	默认为220
emWindowAware	6	设置是否禁用随着DPI放大，flagvalue传递任意值均可	浏览器中建议不要调用
emDetectSubWindowRect	7	是否自动检测子窗口，暂时无用	未使用
emSetSaveName	8	设置保存时的文件名称	如： const char* szName = "测试名"; InitParam(emSetSaveName, (unsigned long) szName); 注：免费版本此接口无效，将会显示默认值
emSetMagnifierBkColor	9	用于设置放大镜的背景色	一般不建议设置，默认透明即可
emSetMagnifierLogoText	10	设置放大镜上的显示的LOGO文字	如： const char* szName = "测试名361度加盟"; InitParam(emSetMagnifierLogoText, (unsigned long) szName); 注：免费版本此接口无效，将会显示默认值
emSetPreCaptureWindowTitle	11	设置网页上截图时弹出窗口的标题	如： const char* szName = "测试名"; InitParam(emSetPreCaptureWindowTitle, (unsigned long) szName); 注：免费版本此接口无效，将会显示默认值
带花的成语emSetPreCaptureWindowTransparent	18	设置预截图窗口的透明度	InitParam(emSetPreCaptureWindowTransparent, 220);
以下是水印设置功能，如果不需要则无需关注
emSetWatermarkPictureType	20	用于设置水印图片的绘制方式	此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的水印图片说明
emSetWatermarkPicturePath	21	用于设置水印图片的BASE64的图片数据	注：仅支持PNG格式的图片的Ba64的字符串
emSetWatermarkTextType	22	用于设置水印文字绘制方式	此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的水印文字设置说明
emSetWatermarkTextValue	23	用于设置水印文字	注：此处传递的水印文字需要是经过BASE64编码的，调用接口： InitParamByBa64
emSetMosaicType	24	指定马赛克的样式	1为矩形，2为随鼠标画线的方式
emSetTooltipText	25	设置工具栏图标的TOOLTIP及完成按钮的文字	此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的工具栏按钮文字设置说明

a). 水印图片设置参数说明：

此处的参数值是一个字符串，以|为分割符，如：

未授权时，此参数对应的设置将采用默认值，不可修改；默认支持的图片大小为200*200，超过此大小的地方，将仅显示是在200*200范围内的图片。

各字段意义如下：

参数名	参数值说明	备注
nShowType	设置绘制类型	1表示在中间显示水印； 2表示在右下显示水印； 3表示复合类型孤魂野鬼[默认在中间添加水印，当满足宽与高大于maxwidth及maxheight时同时在个角显示水印] 默认类型为1
nMinWidth	设置图片绘制水印图片的最小尺寸	当图片尺寸宽或高小于设置时，则不会绘制水印默认：阿斯综合症60*60
nMinHeight	设置图片绘制水印图片的最小尺寸	当图片尺寸宽或高小于设置时，则不会绘制水印默认：阿斯综合症60*60
nMaxWidth	当宽度与高度大于MAX设置时将会在个角显示水印	这两个选项仅在nShowType为3时有效默认：600*600
nMaxHeight	当宽度与高度大于MAX设置时将会在个角显示水印	这两个选项仅在nShowType为3时有效默认：600*600
nShowOfft	控制在显示水印时的偏移[中间显示不生效]，同时控制各角的偏移	例如：如显示在左上角时，此偏移表示离左边及上边的偏移值默认20 开塞露的用法

示例：

constchar* szWatermarkFlag = "3|100|100|400|400|20";

b).水印文字的设置说明：

此处的参数值是一个字符串，以|为分割符，如：

//colorText的值为：A,R,G,B

未授权时，此参数对应的设置将采用默认值，不可修改。

各字段意义如下：

参数名	参数值说明	备注
nShowType	设置绘制类型	1表示在中间显示水印文字； 2表示在右下显示水印文字； 3表示复合类型，在图中间从上至下循环添加45度倾斜的水印文字默认类型为3
nMinWidth	设置图片绘制水印图片的最小尺寸	当图片尺寸宽或高小于设置时，则不会绘制水印默认60,60
nMinHeight	设置图片绘制水印图片的最小尺寸	当图片尺寸宽或高小于设置时，则不会绘制水印默认60,60
nVerticalInterval如何修改文件格式	循环绘制倾斜水印文字的间隔高度	此选项仅在nShowType为3时有效默认150
nOfft	控制在显示水印文字时的偏移[中间显示不生效]	在nShowType为2时有效，表示离右下角的偏移；在nShowType为3时，表示顶部起始位置的偏移默认20
nFontSize	水印文字的字号	默认20
nIsBold	水印文字是否加粗	默认否
nTextWidth	水印文字所占的宽度，当字所占宽度超过这个宽度时，将不会显示	建议在设置中测试好宽度再进行二次设置默认150
nTextHeight	水印文字所占的高度	建议在设置中测试好宽度再进行二次设置默认50
colorText	以逗号为分隔的ARGB色彩设置	如：55,255,0,0 表示透明度是55的红色默认：#66333333

示例：

本文发布于:2023-07-25 16:37:08，感谢您对本站的认可！

本文链接：https://www.wtabcd.cn/fanwen/fan/89/1096242.html

上一篇：怎样安装电脑程序

下一篇：(完整版)托福阅读学科词汇

标签：设置水印文字截图图片接口说明

留言与评论（共有 0 条评论）