文章目录
- 1 MVS基础简介
- 1.1 SDK定义
- 1.3-相机SDK开发包位置-----制作文档、库、示例
- 1.5 运行时库路径
- 1.6-相机出图与SDK取图机制
- 1.7-相机出图与SDK取图机制
- 2 MVS基础特性结合SDK讲解、
- 2.1 枚举相机
- 2.3 检查设备是否可访问
- 2.4 检查设备是否可访问
- 2.5 创建句柄，连接相机
- 2.7开始采集&停止采集
- 3 参数类型
- 3.1 Float型参数
- 3.2 Int型参数
- 4 部分常用功能
- 5 编程引导及制作手册
海康工业相机SDK二次开发
1 MVS基础简介
1.1 SDK定义
1.3-相机SDK开发包位置-----开发文档、库、示例
1.4-SDK开发文档
开发文档路径C:\Program Files (x86)\MVS\Development\Documentations
1.5 运行时库路径
运行时库路径——运行时库会存放在系统的软件默认安装目录 C:\Program Files (x86)\Common Files\MVS\Runtime\下。
通过这个运行时库能够让用户在编写程序时，不需拷贝依赖的动态链接库到其程序当前目录下。
采集卡SDK
第三方支持的插件
各种语言制作例程
1.6-相机出图与SDK取图机制
SDK取图机制
工业相机SDK提供的取图函数并不是从相机内部取图，而是从驱动内部的缓存池中取图。
正常情况下，相机的每一张图像都会从相机拍摄搞定开始，无等待、无滞留地传输到缓存池中等待用户取出。而未被取出的图像就会被新的图像覆盖掉。
1.7-相机出图与SDK取图机制
SDK基础流程
工业相机开发指南->编程引导部分有详细的介绍
2 MVS基础功能结合SDK讲解、
2.1 枚举相机
(1) 枚举相机: 获得设备列表，此处调用MV CC EnumDevices ();
(2)其中结构体中
- nTLayerType表示枚举相机类型;
- pstDevList为输出设备列表;
- strManufacturerName为厂商名字;
- enSortMethod为排序方式;
(3) eg: nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE, &stDeviceList),表示查找GigE和USB3.0设备;
2.2 枚举相机
否可访问就是2.3 检查设备
- （1）一般设备都默认为独占权限。
- （2）在独占权限下，其他App无法连接设备，:表现为左上图红色占用图标
- （3）只允许读CCP寄存器，即为左上图IP、厂商、型号、序列号等 (更多信息即为右侧结构体)
2.4 检查设备是否可访问
枚举相机在打开指定设备前，调用 MV_CC_IsDeviceAccessible() 检查指定设备是否可访问。
(1) 询问设备是否可以在特定模式下可达，调用 MV_CC_IsDeviceAccessible()，读取设备CCP寄存器的值，判断当前状态是否具有某种访问权限。
(2) pstDevlnfo，为枚举到的设备信息; nAccessMode，为需要判定的某种访问权限；
(3)可达，返回true;不可达返回false;
当已经有一个相机连接时，再开一个MVS连接相机时，已被占用，表现为禁止状态，
2.5 创建句柄，连接相机
(1)创建句柄:
pstDevlnfo为输入的设备信息结构体，比如设备数量;handle为输出的设备句柄;比如:nRet =MV_CC_CreateHandle(&handle,stDeviceList.pDevicelnfo[nIndex]);(2)连接相机:
handle为输入的设备柄;nAccessMode为访问权限;nSwitchoverKey为切换访问权限时的密钥;比如nRet = MV_CC_OpenDevice(handle);
注意:
- (1)一般默认设备访问模式为独占权限，此时即可省略
nAccessMode与nSwitchoverKey。 - (2)句柄(Handle)是一个是用来标识对象或者项目的标识符，许可用来描述窗体、文档等，是Windows用来表示对象的。
（1）通过指定信息连接相机，eg: 序列号；
(2) 输入相机序列号，并通过strcmp函数来判断输入系列号和列表中序列号，找到对应设备，最终判断是否找到序列号或者;
2.7开始采集&停止采集
- (1) 点击此处，开始采集，使用
MV_CC_StartGrabbing();再次点击此处即为停止0采集，此时为MV_CC_ StopGrabbing(); - (2)
eg: MV_CC_StartGrabbing(handle);
3 参数类型
3.1 Float型参数
设置参数一-曝光时间:
- 可以设置的最小、最大值;就是(1)Node Name为参数名;Type为参数类型;Min、Max
- (2) 设置参数
MV_CC_SetFloatValue(); - (3) strKey为参数名称;fValue为想要设置的设备属性值；
- (4)设置参数，eg:
MV_CC_SetFloatValue(handle,“ExposureTime”，5000);
注意:Float浮点型数据类型，Float数据类型用于存储单精度浮点数或双精度浮点数；
获取参数一一曝光时间:
- (1)获取参数
MV_CC_GetFloatValue(); - (2) strKey为参数名称;pstFloatValue为返回值;
- (3)
fCurValue为当前值;fMax为最大值;fMin为最小值; - (4)逻辑为:开辟一块空间 (memset) ，再将获取到的值赋予这个空间;
3.2 Int型参数
设置&获取相机参数一图像宽度:
- (1) 设置参数
MV_CC_SetlntValue(); 获取参数MV_CC_GetIntValue(); - (2)其中Inc代表步进值，此处的代表: 宽度只能以16的倍数进行设置;
(在MVS中步长设置错误，会自动调整为最近的n倍步长，如果在SDK研发中步长设置错误，会报错)
注意:Int型参数，INT是用于定义整数类型变量的标识符;