数字摄像机控件使用说明书

本手册中所提及的其它软硬件产品的商标与名称公司都属于本手册的版权属于中本手册中所提及的其它软硬件产品的商标与名称公司都属于本手册的版权属于中国集 有限公司北京图像视觉术分公司未得到本公司的正式任何组织或个人均以任何手段和形式对本手册内容进行复制或传播本手册的内容若有任何恕不另行©2004中国大 集有限公司北京图像视觉技术分公版权所网http://www.daheng-支持热sales@dahengsupport@daheng11.1HVDevice控件是大恒数字摄像机应用接口库开发包的一部分HVDevice封装了大恒数字摄像机的基11.1HVDevice控件是大恒数字摄像机应用接口库开发包的一部分HVDevice封装了大恒数字摄像机的基本用户通过设置控属性和调用实现对摄像机的完全控制和功能应用1.2控件包含HVDevice.ocx等文1.3开发可以在MS-VisualC/C++MS-VisualBasicC++BuilderPowerBuilder等多种支持ActiveX控件的开发工具发自己的应用程使用控件1.4应用程序的用户发布基于控件的应用程需要注册注册将安装目录\OCX下的HVDevice.ocx等文件拷贝到指定的运行Windows系统目录中的程序“regsvr32.exe”注册1.5控件方事件的使用1.5.1术语1AOI(Areaof摄像机采集输出控制摄像机视频数据输出AOI须在当前分辨率(Resolution)大小对于HV1300UC分辨率为 即最大输1.5.1术语1AOI(Areaof摄像机采集输出控制摄像机视频数据输出AOI须在当前分辨率(Resolution)大小对于HV1300UC分辨率为 即最大输幅面为(1280*1024),则AOI窗口应该在(0,0,1280,1024)如果用户需要输出800*600幅面的图像则可以将AOI的宽和高度分别设置为800和控件AOI初始化为当前分辨率最大用户可以调用方法设定AOI具体使用参考SetAOI()方法使用2控件缓控件缓冲区是控件内部用来存储当前采集的图像数据的区域像格式为RGB24其大小由当前AOI区域图0,800,600),则缓冲区大小为800AOI为60031.5.2自定义1DeviceNumber摄像机设从1设备号不能大于当前系统的摄像机数目取值范围由GetPropertyValueRange()获2Resolution摄像机分辨当前摄像机支持的分辨率由当前摄像机类型取值范围由GetPropertyValueRange()13Shutter曝光当前摄像机曝光由当前摄像机类型取值范围由GetPropertyValueRange()4Gain当前摄像机由当前摄像机类型取值范3Shutter曝光当前摄像机曝光由当前摄像机类型取值范围由GetPropertyValueRange()4Gain当前摄像机由当前摄像机类型取值范围由GetPropertyValueRange()5BlackLevel当前摄像机黑电平由当前摄像机类型确定且当BlackLevelEnable允许时取值范围由GetPropertyValueRange()6SnapMode采集方取连续外触发边缘外触发电平外触发7TriggerPolarity外触发极摄像机为外触发采集外触发信号的取下降沿或低电平上升沿或高电平2StrobePolarity闪光灯信号极摄像机输出的闪光灯信号的极8取下降沿或低电平上升沿或高电平9SnapSpeed采集当前摄像机采集图像取StrobePolarity闪光灯信号极摄像机输出的闪光灯信号的极8取下降沿或低电平上升沿或高电平9SnapSpeed采集当前摄像机采集图像取正常取白平衡红白平衡蓝AD转换取转换转换01230123 黑电平参数调节取 31Bayer取01234DisabledEnabled(Enabled(GRBGEnabled( 转换Bayer格式为)转)转Bayer格式为Bayer格式为Enabled(RGGB)转换1Bayer取01234DisabledEnabled(Enabled(GRBGEnabled( 转换Bayer格式为)转)转Bayer格式为Bayer格式为Enabled(RGGB)转换Bayer格式为ConversionType转换取012转换速精度 转换速度精度 转换速精度1.5.3公共控件的公共属性与其他基本文本123456 ForeColor背景Appearance外BorderStyle边界风hWnd窗口句41.5.4以下凡是没有显示说坐标均是指摄像机控件窗口的相对坐标1void抓取单帧图像到控件缓2void抓取连续图像到控件1.5.4以下凡是没有显示说坐标均是指摄像机控件窗口的相对坐标1void抓取单帧图像到控件缓2void抓取连续图像到控件调用该方摄像机抓取一以GrabContinuousChange事件通知用户处理采集图像3void取消当前的调用GrabContinuous() 调用停4void在GrabContinuousChange事件相当用户完成所有对的图像数据处调用Continue()抓取下一帧5void自动白平衡如果当前BayerToRGBConversion属性设置为 则直接退如果已经调用GrabContinuous()启动连集则调用AutoWhiteBalance()控件自动校正当前图像白如果没有调用GrabContinuous()启动连续采 则5会启动连续采集然后完成白平衡注意在调用 应尽量保证当前摄像机拍摄一块亮度均匀的灰白色区6voidSetAOI(longleft,longtop,longwidth,会启动连续采集然后完成白平衡注意在调用 应尽量保证当前摄像机拍摄一块亮度均匀的灰白色区6voidSetAOI(longleft,longtop,longwidth,long设置摄像机采集Areaof 该区域是指视频数据输入摄机时的起始位置和起始位置和大小不能超过当前率参longLeft输入窗口左上角x坐 数值应为4的倍longTop输入窗口左上角y坐数值应为2的倍longWidth输入窗口宽 数值应为4的倍longHeight输入窗口数值应为2的倍7void最大化即设置为当前分辨率8voidDraw(longlong longlong longlonglong long在控件窗口绘制缓存long目标窗口左上角Xlong目标窗口左上角Ylong参6longDestHeight;long源窗口左上角Xlong源窗口左上longDestHeight;long源窗口左上角Xlong源窗口左上角YlongSrcWidth;long源窗口高9voidSaveImage(BSTR保存控件缓存图像为图像目前支持图像格式包括和BSTR文件long获取控件缓存通过缓存地用户可以直接作控件缓存图接访问图像用户不必获取控件缓存地址去一般情控件缓冲区大小由AOI区域决定11.voidGetPropertyValueRange(longPropertyID,long*7long*获取摄像机硬件属性取值范参 long属性=====long*获取摄像机硬件属性取值范参 long属性=====属性Shutter取值属性Gain取值属性BlackLevel取值0123412.voidResolution,long*long*即该分辨率下AOI的最获取分辨率的幅面参shortlong*Width;long*分辨率高1.5.51Click单击HVDevice控件激活的2DblClick事8双击HVDevice控件激活的3GrabContinuousChange用户使用GrabContinuous()或AutoWhiteBalance()启动图双击HVDevice控件激活的3GrabContinuousChange用户使用GrabContinuous()或AutoWhiteBalance()启动图集当每帧图像数据采集完控件自动GrabContinuousChange事用户在该事件响应函数中应及时处理当前有效图像数据如显示图像保存文件继续采集下一帧图然后调用9控件使用一般情摄像机的开始操作和初始化参数的设置控件使用一般情摄像机的开始操作和初始化参数的设置摄像机的结束操作应在应用程应保证控件对象2.2属性控件属性设置有两种 在控件设即二次开发工具集成环通过控件属修改控件的属 在集成开发环境 右键点击控件 择”特性在弹出的属性页窗口中修改当前摄像机的属性设控件 在用户应用程通过对控件属性直接设置一般情建议用户在集成环境中设置控件属性控件 在用户应用程通过对控件属性直接设置一般情建议用户在集成环境中设置控件属性加快启动如果用户要动态设置控件则必须使用第二种采集工作原 采集单帧图像到用户调用控件方法GrabSingle()启动采集图像到内存,采集完 自动停止摄像机采 连续循环采集图像到用户调用控件方 GrabContinuous()或AutoWhiteBalance()启摄像机采集图像到然后摄像机开始循环在连续循集过程控件通过发送事GrabContinuousChange通知用户GrabContinuousChange事件响应函数中完成对采集数控件使 在用户应用程序通过对控件属性赋直接设置属一般情况控件使 在用户应用程序通过对控件属性赋直接设置属一般情况建议用户在集成环境中设置控件属加快程启动速 如果