大恒图像系列数字摄像机
数字摄像机软件开发说明书
2007 年 10 月版本手册中所提及的其它软硬件产品的商标与名称，都属于相应
公司所有。
本手册的版权属于中国大恒（集团）有限公司 北京图像视觉技
术分公司所有。未得到本公司的正式许可，任何组织或个人均不得
以任何手段和形式对本手册内容进行复制或传播。
本手册的内容若有任何修改，恕不另行通知。
© 2007 中国大恒（集团）有限公司北京图像视觉技术分公司 版权所有
网站：http://www.daheng-image.com
销售信箱：sales@daheng-image.com
销售热线：010-82828878转8021
支持信箱：support@daheng-image.com
支持热线：010-82828878转8006前 言
首先感谢您选用大恒图像产品，数字摄像机应用接口库是我公
司提供的应用程序接口函数。它基本上概括了数字摄像机应用程序
编程中涉及的各个方面，通过应用接口库，用户可以很好地了解数
字摄像机的运行机制，并在此基础上进行应用程序的开发。
数字摄像机应用接口库按照模块分为应用功能模块和扩充功能
模块。其中应用功能模块包括数字摄像机的控制、采集图像到内存、
错误处理等功能，扩充功能模块包括图像数据的转换等功能。
本手册按功能对接口库中的函数进行了划分，对于每一个功能
部分的函数都具体给出了它们的函数原型、参数定义、说明、示例
等信息。
手册为用户进行数字摄像机的二次开发提供了详细的说明，如
果用户在使用过程中发现错误和纰漏，请与我公司的销售或技术服
务部门联系，以便我们及时改进。目录
目 录
1概述.................................................. 1
1.1功能................................................ 1
1.2文件................................................ 2
1.2.1应用功能模块...................................... 2
1.2.2扩充功能模块...................................... 2
1.3开发工具............................................ 2
1.4应用程序的发布...................................... 3
2说明.................................................. 4
2.1 应用功能 ........................................... 4
2.1.1 定义 ............................................. 4
2.1.1.1 常量 ........................................... 4
2.1.1.2 结构 .......................................... 16
2.1.1.3 宏 ............................................ 19
2.1.2函数说明......................................... 21
2.1.2.1数字摄像机的控制............................... 21
1．函 数：BeginHVDevice............................... 21
2．函 数：EndHVDevice................................. 22
3．函 数：HVSetResolution............................. 23
4．函 数：HVSetOutputWindow........................... 24
5．函 数 HVSetBlanking............................... 25
6．函 数：HVSetSnapMode............................... 26
7．函 数：HVSetTriggerPolarity........................ 26
8．函 数：HVSetStrobePolarity......................... 27目录
9．函 数：HVSetSnapSpeed.............................. 28
10．函 数：HVEnableVideoMirror........................ 28
11．函 数：HVADCControl............................... 29
12．函 数：HVAGCControl............................... 31
13．函 数：HVAECControl............................... 32
14．函 数：HVCommand.................................. 33
2.1.2.2采集图像到内存................................. 37
1．函 数：HVSnapShot.................................. 37
2．函 数：HVOpenSnap.................................. 38
3．函 数：HVCloseSnap................................. 39
4．函 数：HVStartSnap................................. 40
5．函 数：HVStopSnap.................................. 41
6．函 数：HVTriggerShot............................... 41
7．函 数：HVWaitSync.................................. 42
2.1.2.3错误处理....................................... 42
1．函 数：HVGetErrorString............................ 42
2.1.2.4其它功能....................................... 43
1．函 数：HVGetDeviceTotal............................ 43
2．函 数：HVGetDeviceInfo............................. 43
4．函 数：HVDeviceMemRead............................. 47
5．函 数：HVDeviceMemWrite............................ 48
2.2扩充功能........................................... 49
2.2.1 定义 ............................................ 49
2.2.1.1 常量 .......................................... 49
2.2.2 函数说明 ........................................ 52目录
2.2.2.1图像数据的转换及校正........................... 52
1．函 数：ConvertBayer2RGB............................ 52
2．函 数：GetWhiteBalanceRatio........................ 53
3．函 数：SetGammaLut................................. 54
4．函 数：DetectDeadPixel............................. 55
5．函 数：EraseDeadPixel.............................. 55
6．函 数：GetPatternNoise............................. 56
7．函 数：AvgPatternNoise............................. 57
8．函 数：FixPatternNoise............................. 58
3.附录 ................................................ 60
3.1函数返回值代码表................................... 60
3.2 SV1310FC摄像机功能调用函数列表 .................... 62
3.3 SV1311FC摄像机功能调用函数列表 .................... 63
3.4 SDK中新增功能相关结构说明及实例 ................... 64
4.备注 ................................................ 68概述
1 概述
在 Microsoft 的 32 位 Windows 操作系统中，数字摄像机应用
接口库直接操作数字摄像机，并提供给用户一个简单明确的应用接
口。用户在编制自己的应用程序时，可以直接调用这些库函数来实
现指定的功能。
数字摄像机工作流程如下：
开始（初始化指定设备，申请资源）
参数设置（分辨率、图像窗口、曝光、增益等）
采集图像到内存（采集、停止、读取、存储）

在电气行业中，数字摄像机软件开发说明书通常是指针对专门用于控制、操作或处理数字摄像机设备的计算机程序及其相关文档的集合。这份说明书详细阐述了以下内容： 1. **产品介绍**：它会定义所涉及的数字摄像机类型（如高清、4K、网络摄像机等），以及配套使用的软件的主要功能和特性，例如图像捕捉、视频录制、实时监控、远程访问、变焦控制、白平衡调整、曝光补偿等功能。 2. **系统需求**：说明所需的硬件环境，如处理器类型、内存大小、硬盘空间，以及操作系统兼容性（Windows, macOS, Linux 等）等。 3. **安装指南**：提供详细的安装步骤，包括软件下载、解压、注册信息输入、驱动程序安装、软件配置等内容，确保用户能够顺利将软件与摄像机连接并运行。 4. **操作手册**：详细介绍各项功能的操作方法和使用流程，如如何启动/关闭摄像机、设置录像模式、预览画面、存储路径选择、时间日期同步、报警设置等。 5. **故障排除**：列出常见问题及解决办法，帮助用户快速诊断和修复在使用过程中遇到的问题。 6. **技术规格**：包含软件版本号、版权信息、技术支持联系方式等相关技术参数。 总之，这份数字摄像机软件开发说明书为用户提供了一套全面、详尽的指导，以便他们能够有效地管理和利用该款摄像机软件以满足其各种拍摄和监控需求。