MV系列USB2.0工业数字相机开发说明书
1.2文件
1.2.1应用功能模块：
包含文件HVDAIlT.h 动态链接库HVDAIlT.dll 静态链接库HVDAIlT.lib 1.2.2扩充功能模块
包含文件Raw2RGB.h 动态链接库Raw2RGB.dll 静态链接库Raw2RGB.lib
2.1.1 定义
模块中相关常量，数据结构，宏的说明。
2.1.1.1常量
1.HHV
Typedef HANDLE HHV;
HHV 标识数字摄像机设备句柄。
数字摄像机的控制，参数设置，图像采集等，都需要使用设备句柄。
2.HVTYPE
Typedef enumtag HVTYPE{
}HVTYPE;
HVTYPE 标识当前数字摄像机的设备类型。
不同类型的数字摄像机有一些不同的硬件特性或参数，用户需要根据摄像机类型，完成 相关的操作。
3.HV_RESOLUTION
Typedef enumtag HV_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_MODE
Typedef enumtag HV_SNAP_MODE{
CONTINUATION =0, TRIGGER=1,
TRIGGER_EDGE =2, TRIGGER_LEVEL=3 }HV_SNAP_MODE;
HV_SNAP_MODE 标识图像采集模式。 CONTINUATION 连续； TRIGGER 外触发；
TRIGGER_EDGE 边缘外触发，仅MV31xx系列摄像机支持； TRIGGER_LEVEL 电平外触发，仅MV31xx系列摄像机支持。
5.HV_POLARITY
Typedef enumtag HV_POLARITY {
LOW =0, HIGH =1
}HV_POLARITY;
HV_POLARITY 标识摄像机为外触发采集模式时，外触发信号的极性。 LOW 下降沿或低电平有效； HIGH 上升沿或高电平有效。
6.HV_SNAP_SPEED
Typedef enumtag HV_SNAP_SPEED{
NORMAL_SPEED=0, HIGH_SPEED=1 }HV_SNAP_SPEED;
HV_SNAP_SPEED 标识图像采集速度。 NORMAL_SPEED 正常速度采集； HIGH_SPEED 高速采集。
7.HV_CHANNEL
Typedef enumtag HV_CHANNEL{
RED_CHANNEL=0x10, GREEN_CHANNEL1=0x11, GREEN_CHANNEL2=0x12, BLUE_CHANNEL =0x13 }HV_CHANNEL;
HV_CHANNEL 标识摄像机的增益控制的颜色通道。 RED_CHANNEL 红色通道；
GREEN_CHANNEL1 绿色通道1； GREEN_CHANNEL2 绿色通道2； BLUE_CHANNEL 蓝色通道。
8.HV_ADC_CONTROL
Typedef enumtag HV_ADC_CONTROL{
ADC_BITS =0
ADC_BLKLEVEL_CAL=1,
ADC_BLKLEVEL_CAL_REDCHANNEL=0x10, ADC_BLKLEVEL_CAL_GREENCHANNEL1=0x11, ADC_BLKLEVEL_CAL_GREENCHANNEL2=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_ADC_LEVEL
Typedef enumtag HV_ADC_LEVEL{
ADC_LEVEL0=0, ADC_LEVEL1=1, ADC_LEVEL2=2, ADC_LEVEL3=3 }HV_ADC_LEVEL;
HV_ADC_LEVEL 标识模拟/数字转换级别。 ADC_LEVEL0 0级，10位数据取低7位有效； ADC_LEVEL0 1级，10位数据取低8位有效； ADC_LEVEL2 2级，10位数据取中间8位有效； ADC_LEVEL3 3级，10位数据取高8位有效。
10.HV_AEC_CONTROL
Typedef enumtag HV_AEC_CONTROL{
AEC_EXPOSURE_TIME=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_UNIT
Typedef enumtag HV_SHUTTER_UNIT{
SHUTTER_US=0, SHUTTER_MS=1, }HV_SHUTTER_UNIT;
HV_SHUTTER_UNIT 标识摄像机快门速度的单位。 SHUTTER_US 微秒； SHUTTER_MS 毫秒
12.HV_MIRROR_DIRECTION
Typedef enumtag 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_CODE
Typedef enumtag HV_COMMAND_CODE{
CMD_SET_STROBE_SIGNAL_MODE =0x25, CMD_SET_EXPOSURE_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_INFO
Typedef enumtag 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_MARK 摄像机类型的标志；
DESC_DEVICE_SERIESNUM 摄像机的序列号； DESC_DEVICE_BLANKSIZE 消隐的取值范围；
DESC_DEVICE_HARDWARE_VERSION 摄像机的设备（硬件）版本号。 DESC_DEVICE_BAYER_LAYOUT 摄像机图像Bayer格式
15.HV_CONTROL_CODE
Typedef enumtag HV_CONTROL_CODE{
ORD_QUERY_LAST_STATUS_PRESENCE=0x0000000C, ORD_GET_LAST_STATUS =0x0000000E }HV_CONTROL_CODE;
HV_CONTROL_CODE，列举函数HVCommand的命令控制码CMD_HVAPI_CONTROL执行的功能。
ORD_QUERY_LAST_STATUS_PRESENCE用于查询是否支持，获取摄像机的工作状态；
ORD_GET_LAST_STATUS用于获取摄像机的工作状态。
16.HV_LAST_STATUS
Typedef enumtag HV_LAST_STATUS{
HV_LAST_STATUS_ERROR_CONTROL=0, HV_LAST_STATUS_SNAP =1,
HV_LAST_STATUS_TRANSFER =2 }HV_LAST_STATUS;
HV_LAST_STATUS列举摄像机工作状态类型。 HV_LAST_STATUS_ERROR_CONTROL
摄像机控制操作错误码，调用控制函数返回错误值时，使用ORD_GET_LAST_STATUS获取的详细错误信息；
HV_LAST_STATUS_SNAP
摄像机采集图像操作状态码，实时采集图像时，查询摄像机采集状态； HV_LAST_STATUS_TRANSFER
摄像机采集图像操作状态码，实时采集图像时，在用户定义的回调函数中使用，查询 摄像机采集状态。
17.HV_SIGNAL_TYPE
Typedef enumtag HV_SIGNAL_TYPE{
SIGNAL_IMPULSE=0, SIGNAL_LEVEL =1 }HV_SIGNAL_TYPE;
HV_SIGNAL_TYPE列举摄像机闪光灯信号的模式。 SIGNAL_IMPULSE 脉冲信号 SIGNAL_LEVEL 电平信号
18.HV_EXPOSURE_MODE
Typedef enumtag HV_EXPOSURE_MODE{
SEQUENCE=0, SIMULTANEITY=1
}HV_EXPOSURE_MODE;
HV_EXPOSURE_MODE列举摄像机的曝光模式。 SEQUENCE 顺序模式