A user set (also called "configuration set") is a group of parameter values. It contains all parameter settings needed to control the camera, with a few exceptions.
Some user sets are preset and read-only. These user sets are also called "factory sets".
In this topic Hide
Each user set includes the values of all camera parameters, with the following exceptions:
This means that when you load or save a user set, the values of all camera parameters will be loaded or saved, except the parameters listed above.
Depending on your camera model, the following user sets are available:
The Default user set is a read-only factory set. This is the default startup set on all cameras, except Basler MED ace cameras.
Loading this set configures the camera to provide good camera performance for a variety of applications under average operating conditions.
The Default user set contains the factory default settings of all the camera's parameter values.
The HighGain user set is a read-only factory set.
Loading this set increases the gain by 6 dB.
The HighGain user set contains the same parameter values as the Default user set, with the following exceptions:
The AutoFunctions user set is a read-only factory set.
Loading this user set enables the camera's Exposure Auto and Gain Auto auto functions.
The AutoFunctions user set contains the same parameter values as the Default user set, with the following exceptions:
The Color user set is a read-only factory set.
Loading this user set configures the camera to produce good color images under the most common lighting conditions.
The Color user set contains the same parameter values as the Default user set, with the following exceptions:
The ColorRaw user set is a read-only factory set.
Loading this set disables the color enhancement features.
The ColorRaw user set contains the same parameter values as the Default user set, with the following exceptions:
The LightMicroscopy user set is a read-only factory set. This is the default startup set on Basler MED ace cameras.
Loading this set configures the camera to produce good images with light microscopes.
The LightMicroscopy user set contains the same parameter values as the Default user set, with the following exceptions:
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.
To restore those settings every time the camera is reset, choose a user set as the startup set.
Camera Model | Available User Sets |
---|---|
All ace 2 GigE camera models |
|
All ace 2 USB 3.0 camera models |
|
acA640-90gm |
|
acA640-90gc |
|
acA640-120gm |
|
acA640-120gc |
|
acA640-121gm |
|
acA640-300gm |
|
acA640-300gc |
|
acA720-290gm |
|
acA720-290gc |
|
acA780-75gm |
|
acA780-75gc |
|
acA800-200gm |
|
acA800-200gc |
|
acA1280-60gm |
|
acA1280-60gc |
|
acA1300-22gm |
|
acA1300-22gc |
|
acA1300-30gm |
|
acA1300-30gc |
|
acA1300-60gm |
|
acA1300-60gmNIR |
|
acA1300-60gc |
|
acA1300-75gm |
|
acA1300-75gc |
|
acA1440-73gm |
|
acA1440-73gc |
|
acA1600-20gm |
|
acA1600-20gc |
|
acA1600-60gm |
|
acA1600-60gc |
|
acA1920-25gm |
|
acA1920-25gc |
|
acA1920-40gm |
|
acA1920-40gc |
|
acA1920-48gm |
|
acA1920-48gc |
|
acA1920-50gm |
|
acA1920-50gc |
|
acA2000-50gm |
|
acA2000-50gmNIR |
|
acA2000-50gc |
|
acA2040-25gm |
|
acA2040-25gmNIR |
|
acA2040-25gc |
|
acA2040-35gm |
|
acA2040-35gc |
|
acA2440-20gm |
|
acA2440-20gc |
|
acA2500-14gm |
|
acA2500-14gc |
|
acA2500-20gm |
|
acA2500-20gc |
|
acA2500-20gmMED |
|
acA2500-20gcMED |
|
acA3088-16gm |
|
acA3088-16gc |
|
acA3800-10gm |
|
acA3800-10gc |
|
acA4024-8gm |
|
acA4024-8gc |
|
acA4096-11gm |
|
acA4096-11gc |
|
acA4112-8gm |
|
acA4112-8gc |
|
acA4600-7gc |
|
acA5472-5gm |
|
acA5472-5gc |
|
acA640-750um |
|
acA640-750uc |
|
acA640-90um |
|
acA640-90uc |
|
acA640-120um |
|
acA640-120uc |
|
acA720-520um |
|
acA720-520uc |
|
acA800-510um |
|
acA800-510uc |
|
acA1300-200um |
|
acA1300-200uc |
|
acA1300-30um |
|
acA1300-30uc |
|
acA1440-220um |
|
acA1440-220uc |
|
acA1600-20um |
|
acA1600-20uc |
|
acA1920-25um |
|
acA1920-25uc |
|
acA1920-40um |
|
acA1920-40uc |
|
acA1920-40umMED |
|
acA1920-40ucMED |
|
acA1920-150um |
|
acA1920-150uc |
|
acA1920-155um |
|
acA1920-155uc |
|
acA1920-155umMED |
|
acA1920-155ucMED |
|
acA2040-90um |
|
acA2040-90umNIR |
|
acA2040-90uc |
|
acA2000-165um |
|
acA2000-165umNIR |
|
acA2000-165uc |
|
acA2040-55um |
|
acA2040-55uc |
|
acA2040-120um |
|
acA2040-120uc |
|
acA2440-35um |
|
acA2440-35uc |
|
acA2440-35umMED |
|
acA2440-35ucMED |
|
acA2440-75um |
|
acA2440-75uc |
|
acA2440-75umMED |
|
acA2440-75ucMED |
|
acA2500-14um |
|
acA2500-14uc |
|
acA2500-60um |
|
acA2500-60uc |
|
acA3088-57um |
|
acA3088-57uc |
|
acA3800-14um |
|
acA3800-14uc |
|
acA4024-29um |
|
acA4024-29uc |
|
acA4096-30um |
|
acA4096-30uc |
|
acA4096-30umMED |
|
acA4096-30ucMED |
|
acA4096-40um |
|
acA4096-40uc |
|
acA4096-40umMED |
|
acA4096-40ucMED |
|
acA4112-20um |
|
acA4112-20uc |
|
acA4112-20umMED |
|
acA4112-20ucMED |
|
acA4112-30um |
|
acA4112-30uc |
|
acA4112-30umMED |
|
acA4112-30ucMED |
|
acA4600-10uc |
|
acA5472-17um |
|
acA5472-17uc |
|
boA4096-93cm |
|
boA4096-93cc |
|
boA4112-68cm |
|
boA4112-68cc |
|
All dart BCON for LVDS camera models |
|
All dart BCON for MIPI camera models | User Sets feature not supported |
All dart USB 3.0 camera models |
|
All pulse USB 3.0 camera models |
|
// 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
CEnumerationPtr(nodemap.GetNode("UserSetSelector"))->FromString("HighGain");
CCommandPtr(nodemap.GetNode("UserSetLoad"))->Execute();
// Load the User Set 1 user set
CEnumerationPtr(nodemap.GetNode("UserSetSelector"))->FromString("UserSet1");
CCommandPtr(nodemap.GetNode("UserSetLoad"))->Execute();
// Adjust some camera settings
CIntegerPtr(nodemap.GetNode("Width"))->SetValue(600);
CIntegerPtr(nodemap.GetNode("Height"))->SetValue(400);
CFloatPtr(nodemap.GetNode("ExposureTime"))->SetValue(3500.0);
// Save the settings in User Set 1
CEnumerationPtr(nodemap.GetNode("UserSetSelector"))->FromString("UserSet1");
CCommandPtr(nodemap.GetNode("UserSetSave"))->Execute();
// Designate User Set 1 as the startup set
CEnumerationPtr(nodemap.GetNode("UserSetDefault"))->FromString("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);
// Load the High Gain user set
Pylon.DeviceFeatureFromString(hdev, "UserSetSelector", "HighGain");
Pylon.DeviceExecuteCommandFeature(hdev, "UserSetLoad");
// Load the User Set 1 user set
Pylon.DeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
Pylon.DeviceExecuteCommandFeature(hdev, "UserSetLoad");
// Adjust some camera settings
Pylon.DeviceSetIntegerFeature(hdev, "Width", 600);
Pylon.DeviceSetIntegerFeature(hdev, "Height", 400);
Pylon.DeviceSetFloatFeature(hdev, "ExposureTime", 3500.0);
// Save the settings in User Set 1
Pylon.DeviceFeatureFromString(hdev, "UserSetSelector", "UserSet1");
Pylon.DeviceExecuteCommandFeature(hdev, "UserSetSave");
// Designate User Set 1 as the startup set
Pylon.DeviceFeatureFromString(hdev, "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);
You can also use the pylon Viewer to easily set the parameters.