工业相机 SDK 开发手册
（C++篇）
Ver1.0
ZheJiang Dahua Technology Co., Ltd.
工业相机 SDK 开发手册（C++篇） Ver1.0
1 / 53
变更履历
编号
变更日期
版本号
变更内容概要
配套 SDK 版本
1
2019/02/28
Ver1.0
初版做成
工业相机 SDK 开发手册（C++篇） Ver1.0
2 / 53
目录
1. SDK 概要说明 ............................................................................................................... 5
1.1. 下载 SDK 安装包 .......................................................................................................... 5
1.2. SDK 支持的操作系统 ................................................................................................... 5
1.3. SDK 安装目录 ............................................................................................................... 6
1.3.1. Windows 版 SDK ........................................................................................... 6
1.3.2. Linux 版 SDK ................................................................................................... 7
1.4. SDK 开发（c++接口）对应的资源 ........................................................................... 8
1.5. SDK 开发工程配置 ....................................................................................................... 9
1.5.1. VC6.0 ................................................................................................................ 9
1.5.2. VS2005 ~ VS2013 ....................................................................................... 12
1.5.3. QT 工程（pro 文件） ................................................................................... 15
1.5.4. Linux 下开发的工程配置方法 ...................................................................... 17
2. SDK 的整体调用流程 .................................................................................................. 19
3. SDK 的各功能接口调用说明....................................................................................... 20
3.1. 生成系统单例 .............................................................................................................. 20
3.2. 设备发现 ...................................................................................................................... 20
3.3. 设备连接/断开 ............................................................................................................ 20
3.4. 读写属性 ...................................................................................................................... 21
3.4.1. 使用常用属性节点 ......................................................................................... 21
3.4.2. 使用通用属性方法 ......................................................................................... 24
3.5. 采集图像 ...................................................................................................................... 30
工业相机 SDK 开发手册（C++篇） Ver1.0
3 / 53
3.5.1. 创建/销毁流对象 ........................................................................................... 30
3.5.2. 设置图像接收缓存个数 ................................................................................. 31
3.5.3. 开始/停止采集图像 ....................................................................................... 32
3.5.4. 获取图像 ......................................................................................................... 33
3.6. 事件通知 ...................................................................................................................... 39
3.6.1. 设备连接状态事件 ......................................................................................... 39
3.6.2. 流事件 ............................................................................................................. 41
3.6.3. 相机消息事件 ................................................................................................. 43
4. 第三方平台的图像对象的转换方法 .......................................................................... 46
4.1. Halcon 对象（HObject） ........................................................................................ 46
4.1.1. 相机图像格式为 Mono8 时 ........................................................................... 46
4.1.2. 相机图像格式为 Mono8 以外时（主要是彩色格式） ............................... 47
4.2. OpenCV 对象（cv::Mat） ....................................................................................... 48
4.2.1. 相机图像格式为 Mono8 时 ........................................................................... 48
4.2.2. 相机图像格式为 Mono8 以外时（主要是彩色格式） ............................... 48
4.3. QT 对象（QImage） ................................................................................................ 48
4.3.1. 相机图像格式为 Mono8 时 ........................................................................... 48
4.3.2. 相机图像格式为 Mono8 以外时（主要是彩色格式） ............................... 49
5. 配套例程说明 .............................................................................................................. 49
6. 常见问题&注意点 ....................................................................................................... 50
6.1. 使用 GigE 相机时，进行断点调试开发时，发现操作相机失败。 ....................... 50
6.2. 只能采集到与图像接收缓存个数一样的图像数 ...................................................... 51
