User Sets#

User Setsカメラ機能を使用すると、カメラ設定を保存またはロードできます。カメラの起動時にロードする設定を指定することもできます。

ユーザーセット（「設定セット」とも呼ばれます）は、パラメーター値のグループです。カメラを制御するために必要なすべてのパラメーター設定が含まれていますが、いくつか例外があります。

一部のユーザーセットはプリセットされており、読み取り専用です。これらのユーザーセットは、「工場出荷時セット」とも呼ばれます。

機能を使用する#

User Setの内容#

各ユーザーセットには、すべてのカメラパラメーターの値が含まれますが、次の例外があります。

• 次のカメラ機能に関連するパラメーター値は含まれません。

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

つまり、ユーザーセットをロードまたは保存すると、上記のパラメーターを除くすべてのカメラパラメーターの値がロードまたは保存されます。

User Setのロード#

1. パラメーターを UserSetSelector parameter to one of the available user sets, e.g., UserSet1.
2. Execute the UserSetLoad command.

User Setの保存#

1. パラメーターを UserSetSelector parameter to one of the available user sets, e.g., UserSet1.
2. Execute the UserSetSave command.

Startup Setの選択#

1. パラメーターを UserSetDefault parameter to one of the available user sets, e.g., UserSet1.
2. 新しいスタートアップセットが有効になるように、カメラの電源を入れ直します。

使用可能なUser Sets#

カメラのモデルに応じて、次のユーザーセットを使用できます。

Default#

イメージ 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.

High Gain#

イメージ HighGain user set is a read-only factory set.

このセットをロードすると、ゲインが6dB増加します。

イメージ 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 Auroオートファンクションが有効になります。

イメージ 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.

Color Raw#

イメージ 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.

Light Microscopy#

イメージ 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.

User Set 1, User Set 2, and User Set 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を使用して、パラメーターを簡単に設定することもできます。