Stacked ROI#

Stacked ROIカメラ機能を使用すると、単一の画像として送信されるセンサーアレイ上で、高さが異なり幅が等しい複数のゾーンを定義できます。

これらのゾーンからの画素データのみが送信されます。これにより、カメラのフレームレートが上がります。

The Stacked ROI feature is similar to the Stacked Zone Imaging feature, which is only available on ace Classic cameras.

機能を使用する#

仕組み#

Stacked ROI機能を使用すると、センサーアレイ上で幅が等しい垂直に整列されたゾーンを定義できます。ゾーンの最大数は、カメラのモデルによって異なります。

画像を取得すると、定義されたゾーン内の画素情報のみがセンサーから読み取られます。画素情報はスタックされ、1つの画像として送信されます。

ゾーンの幅は常に同じで、垂直方向に整列されます。ゾーンを設定するには、Baslerは、次の手順をお勧めします。

1. すべてのゾーンに有効な幅と水平オフセットを定義します。
2. 個々のゾーンの高さと垂直オフセットを定義します。

Configuring the ROI Zones#

1. カメラがアイドル状態であること、つまり画像をキャプチャしていないことを確認します。
2. パラメーターを OffsetX parameter to the desired horizontal offset. The value is applied to all zones.
3. パラメーターを Width parameter to the desired zone width. The value is applied to all zones.
4. パラメーターを ROIZoneSelector parameter to the zone that you want to configure, e.g., Zone0.
5. パラメーターを ROIZoneOffset parameter to the desired vertical offset. The value is applied to the zone selected in step 4.
6. パラメーターを ROIZoneSize parameter to the desired zone height. The value is applied to the zone selected in step 4.
7. パラメーターを ROIZoneMode parameter to On to enable the zone.
8. 設定するゾーンごとに、手順4～7を繰り返します。

Stacked ROI機能使用時に考慮すること#

• ゾーンは任意の順序で有効にできます。例えば、ゾーン1、3、5を有効にし、ゾーン0、2、4を無効にできます。
• センサーの周囲にゾーンを自由に配置できます。例えば、ゾーン0を下部あたりに、ゾーン2を上部あたりに、ゾーン1を中央に配置できます。ただし、カメラは常にセンサーの一番上のゾーンから画素データの読み取りと送信を開始し、下部に向かって進みます。
• 垂直にオーバーラップするゾーンを定義できます。2つのゾーンがオーバーラップしている場合、それらは単一のマージされたゾーンとして送信されます。オーバーラップ領域からの画素データは、1回だけ読み取られて送信されます。
• 少なくとも1つのゾーンが定義されている場合、次のパラメーターは読み取り専用になります。
  • OffsetY: The parameter is set to the vertical offset of the topmost zone.
  • Height: The parameter is set to the height of the final image, i.e., the sum of the heights of all zones.
  • CenterY
  • Sequencer機能に関連するすべてのパラメーター。
• ゾーンを設定してからビニングを有効にすると、ゾーンの位置とサイズが自動的に調整されます。パラメーター値は、対応するビニング係数で除算され、切り捨てられます。
• Stacked ROI機能を使用した後にすべてのゾーンを無効にすると、画像ROIのサイズと位置は、最後に無効にしたゾーンのサイズと位置に設定されます。例えば、ゾーン0、1、および2が有効であるとします。次に、ゾーンを2、1、0の順に無効にします。その結果、画像ROIのサイズと位置は、無効にしたゾーン0のサイズと位置に設定されます。

特性#

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

サンプルコード#

// Configure width and offset X for all zones
camera.Width.SetValue(200);
camera.OffsetX.SetValue(100);
// Select zone 0
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone0);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(100);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(100);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);
// Select zone 1
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone1);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(250);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(200);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);

INodeMap& nodemap = camera.GetNodeMap();
// Configure width and offset X for all zones
CIntegerParameter(nodemap, "Width").SetValue(200);
CIntegerParameter(nodemap, "OffsetX").SetValue(100);
// Select zone 0
CEnumParameter(nodemap, "ROIZoneSelector").SetValue("Zone0");
// Set the vertical offset for the selected zone
CIntegerParameter(nodemap, "ROIZoneOffset").SetValue(100);
// Set the height for the selected zone
CIntegerParameter(nodemap, "ROIZoneSize").SetValue(100);
// Enable the selected zone
CEnumParameter(nodemap, "ROIZoneMode").SetValue("On");
// Select zone 1
CEnumParameter(nodemap, "ROIZoneSelector").SetValue("Zone1");
// Set the vertical offset for the selected zone
CIntegerParameter(nodemap, "ROIZoneOffset").SetValue(250);
// Set the height for the selected zone
CIntegerParameter(nodemap, "ROIZoneSize").SetValue(200);
// Enable the selected zone
CEnumParameter(nodemap, "ROIZoneMode").SetValue("On");

// Configure width and offset X for all zones
camera.Parameters[PLCamera.Width].SetValue(200);
camera.Parameters[PLCamera.OffsetX].SetValue(100);
// Select zone 0
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone0);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(100);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(100);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);
// Select zone 1
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone1);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(250);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(200);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);

/* 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 */
/* Configure width and offset X for all zones */
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetX", 100);
CHECK(errRes);
/* Select zone 0 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone0");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 100);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 100);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);
/* Select zone 1 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone1");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 250);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 200);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);

# Configure width and offset X for all zones
camera.Width.Value = 200
camera.OffsetX.Value = 100
# Select zone 0
camera.ROIZoneSelector.Value = "Zone0"
# Set the vertical offset for the selected zone
camera.ROIZoneOffset.Value = 100
# Set the height for the selected zone
camera.ROIZoneSize.Value = 100
# Enable the selected zone
camera.ROIZoneMode.Value = "On"
# Select zone 1
camera.ROIZoneSelector.Value = "Zone1"
# Set the vertical offset for the selected zone
camera.ROIZoneOffset.Value = 250
# Set the height for the selected zone
camera.ROIZoneSize.Value = 200
# Enable the selected zone
camera.ROIZoneMode.Value = "On"

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。