User Sets#

相机的 User Sets 功能允许您保存或加载相机设置。您还可以指定在相机启动时加载的设置。

用户设置集（也称为“配置集”）是一组参数值。它包含控制相机所需的所有参数设置，只有少数例外情况。

部分用户设置集为预设和只读。这些用户设置集也称为“出厂设置集”。

该功能的使用#

用户设置集中包含什么？#

每个用户设置集都包含所有相机参数的值，但有以下例外情况：

• 不包括与以下相机功能相关的参数值：

  • Action Commands
  • Sequencer
  • User-Defined Values
  • Precision Time Protocol

• 在 ace Classic/U/L 相机上，不包括与相机的 LUT 功能相关的参数值。

• Values of parameters that include the term "Selector" in their names are not included (e.g., GainSelector). Exceptions: TestImageSelector, GammaSelector, LightSourceSelector.
• The value of the DeviceUserID parameter is not included.

• The value of the GevGVSPExtendedIDMode parameter is not included.

• 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)

这意味着，当您加载或保存用户设置集时，除了上面列出的参数之外，所有相机参数的值都将被加载或保存。

加载用户设置集#

1. 设置 UserSetSelector parameter to one of the available user sets, e.g., UserSet1.
2. Execute the UserSetLoad command.

保存用户设置集#

1. 设置 UserSetSelector parameter to one of the available user sets, e.g., UserSet1.
2. Execute the UserSetSave command.

选择启动设置集#

1. 设置 UserSetDefault parameter to one of the available user sets, e.g., UserSet1.
2. 将相机电源关闭后再开启，以使新的启动设置集生效。

可用用户设置集#

根据您的相机型号，可以使用以下用户设置集：

默认#

即： Default user set is a read-only factory set. This is the default startup set on all cameras, except Basler MED ace cameras.

加载此设置集可对相机进行配置，以使其在正常操作条件下为各种应用提供良好的相机性能。

即： Default user set contains the factory default settings of all the camera's parameter values.

高增益#

即： HighGain user set is a read-only factory set.

加载此设置集可将增益提高 6 dB。

即： HighGain user set contains the same parameter values as the Default user set, with the following exception:

• If available, the Gain parameter is set to a value that increases the gain by 6 dB compared to the Default user set. The actual parameter value varies by camera model.

Auto Functions#

即： AutoFunctions user set is a read-only factory set.

加载此用户设置集启用相机的自动功能 Exposure Auto 和 Gain Auto。

即： AutoFunctions user set contains the same parameter values as the Default user set, with the following exceptions:

• 即： GainAuto parameter is set to Continuous.
• 即： ExposureAuto parameter is set to Continuous.
• 即： AutoFunctionProfile parameter is set to MinimizeGain.

彩色#

即： Color user set is a read-only factory set.

加载此用户设置集可对相机进行配置，以便在常见的光照条件下生成良好的彩色图像。

即： Color user set contains the same parameter values as the Default user set, with the following exceptions:

• 即： LightSourcePreset parameter is set to Daylight5000K.
• 即： BalanceRatio parameter values are set according to the Daylight5000K light source preset.
• If available, the GammaSelector parameter is set to sRGB.
• If available, the ProcessedRawEnable parameter is set to true.

原色#

即： ColorRaw user set is a read-only factory set.

加载此设置集将禁用色彩增强功能。

即： ColorRaw user set contains the same parameter values as the Default user set, with the following exceptions:

• 即： LightSourcePreset parameter is set to Off.
• 即： BalanceRatio parameter values for all color channels (red, green, blue) are set to 1.
• If available, the ColorAdjustmentEnable parameter is set to false.
• If available, the GammaEnable parameter is set to false.
• If available, the GammaSelector parameter is set to User.

光学显微镜#

即： LightMicroscopy user set is a read-only factory set. This is the default startup set on Basler MED ace cameras.

加载此设置集可将相机配置为使用光学显微镜生成良好的图像。

即： LightMicroscopy user set contains the same parameter values as the Default user set, with the following exceptions:

• 即： ExposureAuto parameter is set to Continuous.
• 即： AutoFunctionProfile parameter is set to MinimizeGainQuick.
• 即： AutoTargetBrightness parameter is set to 0.592.
• 即： AutoFunctionROIUseTonalRange parameter is set to true.
• 即： BslBrightness parameter is set to -0.0625.
• 即： BslContrast parameter is set to 0.15625.
• 即： SharpnessEnhancement 参数设置为以下值：
  • acA2440-35umMED 和 acA2440-75umMED 相机：1.7
  • acA2500-20gmMED 相机：2.2
  • 所有其他 Basler MED ace 相机上：3.7
• On color cameras, the LightSourcePreset parameter is set to Daylight6500K.
• On color cameras, the PixelFormat parameter is set to RGB8.
• On color cameras, the DemosaicingMode parameter is set to BaslerPGI.
• On mono cameras, the PgiMode parameter is set to On.

用户设置集 1、用户设置集 2 和用户设置集 3#

You can use the UserSet1, UserSet2, and UserSet3 user sets to load and save your own camera settings.

Initially, these user sets contain the same parameter values as the Default user set. You can overwrite those values with your own settings to create a user set that is customized for your application.

要在每次重置相机时恢复这些设置，请选择一个用户设置集作为启动设置集。

详情#

显示所有相机型号

示例代码#

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 轻松设置参数。