跳至內容

imaFlex CXP-12 Penta 的 Applets#

本主題將介紹適用於 imaFlex CXP-12 Penta 擷取卡的 Acquisition Applets。

為確保最佳化使用系統資源，並非專為 imaFlex CXP-12 Penta 設計的所有影像擷取與處理功能都會同時載入至 imaFlex CXP-12 Penta 中。相反地，Basler 提供特定影像擷取與處理功能的各種組合，以符合特定應用領域的需求。

通常，applet 支援特定的相機介面標準與拓樸、特定的影像擷取功能，以及可能的影像（預先）處理功能。透過將 applet 載入擷取卡，您可以定義擷取卡的功能，並使其調適於特定應用的需求。

Applets 分為兩種：由 Basler 隨附提供的 Acquisition Applets (*.dll)，以及由您自己或 Basler 使用 VisualApplets 開發的自訂 Applets (*.hap)。除了隨附的 Acquisition Applets 之外，imaFlex CXP-12 Penta 也可以進行程式設計，以執行特定應用程式所需的極高度專門影像處理任務。這項程式設計可由 Basler、認證合作夥伴或您自己使用簡單易用的圖形化 FPGA 設計環境 VisualApplets 來完成。

imaFlex CXP-12 Penta 的 Acquisition Applets 包含在 Framegrabber SDK 以及 pylon Software Suite 中。

要求#

  • 主機軟體：Framegrabber SDK 5.11.3 或更高版本
  • 硬體：系統已連接 imaFlex CXP-12 Penta 擷取卡

限制

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

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

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

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

文件#

以下章節提供採集 applet 文件的連結：

面陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_PentaCXP12Area PDF Acq_PentaCXP12Area PDF

線陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_PentaCXP12line PDF Acq_PentaCXP12line PDF

Frame Grabber Test Applet#

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

面陣取像 Applet#

提供以下 Area Scan Acquisition Applets：

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_PentaCXP12Area

Applet 名稱中的「single」、「dual」和「penta」分母是指您可以連接的最大相機數量。如需詳細資訊，請參閱 Choosing the Right Area Scan Acquisition Applet。

選擇正確的面陣取像 Applet#

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

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

ROI 遞增尺寸取決於影像前處理的 Parallelism，因此會因相機和擷取卡而異。

最大相機數量 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步進尺寸 [px]
5 1 Acq_PentaCXP12Area x: 8
y: 1
5 2 Acq_PentaCXP12Area x: 8
y: 1
5 3 Acq_PentaCXP12Area x: 8
y: 1
5 4 Acq_PentaCXP12Area x: 8
y: 1
5 5 Acq_PentaCXP12Area x: 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_DualCXP12Area x: 16
y: 1
2 2 Acq_DualCXP12Area x: 16
y: 1
1 1 Acq_SingleCXP12Areaa x: 32
y: 1
1 1 Acq_SingleCXP12Areab x: 32
y: 1
1 1 Acq_SingleCXP12Area x: 32
y: 1

所有面陣取像 Applets 的共用規格#
Max. Image Size [px] 32k x 64kc
CXP 埠 5
最高 CXP 速度 CXP-12
Bit Depth Processing [bit] 16（Bayer Demosaicing 則為 14）
Pixel Format Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
Mirroring 是，水平與垂直
Image Selector 是
Bayer Color Reconstruction (HQe) Yes, High Quality Extended (HQe)
白平衡 是
LUT 完整解析度
Pixel Format Conversion RGB 或 Bayer 轉單色，
Bayer 或單色轉 RGB
頻寬總 DMA [MB/s]d 7200

面陣取像 Applets 之間的相異規格#

ROI 步進尺寸 [px] Bandwidth: Mean per Camera [MP/s] 抽頭幾何結構排序
Acq_SingleCXP12Area x: 32
y: 1		 4850 1X-1Y, 1X-2YE
Acq_DualCXP12Area x: 16
y: 1		 2400 1X-1Y, 1X-2YE
Acq_PentaCXP12Area x: 8
y: 1		 1200 僅限 1X-1Y

線陣取像 Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_PentaCXP12Line

Applet 名稱中的「single」、「dual」和「penta」是指您可以連接的最大相機數量。如需詳細資訊，請參閱 Choosing the Right Line Scan Acquisition Applet。

如何選擇正確的線陣取像 Applet#

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

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

ROI 遞增尺寸取決於影像前處理的 Parallelism，因此會因相機和擷取卡而異。

最大相機數量 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步進尺寸 [px]
5 1 Acq_PentaCXP12Line x: 8
y: 1
5 2 Acq_PentaCXP12Line x: 8
y: 1
5 3 Acq_PentaCXP12Line x: 8
y: 1
5 4 Acq_PentaCXP12Line x: 8
y: 1
5 5 Acq_PentaCXP12Line x: 8
y: 1
2 1 Acq_DualCXP12Linee x: 16
y: 1
2 2 Acq_DualCXP12Linee x: 16
y: 1
2 1 1 Acq_DualCXP12Line x: 16
y: 1
2 1 Acq_DualCXP12Line x: 16
y: 1
2 2 Acq_DualCXP12Line x: 16
y: 1
1 1 Acq_SingleCXP12Linee x: 32
y: 1
1 1 Acq_SingleCXP12Linef x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1

所有線陣取像 Applets 的共用規格#
Max. Image Size [px] 32k x 8Mc
Camera Ports 5
Camera Type CXP-12
Bit Depth Processing [bit] 16（BiColor 轉換為 BGR/RGB 時為 12 位元）
Pixel Format Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
Mirroring 是，水平與垂直
抽頭幾何結構排序 僅限 1X-1Y
Image Selector 是
Color Array Filter 是，兩條雙色（BiColor）線
白平衡 是
LUT 完整解析度
Pixel Format Conversion RGB 或 BiColor 轉單色，
單色或 BiColor 轉 RGB
頻寬：總 DMA [MB/s]d 7200

線陣取像 Applets 之間的相異規格#

ROI 步進尺寸 [px] Bandwidth: Mean per Camera [MP/s]
Acq_SingleCXP12Line x: 32
y: 1		 4850
Acq_DualCXP12Line x: 16
y: 1		 2400
Acq_PentaCXP12Line x: 8
y: 1		 1200

Frame Grabber Test Applet#

此 applet 為 Frame Grabber Test Applet。其用途是測試硬體。

此 applet 提供以下功能：

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

使用 Acquisition Applets#

結合 Framegrabber SDK 使用 Acquisition Applets#

在此尋找關於搭配 Framegrabber SDK 使用 Applet 的一般資訊：Acquisition Applets。

安裝 Applets#

在您的擷取卡上使用特定 Applet 之前，您需要將其安裝到擷取卡上。有關安裝 Applet 的說明，請參閱管理 Applet (microDiagnostics)。

手動新增 Applet#

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

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

現在您可以使用新的 Applet 了。

測試影像擷取#

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

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

儲存 Applet 組態#

在 microDisplay X 中或透過 Framegrabber API 設定 Applet 後，您可以儲存設定。如需詳細資訊，請參閱 Other Tasks (microDisplay X)。

  1. 僅在您需要鏡射像素超過 5456 的影像時建議使用。否則請使用 PentaCXP12Area。 ↩︎↩︎↩︎

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

  3. 在此情況下，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 ↩︎↩︎

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

  5. 僅在您需要鏡射像素超過 8k 的影像時建議使用。否則請使用 PentaCXP12Line。 ↩︎↩︎↩︎

  6. 僅在您需要鏡射像素超過 21840 的影像時建議使用。否則請使用 DualCXP12Line。 ↩︎