Acquisition Applets 適用於marathon ACX-DP#
取像卡（frame grabber）的功能是由特定的硬體相關程式所定義。此硬體實作稱為 applet。針對每張取像卡，均提供有多個 applet 可供使用。
透過將 applet 載入至取像卡（frame grabber）上，您可定義取像卡的功能，並將其調整以符合特定應用程式的需求。
marathon ACX-DP 的擷取 Applet 已包含在 Framegrabber SDK 中。
在 marathon 取像卡（frame grabber）上，applet 一經燒錄（flashed）至取像卡（frame grabber）即可使用。
Requirements#
- 主機軟體：Framegrabber SDK（5.7、5.10a 或更高版本），包含與硬體相關的 acquisition applets
- 硬體：系統已連接一臺marathon ACX-DP 影像擷取卡
限制
在所有 applet 中，無法配置大於 4GB 的緩衝區。即使 applet 允許更大的緩衝區大小，由於驅動程式與韌體的限制，您也無法配置大於 4GB 的緩衝區。
您可以透過以下方式計算緩衝區大小：
緩衝區大小 = 影像高度 * 影像寬度 * (像素寬度 / 8)。
對於 RGB 影像：緩衝區大小 = (影像高度 * 影像寬度 * (像素寬度 / 8)) * 3。
說明文件#
以下章節提供 acquisition applets 說明文件的連結：
面陣掃描取像 Applets#
提供以下面陣翻拍 Acquisition Applets：
- Acq_SingleCXP6x2AreaBayer
- Acq_SingleCXP6x2AreaGray
- Acq_SingleCXP6x2AreaRGB
- Acq_DualCXP6x1AreaBayer
- Acq_DualCXP6x1AreaGray
- Acq_DualCXP6x1AreaRGB
Applet 名稱中的分母「single」與「dual」是指您可以連接的最大相機數量。如需詳細資訊，請參閱選擇正確的面陣擷取 Applet。
選擇合適的面陣掃描取像 Applet#
您必須為相機設定選擇正確的 applet。否則，從相機接收到的影像將無法正確處理或顯示，或者相機效能可能會大幅降低。
哪一個 applet 是正確的取決於相機數量、每部相機的通道數以及所需的 ROI 步進大小。
ROI 的步長取決於影像預處理的 Parallelism，因此會因相機和擷取卡而異。
| 相機數量 | 相機連接埠數 | 擷取卡連接埠數 | Mode | Applet | ROI 步長 [px] | 拓樸 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer Pattern | Acq_SingleCXP6x2AreaBayer | x: 8 y: 1 |  |
| 1 | 2 | 2 | Grayscale | Acq_SingleCXP6x2AreaGray | x: 16 y: 1 |  |
| 1 | 2 | 2 | RGB | Acq_SingleCXP6x2AreaRGB | x: 4 y: 1 |  |
| 2 | 1 | 2 | Bayer Pattern | Acq_DualCXP6x1AreaBayer | x: 8 y: 1 |  |
| 2 | 1 | 2 | Grayscale | Acq_DualCXP6x1AreaGray | x: 16 y: 1 |  |
| 2 | 1 | 2 | RGB | Acq_DualCXP6x1AreaRGB | x: 4 y: 1 |  |
所有面陣取像 Applets 的通用規格#
| 相機類型 | CXP-6 |
| 鏡射 | 是，水平與垂直 |
| Image Selector | 是 |
| LUT | 完整解析度 |
| 總 DMA 頻寬 [MB/s] b | 1800 |
不同面陣取像 Applets 之間的規格差異#
| 最大影像尺寸 [px] c | 相機連接埠 | ROI 步長 [px] | 位元深度處理 [bit] | 位元深度輸出 [bit] | Mode | Bayer Color Reconstruction (HQe) | 白平衡 | 頻寬：每台相機平均值 [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x1AreaBayer | 16k x 64k | 2 | x: 8 y: 1 | 每彩色分量 14 | BGR 24、30 packed、36 packed、42 packed 或 48 | Bayer Pattern | 是，High Quality Extended (HQe) | 是 | 600 |
| Acq_DualCXP6x1AreaGray | 64k x 64k | 2 | x: 16 y: 1 | 16 | 灰階 8、10 packed、12 packed、14 packed 或 16 | Grayscale | 否 | 否 | 600 |
| Acq_DualCXP6x1AreaRGB | 64k x 64k | 2 | x: 4 y: 1 | 每彩色分量 16 | BGR 24、30 packed、36 packed、42 packed 或 48 | RGB | 否 | 是 | 200 |
| Acq_SingleCXP6x2AreaBayer | 48k x 64k | 1 | x: 8 y: 1 | 每彩色分量 14 | BGR 24、30 packed、36 packed、42 packed 或 48 | Bayer Pattern | 是，High Quality Extended (HQe) | 是 | 1200 |
| Acq_SingleCXP6x2AreaGray | 64k x 64k | 1 | x: 16 y: 1 | 16 | 灰階 8、10 packed、12 packed、14 packed 或 16 | Grayscale | 否 | 否 | 1200 |
| Acq_SingleCXP6x2AreaRGB | 64k x 64k | 1 | x: 4 y: 1 | 每彩色分量 16 | BGR 24、30 packed、36 packed、42 packed 或 48 | RGB | 否 | 是 | 400 |
線陣取像 Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleCXP6x2LineGray
- Acq_SingleCXP6x2LineRGB
- Acq_DualCXP6x1LineGray
- Acq_DualCXP6x1LineRGB
Applet 名稱中的分母「single」和「dual」是指您可以連接的最大相機數量。如需詳細資訊，請參閱 Choosing the Right Line Scan Acquisition Applet。
選擇正確的線陣取像 Applet#
您必須為您的相機設定選擇正確的 Applet。否則，相機可能無法運作或相機效能可能會顯著降低。
哪一個 applet 是正確的取決於相機數量、每部相機的通道數以及所需的 ROI 步進大小。
ROI 的步長取決於影像預處理的 Parallelism，因此會因相機和擷取卡而異。
| 相機數量 | 相機連接埠數 | 擷取卡連接埠數 | Mode | Applet | ROI 步長 [px] | 拓樸 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Grayscale | Acq_SingleCXP6x2LineGray | x: 16 y: 1 | |
| 1 | 2 | 2 | RGB | Acq_SingleCXP6x2LineRGB | x: 4 y: 1 | |
| 2 | 1 | 2 | Grayscale | Acq_DualCXP6xLineGray | x: 16 y: 1 | |
| 2 | 1 | 2 | RGB | Acq_DualCXP6xLineRGB | x: 4 y: 1 | |
所有線陣取像 Applets 的通用規格#
| 最大影像大小 [px] | 64k x 8Mc |
| 相機類型 | CXP-6 |
| 鏡射 | 是，水平與垂直 |
| Image Selector | 是 |
| Bayer Color Reconstruction (HQe) | 否 |
| LUT | 完整解析度 |
| 總 DMA 頻寬 [MB/s] b | 1800 |
不同線陣取像 Applets 之間的規格差異#
| 相機連接埠 | ROI 步長 [px] | 位元深度處理 [bit] | 位元深度輸出 [bit] | Mode | 白平衡 | 頻寬：每台相機平均值 [MP/s] | |
|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x1LineGray | 2 | x: 16 y: 1 | 16 | 灰階 8、10 packed、12 packed、14 packed 或 16 | Grayscale | 否 | 600 |
| Acq_DualCXP6x1LineRGB | 2 | x: 4 y: 1 | 每彩色分量 16 | BGR 24、30 packed、36 packed、42 packed 或 48 | RGB | 是 | 200 |
| Acq_SingleCXP6x2LineGray | 1 | x: 16 y: 1 | 16 | 灰階 8、10 packed、12 packed、14 packed 或 16 | Grayscale | 否 | 1200 |
| Acq_SingleCXP6x2LineRGB | 1 | x: 4 y: 1 | 每彩色分量 16 | BGR 24、30 packed、36 packed、42 packed 或 48 | RGB | 是 | 400 |
Frame Grabber Test Applet#
此 Applet 是一個 Frame Grabber Test Applet。其用途是測試硬體。
此 Applet 提供下列功能：
| 功能 | 說明 |
|---|---|
| DMA 效能測試 | 針對不同的記憶體大小和中斷速率測試不同的影像尺寸 |
| RAM 測試 | 檢查錯誤與處理 |
| 檢查相機連接埠影像擷取 | 檢查相機連接埠影像擷取 |
| 傳送觸發訊號至相機 | 傳送觸發訊號至相機 |
| GPIO 監控 | 監控 GPI 並設定 GPO |
| 事件測試 | 產生軟體回呼事件 |
| 一般監控 | 監控 FPGA 溫度、電源管理、PoCXP 等。 |
使用 Acquisition Applets#
在此尋找關於透過 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（及其參數化選項）。
為此，您可以使用作為 Framegrabber SDK 環境一部分安裝在您電腦上的 microDisplay X 工具。有關如何載入和測試 Applet 的說明，請參閱 Configuring the Applet (microDisplay X)。
儲存小程式組態#
在您設定好 applet（在 microDisplay X 中或透過 Framegrabber API）之後，您可以儲存設定。如需更多資訊，請參閱 Other Tasks (microDisplay X)。