跳至內容
測試伺服器
開發伺服器

Image ROI#

Image ROI 相機功能可讓您指定要用於影像擷取的感光元件陣列部分。

ROI 是 Region of Interest(感興趣區域,前身為 AOI = Area of Interest)的縮寫。

如果已指定 Image ROI,相機將只傳輸該區域內的像素資料。在多數相機上,這會大幅提高相機的最大幀率。

Image ROI 設定與 Auto Function ROI 設定無關。

使用功能#

變更 Image ROI 的位置與大小#

啟用原廠設定後,相機會設為預設解析度。不過,您可以根據需要變更位置與大小。

若要變更 Image ROI 的位置與大小:

  1. 請確保相機處於閒置狀態,也就是未擷取影像。
  2. 如果您使用的是 Classic/U/L 相機,請設定 CenterX 進行明確的生命週期管理即呼叫 CenterY 參數為 false.
  3. 使用下列參數來指定 Image ROI 的 大小:

    • Width
    • Height
  4. 使用下列參數來指定 Image ROI 的 位置:

    • OffsetX
    • OffsetY

Image ROI 的原點位於感光元件陣列的左上角(第 0 行,第 0 列)。

範例:假設您已指定下列設定:

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

這會建立下列 Image ROI:

Image ROI 範例

資訊

對於面陣掃描相機:

資訊

對於線陣掃描相機:

  • 對於具備 多個感光元件線陣列的線陣掃描相機,適用以下規則:
    如果您將 Image ROI 高度設定為 1,相機在擷取時的輸出取決於相機感光元件線陣列的數量:
    • 具備 2 個感光元件行的相機:
      相機將會輸出以下色彩色版:
      G 在一行,R 與 B 在另一行交替出現。
    • 具備 3 個感光元件線陣列的相機:
      相機將在擷取時輸出所有三個色道(R、G 和 B)。
      關於相機型號中可用的感光元件線陣列數量資訊,請參閱相應相機主題中的一般規格表格。
  • 在所有 racer 2 相機, OffsetY 參數無法使用。
  • 在配備 CXP 介面的相機,其 Height 的 racer 2 相機上,參數會自動設定為 1 且無法更改。對於這些相機,單行會分別傳輸至擷取卡。然後,擷取卡會將其組合成一個畫面。
  • 在配備 GigE 或 5GigE 介面的 racer 2 S 相機上,您可以新增多行以建構畫面。請使用 Height 參數來定義 Image ROI 的高度,也就是傳輸至主機之結果畫面的高度。
    每個畫面的最小行數: 1
    Depending on the host computer, a low frame height (i.e. < 10 lines) may increase the CPU load of the host computer significantly.
    當 每個畫面的最大行數 取決於相機型號:
    • 對於 r2L2048-29gc、r2L2048-58gm、r2L2048-62g5c、r2L2048-172g5m、r2L4096-29gm 和 r2L4096-84g5m 相機:12000
    • 對於 r2L4096-14gc 和 r2L4096-42g5c 相機:10000

資訊

對於 racer 2 S GigE 相機,您可以結合使用 Counter 和 Data Chunks 功能以及觸發設定,來指定哪些行屬於某個畫面,以及哪些畫面屬於正確的測試物件。

資訊

關於相機在不同設定下可達到的影格率或行頻資訊,請參閱 Basler 影格率計算器 (baslerweb.com)。

指南#

當您指定 Image 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 大小#

顯示所有相機型號

相機型號 最小寬度 最小高度
a2A640-240gmSWIR 4 1
a2A640-240umSWIR 4 1
a2A1280-80gmSWIR 4 1
a2A1280-125umSWIR 4 1
a2A1920-51gcBAS 4 2
a2A1920-51gcIP67 4 2
a2A1920-51gcPRO 4 2
a2A1920-51gmBAS 4 1
a2A1920-51gmIP67 4 1
a2A1920-51gmPRO 4 1
a2A1920-160ucBAS 4 2
a2A1920-160ucPRO 4 2
a2A1920-160umBAS 4 1
a2A1920-160umPRO 4 1
a2A1920-165g5cBAS 4 2
a2A1920-165g5mBAS 4 1
a2A1920-168mgc 4 2
a2A1920-168mgm 4 1
a2A2048-35gmSWIR 4 1
a2A2048-37gcBAS 4 2
a2A2048-37gcPRO 4 2
a2A2048-37gmBAS 4 1
a2A2048-37gmPRO 4 1
a2A2048-110umSWIR 4 1
a2A2048-114g5cBAS 4 2
a2A2048-114g5mBAS 4 1
a2A2048-114mgc 4 2
a2A2048-114mgm 4 1
a2A2048-114ucBAS 4 2
a2A2048-114ucPRO 4 2
a2A2048-114umBAS 4 1
a2A2048-114umPRO 4 1
a2A2048-173cmSWIR 48 4
a2A2440-98g5cBAS 4 4
a2A2440-98g5mBAS 4 4
a2A2448-23gcBAS 4 2
a2A2448-23gcIP67 4 2
a2A2448-23gcPRO 4 2
a2A2448-23gmBAS 4 1
a2A2448-23gmIP67 4 1
a2A2448-23gmPRO 4 1
a2A2448-75ucBAS 4 2
a2A2448-75ucPRO 4 2
a2A2448-75umBAS 4 1
a2A2448-75umPRO 4 1
a2A2448-90mgc 4 2
a2A2448-90mgm 4 1
a2A2448-105g5cBAS 4 2
a2A2448-105g5mBAS 4 1
a2A2448-120cc 48 2
a2A2448-120cm 48 2
a2A2448-210cc 48 2
a2A2448-210cm 48 2
a2A2464-23gcBAS 4 2
a2A2464-23gcPRO 4 2
a2A2464-23gmBAS 4 1
a2A2464-23gmPRO 4 1
a2A2464-77ucBAS 4 2
a2A2464-77ucPRO 4 2
a2A2464-77umBAS 4 1
a2A2464-77umPRO 4 1
a2A2464-115g5cBAS 4 2
a2A2464-115g5mBAS 4 1
a2A2560-20gmSWIR 4 1
a2A2560-70umSWIR 4 1
a2A2560-131cmSWIR 48 4
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-14gcIP67 4 2
a2A2840-14gcPRO 4 2
a2A2840-14gmBAS 4 1
a2A2840-14gmIP67 4 1
a2A2840-14gmPRO 4 1
a2A2840-14gmUV 4 1
a2A2840-48ucBAS 4 2
a2A2840-48ucPRO 4 2
a2A2840-48umBAS 4 1
a2A2840-48umPRO 4 1
a2A2840-48umUV 4 1
a2A2840-57mgc 4 2
a2A2840-57mgm 4 1
a2A2840-67g5cBAS 4 2
a2A2840-67g5mBAS 4 1
a2A2840-67g5mUV 4 1
a2A2840-86cc 48 2
a2A2840-86cm 48 2
a2A3536-9gcBAS 4 2
a2A3536-9gcPRO 4 2
a2A3536-9gmBAS 4 2
a2A3536-9gmPRO 4 2
a2A3536-31ucBAS 4 2
a2A3536-31ucPRO 4 2
a2A3536-31umBAS 4 2
a2A3536-31umPRO 4 2
a2A3536-37mgc 4 2
a2A3536-37mgm 4 2
a2A3536-42g5cBAS 4 4
a2A3536-42g5mBAS 4 4
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-9gcIP67 4 2
a2A4096-9gcPRO 4 2
a2A4096-9gmBAS 4 1
a2A4096-9gmIP67 4 1
a2A4096-9gmPRO 4 1
a2A4096-30ucBAS 4 2
a2A4096-30ucPRO 4 2
a2A4096-30umBAS 4 1
a2A4096-30umPRO 4 1
a2A4096-38mgc 4 2
a2A4096-38mgm 4 1
a2A4096-44g5cBAS 4 2
a2A4096-44g5mBAS 4 1
a2A4096-67cc 48 2
a2A4096-67cm 48 2
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-5gcIP67 4 2
a2A4504-5gcPRO 4 2
a2A4504-5gmBAS 4 1
a2A4504-5gmIP67 4 1
a2A4504-5gmPRO 4 1
a2A4504-18ucBAS 4 2
a2A4504-18ucPRO 4 2
a2A4504-18umBAS 4 1
a2A4504-18umPRO 4 1
a2A4504-23mgc 4 2
a2A4504-23mgm 4 1
a2A4504-27g5cBAS 4 2
a2A4504-27g5mBAS 4 1
a2A4504-42cc 48 2
a2A4504-42cm 48 2
a2A4508-6gcBAS 4 2
a2A4508-6gcPRO 4 2
a2A4508-6gmBAS 4 1
a2A4508-6gmPRO 4 1
a2A4508-20ucBAS 4 2
a2A4508-20ucPRO 4 2
a2A4508-20umBAS 4 1
a2A4508-20umPRO 4 1
a2A5060-4gcBAS 4 2
a2A5060-4gmBAS 4 1
a2A5060-15ucBAS 4 2
a2A5060-15umBAS 4 1
a2A5060-21g5cBAS 4 2
a2A5060-21g5mBAS 4 1
a2A5060-35cc 48 2
a2A5060-35cm 48 2
a2A5320-7gcBAS 4 2
a2A5320-7gcIP67 4 2
a2A5320-7gcPRO 4 2
a2A5320-7gmBAS 4 1
a2A5320-7gmPRO 4 1
a2A5320-7gmip67 4 1
a2A5320-23ucBAS 4 2
a2A5320-23ucPRO 4 2
a2A5320-23umBAS 4 1
a2A5320-23umPRO 4 1
a2A5320-29mgc 4 2
a2A5320-29mgm 4 1
a2A5320-34g5cBAS 4 2
a2A5320-34g5mBAS 4 1
a2A5320-52cc 48 2
a2A5320-52cm 48 2
a2A5328-4gcBAS 4 2
a2A5328-4gcIP67 4 2
a2A5328-4gcPRO 4 2
a2A5328-4gmBAS 4 1
a2A5328-4gmIP67 4 1
a2A5328-4gmPRO 4 1
a2A5328-15ucBAS 4 2
a2A5328-15ucPRO 4 2
a2A5328-15umBAS 4 1
a2A5328-15umPRO 4 1
a2A5328-19mgc 4 2
a2A5328-19mgm 4 1
a2A5328-22g5cBAS 4 2
a2A5328-22g5mBAS 4 1
a2A5328-35cc 48 2
a2A5328-35cm 48 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-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
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
boA5056-95cm 64 2
boA5120-150cc 256 4
boA5120-150cm 256 4
boA5120-230cc 256 32
boA5120-230cm 256 32
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
boA9344-30cc 256 4
boA9344-30cm 256 4
boA9344-70cc 256 4
boA9344-70cm 256 4
boA13440-17cm 96 / 48b 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
dmA720-290gc 4 2
dmA720-290gm 4 1
dmA1440-73gc 4 2
dmA1440-73gm 4 1
dmA1920-51gc 4 2
dmA1920-51gm 4 1
dmA2048-37gc 4 2
dmA2048-37gm 4 1
dmA2448-23gc 4 2
dmA2448-23gm 4 1
dmA2840-14gc 4 2
dmA2840-14gm 4 1
dmA3536-9gc 4 2
dmA3536-9gm 4 2
dmA4096-9gc 4 2
dmA4096-9gm 4 1
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
r2L2048-29gc 16 1
r2L2048-58gm 4 1
r2L2048-62cc 48 1
r2L2048-62g5c 16 1
r2L2048-172cm 48 1
r2L2048-172g5m 16 1
r2L4096-14gc 8 1
r2L4096-29gm 4 1
r2L4096-42cc 48 1
r2L4096-42g5c 16 1
r2L4096-84cm 48 1
r2L4096-84g5m 16 1
r2L8192-80cc 64 1
r2L8192-240cm 64 1
r2L16384-60cc 64 1
r2L16384-120cm 64 1
r2T16416-500cm 64 1

  1. 當啟用 Binning 時,最小寬度和最小高度會縮小。數值會向上取整至最接近的整數。範例:如果您將水平 Binning 設定為 3,則實際的最小寬度為 64 / 3 = 21.333 ≈ 22。

  2. 10-bit Pixel Format / 其他 Pixel Format

範例程式碼#

ace Classic/U/L GigE 相機#
// 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);
# Set the width to the maximum value
maxWidth = camera.Width.Max
camera.Width.Value = maxWidth
# Set the height to 500
camera.Height.Value = 500
# Set the offset to 0,0
camera.OffsetX.Value = 0
camera.OffsetY.Value = 0
其他相機#
// 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);
# Set the width to the maximum value
maxWidth = camera.WidthMax.Value
camera.Width.Value = maxWidth
# Set the height to 500
camera.Height.Value = 500
# Set the offset to 0
camera.OffsetX.Value = 0
camera.OffsetY.Value = 0

您也可以 use the pylon Viewer 來輕鬆設定參數。