文档介绍：: .
工业相机SDK
接口设计说明书
编制
审核
批准
目录
1. 简介 3
目标及范围 3
相关术语 3
参考资料 3
2. 分析设计 5
设计思想 5
接口结构 5
数据流分析 6
3. 接口描述（C++接口） 8
传输层工厂类 8
设备控制类 11
GENAPI 16
4. 接口描述（C接口） 21
相机控制通用接口 21
XML 相关接口 37
GIGEVSION相机特有的接口 41
U3V相机特有的接口 44
5. 数据结构描述
44
MV_GIGE_DEVICE_INFO（ GIGE 设备信息） 44
MV_USB3_DEVICE_INF0（ USB3设备信息） 45
MV_CC_DEVICE_INF（相机信息统一结构体） 45
MV_FRAME_OUT_INFO输岀帧信息） 46
MV_XML_NODE_FEATURXML节点基本信息） 47
简介

本文档的目的是设计一套工业相机 SDK的统一接口，兼容 GigEVision、1394、U3V 和CameraLink等标准协议。业务层软件可同时调用 GenApi和这套接口，以实现对相机的控制。当前版本仅支持GigEVision和U3V两种传输协议，所以主要根据
《GigEVisionSDK产品需求规格说明书》和《USB3VisionSDK产品需求规格说明书》进行设计，今后会在此版本的基础上逐渐完善。
本文档的预期读者是项目经理、软件详细设计者、软件开发人员、测试人员和项目管理人员等。

术语/缩写
含义
GigEVisio n
GigE Visio n 是由自动化影像协会 AIA(Automated Imagi ng Associatio n)
发起指定的一种基于千兆以太网的图像传输的标准。具有传输距离长(无中
继时100米)、传输效率咼并可向上升级到万兆网、通信控制方便、软硬件互换性强、可靠性高等优点，是未来数字图像领域的主要接口标准，必将被越来越多的商家多米用。
U3V
全称USB3 Vision，是一种基于，传输速度快。
SDK
应用软件开发包。
Gen ICam
通用相机接口，属于上层应用开发的通用接口协议。
Ge nApi
Gen ICa m的相机接口部分

《》
《》.
《》.
eBUS SDK C++ .
FlyCapture2 C .

JAI
.

分析设计
2 设计思想
工业相机SDK勺设计首先考虑的是支持多个相机协议，提取共性后设计通用的接口和结构体，使得上层应用软件不需要关心具体的相机协议。其次要支持 GenICam把
GenApi引入作为SDK接口的一部分。但由于 GenApi是C+啖形式的接口，为保持接口风格的一致性和用户的需求，我们也需要设计一套 C++S 口。另外，为简化SDK的调用流程和上层软件的开发难度，我们还要设计一套 C接口。最后遵循SDK的易扩展性设计了这套 SDK。
2 接口结构
接口分C++ffi C两套：
C++接口
当前版本主要包含 3 个类：
传输层工厂类，通过该类获取单件实例，然后枚举在线设备，以及创建和销毁设备；
设备控制类，通过该类控制指定的设备，包括开启停止设备、获取图像等；
GenApi,通过该模块可以获取和设置相机参数
SDK I nteface
-1接口结构图
GenApi
C接口
C接口分为四个方向：
相机控制通用接口，包含创建句柄、连接设备、获取图像数据等；
XML相关接口，内部封装了