Baumer工业相机

Baumer工业相机堡盟相机是一种高性能、高质量的工业相机，可用于各种应用场景，如物体检测、计数和识别、运动分析和图像处理。

Baumer的万兆网相机拥有出色的图像处理性能，可以实时传输高分辨率图像。此外，该相机还具有快速数据传输、低功耗、易于集成以及高度可扩展性等特点。

Baumer工业相机通过使用BGAPI SDK进行开发时，可以通过UserSet用户设置功能允许用户为特定应用定制和保存相机设置。。

Baumer工业相机BGAPISDK中UserSet的技术背景

工业相机旨在为机器视觉、检查、机器人和自动化等工业应用捕捉高质量图像和视频。它们配备了各种先进的特性和功能，包括用户设置功能。

UserSet用户设置功能允许用户为特定应用定制和保存相机设置。这意味着用户可以对相机进行一次设置，然后在需要时轻松调用这些设置，而不必每次都手动调整相机。这有助于确保一致和准确的结果，减少设置时间和精力，并提高工作效率。

UserSet用户设置的功能可能因具体的相机型号和制造商而不同。然而，一些可通过用户设置定制的常见功能包括曝光时间、增益、白平衡、对比度、清晰度、色彩校正和触发模式。

为了利用用户设置功能，用户通常通过相机上的一个物理按钮或通过电脑上的一个软件应用程序进入相机的软件界面。在那里，他们可以将摄像机的设置调整到他们想要的值，并将设置保存到用户集。然后可以根据需要快速、方便地访问保存的用户组。

Baumer工业相机软件CameraExplorer是一款用户友好且功能强大的相机管理和图像采集软件解决方案。

它提供的功能包括：实时图像显示、相机参数配置、图像和视频记录、图像测量和图像分析。该软件支持多种堡盟相机和第三方相机，并兼容不同的接口和操作系统。CameraExplorer还提供了一个API，用于与其他软件和自动化系统集成。

这里主要描述如何在C#的平台下实现通过文件保存和导入的方式使保存和载入相机的各类参数的核心代码

相机配置文件代码案例分享

本文介绍使用文件作为相机配置文件对Baumer的工业相机进行开发时，使用通过使用相应的功能来获取保存和载入相机诸多参数的功能。

有关于Baumer工业相机堡盟工业相机如何通过CameraExplorer软件进行设置UserSet的介绍，之前已经有相关的技术博客可以参考：

Baumer工业相机堡盟相机使用CameraExplorer软件进行相机参数保存与 UserSet参数设置

关于 UserSet 的描述：

Baumer 相机可以使用四个 UserSet项，其中 UserSet0为默认选项，包含出厂设置的一系列参数；

User Set 1-3 可以用来存储用户定义修改的相机参数；

User Set 0 作为“Default”值，为只读选项，不可将修改的相机参数保存到该“Default”选项下；

User Set 1-3 可以用来读取，存储相机参数；

如下为核心代码实现步骤：

第一步：保存相机当前参数设置doUserSetStore为文件

C#环境下核心代码如下所示：

private Camera mCamera;
private CameraForm mCameraForm;
private BGAPI_FeatureState state = new BGAPI_FeatureState();
private BGAPIX_TypeArrayINT tUserSet = new BGAPIX_TypeArrayINT();
private BGAPI_FeatureState statedefault = new BGAPI_FeatureState();
private BGAPIX_TypeListINT tDefaultUserSet = new BGAPIX_TypeListINT();
private bool bInitDefault = false;

public UserSetControl(Camera camera, CameraForm camform)
{
	InitializeComponent();
	mCamera = camera;
	mCameraForm = camform;

	mCamera.getUserSet(ref state, ref tUserSet);
	if (state.bIsAvail)
	{
		for (int i = 0; i < tUserSet.length; i++)
		{
			ViewerUserset vro = new ViewerUserset((BGAPI_UserSet)tUserSet.array[i]);
			comboBox_userset.Items.Add(vro);
		}
		if( comboBox_userset.Items.Count > 0 )
			comboBox_userset.AdjustDropDownWidth();
		if (mCameraForm.LastUserSet == -1)
			comboBox_userset.Text = "Select a user set";
		else
			comboBox_userset.SelectedIndex = mCameraForm.LastUserSet;
	}
	else
	{
		button_load.Enabled = false;
		comboBox_userset.Enabled = false;
		button_store.Enabled = false;
	}
	if (state.bIsLock == true)
	{
		button_load.Enabled = false;
        //button_store.Enabled = false;
        //comboBox_userset.Enabled = false;
	}
	mCamera.getUserSetDefault(ref statedefault, ref tDefaultUserSet);
	if (statedefault.bIsAvail)
	{
		bInitDefault = true;
		for (int i = 0; i < tDefaultUserSet.length; i++)
		{
			ViewerUserset vro = new ViewerUserset((BGAPI_UserSet)tDefaultUserSet.array[i]);
			comboBox_default.Items.Add(vro);
            if(tDefaultUserSet.current==tDefaultUserSet.array[i])
                comboBox_default.SelectedIndex = i;
		}
		comboBox_default.AdjustDropDownWidth();
		//comboBox_default.SelectedItem = (BGAPI_UserSet)tDefaultUserSet.current;
               
		bInitDefault = false;
	}
	if (statedefault.bIsAvail == false || statedefault.bIsLock == true)
	{
		comboBox_default.Enabled = false;
	}
}

private void button_store_Click(object sender, EventArgs e)
{
	if (comboBox_userset.SelectedItem == null)
	{
		MessageBox.Show("Please select a user set.", "BGAPI Viewer Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
		return;
	}
	BGAPI_UserSet userset = ((ViewerUserset)comboBox_userset.SelectedItem).Userset;
	Cursor oldCursor = Cursor.Current;
	Cursor.Current = Cursors.WaitCursor;
	int ret = mCamera.doUserSetStore(userset);
	Cursor.Current = oldCursor;
	if (ret != BGAPI.Result.OK)
	{
		if( userset == BGAPI_UserSet.BGAPI_USERSET_FACTORYSETTINGS )
			MessageBox.Show("The user set BGAPI_USERSET_FACTORYSETTINGS is read only and can not be overwritten. doUserSetStore failed with error code " + ret.ToString(), "BGAPI Viewer Error Extended API", MessageBoxButtons.OK, MessageBoxIcon.Error);
		else
			MessageBox.Show("doUserSetStore failed with error code " + ret.ToString(), "BGAPI Viewer Error Extended API", MessageBoxButtons.OK, MessageBoxIcon.Error);
	}
}

第二步：载入已经保存的相机参数setUserSet文件到相机

下面为在在C#环境开启相机连接相机后通过载入UserSet的参数获取相机参数的核心代码，

如下所示：

SystemList 
Open a System 
Get the InterfaceList and fill it Open an Interface 
Get the DeviceList and fill it 
Open a Device

private void button_load_Click(object sender, EventArgs e)
{
	if (comboBox_userset.SelectedItem == null)
	{
		MessageBox.Show("Please select a user set.", "BGAPI Viewer Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
		return;
	}
	int ret = mCamera.getUserSet(ref state, ref tUserSet);
	if (ret != BGAPI.Result.OK)
	{
		MessageBox.Show("getUserSet failed with error code " + ret.ToString(), "BGAPI Viewer Error Extended API", MessageBoxButtons.OK, MessageBoxIcon.Error);
	}


	BGAPI_UserSet userset = ((ViewerUserset)comboBox_userset.SelectedItem).Userset;
	ret = mCamera.setUserSet(userset);
	if (ret == BGAPI.Result.FEATURE_LOCKED)
	{
		MessageBox.Show("The selected user set is locked.", "BGAPI Viewer Error Extended API", MessageBoxButtons.OK, MessageBoxIcon.Error);
	}
	else if (ret != BGAPI.Result.OK)
	{
		MessageBox.Show("setUserSet failed with error code " + ret.ToString(), "BGAPI Viewer Error Extended API", MessageBoxButtons.OK, MessageBoxIcon.Error);
	}
}

工业相机使用文件作为配置文件保存载入的优点

工业相机使用文件作为配置文件进行保存和加载，有几个优点。

首先，将文件作为配置文件使用，确保摄像机的设置和配置可以很容易地在多台摄像机上复制，减少设置时间并提高效率。

其次，将配置文件保存到文件中，可以在团队成员之间和不同的项目中轻松共享和协作。

此外，文件可以很容易地被编辑和更新，允许根据需要快速修改摄像机设置。

最后，将文件作为预案使用，为存储和管理摄像机设置提供了一种方便和有组织的方式，确保它们在需要时容易被访问。

工业相机使用文件作为配置文件保存载入的行业应用

使用文件保存和加载作为配置文件的工业相机通常用于机器视觉、质量控制和检查系统等应用。这些相机通常用于制造和生产线，在那里，精度和准确性是至关重要的。

工业相机使用文件来保存和加载配置文件的一些具体行业应用包括：

汽车制造业： 工业相机在生产过程中被用来检查和测量汽车零件。可以保存和加载配置文件，以确保检查的一致性和准确性。

食品和饮料加工： 工业相机在生产过程中用于监测和检查食品。可以保存和加载配置文件，以确保一致的质量控制。

医药制造： 工业相机用于检查和监测医药产品的生产。可以保存和加载配置文件，以确保符合监管要求。

电子制造业： 工业相机在生产过程中用于检查和测试电子元件。可以保存和加载配置文件，以确保一致的质量控制。

总体而言，在工业相机应用中使用配置文件有助于提高各行业的效率、准确性和一致性。