Multiple ROI#

透過 Multiple ROI 相機功能，您可以定義感光元件陣列上的多個區域，這些區域將組合成單一影像進行傳輸。

系統只會傳輸這些區域中的像素資料。這能提高相機的 frame rate。

Multiple ROI 功能類似於 Stacked ROI 功能，該功能僅適用於 Basler ace 相機。

使用此功能#

運作原理#

Multiple ROI 功能允許您在感光元件陣列上定義區域。區域的最大數量取決於您的相機型號。

擷取影像時，只會從感光元件讀取這些區域內的像素資訊，並將其傳輸為單一影像。

您不需要個別定義區域的大小和位置，而是直接在感光元件陣列上定義行和列。接著，行與列的每一個交集都會建立一個區域。

在以下範例中，定義了兩行和兩列。這會建立四個區域：

Region 11、Region 21、Region 12 和 Region 22 內的像素資訊會以單一影像傳輸。

設定列與欄 #

資訊

在某些相機型號上，建立區域時只能設定列而不能設定行。在這種情況下，每個區域都會涵蓋整個感光元件寬度，且可視為只有單一行。

若要設定行和列：

請確保相機處於閒置狀態，也就是未擷取影像。
請確保已停用 Reverse X and Reverse Y 功能。
設定完行和列之後，您可以重新啟用影像鏡射。
設定欄：
1. 如果您只想定義單一行：
  1. 將 BslMultipleROIColumnsEnable 參數設為 false.
  2. 將 OffsetX 參數設為所需的欄水平偏移量。此數值會套用到所有區域。
  3. 將 Width 參數設為所需的欄寬度。此數值會套用到所有區域。
2. 如果您想要定義多個欄：
  1. 將 BslMultipleROIColumnsEnable 參數設為 true.
  2. 將 BslMultipleROIColumnSelector 參數設為所需的欄，例如： Column1.
  3. 將 BslMultipleROIColumnOffset 參數設為所需的欄水平偏移量，例如 100。
  4. 將 BslMultipleROIColumnSize 參數設為所需的欄寬度，例如 50。
  5. 對您想要設定的每一個欄重複上述步驟。
    注意事項： 為避免產生非預期的副作用，請務必按照遞增順序設定欄，亦即從第 1 欄開始，接著設定第 2 欄，以此類推。
配置資料列：
1. 如果您只想定義單一列：
  1. 將 BslMultipleROIRowsEnable 參數設為 false.
  2. 將 OffsetY 參數設為所需的列垂直偏移量。此數值會套用到所有區域。
  3. 將 Height 參數設為所需的列高度。此數值會套用到所有區域。
2. 如果您要定義多個資料列：
  1. 將 BslMultipleROIRowsEnable 參數設為 true.
  2. 將 BslMultipleROIRowSelector 參數設為所需的列，例如： Row1.
  3. 將 BslMultipleROIRowOffset 將參數設為所需的資料列垂直位移，例如 100。
  4. 將 BslMultipleROIRowSize 將參數設為所需的資料列高度，例如 50。
  5. 重複上述步驟以設定您要配置的每一個資料列。
    注意：為了避免產生不必要的 side effects，請一律以遞增順序配置資料列，也就是從第 1 列開始，接著設定第 2 列，依此類推。
如有必要，請重新啟用 Reverse X and Reverse Y。
這會自動將欄與列的位置調整為鏡射影像。

使用 Multiple ROI 功能時的注意事項#

對於所有區域的組合（也就是 Multiple ROI 功能所建立的影像），感光元件都有一個特定的最小寬度與高度限制。在配置過程中，相機會自動調整參數值與範圍以符合最小寬度和高度。最後一欄一律用來達到最小總寬度。由於 BslMultipleROIColumnSize 參數的增量也會納入考量，因此產生的總寬度可能會大於最小值。
範例： 您的相機感光元件具有 530 的最小總寬度，並允許您設定最多兩欄。如果您將第 1 欄的寬度設為 200，相機會自動將第 2 欄的最小寬度設為 330。
範例 2： 假設您使用的是與上述範例相同的感光元件。同時假設該感光元件解析度為 1920 x 1200。現在，如果您將欄 0 的垂直位移設為 900，將沒有足夠的空間來定義符合最小寬度要求的區域。因此，相機會自動將任何欄的最大垂直位移設為 670（1200 感光元件寬度減去 530 最小總區域寬度）。
基於上述限制，Basler 強烈建議以遞增順序配置欄與列，也就是從第 1 欄開始，接著設定第 2 欄，依此類推。
在彩色相機上，如果像素格式設為包含去馬賽克（debayering）的格式（也就是 RGB 或 YCbCr 像素格式），請注意，唯有區域至少達到去馬賽克區域的大小（例如 3x3 像素），相機才能計算出有意義的色彩資訊。
如果已啟用 BslMultipleROIColumnsEnable 參數已設定為 true，下列參數將會變成唯讀：
- OffsetX：此參數會設為第 1 欄的水平位移。
- Width：此參數會設為所有區域的總寬度，也就是 Multiple ROI 功能所建立影像的寬度。
如果已啟用 BslMultipleROIRowsEnable 參數已設定為 true，下列參數將會變成唯讀：
- OffsetY：此參數會設為第 1 列的垂直位移。
- Height：此參數會設為所有區域的總高度，也就是 Multiple ROI 功能所建立影像的高度。
會影響影像大小的其他相機功能（例如 Binning 或 Pixel Beyond），會在 Multiple ROI 功能之後套用。因此，在配置列與欄時，您不需要將這些功能的影響納入考量。
影像自動功能 ROI 其位置與大小會自動調適為 Multiple ROI 功能的輸出。例如，如果所有區域的組合寬度為 500，則 AutoFunctionROIWidth 參數的最大值將會是 500。

詳細資料#

顯示所有相機型號

相機型號	最大區域數（列 x 欄）
a2A640-240gmSWIR	64 (8 x 8)
a2A640-240umSWIR	64 (8 x 8)
a2A1280-80gmSWIR	64 (8 x 8)
a2A1280-125umSWIR	64 (8 x 8)
a2A1920-51gcBAS	4 (2 x 2)
a2A1920-51gcIP67	4 (2 x 2)
a2A1920-51gcPRO	4 (2 x 2)
a2A1920-51gmBAS	4 (2 x 2)
a2A1920-51gmIP67	4 (2 x 2)
a2A1920-51gmPRO	4 (2 x 2)
a2A1920-160ucBAS	4 (2 x 2)
a2A1920-160ucPRO	4 (2 x 2)
a2A1920-160umBAS	4 (2 x 2)
a2A1920-160umPRO	4 (2 x 2)
a2A1920-165g5cBAS	4 (2 x 2)
a2A1920-165g5mBAS	4 (2 x 2)
a2A1920-168mgc	4 (2 x 2)
a2A1920-168mgm	4 (2 x 2)
a2A2048-35gmSWIR	64 (8 x 8)
a2A2048-37gcBAS	64 (8 x 8)
a2A2048-37gcPRO	64 (8 x 8)
a2A2048-37gmBAS	64 (8 x 8)
a2A2048-37gmPRO	64 (8 x 8)
a2A2048-110umSWIR	64 (8 x 8)
a2A2048-114g5cBAS	64 (8 x 8)
a2A2048-114g5mBAS	64 (8 x 8)
a2A2048-114mgc	64 (8 x 8)
a2A2048-114mgm	64 (8 x 8)
a2A2048-114ucBAS	64 (8 x 8)
a2A2048-114ucPRO	64 (8 x 8)
a2A2048-114umBAS	64 (8 x 8)
a2A2048-114umPRO	64 (8 x 8)
a2A2048-173cmSWIR	64 (8 x 8)
a2A2440-98g5cBAS	64 (8 x 8)
a2A2440-98g5mBAS	64 (8 x 8)
a2A2448-23gcBAS	64 (8 x 8)
a2A2448-23gcIP67	64 (8 x 8)
a2A2448-23gcPRO	64 (8 x 8)
a2A2448-23gmBAS	64 (8 x 8)
a2A2448-23gmIP67	64 (8 x 8)
a2A2448-23gmPRO	64 (8 x 8)
a2A2448-75ucBAS	64 (8 x 8)
a2A2448-75ucPRO	64 (8 x 8)
a2A2448-75umBAS	64 (8 x 8)
a2A2448-75umPRO	64 (8 x 8)
a2A2448-90mgc	64 (8 x 8)
a2A2448-90mgm	64 (8 x 8)
a2A2448-105g5cBAS	64 (8 x 8)
a2A2448-105g5mBAS	64 (8 x 8)
a2A2448-120cc	64 (8 x 8)
a2A2448-120cm	64 (8 x 8)
a2A2448-210cc	64 (8 x 8)
a2A2448-210cm	64 (8 x 8)
a2A2448-232g10c	64 (8 x 8)
a2A2448-232g10m	64 (8 x 8)
a2A2464-23gcBAS	64 (8 x 8)
a2A2464-23gcPRO	64 (8 x 8)
a2A2464-23gmBAS	64 (8 x 8)
a2A2464-23gmPRO	64 (8 x 8)
a2A2464-77ucBAS	64 (8 x 8)
a2A2464-77ucPRO	64 (8 x 8)
a2A2464-77umBAS	64 (8 x 8)
a2A2464-77umPRO	64 (8 x 8)
a2A2464-115g5cBAS	64 (8 x 8)
a2A2464-115g5mBAS	64 (8 x 8)
a2A2560-20gmSWIR	64 (8 x 8)
a2A2560-70umSWIR	64 (8 x 8)
a2A2560-131cmSWIR	64 (8 x 8)
a2A2590-22gcBAS	不支援 Multiple ROI 功能
a2A2590-22gcPRO	不支援 Multiple ROI 功能
a2A2590-22gmBAS	不支援 Multiple ROI 功能
a2A2590-22gmPRO	不支援 Multiple ROI 功能
a2A2590-60ucBAS	不支援 Multiple ROI 功能
a2A2590-60ucPRO	不支援 Multiple ROI 功能
a2A2590-60umBAS	不支援 Multiple ROI 功能
a2A2590-60umPRO	不支援 Multiple ROI 功能
a2A2600-20gcBAS	16 (16 x 1)^a
a2A2600-20gcPRO	16 (16 x 1)^a
a2A2600-20gmBAS	16 (16 x 1)^a
a2A2600-20gmPRO	16 (16 x 1)^a
a2A2600-64ucBAS	16 (16 x 1)^a
a2A2600-64ucPRO	16 (16 x 1)^a
a2A2600-64umBAS	16 (16 x 1)^a
a2A2600-64umPRO	16 (16 x 1)^a
a2A2840-14gcBAS	64 (8 x 8)
a2A2840-14gcIP67	64 (8 x 8)
a2A2840-14gcPRO	64 (8 x 8)
a2A2840-14gmBAS	64 (8 x 8)
a2A2840-14gmIP67	64 (8 x 8)
a2A2840-14gmPRO	64 (8 x 8)
a2A2840-14gmUV	64 (8 x 8)
a2A2840-48ucBAS	64 (8 x 8)
a2A2840-48ucPRO	64 (8 x 8)
a2A2840-48umBAS	64 (8 x 8)
a2A2840-48umPRO	64 (8 x 8)
a2A2840-48umUV	64 (8 x 8)
a2A2840-57mgc	64 (8 x 8)
a2A2840-57mgm	64 (8 x 8)
a2A2840-67g5cBAS	64 (8 x 8)
a2A2840-67g5mBAS	64 (8 x 8)
a2A2840-67g5mUV	64 (8 x 8)
a2A2840-86cc	64 (8 x 8)
a2A2840-86cm	64 (8 x 8)
a2A2840-150g10c	64 (8 x 8)
a2A2840-150g10m	64 (8 x 8)
a2A2840-150g10mUV	64 (8 x 8)
a2A3536-9gcBAS	不支援 Multiple ROI 功能
a2A3536-9gcPRO	不支援 Multiple ROI 功能
a2A3536-9gmBAS	不支援 Multiple ROI 功能
a2A3536-9gmPRO	不支援 Multiple ROI 功能
a2A3536-31ucBAS	不支援 Multiple ROI 功能
a2A3536-31ucPRO	不支援 Multiple ROI 功能
a2A3536-31umBAS	不支援 Multiple ROI 功能
a2A3536-31umPRO	不支援 Multiple ROI 功能
a2A3536-37mgc	不支援 Multiple ROI 功能
a2A3536-37mgm	不支援 Multiple ROI 功能
a2A3536-42g5cBAS	不支援 Multiple ROI 功能
a2A3536-42g5mBAS	不支援 Multiple ROI 功能
a2A3840-13gcBAS	不支援 Multiple ROI 功能
a2A3840-13gcPRO	不支援 Multiple ROI 功能
a2A3840-13gmBAS	不支援 Multiple ROI 功能
a2A3840-13gmPRO	不支援 Multiple ROI 功能
a2A3840-45ucBAS	不支援 Multiple ROI 功能
a2A3840-45ucPRO	不支援 Multiple ROI 功能
a2A3840-45umBAS	不支援 Multiple ROI 功能
a2A3840-45umPRO	不支援 Multiple ROI 功能
a2A4096-9gcBAS	64 (8 x 8)
a2A4096-9gcIP67	64 (8 x 8)
a2A4096-9gcPRO	64 (8 x 8)
a2A4096-9gmBAS	64 (8 x 8)
a2A4096-9gmIP67	64 (8 x 8)
a2A4096-9gmPRO	64 (8 x 8)
a2A4096-30ucBAS	64 (8 x 8)
a2A4096-30ucPRO	64 (8 x 8)
a2A4096-30umBAS	64 (8 x 8)
a2A4096-30umPRO	64 (8 x 8)
a2A4096-38mgc	64 (8 x 8)
a2A4096-38mgm	64 (8 x 8)
a2A4096-44g5cBAS	64 (8 x 8)
a2A4096-44g5mBAS	64 (8 x 8)
a2A4096-67cc	64 (8 x 8)
a2A4096-67cm	64 (8 x 8)
a2A4096-98g10c	64 (8 x 8)
a2A4096-98g10m	64 (8 x 8)
a2A4200-12gcBAS	16 (16 x 1)^a
a2A4200-12gcPRO	16 (16 x 1)^a
a2A4200-12gmBAS	16 (16 x 1)^a
a2A4200-12gmPRO	16 (16 x 1)^a
a2A4200-40ucBAS	16 (16 x 1)^a
a2A4200-40ucPRO	16 (16 x 1)^a
a2A4200-40umBAS	16 (16 x 1)^a
a2A4200-40umPRO	16 (16 x 1)^a
a2A4504-5gcBAS	64 (8 x 8)
a2A4504-5gcIP67	64 (8 x 8)
a2A4504-5gcPRO	64 (8 x 8)
a2A4504-5gmBAS	64 (8 x 8)
a2A4504-5gmIP67	64 (8 x 8)
a2A4504-5gmPRO	64 (8 x 8)
a2A4504-18ucBAS	64 (8 x 8)
a2A4504-18ucPRO	64 (8 x 8)
a2A4504-18umBAS	64 (8 x 8)
a2A4504-18umPRO	64 (8 x 8)
a2A4504-23mgc	64 (8 x 8)
a2A4504-23mgm	64 (8 x 8)
a2A4504-27g5cBAS	64 (8 x 8)
a2A4504-27g5mBAS	64 (8 x 8)
a2A4504-42cc	64 (8 x 8)
a2A4504-42cm	64 (8 x 8)
a2A4504-59g10c	64 (8 x 8)
a2A4504-59g10m	64 (8 x 8)
a2A4508-6gcBAS	16 (16 x 1)^a
a2A4508-6gcPRO	16 (16 x 1)^a
a2A4508-6gmBAS	16 (16 x 1)^a
a2A4508-6gmPRO	16 (16 x 1)^a
a2A4508-20ucBAS	16 (16 x 1)^a
a2A4508-20ucPRO	16 (16 x 1)^a
a2A4508-20umBAS	16 (16 x 1)^a
a2A4508-20umPRO	16 (16 x 1)^a
a2A5060-4gcBAS	不支援 Multiple ROI 功能
a2A5060-4gmBAS	不支援 Multiple ROI 功能
a2A5060-15ucBAS	不支援 Multiple ROI 功能
a2A5060-15umBAS	不支援 Multiple ROI 功能
a2A5060-21g5cBAS	不支援 Multiple ROI 功能
a2A5060-21g5mBAS	不支援 Multiple ROI 功能
a2A5060-35cc	不支援 Multiple ROI 功能
a2A5060-35cm	不支援 Multiple ROI 功能
a2A5320-7gcBAS	64 (8 x 8)
a2A5320-7gcIP67	64 (8 x 8)
a2A5320-7gcPRO	64 (8 x 8)
a2A5320-7gmBAS	64 (8 x 8)
a2A5320-7gmPRO	64 (8 x 8)
a2A5320-7gmip67	64 (8 x 8)
a2A5320-23ucBAS	64 (8 x 8)
a2A5320-23ucPRO	64 (8 x 8)
a2A5320-23umBAS	64 (8 x 8)
a2A5320-23umPRO	64 (8 x 8)
a2A5320-29mgc	64 (8 x 8)
a2A5320-29mgm	64 (8 x 8)
a2A5320-34g5cBAS	64 (8 x 8)
a2A5320-34g5mBAS	64 (8 x 8)
a2A5320-52cc	64 (8 x 8)
a2A5320-52cm	64 (8 x 8)
a2A5320-75g10c	64 (8 x 8)
a2A5320-75g10m	64 (8 x 8)
a2A5328-4gcBAS	64 (8 x 8)
a2A5328-4gcIP67	64 (8 x 8)
a2A5328-4gcPRO	64 (8 x 8)
a2A5328-4gmBAS	64 (8 x 8)
a2A5328-4gmIP67	64 (8 x 8)
a2A5328-4gmPRO	64 (8 x 8)
a2A5328-15ucBAS	64 (8 x 8)
a2A5328-15ucPRO	64 (8 x 8)
a2A5328-15umBAS	64 (8 x 8)
a2A5328-15umPRO	64 (8 x 8)
a2A5328-19mgc	64 (8 x 8)
a2A5328-19mgm	64 (8 x 8)
a2A5328-22g5cBAS	64 (8 x 8)
a2A5328-22g5mBAS	64 (8 x 8)
a2A5328-35cc	64 (8 x 8)
a2A5328-35cm	64 (8 x 8)
a2A5328-49g10c	64 (8 x 8)
a2A5328-49g10m	64 (8 x 8)
acA640-121gm	不支援 Multiple ROI 功能
acA640-300gc	不支援 Multiple ROI 功能
acA640-300gm	不支援 Multiple ROI 功能
acA640-750uc	不支援 Multiple ROI 功能
acA640-750um	不支援 Multiple ROI 功能
acA720-290gc	不支援 Multiple ROI 功能
acA720-290gm	不支援 Multiple ROI 功能
acA720-520uc	不支援 Multiple ROI 功能
acA720-520um	不支援 Multiple ROI 功能
acA800-200gc	不支援 Multiple ROI 功能
acA800-200gm	不支援 Multiple ROI 功能
acA800-510uc	不支援 Multiple ROI 功能
acA800-510um	不支援 Multiple ROI 功能
acA1280-60gc	不支援 Multiple ROI 功能
acA1280-60gm	不支援 Multiple ROI 功能
acA1300-60gc	不支援 Multiple ROI 功能
acA1300-60gm	不支援 Multiple ROI 功能
acA1300-60gmNIR	不支援 Multiple ROI 功能
acA1300-75gc	不支援 Multiple ROI 功能
acA1300-75gm	不支援 Multiple ROI 功能
acA1300-200uc	不支援 Multiple ROI 功能
acA1300-200um	不支援 Multiple ROI 功能
acA1440-73gc	不支援 Multiple ROI 功能
acA1440-73gm	不支援 Multiple ROI 功能
acA1440-220uc	不支援 Multiple ROI 功能
acA1440-220um	不支援 Multiple ROI 功能
acA1600-60gc	不支援 Multiple ROI 功能
acA1600-60gm	不支援 Multiple ROI 功能
acA1920-25gc	不支援 Multiple ROI 功能
acA1920-25gm	不支援 Multiple ROI 功能
acA1920-25uc	不支援 Multiple ROI 功能
acA1920-25um	不支援 Multiple ROI 功能
acA1920-40gc	不支援 Multiple ROI 功能
acA1920-40gm	不支援 Multiple ROI 功能
acA1920-40uc	不支援 Multiple ROI 功能
acA1920-40ucMED	不支援 Multiple ROI 功能
acA1920-40um	不支援 Multiple ROI 功能
acA1920-40umMED	不支援 Multiple ROI 功能
acA1920-48gc	不支援 Multiple ROI 功能
acA1920-48gm	不支援 Multiple ROI 功能
acA1920-50gc	不支援 Multiple ROI 功能
acA1920-50gm	不支援 Multiple ROI 功能
acA1920-150uc	不支援 Multiple ROI 功能
acA1920-150um	不支援 Multiple ROI 功能
acA1920-155uc	不支援 Multiple ROI 功能
acA1920-155ucMED	不支援 Multiple ROI 功能
acA1920-155um	不支援 Multiple ROI 功能
acA1920-155umMED	不支援 Multiple ROI 功能
acA2000-50gc	不支援 Multiple ROI 功能
acA2000-50gm	不支援 Multiple ROI 功能
acA2000-165uc	不支援 Multiple ROI 功能
acA2000-165um	不支援 Multiple ROI 功能
acA2040-25gc	不支援 Multiple ROI 功能
acA2040-25gm	不支援 Multiple ROI 功能
acA2040-25gmNIR	不支援 Multiple ROI 功能
acA2040-35gc	不支援 Multiple ROI 功能
acA2040-35gm	不支援 Multiple ROI 功能
acA2040-55uc	不支援 Multiple ROI 功能
acA2040-55um	不支援 Multiple ROI 功能
acA2040-90uc	不支援 Multiple ROI 功能
acA2040-90um	不支援 Multiple ROI 功能
acA2040-90umNIR	不支援 Multiple ROI 功能
acA2040-120uc	不支援 Multiple ROI 功能
acA2040-120um	不支援 Multiple ROI 功能
acA2440-20gc	不支援 Multiple ROI 功能
acA2440-20gm	不支援 Multiple ROI 功能
acA2440-35uc	不支援 Multiple ROI 功能
acA2440-35ucMED	不支援 Multiple ROI 功能
acA2440-35um	不支援 Multiple ROI 功能
acA2440-35umMED	不支援 Multiple ROI 功能
acA2440-75uc	不支援 Multiple ROI 功能
acA2440-75ucMED	不支援 Multiple ROI 功能
acA2440-75um	不支援 Multiple ROI 功能
acA2440-75umMED	不支援 Multiple ROI 功能
acA2500-14gc	不支援 Multiple ROI 功能
acA2500-14gm	不支援 Multiple ROI 功能
acA2500-14uc	不支援 Multiple ROI 功能
acA2500-14um	不支援 Multiple ROI 功能
acA2500-20gc	不支援 Multiple ROI 功能
acA2500-20gcMED	不支援 Multiple ROI 功能
acA2500-20gm	不支援 Multiple ROI 功能
acA2500-20gmMED	不支援 Multiple ROI 功能
acA2500-60uc	不支援 Multiple ROI 功能
acA2500-60um	不支援 Multiple ROI 功能
acA3088-16gc	不支援 Multiple ROI 功能
acA3088-16gm	不支援 Multiple ROI 功能
acA3088-57uc	不支援 Multiple ROI 功能
acA3088-57ucMED	不支援 Multiple ROI 功能
acA3088-57um	不支援 Multiple ROI 功能
acA3088-57umMED	不支援 Multiple ROI 功能
acA3800-10gc	不支援 Multiple ROI 功能
acA3800-10gm	不支援 Multiple ROI 功能
acA3800-14uc	不支援 Multiple ROI 功能
acA3800-14um	不支援 Multiple ROI 功能
acA4024-8gc	不支援 Multiple ROI 功能
acA4024-8gm	不支援 Multiple ROI 功能
acA4024-29uc	不支援 Multiple ROI 功能
acA4024-29um	不支援 Multiple ROI 功能
acA4096-11gc	不支援 Multiple ROI 功能
acA4096-11gm	不支援 Multiple ROI 功能
acA4096-30uc	不支援 Multiple ROI 功能
acA4096-30ucMED	不支援 Multiple ROI 功能
acA4096-30um	不支援 Multiple ROI 功能
acA4096-30umMED	不支援 Multiple ROI 功能
acA4096-40uc	不支援 Multiple ROI 功能
acA4096-40ucMED	不支援 Multiple ROI 功能
acA4096-40um	不支援 Multiple ROI 功能
acA4096-40umMED	不支援 Multiple ROI 功能
acA4112-8gc	不支援 Multiple ROI 功能
acA4112-8gm	不支援 Multiple ROI 功能
acA4112-20uc	不支援 Multiple ROI 功能
acA4112-20ucMED	不支援 Multiple ROI 功能
acA4112-20um	不支援 Multiple ROI 功能
acA4112-20umMED	不支援 Multiple ROI 功能
acA4112-30uc	不支援 Multiple ROI 功能
acA4112-30ucMED	不支援 Multiple ROI 功能
acA4112-30um	不支援 Multiple ROI 功能
acA4112-30umMED	不支援 Multiple ROI 功能
acA5472-5gc	不支援 Multiple ROI 功能
acA5472-5gm	不支援 Multiple ROI 功能
acA5472-17uc	不支援 Multiple ROI 功能
acA5472-17ucMED	不支援 Multiple ROI 功能
acA5472-17um	不支援 Multiple ROI 功能
acA5472-17umMED	不支援 Multiple ROI 功能
boA1936-400cc	64 (8 x 8)
boA1936-400cm	64 (8 x 8)
boA2448-250cc	64 (8 x 8)
boA2448-250cm	64 (8 x 8)
boA2832-190cc	64 (8 x 8)
boA2832-190cm	64 (8 x 8)
boA4096-93cc	64 (8 x 8)
boA4096-93cm	64 (8 x 8)
boA4096-180cc	64 (8 x 8)
boA4096-180cm	64 (8 x 8)
boA4112-68cc	64 (8 x 8)
boA4112-68cm	64 (8 x 8)
boA4500-45cc	8 (8 x 1)^a
boA4500-45cm	8 (8 x 1)^a
boA4504-100cc	64 (8 x 8)
boA4504-100cm	64 (8 x 8)
boA5056-95cm	不支援 Multiple ROI 功能
boA5120-150cc	不支援 Multiple ROI 功能
boA5120-150cm	不支援 Multiple ROI 功能
boA5120-230cc	不支援 Multiple ROI 功能
boA5120-230cm	不支援 Multiple ROI 功能
boA5320-150cc	64 (8 x 8)
boA5320-150cm	64 (8 x 8)
boA5328-100cc	64 (8 x 8)
boA5328-100cm	64 (8 x 8)
boA6500-36cc	8 (8 x 1)^a
boA6500-36cm	8 (8 x 1)^a
boA8100-16cc	8 (8 x 1)^a
boA8100-16cm	8 (8 x 1)^a
boA9344-30cc	不支援 Multiple ROI 功能
boA9344-30cm	不支援 Multiple ROI 功能
boA9344-70cc	不支援 Multiple ROI 功能
boA9344-70cm	不支援 Multiple ROI 功能
boA13440-17cm	不支援 Multiple ROI 功能
daA720-520uc	不支援 Multiple ROI 功能
daA720-520um	不支援 Multiple ROI 功能
daA1280-54uc	不支援 Multiple ROI 功能
daA1280-54um	不支援 Multiple ROI 功能
daA1440-220uc	不支援 Multiple ROI 功能
daA1440-220um	不支援 Multiple ROI 功能
daA1600-60uc	不支援 Multiple ROI 功能
daA1600-60um	不支援 Multiple ROI 功能
daA1920-15um	不支援 Multiple ROI 功能
daA1920-30uc	不支援 Multiple ROI 功能
daA1920-30um	不支援 Multiple ROI 功能
daA1920-160uc	不支援 Multiple ROI 功能
daA1920-160um	不支援 Multiple ROI 功能
daA2448-70uc	不支援 Multiple ROI 功能
daA2448-70um	不支援 Multiple ROI 功能
daA2500-14uc	不支援 Multiple ROI 功能
daA2500-14um	不支援 Multiple ROI 功能
daA3840-45uc	不支援 Multiple ROI 功能
daA3840-45um	不支援 Multiple ROI 功能
dmA720-290gc	4 (2 x 2)
dmA720-290gm	4 (2 x 2)
dmA1440-73gc	4 (2 x 2)
dmA1440-73gm	4 (2 x 2)
dmA1920-51gc	4 (2 x 2)
dmA1920-51gm	4 (2 x 2)
dmA2048-37gc	64 (8 x 8)
dmA2048-37gm	64 (8 x 8)
dmA2448-23gc	64 (8 x 8)
dmA2448-23gm	64 (8 x 8)
dmA2840-14gc	64 (8 x 8)
dmA2840-14gm	64 (8 x 8)
dmA3536-9gc	不支援 Multiple ROI 功能
dmA3536-9gm	不支援 Multiple ROI 功能
dmA4096-9gc	64 (8 x 8)
dmA4096-9gm	64 (8 x 8)
puA1280-54uc	不支援 Multiple ROI 功能
puA1280-54um	不支援 Multiple ROI 功能
puA1600-60uc	不支援 Multiple ROI 功能
puA1600-60um	不支援 Multiple ROI 功能
puA1920-30uc	不支援 Multiple ROI 功能
puA1920-30um	不支援 Multiple ROI 功能
puA2500-14uc	不支援 Multiple ROI 功能
puA2500-14um	不支援 Multiple ROI 功能
r2L2048-29gc	不支援 Multiple ROI 功能
r2L2048-58gm	不支援 Multiple ROI 功能
r2L2048-62cc	不支援 Multiple ROI 功能
r2L2048-62g5c	不支援 Multiple ROI 功能
r2L2048-172cm	不支援 Multiple ROI 功能
r2L2048-172g5m	不支援 Multiple ROI 功能
r2L4096-14gc	不支援 Multiple ROI 功能
r2L4096-29gm	不支援 Multiple ROI 功能
r2L4096-42cc	不支援 Multiple ROI 功能
r2L4096-42g5c	不支援 Multiple ROI 功能
r2L4096-84cm	不支援 Multiple ROI 功能
r2L4096-84g5m	不支援 Multiple ROI 功能
r2L8192-80cc	不支援 Multiple ROI 功能
r2L8192-240cm	不支援 Multiple ROI 功能
r2L16384-60cc	不支援 Multiple ROI 功能
r2L16384-120cm	不支援 Multiple ROI 功能
r2T16416-500cm	不支援 Multiple ROI 功能

僅能定義資料列。

範例程式碼#

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

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.SetValue(true);
// Select column 1
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.SetValue(100);
camera.BslMultipleROIColumnSize.SetValue(300);
// Select column 2
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.SetValue(500);
camera.BslMultipleROIColumnSize.SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.SetValue(200);
camera.Height.SetValue(500);

INodeMap& nodemap = camera.GetNodeMap();
// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
CBooleanParameter(nodemap, "BslMultipleROIColumnsEnable").SetValue(true);
// Select column 1
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column1");
// The first region should have a horizontal offset of 100 and a width of 300 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(100);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(300);
// Select column 2
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column2");
// The second region should have a horizontal offset of 500 and a width of 400 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(500);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
CBooleanParameter(nodemap, "BslMultipleROIRowsEnable").SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
CIntegerParameter(nodemap, "OffsetY").SetValue(200);
CIntegerParameter(nodemap, "Height").SetValue(500);

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.Parameters[PLCamera.BslMultipleROIColumnsEnable].SetValue(true);
// Select column 1
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(100);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(300);
// Select column 2
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(500);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.Parameters[PLCamera.BslMultipleROIRowsEnable].SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.Parameters[PLCamera.OffsetY].SetValue(200);
camera.Parameters[PLCamera.Height].SetValue(500);

/* 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 */
/* ** In this example, we define two regions in horizontal direction */
/* that will be transmitted as a single image. ** */
/* Enable the ability to configure multiple columns */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIColumnsEnable", 1);
CHECK(errRes);
/* Select column 1 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column1");
CHECK(errRes);
/* The first region should have a horizontal offset of 100 and a width of 300 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 100);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 300);
CHECK(errRes);
/* Select column 2 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column2");
CHECK(errRes);
/* The second region should have a horizontal offset of 500 and a width of 400 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 400);
CHECK(errRes);
/* We only need one row, so disable the ability to configure multiple rows */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIRowsEnable", 0);
CHECK(errRes);
/* Both regions should have a vertical offset of 200 and a height of 500 */
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetY", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 500);
CHECK(errRes);

# ** In this example, we define two regions in horizontal direction
# that will be transmitted as a single image. **
# Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.Value = True
# Select column 1
camera.BslMultipleROIColumnSelector.Value = "Column1"
# The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.Value = 100
camera.BslMultipleROIColumnSize.Value = 300
# Select column 2
camera.BslMultipleROIColumnSelector.Value = "Column2"
# The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.Value = 500
camera.BslMultipleROIColumnSize.Value = 400
# We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.Value = False
# Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.Value = 200
camera.Height.Value = 500

您也可以使用 pylon Viewer 來輕鬆設定參數。