Enhanced Applets (imaWorx CXP-12 Quad)#

本主題將向您介紹 Enhanced Applets。Enhanced Applets 是一組針對 Basler CXP-12 取像卡和介面卡全新推出的即用型 applet。

您可以從 Basler 網站以 ZIP 檔案格式下載 Enhanced Applets、Flat-Field Correction 外掛程式，以及用於計算平面校正值的 Python 用戶端指令碼。

目前，Enhanced Applets 適用於：

CXP-12 Interface Card 1C
CXP-12 Interface Card 2C
CXP-12 Interface Card 4C
imaWorx CXP-12 Quad
imaFlex CXP-12 Quad

Enhanced Applets 是 Acquisition Applets 與 Custom Applets 之間的橋樑：Acquisition Applets 包含用於擷取和預先處理影像與信號資料的功能，以及處理系統資訊的功能。

Enhanced Applets 包含了 Acquisition Applets 的功能範疇以及更多先進的影像處理功能。

Custom Applets 是透過 VisualApplets 建立的，並提供個人化功能。它們可以根據 Acquisition Applets 或 Enhanced Applets 的設計進行自訂。

Acquisition Applets 和 Enhanced Applets 隨附於支援的取像卡和 CXP-12 介面卡中。

調整與自訂#

單一套 applet 永遠無法滿足所有客戶的需求。Enhanced Applets 的核心概念在於能夠快速適應特定的需求：

產生符合您需求的新版或修改版 enhanced applets
產生完全符合您需求但不包含在一般版本中的自訂 enhanced applets。根據自訂處理的複雜度而定，這可能僅適用於 imaFlex 取像卡。
在 VisualApplets 中複製功能區塊以進行高度彈性的自訂處理，並自行實作。這適用於 imaFlex 取像卡。

VisualApplets 功能範例#

VisualApplets 隨附設計範例，您可以用來計算基於區塊的 Flat-Field Correction。有關這些範例及其儲存位置的資訊，請參閱 VisualApplets Tutorial。

除了在 VisualApplets 中進行自訂處理外，也請查看 Adaptations and Customizations 一節中提及的自訂可能性。

Requirements#

主機軟體：Framegrabber SDK 5.11.3 版以及 pylon Viewer 8.0.1 或 8.0.2 版。
硬體： 您的系統連接了以下其中一款擷取卡或介面卡：
- CXP-12 Interface Card 1C
- CXP-12 Interface Card 2C
- CXP-12 Interface Card 4C
- imaWorx CXP-12 Quad
- imaFlex CXP-12 Quad

限制

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

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

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

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

說明文件#

以下章節提供 Enhanced Applets 文件連結：

面陣取像 Applets#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area
Enh_QuadCXP12Card	Enh_QuadCXP12Card

面陣掃描取像 Applets#

目前，Enhanced Applets 適用於面陣相機。這些 applet 完美延伸了 boost v 相機的功能，可滿足您的影像預先處理需求。

提供以下面陣 Enhanced Applets：

Enh_SingleCXP12Area
Enh_DualCXP12Area
Enh_QuadCXP12Card

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

為 Enhanced Applets 選擇合適的 applet 僅取決於連接至擷取卡的相機數量，而與連線組態無關。因此，選擇合適 applet 的矩陣如下：

相機數量	Applet	拓樸
1	Enh_SingleCXP12Area
2	Enh_DualCXP12Area
4	Enh_QuadCXP12Card

有關 applet 的特定規格，請閱讀 applet documentation 的「Features」一章。

與 Acquisition Applets 相比，所有 Enhanced Applets 均具備以下附加功能：

高達 4x4 的 Binning
適用於單色和彩色相機的 Block-based flat-field correction (FFC)
PGI high quality Debayering 與影像品質提升

使用 Enhanced Applets#

搭配 Framegrabber SDK 使用 Enhanced Applets#

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

安裝 Enhanced Applets#

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

手動新增 Enhanced Applets#

若要將您收到的 applet 作為 DLL 檔案（而非安裝程式形式）新增至您的主機檔案系統：

取得您收到的 applet DLL 檔案。
Copy this file into the following directory: <Framegrabber SDK installation directory>\Dll\<frame grabber model>
確保 GenTL 環境變數指向 Framegrabber SDK 安裝目錄。

現在，您可以在 microDisplay X、任何 GenTL consumer 或您自己的 SDK 程式中使用 Framegrabber SDK API 來使用新的 applet。

測試影像擷取#

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

為此，系統提供了 microDisplay X 工具，該工具作為 Framegrabber SDK 環境的一部分已安裝在您的主機電腦上。有關如何載入和測試 applet 的說明，請參閱 Configuring the Applet (microDisplay X)。

儲存小程式組態#

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

搭配 pylon Viewer 使用 Enhanced Applets#

Enhanced Applets 是作為 pylon Viewer 的外掛程式提供的。請聯絡 Basler Sales representative or field application engineer 以索取此外掛程式。

安裝適用於 pylon 的 Enhanced Applets 外掛程式#

您會收到用於 pylon 的 Enhanced Applets 外掛程式（以 DLL 檔案形式）。若要安裝用於 pylon 的 Enhanced Applets 外掛程式：

Copy the DLL files into the pylon installation directory Runtime\x64\pylonCXP\dll\<frame grabber name>.
確保 GenTL 環境變數指向 pylon 安裝目錄。

現在，您可以在 microDisplay X、任何 GenTL consumer 或您自己的 SDK 程式中使用 Framegrabber SDK API 來使用新的 applet。