跳至內容

適用於 imaWorx CXP-12 Quad 的 Acquisition Applets#

本主題將介紹可用於 imaWorx CXP-12 Quad 取像卡（frame grabber）的 Acquisition Applets。

取像卡（frame grabber）的功能是由特定的硬體相關程式所定義。此硬體實作稱為 applet。針對每張取像卡，均提供有多個 applet 可供使用。

透過將 applet 載入至取像卡（frame grabber）上，您可定義取像卡的功能，並將其調整以符合特定應用程式的需求。

imaWorx CXP-12 Quad 的 acquisition applets 已包含在 Framegrabber SDK 以及 pylon Software Suite 中。

在 imaWorx CXP-12 Quad 上，所有隨附的 applet 均已存在於 imaWorx CXP-12 Quad 取像卡中，但一次只能啟用一個。如果您想在 imaWorx CXP-12 Quad 上啟用不同的 applet，請按照 使用 Framegrabber SDK 啟用 Applet 或 使用 pylon 設定取像卡 中的說明進行操作。

除了 Acqusition Applets 外，您也可以使用 Enhanced Applets。Enhanced Applets 為原型版本，僅限透過您的當地 Basler 業務代表或現場應用工程師提出要求方可取得。所有 Enhanced Applets 皆具備下列附加功能：

Requirements#

  • 主機軟體：Framegrabber SDK（5.9 或更高版本）或 pylon Software Suite（6.3 或更高版本），搭配硬體相依的 acquisition applets
  • 硬體：您的系統已連接 imaWorx CXP-12 Quad 取像卡

限制

在所有 applet 中，無法配置大於 4GB 的緩衝區。即使 applet 允許更大的緩衝區大小，由於驅動程式與韌體的限制，您也無法配置大於 4GB 的緩衝區。

您可以透過以下方式計算緩衝區大小：

緩衝區大小 = 影像高度 * 影像寬度 * (像素寬度 / 8)。

對於 RGB 影像：緩衝區大小 = (影像高度 * 影像寬度 * (像素寬度 / 8)) * 3。

說明文件#

以下章節提供 acquisition applets 說明文件的連結：

面陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_TripleCXP12Area PDF Acq_TripleCXP12Area PDF
Acq_QuadCXP12Area PDF Acq_QuadCXP12Area PDF

線陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_TripleCXP12Line PDF Acq_TripleCXP12Line PDF
Acq_QuadCXP12line PDF Acq_QuadCXP12line PDF

Frame Grabber Test Applet#

GenTL Fglib
Frame Grabber Test Applet PDF Frame Grabber Test Applet PDF

面陣掃描取像 Applets#

提供以下面陣翻拍 Acquisition Applets：

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_TripleCXP12Area
  • Acq_QuadCXP12Area

Applet 名稱中的分母「single」、「dual」、「triple」和「quad」是指您可以連接的最大相機數量。如需詳細資訊，請參閱選擇正確的面陣擷取 Applet。

選擇合適的面陣掃描取像 Applet#

您必須為相機設定選擇正確的 applet。否則，從相機接收到的影像將無法正確處理或顯示，或者相機效能可能會大幅降低。

哪一個 applet 是正確的取決於相機數量、每部相機的通道數以及所需的 ROI 步進大小。

ROI 的步長取決於影像預處理的 Parallelism，因此會因相機和擷取卡而異。

相機數上限 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步長 [px]
4 1 Acq_QuadCXP12Area x: 8
y: 1
4 2 Acq_QuadCXP12Area x: 8
y: 1
4 3 Acq_QuadCXP12Area x: 8
y: 1
4 4 Acq_QuadCXP12Area x: 8
y: 1
3 1 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Areab x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
2 1 Acq_DualCXP12Areaa x: 16
y: 1
2 2 Acq_DualCXP12Areaa x: 16
y: 1
2 1 1 Acq_DualCXP12Area x: 16
y: 1
2 1 Acq_DualCXP12Areac x: 16
y: 1
2 2 Acq_DualCXP12Area x: 16
y: 1
1 1 Acq_SingleCXP12Areaa x: 32
y: 1
1 1 Acq_SingleCXP12Aread x: 32
y: 1
1 1 Acq_SingleCXP12Area x: 32
y: 1

所有面陣取像 Applets 的通用規格#
最大影像大小 [px] 32k x 64ke
相機連接埠 4
相機類型 CXP-12
位元深度處理 [bit] 16 (Bayer Demosaicing 則為 14)
Pixel Formats Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
鏡射 是，水平與垂直
Image Selector 是
Bayer Color Reconstruction (HQe) 是，High Quality Extended (HQe)
白平衡 是
LUT 完整解析度
Pixel Format 轉換 RGB 或 Bayer 轉單色，
Bayer 或單色轉 RGB
DMA 總頻寬 [MB/s] f 7200

不同面陣取像 Applets 之間的規格差異#

ROI 步長 [px] 頻寬：每台相機平均值 [MP/s] Tap Geometry Sorting
Acq_SingleCXP12Area x: 32
y: 1		 4850 1X-1Y, 1X-2YE
Acq_DualCXP12Area x: 16
y: 1		 2400 1X-1Y, 1X-2YE
Acq_TripleCXP12Area x: 8
y: 1		 前兩台相機為 1200
第三台相機為 2400		 僅限 1X-1Y
Acq_QuadCXP12Area x: 8
y: 1		 1200 僅限 1X-1Y

線陣取像 Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_TripleCXP12Line
  • Acq_QuadCXP12Line

applet 名稱中的分母「single」、「dual」、「triple」和「quad」指的是您可以連接的相機數量上限。如需詳細資訊，請參閱 選擇正確的線型掃描擷取 Applet (Choosing the Right Line Scan Acquisition Applet)。

選擇正確的線陣取像 Applet#

您必須為您的相機設定選擇正確的 Applet。否則，相機可能無法運作或相機效能可能會顯著降低。

哪一個 applet 是正確的取決於相機數量、每部相機的通道數以及所需的 ROI 步進大小。

ROI 的步長取決於影像預處理的 Parallelism，因此會因相機和擷取卡而異。

相機數上限 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步長 [px]
4 1 Acq_QuadCXP12Line x: 8
y: 1
4 2 Acq_QuadCXP12Line x: 8
y: 1
4 3 Acq_QuadCXP12Line x: 8
y: 1
4 4 Acq_QuadCXP12Line x: 8
y: 1
3 1 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Lineh x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
2 1 Acq_DualCXP12Lineg x: 16
y: 1
2 2 Acq_DualCXP12Lineg x: 16
y: 1
2 1 Acq_DualCXP12Line x: 16
y: 1
2 1 1 Acq_DualCXP12Linei x: 16
y: 1
2 2 Acq_DualCXP12Line x: 16
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1

所有線陣取像 Applets 的通用規格#
最大影像大小 [px] 32k x 8Me
相機連接埠 4
相機類型 CXP-12
位元深度處理 [bit] 16 (用於 BiColor 至 BGR/RGB 轉換為 12 bit)
Pixel Formats Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
鏡射 是，水平與垂直
Tap Geometry Sorting 僅限 1X-1Y
Image Selector 是
彩色陣列濾鏡 是，兩行 BiColor
白平衡 否
LUT 完整解析度
Pixel Format 轉換 RGB 或 BiColor 轉為單色，
單色或 BiColor 轉為 RGB
頻寬：總 DMA [MB/s] f 7200

不同線陣取像 Applets 之間的規格差異#

ROI 步長 [px] 頻寬：每台相機平均值 [MP/s]
Acq_SingleCXP12Line x: 32
y: 1		 4850
Acq_DualCXP12Line x: 16
y: 1		 2400
Acq_TripleCXP12Line x: 16
y: 1		 前兩台相機為 1200
第三台相機為 2400
Acq_QuadCXP12Line x: 4
y: 1		 1200

Frame Grabber Test Applet#

此 Applet 是一個 Frame Grabber Test Applet。其用途是測試硬體。

此 Applet 提供下列功能：

功能 說明
DMA 效能測試 針對不同的記憶體大小和中斷速率測試不同的影像尺寸
RAM 測試 檢查錯誤與處理
檢查相機連接埠影像擷取 檢查相機連接埠影像擷取
傳送觸發訊號至相機 傳送觸發訊號至相機
GPIO 監控 監控 GPI 並設定 GPO
事件測試 產生軟體回呼事件
一般監控 監控 FPGA 溫度、電源管理、PoCXP 等。

使用 Acquisition Applets#

搭配 Framegrabber SDK 使用擷取 Applet#

在此尋找關於透過 Framegrabber SDK 使用 applet 的一般資訊：Acquisition Applets。

安裝 Applets#

在您的擷取卡上使用特定的 Applet 之前，必須先將其安裝至擷取卡上。有關安裝 Applet 的說明，請參閱 Managing Applets (microDiagnostics)。

手動新增 Applet#

若要將作為 *.dll 檔案（而非安裝程式形式）收到的 Applet 新增至主機檔案系統：

  1. 取得您收到的 Applet 檔案 (*.dll)。
  2. Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<Frame grabber model>

現在您可以開始使用新的 Applet。

測試影像擷取#

在您開始在自己的軟體中使用 applet（透過 API）之前，您可能會想要測試系統設定或個別 applet（及其參數化選項）。

為此，您可以使用作為 Framegrabber SDK 環境一部分安裝在您電腦上的 microDisplay X 工具。有關如何載入和測試 Applet 的說明，請參閱 Configuring the Applet (microDisplay X)。

儲存小程式組態#

在您設定好 applet（在 microDisplay X 中或透過 Framegrabber API）之後，您可以儲存設定。如需更多資訊，請參閱 Other Tasks (microDisplay X)。

在 pylon 中使用 Acquisition Applets#

如果您想在 pylon 中使用 applet，請參閱使用 pylon 設定取像卡。

  1. 僅在需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 QuadCXP12Area。 ↩↩↩↩↩↩

  2. 不建議使用，請改用 DualCXP12Area。 ↩

  3. 僅在需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 TripleCXP12Area（僅限單通道相機）。 ↩

  4. 僅在需要鏡射像素超過 21840 的影像時建議使用。否則，請使用 DualCXP12Area。 ↩

  5. 在此情況下，k Px 和 M Px 是指二進位格式。二進位計算的範例為：

    16M px = 16384k px = 16777216 px

    8M px = 8192k px = 8388608 px

    64k px = 65536 px

    48k px = 49152 px

    32k px = 32768 px

    16k px = 16384 px ↩↩

  6. 實際的 DMA 頻寬取決於主機電腦的特定主機板與晶片組。 ↩↩

  7. 僅在需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 QuadCXP12Line。 ↩↩↩↩↩

  8. 不建議使用，請改用 DualCXP12Line。 ↩

  9. 僅在需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 TripleCXP12Line（僅限單通道相機）。 ↩