文档介绍：工业相机SDK接口设计说明书编制审核同意目录1. 介绍 目标及范围 相关术语 参考资料 32. 分析设计 设计思想 接口结构 数据流分析 63. 接口描述(C++接口) 传输层工厂类 设备控制类 GenApi 164. 接口描述(C接口) 相机控制通用接口 XML相关接口 GigEVision相机特有接口 U3V相机特有接口 435. 数据结构描述 MV_GIGE_DEVICE_INFO(GigE设备信息) MV_USB3_DEVICE_INFO(USB3设备信息) _DEVICE_INFO(相机信息统一结构体) MV_FRAME_OUT_INFO(输出帧信息) MV_XML_NODE_FEATURE(xml节点基础信息) 476. 修订统计 48介绍目标及范围本文档目标是设计一套工业相机SDK统一接口,兼容GigEVision、1394、U3V和CameraLink等标准协议。业务层软件可同时调用GenApi和这套接口,以实现对相机控制。目前版本仅支持GigEVision和U3V两种传输协议,所以关键依据《GigEVisionSDK产品需求规格说明书》和《USB3VisionSDK产品需求规格说明书》进行设计,以后会在此版本基础上逐步完善。本文档预期读者是项目经理、软件具体设计者、软件开发人员、测试人员和项目管理人员等。相关术语术语/缩写含义GigEVisionGigEVision是由自动化影像协会AIA(AutomatedImagingAssociation)提议指定一个基于千兆以太网图像传输标准。含有传输距离长(无中继时100米)、传输效率高并可向上升级到万兆网、通信控制方便、软硬件交换性强、可靠性高等优点,是未来数字图像领域关键接口标准,必将被越来越多商家多采取。U3V全称USB3Vision,,传输速度快。SDK应用软件开发包。GenICam通用相机接口,属于上层应用开发通用接口协议。GenApiGenICam相机接口部分参考资料《》.《》.《》.eBUSSDKC++,提取共性后设计通用接口和结构体,使得上层应用软件不需要关心具体相机协议。其次要支持GenICam,把GenApi引入作为SDK接口一部分。但因为GenApi是C++类形式接口,为保持接口风格一致性和用户需求,我们也需要设计一套C++接口。另外,为简化SDK调用步骤和上层软件开发难度,我们还要设计一套C接口。最终遵照SDK易扩展性设计了这套SDK。接口结构接口分C++和C两套:C++接口目前版本关键包含3个类:传输层工厂类,经过该类获取单件实例,然后枚举在线设备,和创建和销毁设备;设备控制类,经过该类控制指定设备,包含开启停止设备、获取图像等;GenApi,经过该模块能够获取和设置相机参数。-1接口结构图C接口C接口分为四个方向:相机控制通用接口,包含创建句柄、连接设备、获取图像数据等;XML相关接口,内部封装了GenICam,实现XML解析和全部相机参数节点获取及设置;GigEVision相机特有接口,如强制IP、设置网络驱动模式等;U3V相机特有接口。-1数据流图接口描述(C++接口)C++接口以类形式提供,所以接口描述也根据类来划分,可划分为三大模块:,TlFactory&GetInstance();输入参数代码/名称数据类型参数说明无无无输出参数代码/名称数据类型参数说明无无无返回值返回传输层工厂单件处理过程把工厂内部定义静态组员单件实例返回备注无示例 CTlFactory&tlFactory=CTlFactory::GetInstance();&GetInstance();输入参数代码/名称数据类型参数说明无无无输出参数代码/名称数据类型参数说明无