imaFlex CXP-12 Penta 的 Applet#
為了確保最佳化使用系統資源，專為 imaFlex CXP-12 Penta 設計的影像擷取與處理功能並不會全部同時載入至 imaFlex CXP-12 Penta 中。相反地，Basler 提供了各種特定影像擷取與處理功能的組合，以符合特定應用領域的需求。
通常，applet 支援特定的相機介面標準與拓樸、特定的影像擷取功能，以及可能包含特定的影像（預先）處理功能。透過將 applet 載入擷取卡中，您即可定義擷取卡的功能，並使其符合特定應用程式的需求。
applet 分為兩種類型：由 Basler 提供且始終隨附的 acquisition applets（*.dll），以及由您或 Basler 在 VisualApplets 中開發的自訂 applet（*.hap）。除了隨附的 acquisition applets 外，imaFlex CXP-12 Penta 也可以進行程式設計，以執行特定應用所需的極高度特製化影像處理任務。這項程式設計可由 Basler、認證夥伴或您使用簡單易用的圖形化 FPGA 程式設計環境 VisualApplets 來完成。
imaFlex CXP-12 Penta 的 acquisition applets 包含在 Framegrabber SDK 以及 pylon Software Suite 中。
Requirements#
- 主機軟體：Framegrabber SDK 5.11.3 或更高版本
- 硬體：系統已連接 imaFlex CXP-12 Penta frame grabber
限制
在所有 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_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 |
面陣掃描取像 Applets#
提供以下面陣翻拍 Acquisition Applets：
- Acq_SingleCXP12Area
- Acq_DualCXP12Area
- Acq_PentaCXP12Area
applet 名稱中的分母「single」、「dual」和「penta」指的是您可以連接的最大相機數量。如需詳細資訊，請參閱 選擇正確的面陣型擷取 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 的通用規格#
| 最大影像大小 [px] | 32k x 64kc |
| CXP 連接埠 | 5 |
| 最高 CXP 速度 | 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]d | 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_PentaCXP12Area | x: 8 y: 1 | 1200 | 僅限 1X-1Y |
線陣取像 Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleCXP12Line
- Acq_DualCXP12Line
- Acq_PentaCXP12Line
applet 名稱中的「single」、「dual」和「penta」指的是您可以連接的最大相機數量。如需詳細資訊，請參閱 選擇正確的線陣型擷取 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 的通用規格#
| 最大影像大小 [px] | 32k x 8Mc |
| 相機連接埠 | 5 |
| 相機類型 | 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]d | 7200 |
不同線陣取像 Applets 之間的規格差異#
| ROI 步長 [px] | 頻寬：每台相機平均值 [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 測試 | 檢查錯誤與處理 |
| 檢查相機連接埠影像擷取 | 檢查相機連接埠影像擷取 |
| 傳送觸發訊號至相機 | 傳送觸發訊號至相機 |
| GPIO 監控 | 監控 GPI 並設定 GPO |
| 事件測試 | 產生軟體回呼事件 |
| 一般監控 | 監控 FPGA 溫度、電源管理、PoCXP 等。 |
| DMAfromPC | 透過 DMA 將影像傳輸至 frame grabber。 |
使用 Acquisition Applets#
搭配 Framegrabber SDK 使用擷取 Applet#
在此尋找關於透過 Framegrabber SDK 使用 applet 的一般資訊：Acquisition Applets。
安裝 Applets#
在您能在擷取卡上使用特定的 applet 之前，您需要將其安裝到擷取卡上。有關安裝 applet 的說明，請參閱 Managing Applets (microDiagnostics)。
手動新增 Applet#
若要將作為 *.dll 檔案（而非安裝程式形式）收到的 Applet 新增至主機檔案系統：
- 取得您收到的 Applet 檔案 (*.dll)。
- Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<frame grabber model>
現在您可以開始使用新的 Applet。
測試影像擷取#
在您開始在自己的軟體中使用 applet（透過 API）之前，您可能會想要測試系統設定或個別 applet（及其參數化選項）。
為此，系統提供了 microDisplay X 工具，該工具作為 Framegrabber SDK 環境的一部分已安裝在您的主機電腦上。有關如何載入和測試 applet 的說明，請參閱 Configuring the Applet (microDisplay X)。
儲存小程式組態#
在您設定好 applet（在 microDisplay X 中或透過 Framegrabber API）之後，您可以儲存設定。如需更多資訊，請參閱 Other Tasks (microDisplay X)。