牛牛截图控件浏览器版调用说明
本说明文档旨在对截图控件的浏览器控件进行说明，指导调用者顺利的将截图控件集成进第三方网页中，使第三方网页也能拥有完美的牛牛截图功能。
牛牛截图网页演示页面请访问：iu/testcapture.htm
写在前面的话：牛牛截图控件目前支持的功能比较丰富，接口比较丰富，但能保证基本功能的接口并不复杂，在查看文档时，请自行根据自己的需求查看相应的接口；添加水印、获取剪贴板中的图片属于高级功能，如果不需要，这部分可以忽略。
提醒：牛牛截图的核心的调用代码已经全部封装在了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 = "测试名"; 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格式的图片的Base64的字符串 |
emSetWatermarkTextType | 22 | 用于设置水印文字绘制方式 | 此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的水印文字设置说明 |
emSetWatermarkTextValue | 23 | 用于设置水印文字 | 注：此处传递的水印文字需要是经过BASE64编码的，调用接口： InitParamByBase64 |
emSetMosaicType | 24 | 指定马赛克的样式 | 1为矩形，2为随鼠标画线的方式 |
emSetTooltipText | 25 | 设置工具栏图标的TOOLTIP及完成按钮的文字 | 此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的工具栏按钮文字设置说明 |
a). 水印图片设置参数说明：
此处的参数值是一个字符串，以|为分割符，如：
//nShowType|nMinWidth|nMinHeight|nMaxWidth|nMaxHeight|nShowOffset
未授权时，此参数对应的设置将采用默认值，不可修改；默认支持的图片大小为200*200，超过此大小的地方，将仅显示是在200*200范围内的图片。
各字段意义如下：
参数名 | 参数值说明 | 备注 |
nShowType | 设置绘制类型 | 1表示在中间显示水印； 2表示在右下显示水印； 3表示复合类型[默认在中间添加水印，当满足宽与高大于maxwidth及maxheight时同时在个角显示水印] 默认类型为1 |
nMinWidth | 设置图片绘制水印图片的最小尺寸 | 当图片尺寸宽或高小于设置时，则不会绘制水印 默认：60*60 |
nMinHeight | ||
nMaxWidth | 当宽度与高度大于MAX设置时将会在个角显示水印 | 这两个选项仅在nShowType间接故意为3时有效 默认：600*600 |
nMaxHeight节假日2022 | ||
nShowOffset | 控制在显示水印时的偏移[中间显示不生效]，同时控制各角的偏移 | 例如：如显示在左上角时，此偏移表示离左边及上边的偏移值 默认20 |
示例：
constchar* szWatermarkFlag = "3|100|100|400|400|20";
b).水印文字的设置说明：
此处的参数值是一个字符串，以|为分割符，如：
//nShowType|nMinWidth|nMinHeight|nVerticalInterval|nOffset|nFontSize|nIsBold|nTextWidth|nTextHeight|colorText
//colorText的值为：A,R,G,B
未授权时，此参数对应的设置将采用默认值，不可修改。
各字段意义如下：
参数名 | 参数值说明 | 备注 |
nShowType | 设置绘制类型 | 1表示在中间显示水印文字； 2表示在右下显示水印文字； 3表示复合类型，在图中间从上至下循环添加45度倾斜的水印文字 默认类型为3 |
nMinWidth | 设置图片绘制水印图片的最小尺寸 | 当图片尺寸宽或高小于设置时，则不会绘制水印 默认60,60 |
nMinHeight | ||
nVerticalInterval | 循环绘制倾斜水印文字的间隔高度 | 此选项仅在nShowType为3时有效 默认150 |
nOffset | 控制在显示水印文字时的偏移[中间显示不生效] | 在nShowType为2时有效，表示离右下角的偏移； 在nShowType为3时，表示顶部起始位置的偏移 默认20 |
nFontSize | 水印文字的字号 | 默认20 |
nIsBold | 水印文字是否加粗 | 默认否 |
nTextWidth | 水印文字所占的宽度，当字所占宽度超过这个宽度时，将不会显示 | 建议在设置中测试好宽度再进行二次设置 默认150 |
nTextHeight | 水印文字所占的高度 | 建议在设置中测试好宽度再进行二次设置 默认50 |
colorText | 以逗号为分隔的ARGB彩设置 | 如：55,255,0,0 表示透明度是55的红 默认：#66333333 |
示例：
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论