数字摄像机软件开发说明书

1、 大恒图像系列数字摄像机数字摄像机软件开发说明书2011年5月版本手册中所提及的其它软硬件产品的商标与名称,都属于相应公司所有。本手册的版权属于中国大恒(集团有限公司北京图像视觉技术分公司所有。未得到本公司的正式许可,任何组织或个人均不得以任何手段和形式对本手册内容进行复制或传播。本手册的内容若有任何修改,恕不另行通知。 2011 中国大恒(集团有限公司北京图像视觉技术分公司版权所有销售热线:010-*转8021支持热线:010-*转8006前言首先感谢您选用大恒图像产品,数字摄像机应用接口库是我公司提供的应用程序接口函数。它基本上概括了数字摄像机应用程序编程中涉及的各个方面,通过应用接口库,

2、用户可以很好地了解数字摄像机的运行机制,并在此基础上进行应用程序的开发。数字摄像机应用接口库按照模块分为应用功能模块和扩充功能模块。其中应用功能模块包括数字摄像机的控制、采集图像到内存、错误处理等功能,扩充功能模块包括图像数据的转换等功能。本手册按功能对接口库中的函数进行了划分,对于每一个功能部分的函数都具体给出了它们的函数原型、参数定义、说明、示例等信息。手册为用户进行数字摄像机的二次开发提供了详细的说明,如果用户在使用过程中发现错误和纰漏,请与我公司的销售或技术服务部门联系,以便我们及时改进。 目录1.概述 (11.1功能 (11.2文件 (11.3开发工具 (21.4应用程序的发布 (2

3、2.说明 (32.1应用功能 (31. HHV (32. HVTYPE (33. HV_RESOLUTION (54. HV_SNAP_MODE (65. HV_POLARITY (66. HV_SNAP_SPEED (77. HV_CHANNEL (78. HV_ADC_CONTROL (89. HV_ADC_LEVEL (810. HV_AEC_CONTROL (911. HV_SHUTTER_UNIT (912. HV_MIRROR_DIRECTION (1013. HV_COMMAND_CODE (1014. HV_DEVICE_INFO (1115. HV_CONTROL_CODE

4、(1216. HV_LAST_STATUS (1217. HV_SIGNAL_TYPE (1318. HV_EXPOSURE_MODE (1319. HV_NOISECORR_CONTROL (131. HV_SANP_INFO (142. HV_SNAPPROC (153. HV_CHECK_PARAM (154. HV API_CONTROL_PARAMETER (155. HV_RES_QUERY_LAST_STATUS_PRESENCE (166. HV_ARG_GET_LAST_STATUS (177. HV_RES_GET_LAST_STA TUS (178. HV_SIGNAL_

5、MODE (171. HV_SUCCESS (18 2. HV_VERIFY (181. 函数:BeginHVDevice (192. 函数:EndHVDevice (203. 函数:HVSetResolution (204. 函数:HVSetOutputWindow (215. 函数:HVSetBlanking (226. 函数:HVSetSnapMode (227. 函数:HVSetTriggerPolarity (238. 函数:HVSetStrobePolarity (239. 函数:HVSetSnapSpeed (2310. 函数:HVEnableVideoMirror (2411.

6、 函数:HV ADCControl (2412. 函数:HV AGCControl (2513. 函数:HV AECControl (2614. 函数:HVCommand (271. 函数:HVSnapShot (302. 函数:HVOpenSnap (313. 函数:HVCloseSnap (324. 函数:HVStartSnap (325. 函数:HVStopSnap (336. 函数:HVTriggerShot (337. 函数:HVWaitSync (331. 函数:HVGetErrorString (341. 函数:HVGetDeviceTotal (342. 函数:HVGetDev

7、iceInfo (343. 函数:HVCheckDevice (364. 函数:HVDeviceMemRead (375. 函数:HVDeviceMemWrite (372.2扩充功能 (381. HV_BAYER_CONVERT_TYPE (382. HV_BAYER_LAYOUT (401. 函数:ConvertBayer2RGB (402. 函数:GetWhiteBalanceRatio (413. 函数:SetGammaLut (424. 函数:DetectDeadPixel (42 目录5. 函数:EraseDeadPixel (436. 函数:GetPatternNoise (44

8、7. 函数:AvgPatternNoise (448. 函数:FixPatternNoise (453.附录 (463.1函数返回值代码表 (464.备注 (1 1.概述在Microsoft 的32位Windows 操作系统中,数字摄像机应用接口库直接操作数字摄像机,并提供给用户一个简单明确的应用接口。用户在编制自己的应用程序时,可以直接调用这些库函数来实现指定的功能。数字摄像机工作流程如下: 一般情况下,摄像机的开始操作和初始化参数的设置,最好在用户应用程序的初始化中完成,摄像机的结束操作应在应用程序退出前执行。1.1 功能应用接口库划分为应用功能模块和扩充功能模块。1.2 文件包含文件HV

9、DAIlT.h动态链接库HVDAIlT.dll静态链接库HVDAIlT.lib包含文件Raw2RGB.h动态链接库Raw2RGB.dll静态链接库Raw2RGB.lib 1.3开发工具应用接口库支持32位编程开发工具Microsoft Visual C/C+、Microsoft Visual Basic、Borland C/C+、Delphi、C+ Builder、Power Builder等。使用C/C+编程工具,用户应在程序中调用相关的包含文件(.h,并将静态链接库(.lib文件加入到工程文件中,供编译程序在链接(Link时使用。需要说明的是,MS-Visual C/C+和C+ Build

10、er定义了各自的静态链接库的文件格式,它们之间是不通用的。使用MS-Visual Basic、Delphi、Power Builder等编程工具调用应用接口库时,应按照调用动态链接库的方法,在程序中重新声明函数原型,这时要注意正确定义参数的数据类型。1.4应用程序的发布发布数字摄像机的应用程序,首先,安装摄像机的设备驱动程序(安装步骤可参见“安装数字摄像机设备驱动程序”说明,并确认安装成功;然后,将要发布的应用程序安装到相应的工作目录。这样,应用程序就可以运行了。如果需要将驱动程序与二次开发的应用程序安装盘一并发布,请将随卡的驱动程序光盘或软盘中,相应操作系统目录下的驱动程序拷贝到准备发布的安

11、装盘上即可。 2.说明2.1应用功能数字摄像机应用接口库包括数字摄像机的控制、采集图像到内存、错误处理、其它功能等功能。函数的原型声明在包含文件HVDAIlT.h,动态链接库HVDAIlT.dll,静态链接库HVDAIlT.lib。模块中相关常量,数据结构,宏的说明。1. HHVtypedef HANDLE HHV;HHV 标识数字摄像机设备句柄。数字摄像机的控制,参数设置,图像采集等,都需要使用设备句柄。2. HVTYPEtypedef enum tagHVTYPE HV1300UCTYPE = 0,HV2000UCTYPE = 1,HV1301UCTYPE = 2,HV2001UCTYPE

12、 = 3,HV3000UCTYPE = 4,HV1300UMTYPE = 5,HV1302UCTYPE = 6,HV2002UCTYPE = 7,HV3102UCTYPE = 8,HV1302UMTYPE = 9 HV1300FCTYPE = 10, HV2000FCTYPE = 11, HV3100FCTYPE = 12, HV1300FMTYPE = 13, HV1303UCTYPE = 14, HV2003UCTYPE = 15, HV3103UCTYPE = 16, HV1303UMTYPE = 17, SV1300FMTYPE = 18, SV1300FCTYPE = 19, SV1

13、310FCTYPE = 20, SV1310FMTYPE = 21, SV1311FCTYPE = 22, SV1311FMTYPE = 23, SV400FCTYPE = 24, SV400FMTYPE = 25, DH1394FXTYPE = 26, SV1410FCTYPE = 27, SV1410FMTYPE = 28, SV1420FCTYPE = 29, SV1420FMTYPE = 30, SV2000FCTYPE = 31, SV2000FMTYPE = 32, SV1400FCTYPE = 33, SV1400FMTYPE = 34, HV1350UCTYPE = 35, H

14、V2050UCTYPE = 36, HV3150UCTYPE = 37, HV1350UMTYPE = 38, HV1360UCTYPE = 39, HV2060UCTYPE = 40,HV3160UCTYPE = 41,HV1360UMTYPE = 42,HV2060UCTYPE = 40,HV3160UCTYPE = 41,HV1360UMTYPE = 42,HV1351UCTYPE = 56,HV2051UCTYPE = 57,HV3151UCTYPE = 58,HV1351UMTYPE = 59,GV400UCTYPE = 60,GV400UMTYPE = 61 HVTYPE;HVTY

15、PE 标识当前数字摄像机的设备类型。不同类型的数字摄像机有一些不同的硬件特性或参数,用户需要根据摄像机类型,完成相关的操作。3. HV_RESOLUTIONtypedef enum tagHV_RESOLUTION RES_MODE0 = 0,RES_MODE1 = 1,RES_MODE2 = 2,RES_MODE3 = 3 HV_RESOLUTION;HV_RESOLUTION 标识图像分辨率的类型。RES_MODE0分辨率0;RES_MODE1分辨率1;RES_MODE2 分辨率2;RES_MODE3分辨率3。4. HV_SNAP_MODEtypedef enum tagHV_SNAP_M

16、ODE CONTINUATION = 0,TRIGGER = 1,TRIGGER_EDGE = 2,TRIGGER_LEVEL = 3 HV_SNAP_MODE;HV_SNAP_MODE 标识图像采集模式。CONTINUATION连续;TRIGGER外触发;TRIGGER_EDGE边缘外触发,仅HV31xx系列摄像机支持;TRIGGER_LEVEL电平外触发,仅HV31xx系列摄像机支持。5. HV_POLARITYtypedef enum tag HV_POLARITY LOW = 0,HIGH = 1 HV_POLARITY;HV_POLARITY 标识摄像机为外触发采集模式时,外触发信号

17、的极性。LOW下降沿或低电平有效; HIGH上升沿或高电平有效。6. HV_SNAP_SPEEDtypedef enum tagHV_SNAP_SPEED NORMAL_SPEED = 0,HIGH_SPEED = 1 HV_SNAP_SPEED;HV_SNAP_SPEED 标识图像采集速度。NORMAL_SPEED正常速度采集;HIGH_SPEED高速采集。7. HV_CHANNELtypedef enum tagHV_CHANNEL RED_CHANNEL = 0x10,GREEN_CHANNEL1 = 0x11,GREEN_CHANNEL2 = 0x12,BLUE_CHANNEL = 0

18、x13 HV_CHANNEL;HV_CHANNEL 标识摄像机的增益控制的颜色通道。RED_CHANNEL红色通道;GREEN_CHANNEL1绿色通道1;GREEN_CHANNEL2绿色通道2;BLUE_CHANNEL 蓝色通道。8. HV_ADC_CONTROLtypedef enum tagHV_ADC_CONTROLADC_BITS = 0ADC_BLKLEVEL_CAL = 1,ADC_BLKLEVEL_CAL_REDCHANNEL = 0x10,ADC_BLKLEVEL_CAL_GREENCHANNEL1 = 0x11,ADC_BLKLEVEL_CAL_GREENCHANNEL2

19、= 0x12,ADC_BLKLEVEL_CAL_BLUECHANNEL = 0x13, HV_ADC_CONTROL;HV_ADC_CONTROL 标识摄像机的模拟/数字转换控制方式。ADC_BITS模拟/数字转换级别控制;ADC_BLKLEVEL_CAL黑电平参数调节允许;ADC_BLKLEVEL_CAL_REDCHANNEL红色通道黑电平调节;ADC_BLKLEVEL_CAL_GREENCHANNEL1绿色通道1黑电平调节;ADC_BLKLEVEL_CAL_GREENCHANNEL2绿色通道2黑电平调节;ADC_BLKLEVEL_CAL_BLUECHANNEL蓝色通道黑电平调节。9. HV

20、_ADC_LEVELtypedef enum tagHV_ADC_LEVELADC_LEVEL0 = 0,ADC_LEVEL1 = 1, ADC_LEVEL2 = 2,ADC_LEVEL3 = 3 HV_ADC_LEVEL;HV_ADC_LEVEL 标识模拟/数字转换级别。ADC_LEVEL00级,10位数据取低7位有效;ADC_LEVEL01级,10位数据取低8位有效;ADC_LEVEL22级,10位数据取中间8位有效;ADC_LEVEL33级,10位数据取高8位有效。10. HV_AEC_CONTROLtypedef enum tagHV_AEC_CONTROLAEC_EXPOSURE_T

21、IME = 1,AEC_SHUTTER_SPEED = 2,AEC_SHUTTER_UNIT = 3 HV_AEC_CONTROL;HV_AEC_CONTROL 标识摄像机曝光控制方式。AEC_EXPOSURE_TIME曝光系数;AEC_SHUTTER_SPEED快门速度;AEC_SHUTTER_UNIT快门速度单位。11. HV_SHUTTER_UNITtypedef enum tagHV_SHUTTER_UNIT SHUTTER_US = 0,SHUTTER_MS = 1, HV_SHUTTER_UNIT;HV_SHUTTER_UNIT 标识摄像机快门速度的单位。SHUTTER_US微秒;

22、SHUTTER_MS毫秒12. HV_MIRROR_DIRECTIONtypedef enum tag HV_MIRROR_DIRECTION VERT_DIR = 1,Hor_DIR = 2,Full_DIR = 3 HV_MIRROR_DIRECTION;HV_MIRROR_DIRECTION 标识图像采集的镜像功能。VERT_DIR垂直方向。Hor_DIR水平方向。Full_DIR全方向。13. HV_COMMAND_CODEtypedef enum tagHV_COMMAND_CODE CMD_SET_STROBE_SIGNAL_MODE = 0x25,CMD_SET_EXPOSURE

23、_MODE = 0x26,CMD_SET_ROW_NOISECORR_CONTROL = 0x27,CMD_HVAPI_CONTROL = 0x100 HV_COMMAND_CODE;HV_COMMAND_CODE 标识摄像机的控制功能。CMD_SET_STROBE_SIGNAL_MODE控制闪光灯信号模式的功能码CMD_SET_EXPOSURE_MODE控制曝光模式的功能码CMD_SET_ROW_NOISECORR_CONTROL控制行噪声校正开关的功能码CMD_HVAPI_CONTROL执行HV_CONTROL_CODE定义的功能。14. HV_DEVICE_INFOtypedef enu

24、m tag HV_DEVICE_INFO DESC_DEVICE_TYPE = 0,DESC_RESOLUTION = 1,DESC_DEVICE_MARK = 2,DESC_DEVICE_SERIESNUM = 3,DESC_DEVICE_BLANKSIZE = 4,DESC_DEVICE_HARDWARE_VERSION = 6,DESC_DEVICE_BAYER_LAYOUT = 11 HV_DEVICE_INFO;HV_DEVICE_INFO 标识摄像机的信息。DESC_DEVICE_TYPE摄像机的设备类型;DESC_RESOLUTION摄像机的分辨率;DESC_DEVICE_MAR

25、K摄像机类型的标志;DESC_DEVICE_SERIESNUM 摄像机的序列号;DESC_DEVICE_BLANKSIZE消隐的取值范围;DESC_DEVICE_HARDWARE_VERSION摄像机的设备(硬件版本号。DESC_DEVICE_BAYER_LAYOUT摄像机图像Bayer格式15. HV_CONTROL_CODEtypedef enum tagHV_CONTROL_CODE ORD_QUERY_LAST_STATUS_PRESENCE = 0x0000000C,ORD_GET_LAST_STATUS = 0x0000000E HV_CONTROL_CODE;HV_CONTROL

26、_CODE,列举函数HVCommand的命令控制码CMD_HVAPI_ CONTROL执行的功能。ORD_QUERY_LAST_STATUS_PRESENCE用于查询是否支持,获取摄像机的工作状态;ORD_GET_LAST_STATUS用于获取摄像机的工作状态。16. HV_LAST_STATUStypedef enum tagHV_LAST_STATUS HV_LAST_STATUS_ERROR_CONTROL = 0,HV_LAST_STATUS_SNAP = 1,HV_LAST_STATUS_TRANSFER = 2 HV_LAST_STATUS;HV_LAST_STATUS列举摄像机工

27、作状态类型。HV_LAST_STATUS_ERROR_CONTROL摄像机控制操作错误码,调用控制函数返回错误值时,使用ORD_GET_LAST_STATUS获取的详细错误信息;HV_LAST_STATUS_SNAP 摄像机采集图像操作状态码,实时采集图像时,查询摄像机采集状态;HV_LAST_STATUS_TRANSFER摄像机采集图像操作状态码,实时采集图像时,在用户定义的回调函数中使用,查询摄像机采集状态。17. HV_SIGNAL_TYPEtypedef enum tagHV_SIGNAL_TYPESIGNAL_IMPULSE = 0,SIGNAL_LEVEL = 1HV_SIGNAL

28、_TYPE;HV_SIGNAL_TYPE列举摄像机闪光灯信号的模式。SIGNAL_IMPULSE脉冲信号SIGNAL_LEVEL电平信号18. HV_EXPOSURE_MODEtypedef enum tagHV_EXPOSURE_MODESEQUENCE = 0,SIMULTANEITY = 1 HV_EXPOSURE_MODE;HV_ EXPOSURE_MODE列举摄像机的曝光模式。SEQUENCE顺序模式SIMULTANEITY同时模式19. HV_NOISECORR_CONTROLtypedef enum tagHV_NOISECORR_CONTROL NOISECORR_ENABLE

29、 = 0,NOISECORR_DISABLE = 1 HV_NOISECORR_CONTROL;HV_NOISECORR_CONTROL列举摄像机的噪声校正控制开关。NOISECORR_ENABLE噪声校正控制开启NOISECORR_DISABLE噪声校正控制关闭1. HV_SANP_INFOtypedef struct tagHV_SANP_INFO HHV hhv;int nDevice;int nIndex;void *pParam; HV_SNAP_INFO;HV_SNAP_INFO 结构包含执行采集图像到内存的操作中,摄像机的工作状态。在连续采集图像到内存的过程中,标示当前工作的摄像

30、机设备,图像数据缓冲区的序号和用户定义的参数。成员hhv标示当前工作的摄像机的句柄。nDevice标示当前工作的摄像机的序号(从1开始。nIndex标示当前摄像机采集的图像数据缓冲区的序号(从0开始。pParam指向用户定义的参数。 2. HV_SNAPPROCtypedef int (CALLBACK *HV_SNAPPROC(HV_SNAP_INFO *pInfo;HV_SNAPPROC标示回调函数的声明。在采集图像到内存控制程序中,用户定义回调函数,在函数体中编写自己的程序,如,图像数据的处理等。使用函数HVOpenSnap注册回调函数,由摄像机采集控制程序调用。3. HV_CHECK_

31、PARAMtypedef struct tagHV_CHECK_PARAM BYTE byParam1;BYTE byParam2;BYTE byParam3;BYTE byParam4; HV_CHECK_PARAM;HV_CHECK_PARAM 结构包含给定的摄像机查验参数。成员byParam1参数1。byParam2参数2。byParam3参数3。byParam4参数4。4. HV API_CONTROL_PARAMETERtypedef struct tagHVAPI_CONTROL_PARAMETER HV_CONTROL_CODE code;void *pInBuf;DWORD d

32、wInBufSize;void *pOutBuf; DWORD dwOutBufSize;DWORD *pBytesRet; HVAPI_CONTROL_PARAMETER;HVAPI_CONTROL_PARAMETER结构用于CMD_HVAPI_CONTROL 功能的输入输出参数。成员code功能码,参见HV_CONTROL_CODE,其它成员pInBuf,dwInBufSize,pOutBuf,dwOutBufSize和pBytesRet描述code的参数,每个功能都有各自对应的输入输出参数;pInBuf指向输入缓冲区,如果code指明的操作不需要输入参数,pInBuf设置为NULL;dw

33、InBufSize输入缓冲区大小,单位:字节,如果code指明的操作不需要输入参数,dwInBufSize设置为0;pOutBuf指向输出缓冲区,如果code指明的操作不需要输出参数,pOutBuf设置为NULL;dwOutBufSize输出缓冲区大小,单位:字节,如果code指明的操作不需要输入参数,dwOutBufSize设置为0;pBytesRet指向一个DWORD变量,接收pOutBuf中实际输出的数据大小,单位:字节,如果输出缓冲区太小,HVCommand函数返回STATUS_NOT_ENOUGH_SYSTEM_MEMORY,并且pBytesRet为0。5. HV_RES_QUERY

34、_LAST_STATUS_PRESENCEtypedef struct tagHV_RES_QUERY_LAST_STATUS_PRESENCE DWORD : 29;DWORD Transfer : 1;DWORD Snap : 1;DWORD Control : 1; HV_RES_QUERY_LAST_STATUS_PRESENCE;HV_RES_QUERY_LAST_STATUS_PRESENCE结构用于ORD_QUERY_LAST_STATUS_PRESENCE的输出参数,描述是否支持,获取摄像机的工作状态。成员Transfer 标示是否支持,在用户定义的回调函数中获取摄像机采集图像

35、操作状态码;Snap标示是否支持,获取摄像机采集图像操作状态码;Control标示是否支持,获取摄像机控制操作错误码。6. HV_ARG_GET_LAST_STATUStypedef struct tagHV_ARG_GET_LAST_STATUS HV_LAST_STATUS type; HV_ARG_GET_LAST_STATUS;HV_ARG_GET_LAST_STATUS结构用于ORD_GET_LAST_STATUS的输入参数,描述要获取的摄像机工作状态类型。成员type摄像机工作状态类型,参见HV_LAST_STATUS。7. HV_RES_GET_LAST_STATUStypede

36、f struct tagHV_RES_GET_LAST_STATUS DWORD status; HV_RES_GET_LAST_STATUS;HV_RES_GET_LAST_STATUS结构用于ORD_GET_LAST_STATUS的输出参数,描述摄像机工作状态。成员status标识摄像机工作状态码或错误码。8. HV_SIGNAL_MODEtypedef struct tagHV_SIGNAL_MODEint Polarity; /0:LOW ;1: HIGHint Mode; /0:SIGNAL_IMPULSE; 1: SIGNAL_LEVELHV_SIGNAL_MODE;HV_SIGN

37、AL_MODE结构用于设置摄像机闪光灯信号的模式和极性。 成员Polarity标识摄像机闪光灯信号的极性。Mode标示摄像机闪光灯信号的模式。1. HV_SUCCESSBOOL HV_SUCCESS(statusHV_SUCCESS宏检查函数执行的返回状态。参数:HVSTATUS status;函数执行的返回状态。返回值:标识函数执行结果,成功为TRUE;失败为FALSE。注释:HV_SUCCESS在HVDef.h中的定义如下,#define HV_SUCCESS(status(status= STATUS_OK 2. HV_VERIFYHV_VERIFY(statusHV_VERIFY宏校验

38、函数执行是否成功。HV_VERIFY宏只在调试(DEBUG版的执行程序中运行,函数执行成功,不显示信息;函数执行不成功,则弹出对话框,显示错误信息。在发布(RELEASE版的执行程序中不运行,也不产生任何代码。参数:HVSTATUS status;函数执行的返回状态。注释:HV_VERIFY在HVDef.h中的定义如下,#ifdef _DEBUG#define HV_VERIFY(statusif(status!= STATUS_OK :MessageBox(NULL,HVGetErrorString(status, Error,MB_ICONWARNING | MB_OK;#else#def

39、ine HV_VERIFY(status(status#endif数字摄像机的开始(初始化、结束,设置分辨率、图像窗口、采集模式等。1. 函数:BeginHVDevice原型:HVSTATUS _stdcall BeginHVDevice(int nDevice,HHV *pHandle参数:int nDevice;摄像机序号,由1开始。HHV *pHandle;指向摄像机设备句柄。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:开始指定摄像机操作,初始化摄像机,获得其设备句柄,分配相应的资源。输入参数nDevice是摄像机的逻辑序号,按照大恒数字摄像机序列,如HV1300

40、UC、HV2000UC HVxxx等,由低到高排列确定,同一型号设备按所连接USB接口序号排列。例如:用户系统中有3支HV1300UC,按USB接口序号,则摄像机的序号分别为1、2、3。如果nDevice的值超过当前系统实际的摄像机数,则返回STATUS_NO_DEVICE_FOUND。调用函数HVGetDeviceInfo可以确定当前摄像机类型。摄像机使用完毕,调用函数EndHVDevice结束。范例:如果系统中安装了两支或两支以上的摄像机,则可以按下面调用得到每支摄像机的设备句柄。BeginHVDevice(1,&hDevice1;/打开摄像机1BeginHVDevice(2,&hDevi

41、ce2;/打开摄像机2 /类推 参看:EndHVDevice,HVGetDeviceInfo。2. 函数:EndHVDevice原型:HVSTATUS _stdcall EndHVDevice(HHV hhv参数:HHV hhv;摄像机句柄。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:结束指定摄像机操作,释放其设备句柄和资源。调用函数前,必须停止摄像机工作,如果摄像机正在采集图像时调用函数,则返回STA TUS_IN_WORK。范例:EndHVDevice(hDevice1; /关闭摄像机1EndHVDevice(hDevice2;/关闭摄像机2参看:BeginHVDe

42、vice。3. 函数:HVSetResolution原型:HVSTATUS _stdcall HVSetResolution(HHV hhv, HV_RESOLUTION resoultion;参数:HHV hhv;摄像机句柄。HV_RESOLUTION resolution;图像分辨率。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置摄像机的分辨率,HV13xxUx系列摄像机的分辨率:RES_MODE0 12801024,RES_MODE1 640512,RES_MODE2 320256。HV20xxUx系列摄像机的分辨率:RES_MODE0 16001200,RES

43、_MODE1 800600,RES_MODE2400300。HV31xxUx系列摄像机的分辨率:RES_MODE0 20481536,RES_MODE1 1024768,RES_MODE2640480,RES_MODE3 512384。GV400Ux摄像机的分辨率:RES_MODE0 752480,RES_MODE1 376240。其中GV400UC在 RES_MODE1模式下图像为黑白图像。有关摄像机分辨率的信息,参见函数HVGetDeviceInfo。范例:HVSetResolution(hDevice1,RES_MODE1;参看:HVSetOutputWindow。4. 函数:HVSet

44、OutputWindow原型:HVSTATUS _stdcall HVSetOutputWindow(HHV hhv,int nStartX,int nStartY,int nWidth,int nHeight参数:HHV hhv;摄像机句柄。int nStartX;输出窗口左上角x坐标,数值应为4的倍数。int nStartY;输出窗口左上角y坐标,数值应为2的倍数。int nWidth;输出窗口宽度,数值应为4的倍数。int nHeight;输出窗口高度,数值应为2的倍数。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置图像输出(Output窗口,输出窗口是指图像数

45、据从摄像机输出时的起始位置和大小。输出窗口大小只能等于或小于当前分辨率的大小。需要特别说明的是摄像机GV400Ux,在调节窗口时,需要满足条件:nWidth *rate + Horizontal Blanking + 0x5e 0x294rate取值:分辨率Mode0:rate=1;Mode1:rate=2范例:HVSetOutputWindow(hDevice1,0,0,640,512;参看:HVSetResolution。 5. 函数:HVSetBlanking原型:HVSTATUS _stdcall HVSetBlanking(HHV hhv, int nHor, int nVert;参

46、数:HHV hhv;摄像机句柄。int nHor;行消隐值。int nVert;场消隐值。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置摄像机的消隐值,消隐的取值范围通过函数HVGetDeviceInfo得到,请参考HVGetDeviceInfo 函数说明。GV400Ux摄像机的行消隐与水平宽度需要满足一定的条件,详见HVSetResolution函数说明。范例:HVSetBlanking(hDevice1,20,0;6. 函数:HVSetSnapMode原型:HVSTATUS _stdcall HVSetSnapMode(HHV hhv, HV_SNAP_MODE

47、mode;参数:HHV hhv;摄像机句柄。HV_SNAP_MODE mode;图像采集模式:CONTINUATION 连续方式;TRIGGER 外触发方式;TRIGGER_EDGE 边缘外触发;TRIGGER_LEVEL 电平外触发。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置图像的采集方式。范例:HVSetSnapMode(hDevice1, CONTINUATION;仅HV31xxUx摄像机支持TRIGGER_EDGE和TRIGGER_LEVEL两种模式。 7. 函数:HVSetTriggerPolarity原型:HVSTATUS _stdcall HVSet

48、TriggerPolarity(HHV hhv, HV_POLARITY polarity;参数:HHV hhv;摄像机句柄。HV_POLARITY polarity;外触发信号的极性:LOW 下降沿或低电平有效;HIGH 上升沿或高电平有效。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:当摄像机为外触发模式采集图像时,设置外触发信号的极性。范例:HVSetTriggerPolarity(hDevice1, LOW;8. 函数:HVSetStrobePolarity原型:HVSTATUS _stdcall HVSetStrobePolarity(HHV hhv, HV_P

49、OLARITY polarity;参数:HHV hhv;摄像机句柄。HV_POLARITY polarity;闪光灯信号的极性:LOW 下降沿或低电平有效;HIGH 上升沿或高电平有效。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置摄像机输出的闪光灯信号的极性。范例:HVSetStrobePolarity(hDevice1, LOW;9. 函数:HVSetSnapSpeed原型:HVSTATUS _stdcall HVSetSnapSpeed (HHV hhv, HV_SNAP_SPEED speed;参数:HHV hhv;摄像机句柄。 HV_SNAP_SPEED s

50、peed;图像采集速度:NORMAL_SPEED正常速度;HIGH_SPEED高速。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置图像的采集速度,例如HV1301UC,HV1302UC,HV1300UM,HV1302UM分辨率为12801024时,高速采集为15fps,正常速度采集时为7.5fps;HV2001UC,HV2002UC分辨率为16001200时,高速采集为10fps,正常速度采集时为5fps;HV3000UC,HV3102UC分辨率为20481536时,高速采集为6fps,正常速度采集时为3fps。范例:HVSetSnapMode(hDevice1, N

51、ORMAL_SPEED;10. 函数:HVEnableVideoMirror原型:HVSTATUS _stdcall HVEnableVideoMirror(HHV hhv,HV_MIRROR_DIRECTION dir,BOOL bEnable参数:HHV hhv;摄像机句柄。HV_MIRROR_DIRECTION dir;图像采集的镜像方向。BOOL bEnable;TRUE 允许,FALSE 禁止。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:设置采集图像的垂直方向镜像功能。只有GV400Ux摄像机同时支持垂直、水平和完全镜像,其他摄像机都只支持垂直镜像。11. 函

52、数:HV ADCControl原型:HVSTATUS _stdcall HVADCControl(HHV hhv, BYTE byParam, long lValue;参数:HHV hhv;摄像机句柄。BYTE byParam;控制参数, ADC_BITS 模拟/数字转换级别;ADC_BLKLEVEL_CAL 黑电平参数调节允许;ADC_BLKLEVEL_CAL_REDCHANNEL 红色通道黑电平调节;ADC_BLKLEVEL_CAL_GREENCHANNEL1绿色通道1黑电平调节;ADC_BLKLEVEL_CAL_GREENCHANNEL2绿色通道2黑电平调节;ADC_BLKLEVEL_C

53、AL_BLUECHANNEL蓝色通道黑电平调节;long lValue;参数值,设置模拟数字转换级别,取值,ADC_LEVEL0;ADC_LEVEL1;ADC_LEVEL2;ADC_LEVEL3。设置黑电平参数调节允许,取值,TRUE 允许;FALSE 禁止。设置黑电平参数,取值,-255 到255。注:GV400Ux摄像机黑电平参数,取值:-127到127。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:摄像机的模拟/数字转换控制。12. 函数:HV AGCControl原型:HVSTATUS _stdcall HVAGCControl(HHV hhv, BYTE byP

54、aram, long lValue;参数:HHV hhv;摄像机句柄。BYTE byParam;控制参数,AGC_GAIN_RED_CHANNEL 红通道增益调节;AGC_GAIN_GREEN_CHANNEL1 绿通道1增益调节;AGC_GAIN_GREEN_CHANNEL2 绿通道2增益调节; AGC_GAIN_BLUE_CHANNEL 蓝通道增益调节;long lValue;增益大小,HV-50系列和HV-51系列摄像机增益0-63。其他HV系列摄像机分通道的增益调节取值,0-127。GV400Ux摄像机增益调节为:16-64。返回值:调用成功,返回STA TUS_OK,否则返回错误代码。说明:摄像机的自动增益控制。13. 函数:HV AECControl原型:HVSTATUS _stdcall HVAECControl(HHV hhv, BYTE byParam, long lValue;参数:HHV hhv;摄像机句柄。BYTE byParam;控制参数,AEC_EXPOSURE_TIME 曝光系数;AEC_SHUTTER_SPEED 快门速度;AE