海康工业相机功能模块-参数保存、加载、批量复制参数

前言

前面一篇文章,讲了工业相机参数如何设置与获取,使用sdk能够将自己想要的参数快速的配置进自己的程序,但是,在实际使用中,我们会发现,sdk配置的参数似乎在断电只会就消失啦,不能实现断电生效???
软件开发过程中,只能够配置常见的参数,一些偏门的参数,非常见的相机调试参数,如何批量设置进相机、如果断电能够保存???
这一篇文章就是来介绍、解决这个问题

相机参数保存的快速方法

  • MVS如何操作

参考相机用户手册提供的方法,主要操作分为3步

  1. 修改参数后,通过User Set Selector 参数下拉选择其中一套User Set 参数,例如选择"User Set 1"(你的参数保存在哪里)
  2. 通过User Set default参数下拉选择其中一套User Set 参数,例如选择"User Set 1"(相机重新上电后,加载那套参数)
  3. 点击User Set Save 处的“Execute”,即可将参数保存到用户参数中(实际有效的保存操作)
    在这里插入图片描述
  • sdk接口如何调用-UserSetSave方法
    参考在MVS里面的操作,主要是三句话的调用
//初始化部分,放在Opendevice之后即可
nRet = MV_CC_SetEnumValue(handle, "UserSetSelector", 1);
if (MV_OK != nRet)
{
    
    
	printf("error: SetEnumValue UserSetSelector fail [%x]\n", nRet);
}
nRet = MV_CC_SetEnumValue(handle, "UserSetDefault", 1);
if (MV_OK != nRet)
{
    
    
	printf("error: SetEnumValue UserSetDefault fail [%x]\n", nRet);
}
//设置Command型节点-发送参数保存命令
//大部分参数修改完成后,调用此命令进行保存,不建议频繁调用
nRet = MV_CC_SetCommandValue(m_handle, "UserSetSave");
if (MV_OK != nRet)
{
    
    
	printf("error: SetCommandValue fail [%x]\n", nRet);
}

相机参数导入导出的操作方法

UserSetLoad 加载相机内部参数

  1. 方法1: UserSetLoad 加载相机内部参数
    上面讲了,使用UserSetSave方法,相机支持3套用户参数保存,那么我们可以将不同的参数保存到不同的UserSetSelector里面,然后使用UserSetLoad 把参数再调出来,实现不同参数组合的切换
    代码实现也很简单
    参数保存,参考上面的伪代码,参数加载如下:
nRet = MV_CC_SetEnumValue(handle, "UserSetSelector", 1);//切换不同的参数组
if (MV_OK != nRet)
{
    
    
	printf("error: SetEnumValue UserSetSelector fail [%x]\n", nRet);
}
nRet = MV_CC_SetCommandValue(m_handle, "UserSetLoad");//load
if (MV_OK != nRet)
{
    
    
	printf("error: SetCommandValue fail [%x]\n", nRet);
}

FeatureLoad/FeatureSave

  1. 方法2:FeatureLoad/FeatureSave
    参考MVS提供的示例程序:C:\Program Files (x86)\MVS\Development\Samples\VC\VS\SimpleSamples\ParametrizeCamera_LoadAndSave
    关键代码:
 // ch:打开设备 | en:Open device
        nRet = MV_CC_OpenDevice(handle);
        if (MV_OK != nRet)
        {
    
    
            printf("Open Device fail! nRet [0x%x]\n", nRet);
            break;
        }
        printf("Start export the camera properties to the file\n");
        printf("Wait......\n");
        // ch:将相机属性导出到文件中 | en:Export the camera properties to the file
        nRet = MV_CC_FeatureSave(handle, "FeatureFile.ini");
        if (MV_OK != nRet)
        {
    
    
            printf("Save Feature fail! nRet [0x%x]\n", nRet);
            break;
        }
        printf("Finish export the camera properties to the file\n\n");
        //--------------------------------------------------------------------------
        printf("Start import the camera properties from the file\n");
        printf("Wait......\n");
        // ch:从文件中导入相机属性 | en:Import the camera properties from the file
        nRet = MV_CC_FeatureLoad(handle, "FeatureFile.ini");
        if (MV_OK != nRet)
        {
    
    
            printf("Load Feature fail! nRet [0x%x]\n", nRet);
            break;
        }
        printf("Finish import the camera properties from the file\n");
        // ch:关闭设备 | Close device
        nRet = MV_CC_CloseDevice(handle);
        if (MV_OK != nRet)
        {
    
    
            printf("ClosDevice fail! nRet [0x%x]\n", nRet);
            break;
        }

调用MV_CC_FeatureSave接口,可以将相机参数导出到本地,形成一个.ini结尾的文件,打开这个文件可以看见相机的参加参数,例如曝光、增益等
在这里插入图片描述
修改这个文件中的你想要修改的参数值,再调用MV_CC_FeatureLoad可以重新导入修改之后的参数
如果是批量应用的话,事先导出一份ini文件,然后使用FeatureLoad的接口,就可以实现批量化的参数设置,减少人员调试

当然,这个功能暂时也有几个缺点:

  • 只能导出部分参数,只能导出Streamable属性为YES的参数,为NO的参数无法导出,这个属性取决于相机,相机支持就能导出;目前根据观察,海康大部分相机的常见参数,都是YES啦,因此,也无需更多的关心这个问题
    在这里插入图片描述
  • 不同固件版本、不同相机型号,ini文件不能互相导入
  • 无法与MVS客户端互相兼容,MVS不支持ini文件导入

FileAccess 功能

  • 方法3:FileAccess 功能
    这个功能,是将方法1中的userset参数读出与重新写入,不过,导出来的文件是bin文件,不能够被直接阅读与修改
    示例程序:C:\Program Files (x86)\MVS\Development\Samples\VC\VS\SimpleSamples\ParametrizeCamera_FileAccess
    关键代码:
MV_CC_FILE_ACCESS stFileAccess = {
    
    0};

    stFileAccess.pUserFileName = "UserSet1.bin";
    stFileAccess.pDevFileName = "UserSet1";
    if (1 == g_nMode)
    {
    
    
        //ch:读模式 |en:Read mode
        g_nRet = MV_CC_FileAccessRead(pUser, &stFileAccess);
        if (MV_OK != g_nRet)
        {
    
    
            printf("File Access Read fail! nRet [0x%x]\n", g_nRet);
        }
    }
    else if (2 == g_nMode)
    {
    
    
        //ch:写模式 |en:Write mode
        g_nRet = MV_CC_FileAccessWrite(pUser, &stFileAccess);
        if (MV_OK != g_nRet)
        {
    
    
            printf("File Access Write fail! nRet [0x%x]\n", g_nRet);
        }
    }

缺点:

  • bin文件不能被阅读与修改
  • .要求相机型号、固件版本号一致
  • 无法与MVS客户端互相兼容,MVS不支持bin文件导入

MVS导入导出功能

方法4:MVS导入导出功能
前面提到的方法2、方法3都是sdk调用层面的使用方法,且不与MVS兼容,那么再不修改代码增加软件功能的情况下,如何使用MVS批量导入参数呢?
版本要求:MVS3.2.1版本及其以上
使用方法很简单,链接相机后,在属性界面的上方找到导入/导出的图标按钮,点击即可,生成.mfs后缀的文件即可
在这里插入图片描述
缺点就是:
此方法是MVS软件实现的,没有开放出来接口供用户调用

几种方法的优缺点比较

方法 优点 缺点
UserSetLoad (推荐使用) 操作简单、MVS、sdk都可以操作实现 批量机台复制操作不易
FeatureLoad/FeatureSave ini文件可读性高,批量机台复制简单、参数修改简单 需代码开发;MVS不兼容
FileAccess 批量复制简单 bin文件不可读;MVS不兼容
MVS导入导出(推荐使用) 批量复制简单 无接口开放

猜你喜欢

转载自blog.csdn.net/qq_23107577/article/details/114261188