Enhanced Applets#

本主題將為您介紹 Enhanced Applets。Enhanced Applets 是一組針對 Basler CXP-12 張擷取卡及 Interface Cards 推出的全新隨裝即用 applets。

您可以從 Basler 網站以 ZIP 檔案形式下載 Enhanced Applets、Flat-Field Correction 外掛程式，以及用於計算 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 Interface Cards 一同提供。

調適與自訂#

要在單一套 applets 中完全滿足所有客戶的需求是不可能的。Enhanced applets 的理念在於快速適應特定需求：

產生符合您需求的新增或修改過的 enhanced applets
產生完全符合您需求的自訂 enhanced applets，但這些 applets 將不會包含在一般發行版本中。根據自訂處理的複雜度，這可能僅適用於 imaFlex frame grabbers。
在 VisualApplets 中複製功能區塊以進行高度彈性且自訂的處理，並由您自行實作。這適用於 imaFlex frame grabber。

VisualApplets 功能範例#

VisualApplets 隨附設計範例，您可以用來計算基於區塊的 Flat-Field Correction。您可以在 VisualApplets 教學課程中找到有關這些範例及其儲存位置的資訊。

除了在 VisualApplets 中進行自訂處理之外，請查看調適與自訂一節中所提及的自訂可能性。

要求#

主機軟體：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 說明文件的連結：

CXP-12 Interface Card 1C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area

CXP-12 Interface Card 2C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area

CXP-12 Interface Card 4C#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area
Enh_QuadCXP12Area	Enh_QuadCXP12Area

面陣取像 Applet#

目前，Enhanced Applets 適用於面陣相機。這些 applets 完美地擴充了 boost v 相機的功能，以滿足您的影像預先處理需求。

提供以下面陣 Enhanced Applets：

Enh_SingleCXP12Area
Enh_DualCXP12Area
Enh_QuadCXP12Area

選擇正確的面陣取像 Applet#

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

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

如需該 Applet 的具體規格，請閱讀Applet 文件的「功能」一章。

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

高達 4x4 的 Binning
適用於單色和彩色相機的基於區塊的 Flat-Field Correction (FFC)
PGI high quality Debayering 與影像品質提升

使用 Enhanced Applets#

搭配 Framegrabber SDK 使用 Enhanced Applets#

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

安裝 Enhanced Applets#

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

手動新增 Enhanced Applets#

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

取得您接收到的 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 程式中使用這些新 Applet，並透過 Framegrabber SDK API 進行存取。

測試影像擷取#

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

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

儲存 Applet 組態#

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

搭配 pylon Viewer 使用 Enhanced Applets#

Enhanced Applets 是作為 pylon Viewer 的外掛程式提供的。請聯絡 Basler 銷售代表或現場應用工程師以索取此外掛程式。

安裝 pylon 的 Enhanced Applets 外掛程式#

您以 DLL 檔案形式接收用於 pylon 的 Enhanced Applets 外掛程式。若要安裝用於 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 程式中使用這些新 Applet，並透過 Framegrabber SDK API 進行存取。