User Sets#

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

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

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

機能を使用する#

User Setの内容#

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

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

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

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

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

User Setのロード#

1. UserSetSelectorパラメーターを、使用可能なユーザーセットの1つ（UserSet1など）に設定します。
2. UserSetLoadコマンドを実行します。

User Setの保存#

1. UserSetSelectorパラメーターを、使用可能なユーザーセットの1つ（UserSet1など）に設定します。
2. UserSetSaveコマンドを実行します。

Startup Setの選択#

1. UserSetDefaultパラメーターを、使用可能なユーザーセットの1つ（UserSet1など）に設定します。
2. 新しいスタートアップセットが有効になるように、カメラの電源を入れ直します。

使用可能なUser Sets#

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

Default#

Defaultユーザーセットは、読み取り専用の工場出荷時セットです。これは、Basler MED aceカメラを除くすべてのカメラのデフォルトのスタートアップセットです。

このセットをロードすると、平均的な動作条件でのさまざまな用途に適したカメラパフォーマンスを提供するようにカメラが設定されます。

Defaultユーザーセットには、すべてのカメラのパラメーター値の工場出荷時のデフォルト設定が含まれます。

High Gain#

HighGainユーザーセットは、読み取り専用の工場出荷時セットです。

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

HighGainユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれますが、次の例外があります。

• 使用可能な場合、Gainパラメーターは、Defaultのユーザー設定と比較してゲインを6dB増加させた値に設定されます。実際のパラメーター値は、カメラのモデルによって異なります。

Auto Functions#

AutoFunctionsユーザーセットは、読み取り専用の工場出荷時セットです。

このユーザーセットをロードすると、カメラのExposure AutoおよびGain Auroオートファンクションが有効になります。

AutoFunctionsユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれますが、次の例外があります。

• GainAutoパラメーターは、Continuousに設定されます。
• ExposureAutoパラメーターは、Continuousに設定されます。
• AutoFunctionProfileパラメーターは、MinimizeGainに設定されます。

カラー#

Colorユーザーセットは、読み取り専用の工場出荷時セットです。

このユーザーセットをロードすると、最も一般的な照明条件下で良好なカラー画像を生成するようにカメラが設定されます。

Colorユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれますが、次の例外があります。

• LightSourcePresetパラメーターは、Daylight5000Kに設定されます。
• BalanceRatioパラメーターの値は、Daylight5000K光源の初期値に従って設定されます。
• 使用可能な場合、GammaSelectorパラメーターはsRGBに設定されます。
• 使用可能な場合、ProcessedRawEnableパラメーターはtrueに設定されます。

Color Raw#

ColorRawユーザーセットは、読み取り専用の工場出荷時セットです。

このセットをロードすると、カラー拡張機能が無効になります。

ColorRawユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれますが、次の例外があります。

• LightSourcePresetパラメーターは、Offに設定されます。
• すべてのカラーチャンネル（赤、緑、青）のBalanceRatioパラメーター値は1に設定されます。
• 使用可能な場合、ColorAdjustmentEnableパラメーターはfalseに設定されます。
• 使用可能な場合、GammaEnableパラメーターはfalseに設定されます。
• 使用可能な場合、GammaSelectorパラメーターはUserに設定されます。

Light Microscopy#

LightMicroscopyユーザーセットは、読み取り専用の工場出荷時セットです。これは、BaslerMED aceカメラのデフォルトのスタートアップセットです。

このセットをロードすると、光学顕微鏡で良好な画像を生成するようにカメラが設定されます。

LightMicroscopyユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれますが、次の例外があります。

• ExposureAutoパラメーターは、Continuousに設定されます。
• AutoFunctionProfileパラメーターはMinimizeGainQuickに設定されます。
• AutoTargetBrightnessパラメーターは0.592に設定されます。
• AutoFunctionROIUseTonalRangeパラメーターはtrueに設定されます。
• BslBrightnessパラメーターは-0.0625に設定されます。
• BslContrastパラメーターは0.15625に設定されます。
• イメージ SharpnessEnhancement パラメーターは次の値に設定されます。
  • acA2440-35umMEDおよびacA2440-75umMEDカメラ：1.7
  • acA2500-20gmMEDカメラ：2.2
  • その他のBasler MED aceカメラ：3.7
• カラーカメラでは、LightSourcePresetパラメーターはDaylight6500Kに設定されます。
• カラーカメラでは、PixelFormatパラメーターはRGB8に設定されます。
• カラーカメラでは、DemosaicingModeパラメーターはBaslerPGIに設定されます。
• モノカメラでは、PgiModeパラメーターはOnに設定されます。

User Set 1, User Set 2, and User Set 3#

UserSet1、UserSet2、およびUserSet3のユーザーセットを使用して、独自のカメラ設定をロードおよび保存できます。

初期状態では、これらのユーザーセットには、Defaultユーザーセットと同じパラメーター値が含まれています。これらの値を独自の設定で上書きして、自分の用途向けにカスタマイズされたユーザーセットを作成できます。

カメラをリセットするたびにこれらの設定を復元するには、スタートアップセットとしてユーザーセットを選択します。

特性#

すべてのカメラモデルを表示します

サンプルコード#

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