User Sets#
用户设置集（也称为“配置集”）是一组参数值。它包含控制相机所需的所有参数设置，只有少数例外情况。
部分用户设置集为预设和只读。这些用户设置集也称为“出厂设置集”。
该功能的使用#
用户设置集中包含什么？#
每个用户设置集都包含所有相机参数的值，但有以下例外情况：
-
不包括与以下相机功能相关的参数值：
-
在 ace Classic/U/L 相机上，不包括与相机的 LUT 功能相关的参数值。
- 不包括名称中包含“Selector”这个词的参数值（例如
GainSelector）。例外情况：TestImageSelector、GammaSelector、LightSourceSelector。 - 不包括
DeviceUserID参数的值。 -
不包括
GevGVSPExtendedIDMode参数的值。 -
Only the following Network-Related Parameters are included:
- Packet Size (
GevSCPSPacketSize) - Inter-Packet Delay (
GevSCPD) - Frame Transmission Delay (
GevSCFTD) - Bandwidth Reserve (
GevSCBWR) - Bandwidth Reserve Accumulation (
GevSCBWRA) - Bandwidth Reserve Mode (
BandwidthReserveMode)
- Packet Size (
这意味着，当您加载或保存用户设置集时，除了上面列出的参数之外，所有相机参数的值都将被加载或保存。
加载用户设置集#
信息
- 加载用户设置集后，它将覆盖当前的相机设置。
- 仅当相机空闲（即不采集图像）时才可以加载用户设置集。
- 将
UserSetSelector参数设置为可用用户设置集，例如UserSet1。 - 执行
UserSetLoad命令。
保存用户设置集#
信息
- 只能保存用户设置集
UserSet1、UserSet2和UserSet3。其他用户设置集均为只读。 - 仅当相机空闲（即不采集图像）时才可以保存用户设置集。
- 将
UserSetSelector参数设置为可用用户设置集，例如UserSet1。 - 执行
UserSetSave命令。
选择启动设置集#
信息
- 相机开机时，将加载您选为启动设置集的用户设置集。
- 仅当相机空闲时（即未采集图像时）才可以选择启动设置集。
- 将
UserSetDefaultSelector参数设置为可用用户设置集，例如UserSet1。 - 将相机电源关闭后再开启，以使新的启动设置集生效。
可用用户设置集#
根据您的相机型号，可以使用以下用户设置集：
默认#
Default 用户设置集是只读出厂设置。这是所有相机上的默认启动设置集，不过 Basler MED ace 相机除外。
加载此设置集可对相机进行配置，以使其在正常操作条件下为各种应用提供良好的相机性能。
默认用户设置集包含所有相机参数值的出厂默认设置。
高增益#
HighGain 用户设置集是只读出厂设置集。
HighGain 用户设置集包含与默认用户设置集相同的参数值，但有以下例外情况：
- 如果可用，
GainRaw参数设置为在默认用户设置集基础上增加 6 dB 的值。实际参数值因相机型号而异。
Auto Functions#
AutoFunctions 用户设置集是只读出厂设置集。
加载此用户设置集启用相机的自动功能 Exposure Auto 和 Gain Auto。
AutoFunctions 用户设置集包含与默认用户设置集相同的参数值，但有以下例外情况：
GainAuto参数设置为Continuous。ExposureAuto参数设置为Continuous。AutoFunctionProfile参数设置为GainMinimum。
彩色#
Color 用户设置集是只读出厂设置集。
加载此用户设置集可对相机进行配置，以便在常见的光照条件下生成良好的彩色图像。
Color 用户设置集包含与默认用户设置集相同的参数值，但有以下例外情况：
- 将
LightSourceSelector参数设置为Daylight。 BalanceRatioAbs参数值根据Daylight光源预设设置。- 如果可用，则
GammaSelector参数设置为sRGB。 - 如果可用，则
ProcessedRawEnable参数设置为true。
原色#
ColorRaw 用户设置集是只读出厂设置集。
加载此设置集将禁用色彩增强功能。
ColorRaw 用户设置集包含与默认用户设置集相同的参数值，但有以下例外情况：
- 将
LightSourceSelector参数设置为Off。 - 所有颜色通道（红、绿、蓝）的
BalanceRatioAbs参数值均设置为 1。 - 如果可用，则
ColorAdjustmentEnable参数设置为false。 - 如果可用，则
GammaEnable参数设置为false。 - 如果可用，则
GammaSelector参数设置为User。
光学显微镜#
LightMicroscopy 用户设置集是只读出厂设置。这是 Basler MED ace 相机上的默认启动设置集。
加载此设置集可将相机配置为使用光学显微镜生成良好的图像。
LightMicroscopy 用户设置集包含与默认用户设置集相同的参数值，但有以下例外情况：
ExposureAuto参数设置为Continuous。AutoFunctionProfile参数设置为GainMinimumQuick。AutoTargetValue参数设置为 0.592。AutoFunctionAOIUsageTonalRange参数设置为true。BslBrightness参数设置为 -0.0625。BslContrast参数设置为 0.15625。- 即：
SharpnessEnhancementAbs参数设置为以下值：- acA2440-35umMED 和 acA2440-75umMED 相机：1.7
- acA2500-20gmMED 相机：2.2
- 所有其他 Basler MED ace 相机上：3.7
- 在彩色相机上，将
LightSourceSelector参数设置为Daylight6500K。 - 在彩色相机上，
PixelFormat参数设置为RGB8。 - 在彩色相机上，
DemosaicingMode参数设置为BaslerPGI。 - 在单色相机上，
PgiMode参数设置为On。
用户设置集 1、用户设置集 2 和用户设置集 3#
您可以使用 UserSet1、UserSet2 和 UserSet3 用户设置集来加载和保存自己的相机设置。
最初，这些用户设置集包含与默认用户设置集相同的参数值。您可以使用自己的设置覆盖这些值，以创建针对您的应用定制的用户设置集。
要在每次重置相机时恢复这些设置，请选择一个用户设置集作为启动设置集。
信息
On boost V cameras, the DeviceReset command doesn't load a configured startup user set. Power-cycle the camera for the startup set to become effective.
详情#
| 相机型号 | 可用用户设置集 |
|---|---|
| a2A1280-125umSWIR | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1280-80gmSWIR | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-160ucBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-160ucPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-160umBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-160umPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-165g5cBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-165g5mBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-51gcBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-51gcPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-51gmBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A1920-51gmPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-110umSWIR | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114g5cBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114g5mBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114ucBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114ucPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114umBAS | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-114umPRO | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| a2A2048-35gmSWIR | 用户设置集 1 用户设置集 2 用户设置集 3 默认 |
| 12345...20 | |
示例代码#
ace Classic/U/L GigE 相机#
// Load the High Gain user set
camera.UserSetSelector.SetValue(UserSetSelector_HighGain);
camera.UserSetLoad.Execute();
// Load the User Set 1 user set
camera.UserSetSelector.SetValue(UserSetSelector_UserSet1);
camera.UserSetLoad.Execute();
// Adjust some camera settings
camera.Width.SetValue(600);
camera.Height.SetValue(400);
camera.ExposureTime.SetValue(3500.0);
// Save the settings in User Set 1
camera.UserSetSelector.SetValue(UserSetSelector_UserSet1);
camera.UserSetSave.Execute();
// Designate User Set 1 as the startup set
camera.UserSetDefaultSelector.SetValue(UserSetDefaultSelector_UserSet1);
INodeMap& nodemap = camera.GetNodeMap();
// Load the High Gain user set
CEnumParameter(nodemap, "UserSetSelector").SetValue("HighGain");
CCommandParameter(nodemap, "UserSetLoad").Execute();
// Load the User Set 1 user set
CEnumParameter(nodemap, "UserSetSelector").SetValue("UserSet1");
CCommandParameter(nodemap, "UserSetLoad").Execute();
// Adjust some camera settings
CIntegerParameter(nodemap, "Width").SetValue(600);
CIntegerParameter(nodemap, "Height").SetValue(400);
CFloatParameter(nodemap, "ExposureTime").SetValue(3500.0);
// Save the settings in User Set 1
CEnumParameter(nodemap, "UserSetSelector").SetValue("UserSet1");
CCommandParameter(nodemap, "UserSetSave").Execute();
// Designate User Set 1 as the startup set
CEnumParameter(nodemap, "UserSetDefaultSelector").SetValue("UserSet1");
// Load the High Gain user set
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.HighGain);
camera.Parameters[PLCamera.UserSetLoad].Execute();
// Load the User Set 1 user set
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.UserSet1);
camera.Parameters[PLCamera.UserSetLoad].Execute();
// Adjust some camera settings
camera.Parameters[PLCamera.Width].SetValue(600);
camera.Parameters[PLCamera.Height].SetValue(400);
camera.Parameters[PLCamera.ExposureTime].SetValue(3500.0);
// Save the settings in User Set 1
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.UserSet1);
camera.Parameters[PLCamera.UserSetSave].Execute();
// Designate User Set 1 as the startup set
camera.Parameters[PLCamera.UserSetDefaultSelector].SetValue(PLCamera.UserSetDefaultSelector.UserSet1);
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK; /* Return value of pylon methods */
/* Load the High Gain user set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "HighGain");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetLoad");
CHECK(errRes);
/* Load the User Set 1 user set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetLoad");
CHECK(errRes);
/* Adjust some camera settings */
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", 600);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 400);
CHECK(errRes);
errRes = PylonDeviceSetFloatFeature(hdev, "ExposureTime", 3500.0);
CHECK(errRes);
/* Save the settings in User Set 1 */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetSave");
CHECK(errRes);
/* Designate User Set 1 as the startup set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetDefaultSelector", "UserSet1");
CHECK(errRes);
# Load the High Gain user set
camera.UserSetSelector.Value = "HighGain"
camera.UserSetLoad.Execute()
# Load the User Set 1 user set
camera.UserSetSelector.Value = "UserSet1"
camera.UserSetLoad.Execute()
# Adjust some camera settings
camera.Width.Value = 600
camera.Height.Value = 400
camera.ExposureTime.Value = 3500.0
# Save the settings in User Set 1
camera.UserSetSelector.Value = "UserSet1"
camera.UserSetSave.Execute()
# Designate User Set 1 as the startup set
camera.UserSetDefaultSelector.Value = "UserSet1"
其他相机#
// Load the High Gain user set
camera.UserSetSelector.SetValue(UserSetSelector_HighGain);
camera.UserSetLoad.Execute();
// Load the User Set 1 user set
camera.UserSetSelector.SetValue(UserSetSelector_UserSet1);
camera.UserSetLoad.Execute();
// Adjust some camera settings
camera.Width.SetValue(600);
camera.Height.SetValue(400);
camera.ExposureTime.SetValue(3500.0);
// Save the settings in User Set 1
camera.UserSetSelector.SetValue(UserSetSelector_UserSet1);
camera.UserSetSave.Execute();
// Designate User Set 1 as the startup set
camera.UserSetDefault.SetValue(UserSetDefault_UserSet1);
INodeMap& nodemap = camera.GetNodeMap();
// Load the High Gain user set
CEnumParameter(nodemap, "UserSetSelector").SetValue("HighGain");
CCommandParameter(nodemap, "UserSetLoad").Execute();
// Load the User Set 1 user set
CEnumParameter(nodemap, "UserSetSelector").SetValue("UserSet1");
CCommandParameter(nodemap, "UserSetLoad").Execute();
// Adjust some camera settings
CIntegerParameter(nodemap, "Width").SetValue(600);
CIntegerParameter(nodemap, "Height").SetValue(400);
CFloatParameter(nodemap, "ExposureTime").SetValue(3500.0);
// Save the settings in User Set 1
CEnumParameter(nodemap, "UserSetSelector").SetValue("UserSet1");
CCommandParameter(nodemap, "UserSetSave").Execute();
// Designate User Set 1 as the startup set
CEnumParameter(nodemap, "UserSetDefault").SetValue("UserSet1");
// Load the High Gain user set
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.HighGain);
camera.Parameters[PLCamera.UserSetLoad].Execute();
// Load the User Set 1 user set
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.UserSet1);
camera.Parameters[PLCamera.UserSetLoad].Execute();
// Adjust some camera settings
camera.Parameters[PLCamera.Width].SetValue(600);
camera.Parameters[PLCamera.Height].SetValue(400);
camera.Parameters[PLCamera.ExposureTime].SetValue(3500.0);
// Save the settings in User Set 1
camera.Parameters[PLCamera.UserSetSelector].SetValue(PLCamera.UserSetSelector.UserSet1);
camera.Parameters[PLCamera.UserSetSave].Execute();
// Designate User Set 1 as the startup set
camera.Parameters[PLCamera.UserSetDefault].SetValue(PLCamera.UserSetDefault.UserSet1);
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK; /* Return value of pylon methods */
/* Load the High Gain user set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "HighGain");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetLoad");
CHECK(errRes);
/* Load the User Set 1 user set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetLoad");
CHECK(errRes);
/* Adjust some camera settings */
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", 600);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 400);
CHECK(errRes);
errRes = PylonDeviceSetFloatFeature(hdev, "ExposureTime", 3500.0);
CHECK(errRes);
/* Save the settings in User Set 1 */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "UserSetSave");
CHECK(errRes);
/* Designate User Set 1 as the startup set */
errRes = PylonDeviceFeatureFromString(hdev, "UserSetDefault", "UserSet1");
CHECK(errRes);
# Load the High Gain user set
camera.UserSetSelector.Value = "HighGain"
camera.UserSetLoad.Execute()
# Load the User Set 1 user set
camera.UserSetSelector.Value = "UserSet1"
camera.UserSetLoad.Execute()
# Adjust some camera settings
camera.Width.Value = 600
camera.Height.Value = 400
camera.ExposureTime.Value = 3500.0
# Save the settings in User Set 1
camera.UserSetSelector.Value = "UserSet1"
camera.UserSetSave.Execute()
# Designate User Set 1 as the startup set
camera.UserSetDefault.Value = "UserSet1"
您也可以使用 pylon Viewer 轻松设置参数。