海康工业相机参数设置与获取

2024-06-02 04:42| 来源: 网络整理| 查看: 265

海康工业相机参数设置与获取通用接口介绍常见相机参数设置获取Int型参数-图像宽度、图像高度Enum型参数-图像格式、触发模式设置float 型参数-曝光、增益设置string型参数-用户名称Command型参数-软触发、参数保存命令

通用接口介绍

拿到海康工业相机之后，通过其官方提供的MVS客户端，我们可以设置相关相机参数，来调整图像，达到我们想要的效果，但是如此众多的相机参数，我们该如何集成进入我们软件呢在这里插入图片描述从查询SDK文档中，可以发现，他们提供了一套通用接口，来对相机进行参数获取与设置通用接口把相机参数，分成六大类，除command参数外，每一类提供Set/Get接口来设置与获取相关节点

类型描述Int整数型参数Enum枚举型参数float浮点型参数bool布尔型参数string字符串型参数Command命令型参数以MV_CC_GeIntValue为例：在这里插入图片描述

代码示例，获取 Width： //获取int型参数 MVCC_INTVALUE struIntValue = {0}; nRet = MV_CC_GetIntValue(handle, "Width", &struIntValue); if (MV_OK != nRet) { printf("error: GetIntValue fail [%x]\n", nRet); return; }

这里的第二个参数“Width”，作为整个接口的关键参数，文档中，告知我们要去查找xml属性表，然后对着查表进行参数设置，xml表如下所示：在这里插入图片描述

功能名称（GetNode: key参数）数据类型数值范围定义访问模式描述Image Format ControlWidthIInteger＞0R/(W)ROI的宽

注意：海康目前以不再维护更新表格，且表格不再对外提供

通过查表，我们可以知道key值该填什么，key值的属性是什么，但是，这样子太慢啦，我怎么知道我调的参数，在xml表的什么位置呢通过观察MVS客户端，有一个更简单的方法能够知道相机参数的属性，类型等，可以快速方便的对参数进行操作

在MVS中找到自己想要的参数，鼠标选中它，在MVS右下角，参数描述中，能看看该参数的节点名、类型、取值范围、步进等信息在这里插入图片描述

上图可知，图像宽度“Width”，其节点名为“Width”，类型是“int”，取值范围是32~2048,步进是16；根据类型，我们就可以选用MV_CC_SetIntValue/MV_CC_GetIntValue来对该属性进行操作；还需注意以下两点：不同的相机参数有不同的类型，取值范围与步进不同的相机，相同的参数，有不同的取值范围与步进常见相机参数设置获取 Int型参数-图像宽度、图像高度 //获取int型参数-Width值 MVCC_INTVALUE struIntValue = {0}; nRet = MV_CC_GetIntValue(handle, "Width", &struIntValue); if (MV_OK != nRet) { printf("error: GetIntValue fail [%x]\n", nRet); } //打印当前宽度，宽带最大值，最小值，步进 printf("Width；%d,Width_Max:%d,Width_min:%d,Width_Inc:%d\n", struIntValue.nCurValue,struIntValue.nMax,struIntValue.nMin,struIntValue.nInc); //设置int型参数-Width值 unsigned int nValue = 752; //注意点1：value值需要是步进值的整数倍，否则会失败 //注意点2：宽度、高度等参数设置时，只有在MV_CC_Startgrab接口调用前才能设置,取流过程中，不能修改宽高 //注意点3：宽度、高度等参数设置时，若有Offset X、Y偏移，应当先调用相关接口，将偏移量置0 nRet = MV_CC_SetIntValue(handle, "Width", nValue); if (MV_OK != nRet) { printf("error: SetIntValue fail [%x]\n", nRet); } Enum型参数-图像格式、触发模式设置 //获取Enum型参数-相机图像格式 MVCC_ENUMVALUE struEnumValue = {0}; nRet = MV_CC_GetEnumValue(handle, "PixelFormat", &struEnumValue); if (MV_OK != nRet) { printf("error: GetEnumValue fail [%x]\n", nRet); } //设置Enum型参数-相机图像格式 //注意点1：相机图像格式设置时，只有在MV_CC_Startgrab接口调用前才能设置,取流过程中，不能修改图像格式 nRet = MV_CC_SetEnumValue(handle, "PixelFormat", PixelType_Gvsp_Mono12); if (MV_OK != nRet) { printf("error: SetEnumValue fail [%x]\n", nRet); } //设置Enum型参数-设置触发模式为on nRet = MV_CC_SetEnumValue(handle, "TriggerMode", MV_TRIGGER_MODE_ON); if (MV_OK != nRet) { printf("Set Trigger Mode fail! nRet [0x%x]\n", nRet); } float 型参数-曝光、增益设置 //获取float型参数-曝光参数获取 MVCC_FLOATVALUE struFloatValue = {0}; nRet = MV_CC_GetFloatValue(handle, "ExposureTime", &struFloatValue); if (MV_OK != nRet) { printf("error: GetFloatValue fail [%x]\n", nRet); } //打印曝光当前值，可设置的最大值、最小值 printf("Exp；%d,Exp_Max:%d,Exp_min:%d\n", struFloatValue.fCurValue,struFloatValue.fMax,struFloatValue.fMin); //获取float型参数-增益参数获取 MVCC_FLOATVALUE struFloatValue = {0}; nRet = MV_CC_GetFloatValue(handle, "Gain", &struFloatValue); if (MV_OK != nRet) { printf("error: GetFloatValue fail [%x]\n", nRet); } //打印增益当前值，可设置的最大值、最小值 printf("Gain；%d,Gain_Max:%d,Gain_min:%d\n", struFloatValue.fCurValue,struFloatValue.fMax,struFloatValue.fMin); //获取float型参数-曝光值 //注意点1：曝光设置有前置条件需要注意，例如自动曝光、曝光模式等，前置条件是否调用，可以再MVS里面观察，设置曝光时，是否提前勾选了其他参数 float fValue = 1000; nRet = MV_CC_SetFloatValue(handle, "ExposureTime", fValue); if (MV_OK != nRet) { printf("error: SetFloatValue fail [%x]\n", nRet); } //获取float型参数-增益值 //注意点1：增益设置有前置条件需要注意，例如自动增益，前置条件是否调用，可以再MVS里面观察，设置增益时，是否提前勾选了其他参数 //注意点2：海康小部分相机增益节点不叫“Gain”，也不是用float节点进行设置，如果遇到了，就在MVS里面观察使用对应接口吧 float fValue = 5; nRet = MV_CC_SetFloatValue(handle, "Gain", fValue); if (MV_OK != nRet) { printf("error: SetFloatValue fail [%x]\n", nRet); } string型参数-用户名称 //获取string型参数 MVCC_STRINGVALUE struStringValue = {0}; nRet = MV_CC_GetStringValue(handle, "DeviceUserID", &struStringValue); if (MV_OK != nRet) { printf("error: GetStringValue fail [%x]\n", nRet); } printf("DeviceUserID:[%s]\n", struStringValue.chCurValue); //设置string型参数-自定义用户名称 nRet = MV_CC_SetStringValue(handle, "DeviceUserID", "HikCamera"); if (MV_OK != nRet) { printf("error: SetStringValue fail [%x]\n", nRet); } Command型参数-软触发、参数保存命令 //设置Command型节点-发送软触发命令 nRet = MV_CC_SetCommandValue(m_handle, "TriggerSoftware"); if (MV_OK != nRet) { printf("error: SetCommandValue fail [%x]\n", nRet); }

参数保存，需要用到一些组合参数

//设置Enum型参数-相机参数保存/默认加载项 //仅需在opendevice之后，初始化执行一次 UserSetSelector/UserSetDefault即可 nRet = MV_CC_SetEnumValue(handle, "UserSetSelector", 1); if (MV_OK != nRet) { printf("Set UserSetSelector 1! nRet [0x%x]\n", nRet); } nRet = MV_CC_SetEnumValue(handle, "UserSetDefault", 1); if (MV_OK != nRet) { printf("Set UserSetDefault 1! nRet [0x%x]\n", nRet); } //设置Command型节点-发送参数保存命令-参数会保存到相机内部ROM里面 //当修改参数完成后，可以调用该节点进行参数保存 //执行成功后，掉电不会消失 nRet = MV_CC_SetCommandValue(m_handle, "UserSetSave"); if (MV_OK != nRet) { printf("Set UserSetSave fail [%x]\n", nRet); }

其他的参数与功能，查询MVS参数描述与功能不同的功能，需要组合不同的参数，注意MVS中的操作顺序，以便调整sdk接口的调用顺序与函数位置

【本文地址】

公司简介

联系我们