適用於 marathon VCLx 的 Acquisition Applets#
取像卡（frame grabber）的功能是由特定的硬體相關程式所定義。此硬體實作稱為 applet。針對每張取像卡，均提供有多個 applet 可供使用。
透過將 applet 載入至取像卡（frame grabber）上，您可定義取像卡的功能，並將其調整以符合特定應用程式的需求。
適用於 marathon VCLx 的 acquisition applets 已包含在 Framegrabber SDK 中。
在 marathon 取像卡（frame grabber）上，applet 一經燒錄（flashed）至取像卡（frame grabber）即可使用。
Requirements#
- 主機軟體：Framegrabber SDK（5.7、5.10a 或更高版本），包含與硬體相關的 acquisition applets
- 硬體：marathon VCLx frame grabber 已連接至您的系統
限制
在所有 applet 中，無法配置大於 4GB 的緩衝區。即使 applet 允許更大的緩衝區大小，由於驅動程式與韌體的限制，您也無法配置大於 4GB 的緩衝區。
您可以透過以下方式計算緩衝區大小：
緩衝區大小 = 影像高度 * 影像寬度 * (像素寬度 / 8)。
對於 RGB 影像：緩衝區大小 = (影像高度 * 影像寬度 * (像素寬度 / 8)) * 3。
說明文件#
以下章節提供 acquisition applets 說明文件的連結：
面陣掃描取像 Applets#
提供以下面陣翻拍 Acquisition Applets：
- Acq_DualBaseAreaBayer
- Acq_DualBaseAreaGray
- Acq_DualBaseAreaRGB
- Acq_SingleFullAreaBayer
- Acq_SingleFullAreaGray
- Acq_SingleFullAreaRGB
- Acq_SingleMediumAreaBayer
- Acq_SingleMediumAreaGray
- Acq_SingleMediumAreaRGB
Applet 名稱中的分母「single」與「dual」是指您可以連接的最大相機數量。如需詳細資訊，請參閱選擇正確的面陣擷取 Applet。
選擇合適的面陣掃描取像 Applet#
您必須為相機設定選擇正確的 applet。否則，從相機接收到的影像將無法正確處理或顯示，或者相機效能可能會大幅降低。
哪一個 applet 是正確的取決於相機數量、每部相機的通道數以及所需的 ROI 步進大小。
ROI 的步長取決於影像預處理的 Parallelism，因此會因相機和擷取卡而異。
| 相機數量 | 相機連接埠數 | 擷取卡連接埠數 | Mode | Applet | ROI 步長 [px] | 拓樸 |
|---|---|---|---|---|---|---|
| 1 | 2 | 2 | Bayer Pattern | Acq_SingleFullAreaBayer Acq_SingleMediumAreaBayer | x: 16; y: 1 x: 8; y: 1 |  |
| 1 | 2 | 2 | Grayscale | Acq_SingleFullAreaGray Acq_SingleMediumAreaGray | x: 16; y: 1 x: 8; y: 1 |  |
| 1 | 2 | 2 | RGB | Acq_SingleFullAreaRGB Acq_SingleMediumAreaRGB | x: 8; y: 1 x: 4; y: 1 |  |
| 2 | 1 | 2 | Bayer Pattern | Acq_DualBaseAreaBayer | x: 8 y: 1 |  |
| 2 | 1 | 2 | Grayscale | Acq_DualBaseAreaGray | x: 8 y: 1 |  |
| 2 | 1 | 2 | RGB | Acq_DualBaseAreaRGB | x: 8 y: 1 |  |
所有面陣取像 Applets 的通用規格#
| 最大影像大小 [px] | 16k x 64kb |
| 相機時脈最大值 | 85 MHz |
| Image Selector | 是 |
| LUT | 完整解析度 |
| 總 DMA 頻寬 [MB/s] c | 1800 |
不同面陣取像 Applets 之間的規格差異#
| 相機連接埠 | 相機類型 | ROI 步長 [px] | 位元深度處理 [bit] | 位元深度輸出 [bit] | Mode | 鏡射 | Tap Geometry Sorting | Bayer Color Reconstruction (HQe) | 白平衡 | 頻寬：每台相機平均值 [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseAreaBayer | 2 | BASE | x: 8 y: 1 | 每色頻 12 位元 | BGR 24、30 packed、36 packed 或 48 | Bayer Pattern | 是，水平與垂直 | 1、2、4（水平與垂直） | 是，High Quality Extended (HQe) | 是 | 255 |
| Acq_DualBaseAreaGray | 2 | BASE | x: 8 y: 1 | 16 | Grayscale 8、10 packed、12 packed 或 16 | Grayscale | 是，水平與垂直 | 1、2、4（水平與垂直） | 否 | 否 | 255 |
| Acq_DualBaseAreaRGB | 2 | BASE | x: 8 y: 1 | 每色頻 8 位元 | BGR 24 | RGB | 是，水平與垂直 | 1、2、4（水平與垂直） | 否 | 是 | 85 |
| Acq_SingleFullAreaBayer | 1 | FULL | x: 16 y: 1 | 每色頻 10 位元 | BGR 24、30 packed 或 48 | Bayer Pattern | 是，水平 | 8、10（水平） | 是，High Quality Extended (HQe) | 是 | 850 |
| Acq_SingleFullAreaGray | 1 | FULL | x: 16 y: 1 | 10 | Grayscale 8, 10 packed, 16 | Grayscale | 是，水平 | 8、10（水平） | 否 | 否 | 850 |
| Acq_SingleFullAreaRGB | 1 | FULL | x: 8 y: 1 | 每色頻 10 位元 | BGR 24、30 packed 或 48 | RGB | 是，水平 | 1、2、4（水平與垂直） | 否 | 是 | 284 |
| Acq_SingleMediumAreaBayer | 1 | MEDIUM | x: 8 y: 1 | 每色頻 12 位元 | BGR 24、30 packed、36 packed 或 48 | Bayer Pattern | 是，水平與垂直 | 1、2、4（水平與垂直） | 是，High Quality Extended (HQe) | 是 | 340 |
| Acq_SingleMediumAreaGray | 1 | MEDIUM | x: 8 y: 1 | 12 | Grayscale 8, 10 packed, 16 | Grayscale | 是，水平與垂直 | 1、2、4（水平與垂直） | 否 | 否 | 340 |
| Acq_SingleMediumAreaRGB | 1 | MEDIUM | x: 4 y: 1 | 每色頻 12 位元 | BGR 24、30 packed、36 packed 或 48 | RGB | 是，水平與垂直 | 1、2、4（水平與垂直） | 否 | 是 | 170 |
線陣取像 Applets#
提供以下 Line Scan Acquisition Applets：
- Acq_SingleFullLineGray
- Acq_SingleFullLineRGB
- Acq_SingleMediumLineGray
- Acq_SingleMediumLineRGB
- Acq_DualBaseLineGray
- Acq_DualBaseLineRGB
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_SingleFullLineGray Acq_SingleMediumLineGray | x: 8; y: 1 x: 8; y: 1 | |
| 1 | 2 | 2 | RGB | Acq_SingleFullLineRGB Acq_SingleMediumLineRGB | x: 4; y: 1 x: 4; y: 1 | |
| 2 | 1 | 2 | Grayscale | Acq_DualBaseLineGray | x: 4 y: 1 | |
| 2 | 1 | 2 | RGB | Acq_DualBaseLineRGB | x: 1 y: 1 | |
所有線陣取像 Applets 的通用規格#
| 鏡射 | 是，水平 |
| 相機時脈 | 85 MHz |
| Image Selector | 是 |
| Bayer Color Reconstruction (HQe) | 否 |
| LUT | 完整解析度 |
| 總 DMA 頻寬 (MB/s) c | 1800 |
不同線陣取像 Applets 之間的規格差異#
| 影像大小 [px] b | 相機連接埠 | 相機類型 | ROI 步長 [px] | 位元深度處理 [bit] | 位元深度輸出 [bit] | Mode | Tap Geometry Sorting | 白平衡 | 頻寬：每台相機平均值 [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|---|
| Acq_DualBaseLineGray | 48k x 16M | 2 | BASE | x: 4 y: 1 | 16 | Grayscale 8、10 packed、12 packed 或 16 | Grayscale | 1、2、3、4 (水平) | 否 | 255 |
| Acq_DualBaseLineRGB | 32k x 16M | 2 | BASE | x: 1 y: 1 | 每色頻 8 位元 | BGR 24 | RGB | 1、2、4 (水平) | 是 | 85 |
| Acq_SingleFullLineGray | 51k x 16M | 1 | FULL | x: 8 y: 1 | 10 | Grayscale 8、10 packed 或 16 | Grayscale | 8、10（水平） | 否 | 850 |
| Acq_SingleFullLineRGB | 32k x 16M | 1 | FULL | x: 4 y: 1 | 每色頻 10 位元 | BGR 24、30 packed 或 48 | RGB | 1、2、4 (水平) | 是 | 284 |
| Acq_SingleMediumLineGray | 48k x 16M | 1 | MEDIUM | x: 8 y: 1 | 12 | Grayscale 8、10 packed、12 packed 或 16 | Grayscale | 1、2、3、4 (水平) | 否 | 340 |
| Acq_SingleMediumLineRGB | 32k x 16M | 1 | MEDIUM | x: 4 y: 1 | 每色頻 12 位元 | BGR 24、30 packed、36 packed 或 48 | RGB | 1、2、4 (水平) | 是 | 170 |
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)。