MVSDK_Net 数据结构类 成功,无错误 通用的错误 错误或无效的句柄 错误的参数 错误或无效的帧句柄 无效的帧 相机/事件/流等资源无效 设备与主机的IP网段不匹配 内存不足 传入的内存空间不足 属性类型错误 属性不可访问、或不能读/写、或读/写失败 属性值超出范围、或者不是步长整数倍 设备不支持的功能 支持设备最大个数 字符串最大长度 失败属性列表最大长度 ExposureEnd事件ID FrameTrigger事件ID FrameStart事件ID AcquisitionStart事件ID AcquisitionTrigger事件ID ReadOut事件ID 枚举:属性类型 整型数 浮点数 枚举 布尔 字符串 命令 分组节点 寄存器节点 未定义 枚举:接口类型 网卡接口类型 USB3.0接口类型 CAMERALINK接口类型 PCIe接口类型 忽略接口类型 无效接口类型 枚举:设备类型 GIGE相机 USB3.0相机 CAMERALINK 相机 PCIe相机 未知类型 枚举:创建句柄方式 通过已枚举设备的索引(从0开始,比如 0, 1, 2...) 通过设备键"厂商:序列号" 通过设备自定义名 通过设备IP地址 枚举:访问权限 GigE相机没有被连接 独占访问权限 非独占可读访问权限 切换控制访问权限 无法确定 未定义访问权限 枚举:抓图策略 按到达顺序处理图片 获取最新的图片 等待获取下一张图片(只针对GigE相机) 未定义 枚举:流事件状态 正常流事件 丢帧事件 丢包事件 图像错误事件 取流错误事件 太多连续重传 太多丢包 枚举:图像转换Bayer格式所用的算法 最近邻 双线性 边缘检测 不支持 枚举:事件类型 设备离线通知 设备在线通知 枚举:视频格式 AVI格式 不支持 枚举:图像翻转类型 垂直(Y轴)翻转 水平(X轴)翻转 枚举:顺时针旋转角度 顺时针旋转90度 顺时针旋转180度 顺时针旋转270度 枚举:图像保存格式 BMP图像格式 JPEG图像格式 PNG图像格式 TIFF图像格式 未定义的图像格式 枚举:图像格式 Undefined Mono1p Mono2p Mono4p Mono8 Mono8S Mono10 Mono10Packed Mono12 Mono12Packed Mono14 Mono16 BayGR8 BayRG8 BayGB8 BayBG8 BayGR10 BayRG10 BayGB10 BayBG10 BayGR12 BayRG12 BayGB12 BayBG12 BayGR10Packed BayRG10Packed BayGB10Packed BayBG10Packed BayGR12Packed BayRG12Packed BayGB12Packed BayBG12Packed BayGR16 BayRG16 BayGB16 BayBG16 RGB8 BGR8 RGBA8 BGRA8 RGB10 BGR10 RGB12 BGR12 RGB16 RGB10V1Packed RGB10P32 RGB12V1Packed RGB565P BGR565P YUV411_8_UYYVYY YUV422_8_UYVY YUV422_8 YUV8_UYV YCbCr8CbYCr YCbCr422_8 YCbCr422_8_CbYCrY YCbCr411_8_CbYYCrYY YCbCr601_8_CbYCr YCbCr601_422_8 YCbCr601_422_8_CbYCrY YCbCr601_411_8_CbYYCrYY YCbCr709_8_CbYCr YCbCr709_422_8 YCbCr709_422_8_CbYCrY YCbCr709_411_8_CbYYCrYY RGB8Planar RGB10Planar RGB12Planar RGB16Planar BayerRG10p, currently used for specific project, please do not use them BayerRG12p, currently used for specific project, please do not use them mono1c, customized image format, used for binary output mono1e, customized image format, used for displaying connected domain 枚举:传输模式(gige) 单播模式 组播模式 字符串信息 字符串.长度不超过256 GigE网卡信息 网卡描述信息 网卡Mac地址 设备Ip地址 子网掩码 默认网关 保留 USB接口信息 USB接口描述信息 USB接口Vendor ID USB接口设备ID USB接口Subsystem ID USB接口Revision USB接口speed 保留 GigE设备信息 设备支持的IP配置选项 value:4 相机只支持LLA value:5 相机支持LLA和Persistent IP value:6 相机支持LLA和DHCP value:7 相机支持LLA、DHCP和Persistent IP value:0 获取失败 设备当前的IP配置选项 value:4 LLA处于活动状态 value:5 LLA和Persistent IP处于活动状态 value:6 LLA和DHCP处于活动状态 value:7 LLA、DHCP和Persistent IP处于活动状态 value:0 获取失败 保留 设备Mac地址 设备Ip地址 子网掩码 默认网关 网络协议版本 Ip配置有效性 Ip配置有效时字符串值"Valid" Ip配置无效时字符串值"Invalid On This Interface" 保留 Usb设备信息 true支持,false不支持,其他值 非法。 true支持,false不支持,其他值 非法。 true支持,false不支持,其他值 非法。 true支持,false不支持,其他值 非法。 true支持,false不支持,其他值 非法。 保留 保留 配置有效性 GenCP 版本 U3V 版本号 设备引导号 设备系列号 设备序列号 设备传输速度 设备最大供电量 保留 设备通用信息 设备类别 保留 厂商:序列号 用户自定义名 设备序列号 厂商 设备型号 设备制造信息 设备版本 保留 设备信息 接口类别 保留 接口名 保留 接口信息 设备信息 Gige设备信息 Usb设备信息 接口信息 GigE网卡信息 Usb接口信息 网络传输模式 传输模式 目标ip地址 目标端口号 预留位 加载失败的属性信息 加载失败的属性个数 加载失败的属性集合,上限128 设备信息列表 设备数量 设备息列表(SDK内部缓存),最多100设备 连接事件信息 事件类型 预留字段 参数更新事件信息 是否是定时更新,true:表示是定时更新,false:表示非定时更新 预留字段 更新的参数个数 更新的参数名称集合(SDK内部缓存) 流事件信息 流通道号 流数据BlockID 时间戳 流事件状态码 事件状态错误码 预留字段 消息通道事件信息 事件Id 消息通道号 流数据BlockID 时间戳 预留字段 参数个数 事件相关的属性名列集合(SDK内部缓存) Chunk数据信息 ChunkID 属性名个数 Chunk数据对应的属性名集合(SDK内部缓存) 帧图像信息 帧Id(仅对GigE/Usb/PCIe相机有效) 数据帧状态(0是正常状态) 图像宽度 图像高度 图像大小 图像像素格式 图像时间戳(仅对GigE/Usb/PCIe相机有效) 帧数据中包含的Chunk个数(仅对GigE/Usb相机有效) 图像paddingX(仅对GigE/Usb/PCIe相机有效) 图像paddingY(仅对GigE/Usb/PCIe相机有效) 图像在网络传输所用的时间(单位:微秒,非GigE相机该值为0) 预留字段 帧图像数据信息 帧图像句柄(SDK内部帧管理用) 帧图像数据的内存首地址 帧信息 预留字段 PCIE设备统计流信息 图像错误的帧数 丢包的帧数 预留 正常获取的帧数 帧率 带宽(Mbps) 预留 U3V设备统计流信息 图像错误的帧数 丢包的帧数 预留 正常获取的帧数 帧率 带宽(Mbps) 预留 Gige设备统计流信息 预留 图像错误的帧数 丢包的帧数 预留 预留 正常获取的帧数 帧率 带宽(Mbps) 预留 统计流信息 设备类型 PCIE设备统计信息 U3V设备统计信息 Gige设备统计信息 枚举属性的枚举值信息 枚举值 symbol名 枚举属性的可设枚举值列表信息 存放枚举值内存大小 存放可设枚举值列表(调用者分配缓存) 像素转换结构体 图像宽 图像高 像素格式 输入图像数据 输入图像长度 图像宽填充 图像高填充 转换Bayer格式算法 目标像素格式 输出数据缓存(调用者分配缓存) 提供的输出缓冲区大小 输出数据长度 预留 图像翻转结构体 图像宽 图像高 像素格式 翻转类型 输入图像数据 输入图像长度 输出数据缓存(调用者分配缓存) 提供的输出缓冲区大小 输出数据长度 预留 图像旋转结构体 图像宽 图像高 像素格式 旋转角度 输入图像数据 输入图像长度 输出数据缓存(调用者分配缓存) 提供的输出缓冲区大小 输出数据长度 预留 保存图像结构体 图像宽 图像高 像素格式 输入图像数据 输入数据大小 输入图片格式 输入文件路径 JPG编码质量(50-99],PNG编码质量[0-9] 转换Bayer格式算法 预留 设备连接状态事件回调函数声明 [in] 回调时主动推送的设备连接状态事件信息 [in] 用户自定义数据 参数更新事件回调函数声明 [in] 回调时主动推送的参数更新事件信息 [in] 用户自定义数据 流事件回调函数声明 [in] 回调时主动推送的流事件信息 [in] 用户自定义数据 消息通道事件回调函数声明 [in] 回调时主动推送的消息通道事件信息 [in] 用户自定义数据 帧数据信息回调函数声明 [in]回调时主动推送的帧信息 [in] 用户自定义数据 相机类 相机构造函数 获取版本信息 成功时返回版本信息,失败时返回NULL 枚举设备 [OUT] 设备列表 [IN] 待枚举的接口类型, 类型可任意组合,如 interfaceTypeGige | interfaceTypeUsb3 成功,返回IMV_OK;错误,返回错误码 1、当interfaceType = interfaceTypeAll 时,枚举所有接口下的在线设备 2、当interfaceType = interfaceTypeGige 时,枚举所有GigE网口下的在线设备 3、当interfaceType = interfaceTypeUsb3 时,枚举所有USB接口下的在线设备 4、当interfaceType = interfaceTypeCL 时,枚举所有CameraLink接口下的在线设备 5、该接口下的interfaceType支持任意接口类型的组合,如,若枚举所有GigE网口和USB3接口下的在线设备时, 可将interfaceType设置为 interfaceType = interfaceTypeGige | interfaceTypeUsb3,其它接口类型组合以此类推 以单播形式枚举设备, 仅限Gige设备使用 [OUT] 设备列表 [IN] 设备的IP地址 成功,返回IMV_OK;错误,返回错误码 通过指定标示符创建设备句柄,如指定索引、设备键、设备自定义名、IP地址. [IN] 创建设备方式 [IN] 指定索引 [IN] 设备键、设备自定义名、IP地址 成功,返回IMV_OK;错误,返回错误码 销毁设备句柄 成功,返回IMV_OK;错误,返回错误码 获取设备信息 [OUT] 设备信息 成功,返回IMV_OK;错误,返回错误码 打开设备 成功,返回IMV_OK;错误,返回错误码 打开设备 [IN] 控制通道权限(IMV_Open默认使用accessPermissionControl权限) 成功,返回IMV_OK;错误,返回错误码 判断设备是否已打开 打开状态,返回true;关闭状态或者掉线状态,返回false 关闭设备 成功,返回IMV_OK;错误,返回错误码 设置传输类型 传输类型结构体 成功,返回IMV_OK;错误,返回错误码 修改设备IP, 仅限Gige设备使用 [IN] IP地址 [IN] 子网掩码 [IN] 默认网关 成功,返回IMV_OK;错误,返回错误码 1、调用该函数时如果pSubnetMask和pGateway都设置了有效值,则以此有效值为准; 2、调用该函数时如果pSubnetMask和pGateway都设置了NULL,则内部实现时用它所连接网卡的子网掩码和网关代替 3、调用该函数时如果pSubnetMask和pGateway两者中其中一个为NULL,另一个非NULL,则返回错误 获取设备的当前访问权限, 仅限Gige设备使用 [OUT] 设备的当前访问权限 成功,返回IMV_OK;错误,返回错误码 设置设备对sdk命令的响应超时时间,仅限Gige设备使用 [IN] 超时时间,单位ms 成功,返回IMV_OK;错误,返回错误码 下载设备描述XML文件,并保存到指定路径,如:D:\\xml.zip [IN] 文件要保存的路径 成功,返回IMV_OK;错误,返回错误码 保存设备配置到指定的位置。同名文件已存在时,覆盖。 [IN] 导出的设备配置文件全名(含路径),如:D:\\config.xml 或 D:\\config.mvcfg 成功,返回IMV_OK;错误,返回错误码 从文件加载设备xml配置 [IN] 设备配置(xml)文件全名(含路径),如:D:\\config.xml 或 D:\\config.mvcfg [OUT] 加载失败的属性名列表。存放加载失败的属性上限为IMV_MAX_ERROR_LIST_NUM。 成功,返回IMV_OK;错误,返回错误码 写用户自定义数据。相机内部保留32768字节用于用户存储自定义数据(此功能针对本品牌相机,其它品牌相机无此功能) [IN] 数据缓冲的指针 [IN] 期望写入的字节数 [OUT] 实际写入的字节数 成功,返回IMV_OK;错误,返回错误码 读用户自定义数据。相机内部保留32768字节用于用户存储自定义数据(此功能针对本品牌相机,其它品牌相机无此功能) [OUT] 数据缓冲的指针 [IN] 期望读出的字节数 [OUT] 实际读出的字节数 成功,返回IMV_OK;错误,返回错误码 往相机串口寄存器写数据,每次写会清除掉上次的数据(此功能只支持包含串口功能的本品牌相机) [IN] 数据缓冲的指针 [IN] 期望写入的字节数 [OUT] 实际写入的字节数 成功,返回IMV_OK;错误,返回错误码 从相机串口寄存器读取串口数据(此功能只支持包含串口功能的本品牌相机 ) [OUT] 数据缓冲的指针 [IN] 期望读出的字节数 [OUT] 实际读出的字节数 成功,返回IMV_OK;错误,返回错误码 设备连接状态事件回调注册 [IN] 设备连接状态事件回调函数 [IN] 用户自定义数据, 可设为NULL 成功,返回IMV_OK;错误,返回错误码 只支持一个回调函数,且设备关闭后,注册会失效,打开设备后需重新注册 参数更新事件回调注册 [IN] 参数更新注册的事件回调函数 [IN] 用户自定义数据, 可设为NULL 成功,返回IMV_OK;错误,返回错误码 只支持一个回调函数,且设备关闭后,注册会失效,打开设备后需重新注册 流通道事件回调注册 [IN] 流通道事件回调注册函数 [IN] 用户自定义数据, 可设为NULL 成功,返回IMV_OK;错误,返回错误码 只支持一个回调函数,且设备关闭后,注册会失效,打开设备后需重新注册 消息通道事件回调注册 [IN] 消息通道事件回调注册函数 [IN] 用户自定义数据, 可设为NULL 成功,返回IMV_OK;错误,返回错误码 只支持一个回调函数,且设备关闭后,注册会失效,打开设备后需重新注册 设置帧数据缓存个数 [IN] 缓存数量 成功,返回IMV_OK;错误,返回错误码 不能在拉流过程中设置 清除帧数据缓存 成功,返回IMV_OK;错误,返回错误码 设置驱动包间隔时间(MS),仅对Gige设备有效 [IN] 包间隔时间,单位是毫秒 成功,返回IMV_OK;错误,返回错误码 触发模式尾包丢失重传机制 设置单次重传最大包个数, 仅对GigE设备有效 [IN] 单次重传最大包个数 成功,返回IMV_OK;错误,返回错误码 maxPacketNum为0时,该功能无效 设置同一帧最大丢包的数量,仅对GigE设备有效 [IN] 最大丢包的数量 成功,返回IMV_OK;错误,返回错误码 maxLostPacketNum为0时,该功能无效 设置U3V设备的传输数据块的数量和大小,仅对USB设备有效 [IN] 传输数据块的数量(范围:5-256) [IN] 传输数据块的大小(范围:8-512, 单位:KByte) 成功,返回IMV_OK;错误,返回错误码 1、传输数据块数量,范围5 - 256, 默认为64,高分辨率高帧率时可以适当增加该值;多台相机共同使用时,可以适当减小该值 2、传输每个数据块大小,范围8 - 512, 默认为64,单位是KByte 开始取流 成功,返回IMV_OK;错误,返回错误码 开始取流 [IN] 允许最多的取帧数,达到指定取帧数后停止取流,如果为0,表示忽略此参数连续取流(IMV_StartGrabbing默认0) [IN] 取流策略,(IMV_StartGrabbing默认使用grabStrartegySequential策略取流) 成功,返回IMV_OK;错误,返回错误码 判断设备是否正在取流 正在取流,返回true;不在取流,返回false 停止取流 成功,返回IMV_OK;错误,返回错误码 注册帧数据回调函数(异步获取帧数据机制) [IN] 帧数据信息回调函数,建议不要在该函数中处理耗时的操作,否则会阻塞后续帧数据的实时性 [IN] 用户自定义数据, 可设为NULL 成功,返回IMV_OK;错误,返回错误码 该异步获取帧数据机制和同步获取帧数据机制(IMV_GetFrame)互斥,对于同一设备,系统中两者只能选其一 只支持一个回调函数, 且设备关闭后,注册会失效,打开设备后需重新注册 获取一帧图像(同步获取帧数据机制) [OUT] 帧数据信息 [IN] 获取一帧图像的超时时间,INFINITE时表示无限等待,直到收到一帧数据或者停止取流。单位是毫秒 成功,返回IMV_OK;错误,返回错误码 该接口不支持多线程调用。 该同步获取帧机制和异步获取帧机制(IMV_AttachGrabbing)互斥,对于同一设备,系统中两者只能选其一。 使用内部缓存获取图像,需要IMV_ReleaseFrame进行释放图像缓存。 释放图像缓存 [IN] 帧数据信息 成功,返回IMV_OK;错误,返回错误码 帧数据深拷贝克隆 [IN] 克隆源帧数据信息 [OUT] 新的帧数据信息 成功,返回IMV_OK;错误,返回错误码 使用IMV_ReleaseFrame进行释放图像缓存。 获取Chunk数据(仅对GigE/Usb相机有效) [IN] 帧数据信息 [IN] 索引ID [OUT] Chunk数据信息 成功,返回IMV_OK;错误,返回错误码 获取流统计信息(IMV_StartGrabbing / IMV_StartGrabbingEx执行后调用) [OUT] 流统计信息数据 成功,返回IMV_OK;错误,返回错误码 重置流统计信息(IMV_StartGrabbing / IMV_StartGrabbingEx执行后调用) 成功,返回IMV_OK;错误,返回错误码 判断属性是否可用 [IN] 属性名 可用,返回true;不可用,返回false 判断属性是否可读 [IN] 属性名 可读,返回true;不可读,返回false 判断属性是否可写 [IN] 属性名 可写,返回true;不可写,返回false 判断属性是否可流 [IN] 属性名 可流,返回true;不可流,返回false 判断属性是否有效 [IN] 属性名 有效,返回true;无效,返回false 获取属性类型 [IN] 属性名 [OUT] 属性类型 获取成功,返回true;获取失败,返回false 获取整型属性值 [IN] 属性名 [OUT] 整型属性值 成功,返回IMV_OK;错误,返回错误码 获取整型属性可设的最小值 [IN] 属性名 [OUT] 整型属性可设的最小值 成功,返回IMV_OK;错误,返回错误码 获取整型属性可设的最大值 [IN] 属性名 [OUT] 整型属性可设的最大值 成功,返回IMV_OK;错误,返回错误码 获取整型属性步长 [IN] 属性名 [OUT] 整型属性步长 成功,返回IMV_OK;错误,返回错误码 设置整型属性值 [IN] 属性名 [IN] 待设置的整型属性值 成功,返回IMV_OK;错误,返回错误码 获取浮点属性值 [IN] 属性名 [OUT] 浮点属性值 成功,返回IMV_OK;错误,返回错误码 获取浮点属性可设的最小值 [IN] 属性名 [OUT] 浮点属性可设的最小值 成功,返回IMV_OK;错误,返回错误码 获取浮点属性可设的最大值 [IN] 属性名 [OUT] 浮点属性可设的最大值 成功,返回IMV_OK;错误,返回错误码 设置浮点属性值 [IN] 属性名 [IN] 待设置的浮点属性值 成功,返回IMV_OK;错误,返回错误码 获取布尔属性值 [IN] 属性名 [OUT] 布尔属性值 成功,返回IMV_OK;错误,返回错误码 设置布尔属性值 [IN] 属性名 [IN] 待设置的布尔属性值 成功,返回IMV_OK;错误,返回错误码 获取枚举属性值 [IN] 属性名 [OUT] 枚举属性值 成功,返回IMV_OK;错误,返回错误码 设置枚举属性值 [IN] 属性名 [IN] 待设置的枚举属性值 成功,返回IMV_OK;错误,返回错误码 获取枚举属性symbol值 [IN] 属性名 [OUT] 枚举属性symbol值 成功,返回IMV_OK;错误,返回错误码 设置枚举属性symbol值 [IN] 属性名 [IN] 待设置的枚举属性symbol值 成功,返回IMV_OK;错误,返回错误码 获取枚举属性的可设枚举值的个数 [IN] 属性名 [OUT] 枚举属性的可设枚举值的个数 成功,返回IMV_OK;错误,返回错误码 获取枚举属性的可设枚举值列表 [IN] 属性名 [OUT] 枚举属性的可设枚举值列表 成功,返回IMV_OK;错误,返回错误码 获取字符串属性值 [IN] 属性名 [OUT] 字符串属性值 成功,返回IMV_OK;错误,返回错误码 设置字符串属性值 [IN] 属性名 [IN] 待设置的字符串属性值 成功,返回IMV_OK;错误,返回错误码 执行命令属性 [IN] 属性名 成功,返回IMV_OK;错误,返回错误码 像素格式转换 [IN][OUT] 像素格式转换参数结构体 成功,返回IMV_OK;错误,返回错误码 只支持转化成目标像素格式gvspPixelRGB8 / gvspPixelBGR8 / gvspPixelMono8 / gvspPixelBGRA8 通过该接口将原始图像数据转换成用户所需的像素格式并存放在调用者指定内存中。 像素格式为YUV411Packed的时,图像宽须能被4整除 像素格式为YUV422Packed的时,图像宽须能被2整除 像素格式为YUYVPacked的时,图像宽须能被2整除 转换后的图像:数据存储是从最上面第一行开始的,这个是相机数据的默认存储方向 图像翻转 [IN][OUT] 图像翻转参数结构体 成功,返回IMV_OK;错误,返回错误码 只支持像素格式gvspPixelRGB8 / gvspPixelBGR8 / gvspPixelMono8的图像的垂直和水平翻转。 通过该接口将原始图像数据翻转后并存放在调用者指定内存中。 图像顺时针旋转 [IN][OUT] 图像旋转参数结构体 成功,返回IMV_OK;错误,返回错误码 只支持gvspPixelRGB8 / gvspPixelBGR8 / gvspPixelMono8格式数据的90/180/270度顺时针旋转。 通过该接口将原始图像数据旋转后并存放在调用者指定内存中。 保存图像到文件 [IN] 保存图片文件参数结构体 成功,返回IMV_OK;错误,返回错误码 该接口支持保存BMP/JPEG/PNG/TIFF,JPEG格式最大支持宽高为65500