Image ROI

Image ROIカメラ機能を使用すると、画像取得に使用するセンサーアレイの部分を指定できます。

ROIはregion of interest（関心領域）の短縮形（以前はAOI = area of interest（関心領域））。

画像ROIを指定した場合、カメラはその領域内からの画素データのみを送信します。ほとんどのカメラでは、これによりカメラの最大フレームレートが大幅に向上します。

画像ROI設定は、オートファンクションROI設定とは無関係です。

機能を使用する

Image ROIの位置とサイズの変更

工場出荷時の設定を有効にすると、カメラはデフォルトの解像度に設定されます。ただし、必要に応じて位置とサイズを変更できます。

画像ROIの位置とサイズを変更するには、次の手順に従います。

1. カメラがアイドル状態であること、つまり画像をキャプチャしていないことを確認します。
2. ace Classic/U/Lカメラを使用している場合は、CenterXおよびCenterYパラメーターをfalseに設定します。

3. 次のパラメーターを使用して、画像ROIのサイズを指定します。

   • Width
   • Height

4. 次のパラメーターを使用して、画像ROIの位置を指定します。

   • OffsetX
   • OffsetY

画像ROIの原点は、センサーアレイの左上隅（列0、行0）になります。

例：次の設定を指定したとします。

• Width = 16
• Height = 10
• OffsetX = 2
• OffsetY = 6

これにより、次のイメージROIが作成されます。

情報

• 多くのカメラでは、画像ROIのサイズ（特に高さ）を小さくすると、カメラの最大フレームレートが非常に高くなります。
• Binning機能が有効になっている場合、画像ROIの設定は、センサーの物理的な線ではなく、ビンされた行と列を参照します。

ガイドライン

画像ROIを指定する場合は、次のガイドラインに従ってください。

ガイドライン	例
OffsetX + Width ≤ WidthMax	1920 x 1080画素センサー付きカメラ： OffsetX + Width ≤ 1920
OffsetY + Height ≤ HeightMax	1920 x 1080画素センサー付きカメラ： OffsetY + Height ≤ 1080

WidthMaxおよびHeightMaxパラメーター値は、Binning、Decimation、またはScaling（使用可能な場合）の現在の設定に適合します。

特性

Image ROIのサイズ

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

カメラモデル	Minimum Width	Minimum Height
a2A1920-51gcBAS	4	2
a2A1920-51gcPRO	4	2
a2A1920-51gmBAS	4	1
a2A1920-51gmPRO	4	1
a2A1920-160ucBAS	4	2
a2A1920-160ucPRO	4	2
a2A1920-160umBAS	4	1
a2A1920-160umPRO	4	1
a2A2448-23gcBAS	4	2
a2A2448-23gcPRO	4	2
a2A2448-23gmBAS	4	1
a2A2448-23gmPRO	4	1
a2A2448-75ucBAS	4	2
a2A2448-75ucPRO	4	2
a2A2448-75umBAS	4	1
a2A2448-75umPRO	4	1
a2A2448-105g5cBAS	4	2
a2A2448-105g5mBAS	4	1
a2A2590-22gcBAS	4	2
a2A2590-22gcPRO	4	2
a2A2590-22gmBAS	4	1
a2A2590-22gmPRO	4	1
a2A2590-60ucBAS	4	2
a2A2590-60ucPRO	4	2
a2A2590-60umBAS	4	1
a2A2590-60umPRO	4	1
a2A2600-20gcBAS	4	2
a2A2600-20gcPRO	4	2
a2A2600-20gmBAS	4	1
a2A2600-20gmPRO	4	1
a2A2600-64ucBAS	4	2
a2A2600-64ucPRO	4	2
a2A2600-64umBAS	4	1
a2A2600-64umPRO	4	1
a2A2840-14gcBAS	4	2
a2A2840-14gcPRO	4	2
a2A2840-14gmBAS	4	1
a2A2840-14gmPRO	4	1
a2A2840-48ucBAS	4	2
a2A2840-48ucPRO	4	2
a2A2840-48umBAS	4	1
a2A2840-48umPRO	4	1
a2A2840-67g5cBAS	4	2
a2A2840-67g5mBAS	4	1
a2A3840-13gcBAS	4	2
a2A3840-13gcPRO	4	2
a2A3840-13gmBAS	4	1
a2A3840-13gmPRO	4	1
a2A3840-45ucBAS	4	2
a2A3840-45ucPRO	4	2
a2A3840-45umBAS	4	1
a2A3840-45umPRO	4	1
a2A4096-9gcBAS	4	2
a2A4096-9gcPRO	4	2
a2A4096-9gmBAS	4	1
a2A4096-9gmPRO	4	1
a2A4096-30ucBAS	4	2
a2A4096-30ucPRO	4	2
a2A4096-30umBAS	4	1
a2A4096-30umPRO	4	1
a2A4096-44g5cBAS	4	2
a2A4096-44g5mBAS	4	1
a2A4200-12gcBAS	4	2
a2A4200-12gcPRO	4	2
a2A4200-12gmBAS	4	1
a2A4200-12gmPRO	4	1
a2A4200-40ucBAS	4	2
a2A4200-40ucPRO	4	2
a2A4200-40umBAS	4	1
a2A4200-40umPRO	4	1
a2A4504-5gcBAS	4	2
a2A4504-5gcPRO	4	2
a2A4504-5gmBAS	4	1
a2A4504-5gmPRO	4	1
a2A4504-18ucBAS	4	2
a2A4504-18ucPRO	4	2
a2A4504-18umBAS	4	1
a2A4504-18umPRO	4	1
a2A4504-27g5cBAS	4	2
a2A4504-27g5mBAS	4	1
a2A5320-7gcBAS	4	2
a2A5320-7gcPRO	4	2
a2A5320-7gmBAS	4	1
a2A5320-7gmPRO	4	1
a2A5320-23ucBAS	4	2
a2A5320-23ucPRO	4	2
a2A5320-23umBAS	4	1
a2A5320-23umPRO	4	1
a2A5320-34g5cBAS	4	2
a2A5320-34g5mBAS	4	1
a2A5328-4gcBAS	4	2
a2A5328-4gcPRO	4	2
a2A5328-4gmBAS	4	1
a2A5328-4gmPRO	4	1
a2A5328-15ucBAS	4	2
a2A5328-15ucPRO	4	2
a2A5328-15umBAS	4	1
a2A5328-15umPRO	4	1
a2A5328-22g5cBAS	4	2
a2A5328-22g5mBAS	4	1
acA640-90gc	2	2
acA640-90uc	2	2
acA640-121gm	1	1
acA640-300gc	16	2
acA640-300gm	16	1
acA640-750uc	16	2
acA640-750um	16	1
acA720-290gc	2	2
acA720-290gm	1	1
acA720-520uc	2	2
acA720-520um	1	1
acA800-200gc	16	2
acA800-200gm	16	1
acA800-510uc	16	2
acA800-510um	16	1
acA1280-60gc	2	2
acA1280-60gm	1	1
acA1300-60gc	2	2
acA1300-60gm	1	1
acA1300-60gmNIR	1	1
acA1300-75gc	16	2
acA1300-75gm	16	1
acA1300-200uc	16	2
acA1300-200um	16	1
acA1440-73gc	2	2
acA1440-73gm	1	1
acA1440-220uc	2	2
acA1440-220um	1	1
acA1600-20gc	2	2
acA1600-20uc	2	2
acA1600-60gc	2	2
acA1600-60gm	1	1
acA1920-25gc	64	64
acA1920-25gm	64	64
acA1920-25uc	64a	64a
acA1920-25um	64a	64a
acA1920-40gc	2	2
acA1920-40gm	1	1
acA1920-40uc	4	2
acA1920-40ucMED	4	2
acA1920-40um	4	1
acA1920-40umMED	4	1
acA1920-48gc	32	2
acA1920-48gm	32	1
acA1920-50gc	2	2
acA1920-50gm	1	1
acA1920-150uc	32	2
acA1920-150um	32	1
acA1920-155uc	4	2
acA1920-155ucMED	4	2
acA1920-155um	4	1
acA1920-155umMED	4	1
acA2000-50gc	2	2
acA2000-50gm	1	1
acA2000-165uc	8	2
acA2000-165um	8	1
acA2040-25gc	2	2
acA2040-25gm	1	1
acA2040-25gmNIR	1	1
acA2040-35gc	2	2
acA2040-35gm	1	1
acA2040-55uc	4	2
acA2040-55um	4	1
acA2040-90uc	8	2
acA2040-90um	8	1
acA2040-90umNIR	8	1
acA2040-120uc	4	2
acA2040-120um	4	1
acA2440-20gc	2	2
acA2440-20gm	1	1
acA2440-35uc	4	2
acA2440-35ucMED	4	2
acA2440-35um	4	1
acA2440-35umMED	4	1
acA2440-75uc	4	2
acA2440-75ucMED	4	2
acA2440-75um	4	1
acA2440-75umMED	4	1
acA2500-14gc	64	64
acA2500-14gm	64	64
acA2500-14uc	64a	64a
acA2500-14um	64a	64a
acA2500-20gc	32	2
acA2500-20gcMED	32	2
acA2500-20gm	32	1
acA2500-20gmMED	32	1
acA2500-60uc	32	1
acA2500-60um	32	1
acA3088-16gc	376	320
acA3088-16gm	376	320
acA3088-57uc	376	320
acA3088-57ucMED	376	320
acA3088-57um	376	320
acA3088-57umMED	376	320
acA3800-10gc	64	64
acA3800-10gm	64	64
acA3800-14uc	64	64
acA3800-14um	64a	64a
acA4024-8gc	8	6
acA4024-8gm	8	5
acA4024-29uc	8	6
acA4024-29um	8	5
acA4096-11gc	16	2
acA4096-11gm	16	1
acA4096-30uc	4	2
acA4096-30ucMED	4	2
acA4096-30um	4	1
acA4096-30umMED	4	1
acA4096-40uc	4	2
acA4096-40ucMED	4	2
acA4096-40um	4	1
acA4096-40umMED	4	1
acA4112-8gc	16	2
acA4112-8gm	16	1
acA4112-20uc	4	2
acA4112-20ucMED	4	2
acA4112-20um	4	1
acA4112-20umMED	4	1
acA4112-30uc	4	2
acA4112-30ucMED	4	2
acA4112-30um	4	1
acA4112-30umMED	4	1
acA4600-7gc	64	64
acA4600-10uc	64	64
acA5472-5gc	8	6
acA5472-5gm	8	5
acA5472-17uc	8	6
acA5472-17ucMED	8	6
acA5472-17um	8	5
acA5472-17umMED	8	5
boA1936-400cc	48	2
boA1936-400cm	48	2
boA2448-250cc	96／48b	2
boA2448-250cm	48	2
boA2832-190cc	96／48b	2
boA2832-190cm	48	2
boA4096-93cc	48	2
boA4096-93cm	48	2
boA4096-180cc	96／48b	2
boA4096-180cm	48	2
boA4112-68cc	48	2
boA4112-68cm	48	2
boA4500-45cc	48	2
boA4500-45cm	48	2
boA4504-100cc	96／48b	2
boA4504-100cm	96／48b	2
boA5320-150cc	96／48b	2
boA5320-150cm	96／48b	2
boA5328-100cc	96／48b	2
boA5328-100cm	96／48b	2
boA6500-36cc	48	2
boA6500-36cm	48	2
boA8100-16cc	48	2
boA8100-16cm	48	2
daA720-520uc	2	6
daA720-520um	4	3
daA1280-54uc	16	8
daA1280-54um	16	8
daA1440-220uc	2	6
daA1440-220um	4	3
daA1600-60uc	16	8
daA1600-60um	16	8
daA1920-15um	16	8
daA1920-30uc	16	8
daA1920-30um	16	8
daA1920-160uc	2	6
daA1920-160um	4	1
daA2448-70uc	2	6
daA2448-70um	4	3
daA2500-14uc	16	8
daA2500-14um	16	8
daA3840-45uc	2	6
daA3840-45um	4	4
puA1280-54uc	16	8
puA1280-54um	16	8
puA1600-60uc	16	8
puA1600-60um	16	8
puA1920-30uc	4	4
puA1920-30um	4	4
puA2500-14uc	4	4
puA2500-14um	4	4

---

1. ビニングを有効にすると、最小幅と最小高さが減少します。値は最も近い整数に丸められます。Example：水平ビニングを3に設定した場合、有効最小幅は64 / 3 = 21.333 ≈ 22です。

2. 10ビットピクセルフォーマット／その他のピクセルフォーマット

サンプルコード

ace Classic/U/L GigEカメラ

C++ (Native)C++ (Generic)C#C (Generic)

// Set the width to the maximum value
int64_t maxWidth = camera.Width.GetMax();
camera.Width.SetValue(maxWidth);
// Set the height to 500
camera.Height.SetValue(500);
// Set the offset to 0,0
camera.OffsetX.SetValue(0);
camera.OffsetY.SetValue(0);

INodeMap& nodemap = camera.GetNodeMap();
// Set the width to the maximum value
int64_t maxWidth = CIntegerParameter(nodemap, "Width").GetMax();
CIntegerParameter(nodemap, "Width").SetValue(maxWidth);
// Set the height to 500
CIntegerParameter(nodemap, "Height").SetValue(500);
// Set the offset to 0,0
CIntegerParameter(nodemap, "OffsetX").SetValue(0);
CIntegerParameter(nodemap, "OffsetY").SetValue(0);

// Set the width to the maximum value
Int64 maxWidth = camera.Parameters[PLCamera.Width].GetMaximum();
camera.Parameters[PLCamera.Width].SetValue(maxWidth);
// Set the height to 500
camera.Parameters[PLCamera.Height].SetValue(500);
// Set the offset to 0,0
camera.Parameters[PLCamera.OffsetX].SetValue(0);
camera.Parameters[PLCamera.OffsetY].SetValue(0);

/* 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 */
int64_t maxWidth = 0;
/* Set the width to the maximum value */
errRes = PylonDeviceGetIntegerFeatureMax(hdev, "Width", &maxWidth);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", maxWidth);
CHECK(errRes);
/* Set the height to 500 */
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 500);
CHECK(errRes);
/* Set the offset to 0,0 */
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetX", 0);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetY", 0);
CHECK(errRes);

その他のカメラ

C++ (Native)C++ (Generic)C#C (Generic)

// Set the width to the maximum value
int64_t maxWidth = camera.WidthMax.GetValue();
camera.Width.SetValue(maxWidth);
// Set the height to 500
camera.Height.SetValue(500);
// Set the offset to 0
camera.OffsetX.SetValue(0);
camera.OffsetY.SetValue(0);

INodeMap& nodemap = camera.GetNodeMap();
// Set the width to the maximum value
int64_t maxWidth = CIntegerParameter(nodemap, "WidthMax").GetValue();
CIntegerParameter(nodemap, "Width").SetValue(maxWidth);
// Set the height to 500
CIntegerParameter(nodemap, "Height").SetValue(500);
// Set the offset to 0
CIntegerParameter(nodemap, "OffsetX").SetValue(0);
CIntegerParameter(nodemap, "OffsetY").SetValue(0);

// Set the width to the maximum value
Int64 maxWidth = camera.Parameters[PLCamera.WidthMax].GetValue();
camera.Parameters[PLCamera.Width].SetValue(maxWidth);
// Set the height to 500
camera.Parameters[PLCamera.Height].SetValue(500);
// Set the offset to 0
camera.Parameters[PLCamera.OffsetX].SetValue(0);
camera.Parameters[PLCamera.OffsetY].SetValue(0);

/* 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 */
int64_t maxWidth = 0;
/* Set the width to the maximum value */
errRes = PylonDeviceGetIntegerFeature(hdev, "WidthMax", &maxWidth);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", maxWidth);
CHECK(errRes);
/* Set the height to 500 */
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 500);
CHECK(errRes);
/* Set the offset to 0 */
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetX", 0);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetY", 0);
CHECK(errRes);

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