海康威视视频组件使用帮助.doc

XX组件使用帮助北京三维力控科技有限公司海康威视视频组件使用帮助1. 功能说明连接海康视频服务器，实时显示视频并能执行一些基本的摄像头操作1.1. 功能介绍（组件实现的功能介绍）1.2. 专业名词介绍（涉及到的专业名词介绍等）2. 使用环境ForceControl6.03. 静态特性3.1. 安装或添加组件将DsSdk.dll、HCNetSDK.dll、PlayCtrl.dll放在力控安装目录下，FCNetVideo_HC.dll放在sysysub下。请参照力控用户手册组件安装部分帮助。3.2. 添加组件（如何在组态环境添加组件，使用图片或文字说明添加过程）请参照力控用户手册组件添加部分帮助3.3. 组件属性页设置说明只显示视频画面：可以固定分辨率也可以选择自定义通过拖拉组件随意选择大小（视频画面最小分辨率为800*600，切比例固定为4:3），如果没有选择只显示视频画面则在视频画面的右侧显示已连接的设备列表和操作按钮，组件大小通过拖拉随意调整。3.4. 运行环境使用双击摄像头则将该摄像头的视频内容在当前已选视频窗口中播放，如果双击视频节点则将改视频服务器中所有摄像头的视频在当前所有的视频窗口中播放当视频没有播放的时候可以改变画面窗口个数和网络延时，在播放的过程中可以实时录像和抓图，可以播放/停止所有视频；如果该摄像头支持云台控制功能，可以通过按钮对摄像头进行操作。4. 动态特性（组件的属性、方法和事件的用途及帮助）4.1. 组件属性4.1.1. 属性列表功能类别属性名称功能介绍基本属性DrawBK是否绘制背景色4.1.2. 属性说明（组件所有属性功能、名称、类型、示例的分项详细说明）属性:描述:类型:(string,int,double)说明 :(详细的使用说明和注意事项)示例 :(写上示例说明)关联方法:(可以不写)关联属性:4.2. 组件方法4.2.1. 方法列表功能类别方法名称功能介绍4.2.2. 方法说明4.2.2.1. 添加并注册设备函数原型:#FCNetVideo_HC.AddDevice(CString csDeviceName,CString csIP, int nPort,CString csUserName, CString csPassWord)函数描述:添加并注册设备返回值:int 0-失败 1-成功参数 :csDeviceName-设备名称 csIP-IP地址 nPort-端口号 csUserName-用户名 csPassWord-密码说明 :添加并注册设备示例 :#FCNetVideo_HC.AddDevice(dev00,192.168.0.1,8000,admin, 12345);/添加并注册名dev00，IP为192.168.0.1，端口号为8000，用户名为admin，密码为12345的设备4.2.2.2. 调用预置点函数原型:#FCNetVideo_HC.AdjustPreset(int nWndIndex, int nDeviceIndex,int nChanIndex，int nPresetIndex)函数描述:调用预置点返回值:int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-预置点索引号说明 :添加并注册设备示例 :#FCNetVideo_HC.AdjustPreset(0,0,1,5);/调用第一个窗口中第一个设备中第2个通道的视频的第5个预置点4.2.2.3. 删除预置点函数原型:#FCNetVideo_HC.DelPreset(int nWndIndex, int nDeviceIndex,int nChanIndex，int nPresetIndex)函数描述:删除预置点返回值:int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-预置点索引号说明 :删除预置点示例 :#FCNetVideo_HC.DelPreset(0,0,1,5);/删除第一个窗口中第一个设备中第2个通道的视频的第5个预置点4.2.2.4. 导出网络设备配置文件函数原型:FCNewVideo_HC.ExportFile(int nWithDlg, CString csFilePath)函数描述:导出网络设备配置文件返回值:void参数 :nWithDlg-是否需要对话框 0-不需要 1-需要 csFilePath-文件路径名称说明 :导出网络设备配置文件，nWithDlg为1时csFilePath无效示例 :FCNewVideo_HC.ExportFile(1,);/导出配置文件4.2.2.5. 导入网络设备配置文件函数原型:FCNewVideo_HC.ImportFile(int nWithDlg, CString csFilePath)函数描述:导入网络设备配置文件返回值:void参数 :nWithDlg-是否需要对话框 0-不需要 1-需要 csFilePath-文件路径名称说明 :导入网络设备配置文件，nWithDlg为1时csFilePath无效示例 :FCNewVideo_HC.ImportFile(1,);/导入配置文件4.2.2.6. 注册/注销设备函数原型:#FCNetVideo_HC.LogInOut(int nDeviceIndex,int nLogInOut)函数描述:注册/注销设备返回值:int 0-失败 1-成功参数 :nDeviceIndex-设备索引号，索引号从0开始 nLogInOut 0-注销 1-注册说明 :注册/注销设备示例 :#FCNetVideo_HC.LogInOut(1,0);/注销设备列表中第二个设备4.2.2.7. 注册/注销设备函数原型:#FCNetVideo_HC.LogInOutEx(CString csDeviceName,int nLogInOut)函数描述:注册/注销设备返回值:int 0-失败 1-成功参数 :csDeviceName-设备名称 nLogInOut 0-注销 1-注册说明 :注册/注销设备示例 :#FCNetVideo_HC.LogInOutEx(dev00,0);/注销设备列表中名称为dev00的设备4.2.2.8. 播放/停止函数原型:#FCNetVideo_HC.Play(int nPlay)函数描述:播放/停止返回值:void参数 :nPlay-是否播放，0-停止 1-播放说明 :播放/停止当前所有视频示例 :#FCNetVideo_HC.Play(1);/播放当前视频4.2.2.9. 云台控制操作函数原型:#FCNetVideo_HC.PTZControl(int nWndIndex, int nDeviceIndex,int nChanIndex，int nControlIndex)函数描述:云台控制操作返回值:int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-动作标记 0-云台上 1-云台下 2-云台左 3-云台右 4-调焦缩 5-调焦伸 6-聚焦近 7-聚焦远 8-光圈大 9-光圈小说明 :云台控制操作示例 :#FCNetVideo_HC.PTZControl(0,0,1,0);/将第一个窗口中第一个设备中第2个通道的视频向上移动4.2.2.10. 设置预置点函数原型:#FCNetVideo_HC.SetPreset(int nWndIndex, int nDeviceIndex,int nChanIndex，int nPresetIndex)函数描述:设置预置点返回值:int 0-失败 1-成功参数 :nWndIndex-窗口索引号 nDeviceIndex-设备索引号 nChanIndex-通道索引号 nPresetIndex-预置点索引号说明 :设置预置点示例 :#FCNetVideo_HC.SetPreset(0,0,1,5);/设置第一个窗口中第一个设备中第2个通道的视频的当前位置为第5个预置点4.2.2.11. 设置视频窗口个数函数原型:#FCNetVideo_HC.SetWndNum(int nWndNum)函数描述:设置视频窗口个数返回值:int 1-成功 0-失败参数 :nWndNum-窗口个数(只能为1，4，9，16，25，36，49，64，81)说明 :设置窗口个数示例 :#FCNetVideo_HC.SetWndNum(16);/将窗口个数设置为16;4.2.2.12. 播放视频函数原型:#FCNetVideo_HC.ShowVideo(int nWndIndex,int nDeviceIndex, int nChanIndex, int nFullScreen)函数描述:播放视频返回值:int 0-失败 1-成功参数 :nWndIndex-播放视频的窗口索引号，索引号从0开始 nDeviceIndex-设备索引号，索引号从0开始 nChanIndex-通道索引号，索引号从0开始 nFullScreen-是否全屏 0-正常显示 1-全屏显示说明 :在指定窗口播放指定设备中指定通道的视频示例 :#FCNetVideo_HC.ShowVideo(1,0,1,1);/全屏播放第一个设备中第二个通道的视频4.2.2.13. 播放视频函数原型:#FCNetVideo_HC.ShowVideoEx(int nWndIndex,CString csDeviceName, CString csChanName,int nFullScreen)函数描述:播放视频返回值:int 0-失败 1-成功参数 :nWndIndex-播放视频的窗口索引号，索引号从0开始 csDeviceName-设备名称 csChanName-通道名称 nFullScreen-是否全屏 0-正常显示 1-全屏显示说明 :在指定窗口播放指定设备中指定通道的视频示例 :#FCNetVideo_HC.ShowVideoEx(1,dev00,camera1,0);/在第二个视频窗口中正常播放dev00设备中camera1通道中的视频4.2.2.14. 抓图函数原型:#FCNetVideo_HC.SnathBMP(int nWndIndex)函数描述:抓图返回值:void参数 :nWndIndex-窗口索引，0为起始索引号说明 :将索引号为nIndex的窗口进行抓图示例 :#FCNetVideo_HC.SetWndNum(5);/对索引号为5的窗口进行抓图;4.3. 组件事件4.3.1. 事件列表功能类别事件名称功能介绍鼠标操作OnClick鼠标单击时触发4.3.2. 事件说明（组件所有事件功能、名称、参数、类型、示例的分项详细说明）函数原型:函数描述:返回值:(void,int,float,string)参数 :(每个参数都要说明)触发条件：说明 :(详细的使用说明和注意事项)示例 :(写上示例说明)关联属性:关联方法:5. 应用实例