相机在工作中,有许多可以自由调节的参数,如帧率,曝光时间,图像滤波开关等。不同的应用场景对于工作参数的需求也不同,用户可以根据自己的需求进行自由设置。为了方便用户的调试与使用,Vzense相机开发与设计了两种方法可以帮助用户预设相机的工作参数。本文介绍了Vzense 3D ToF相机如何设置相机参数以及生成相应的配置文件。
Table of Contents
参数设置方法
相机内部存储出厂默认参数,上电后会读取内部参数并设置生效。SDK连接相机后,由API控制是否设置其他参数,若不设置则使用相机默认参数运行。如果进行参数设置,则会动态改变相机工作参数运行,但不改变相机内部默认参数,即断电后不保存。默认参数设置方法分为软件设置方法与硬件设置方法。
软件设置方法:通过SDK读取配置文件,实时设置参数值,使相机动态生效,不改变相机默认参数,断电不保存,需要每次上电时执行一次。
硬件设置方法:通过工具将配置文件导入到相机设备中,改变相机的默认参数,断电保存,重启生效。
注意:部分机型不支持硬件设置方法,具体机型是否支持,请联系FAE确认。
生成配置文件
使用ScepterGUITool工具,打开相机。根据使用场景,调节工具中对应的相机参数,调整完毕,点击“Generate”,生成配置文件,提示保存成功,配置文件保存在JsonConfig文件夹下,以 ’相机品类_ 年_ 月_ 日_ 时_ 分_ 秒_ SN.json‘ 格式命名,可以点击链接跳转到生成的文件处,如下图所示:
软件设置方法
1、ScepterGUITool使用:当前操作设置参数不改变相机设备内部参数,断电后不保存。
将相机断电重启,使用ScepterGUITool打开相机,此时ScepterGUITool显示的相机工作参数为相机默认参数。点击“ApplyByApp”后,选择之前生成的配置文件,提示导入成功后,当前使用的工作参数已经设置为与配置文件一致。重启再次连接后,配置文件的参数不会生效。
如下图所示:
2、SDK相关API:
参考例程:
BaseSDK/Windows/Samples/Base/DS86/DeviceSetParamsByJson。
与ScepterGUITool的“ApplyByApp”功能一致,如果需要在工程代码中使用导入工具配置功能,可以通过如下API调用。
//通过Json文件设置参数保存至ScepterGUITool,相机断电后不保存
ScStatus scSetParamsByJson(ScDeviceHandle device, char* pfilePath);
硬件设置方法
1、ScepterGUITool使用:当前操作设置参数修改相机设备内部参数,断电后仍保存。
使用ScepterGUITool工具,打开相机。点击“ImportToDevice”,选择配置文件,提示导入成功后需要重启生效。重启再次连接后,配置文件的参数自动生效使用,如下图所示:
2、SDK相关API:
参考例程:
BaseSDK/Windows/Samples/Base/DS86/DeviceImportParamInitFile。
与ScepterGUITool的“ImportToDevice”功能一致,如果需要在工程代码中使用导入相机配置功能,可以通过如下API调用。
//将参数设置保存至相机内部参数,断电重启仍生效
ScStatus scImportParamInitFile(ScDeviceHandle device, char* pfilePath);
参数恢复出厂设置
1、ScepterGUITool使用:当前操作将相机内部参数恢复出厂默认设置。
使用ScepterGUITool工具,打开相机。点击“RestoreDevice”后,执行成功,相机重启,参数更新为默认设置。如下图所示:
2、SDK相关API:
与ScepterGUITool的“RestoreDevice”功能一致,如果需要在工程代码中使用恢复出厂设置功能,可以通过如下API调用。
//重置设备参数为默认参数
ScStatus scRestoreParamInitFile(ScDeviceHandle device);