跳至內容

marathon ACL 的 Acquisition Applets#

本主題將向您介紹適用於 marathon ACL 取像卡的 Acquisition Applets。

取像卡（frame grabber）的功能是由特定的硬體相關程式所定義。此硬體實作稱為 applet。針對每張取像卡，均提供有多個 applet 可供使用。

透過將 applet 載入至取像卡（frame grabber）上，您可定義取像卡的功能，並將其調整以符合特定應用程式的需求。

marathon ACL 的 Acquisition Applets 已包含在 Framegrabber SDK 中。

在 marathon 取像卡（frame grabber）上，applet 一經燒錄（flashed）至取像卡（frame grabber）即可使用。

Requirements#

  • 主機軟體：Framegrabber SDK（5.7、5.10a 或更高版本），包含與硬體相關的 acquisition applets
  • 硬體：marathon ACL 取像卡已連接至您的系統

限制

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

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

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

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

說明文件#

以下章節提供 acquisition applets 說明文件的連結：

面陣取像 Applets 線陣取像 Applets 測試 Applet
Acq_SingleBaseAreaBayer PDF
Acq_SingleBaseAreaGray PDF Acq_SingleBaseLineGray PDF
Acq_SingleBaseAreaRGB PDF Acq_SingleBaseLineRGB
Acq_SingleFullAreaBayer PDF Acq_SingleFullLineBayer_RB_GG PDF
Acq_SingleFullLineBayer_RG_GB PDF
Acq_SingleFullAreaGray PDF Acq_SingleFullLineGray PDF
Acq_SingleFullAreaRGB PDF Acq_SingleFullLineRGB PDF
Acq_SingleMediumAreaBayer PDF
Acq_SingleMediumAreaGray PDF Acq_SingleMediumLineGray PDF
Acq_SingleMediumAreaRGB PDF Acq_SingleMediumLineRGB PDF
Acq_DualBaseAreaBayer PDF Acq_DualBaseLineBayer_RG_GB PDF
Acq_DualBaseAreaGray PDF Acq_DualBaseLineGray PDF
Acq_DualBaseAreaRGB PDF Acq_DualBaseLineRGB PDF
FrameGrabberTest PDF

面陣掃描取像 Applets#

提供以下面陣翻拍 Acquisition Applets：

  • Acq_DualBaseAreaBayer
  • Acq_DualBaseAreaGray
  • Acq_DualBaseAreaRGB
  • Acq_SingleBaseAreaBayer
  • Acq_SingleBaseAreaGray
  • Acq_SingleBaseAreaRGB
  • 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 1 2 Bayer Pattern Acq_SingleBaseAreaBayer x: 4
y: 1		 單一相機、單一連接埠、Bayer 格式
1 1 2 Grayscale Acq_SingleBaseAreaGray x: 4
y: 1		 單一相機、單一連接埠、灰階
1 1 2 RGB Acq_SingleBaseAreaRGB x: 8
y: 1		 單一相機、單一連接埠、RGB
1 2 2 Bayer Pattern Acq_SingleFullAreaBayer
Acq_SingleMediumAreaBayer		 x: 8; y: 1
x: 4; y: 1		 單相機、雙連接埠、Bayer 格式
1 2 2 Grayscale Acq_SingleFullAreaGray
Acq_SingleMediumAreaGray		 x: 16; y: 1
x: 4; y: 1		 單相機、雙連接埠、灰階
1 2 2 RGB Acq_SingleFullAreaRGB
Acq_SingleMediumAreaRGB		 x: 4; y: 1
x: 4; y: 1		 單相機、雙連接埠、RGB
2 1 2 Bayer Pattern Acq_DualBaseAreaBayer x: 4
y: 1		 兩台相機、各一個連接埠、Bayer 格式
2 1 2 Grayscale Acq_DualBaseAreaGray x: 4
y: 1		 兩台相機、各一個連接埠、灰階
2 1 2 RGB Acq_DualBaseAreaRGB x: 1
y: 1		 兩台相機、各一個連接埠、RGB

所有面陣取像 Applets 的通用規格#
最大影像大小 [px] 16k x 64kb
相機時脈最大值 85 MHz
Image Selector 是
LUT 完整解析度

不同面陣取像 Applets 之間的規格差異#

相機連接埠 相機類型 ROI 步長 [px] 位元深度處理 [bit] 位元深度輸出 [bit] Mode 鏡射 Tap Geometry Sorting Bayer Color Reconstruction (HQe) 白平衡 頻寬：每台相機平均值 [MP/s] 總 DMA 頻寬 [MB/s] c
Acq_DualBaseAreaBayer 2 BASE x: 4
y: 1		 每色頻 8 位元 BGR 24 Bayer Pattern 是，水平與垂直 1、2、4（水平與垂直） 是，High Quality Extended (HQe) 是 255 1800
Acq_DualBaseAreaGray 2 BASE x: 4
y: 1		 16 Grayscale 8、10 packed、12 packed 或 16 Grayscale 是，水平與垂直 1、2、4（水平與垂直） 否 否 255 900
Acq_DualBaseAreaRGB 2 BASE x: 1
y: 1		 每色頻 8 位元 BGR 24 RGB 是，水平與垂直 1、2、4（水平與垂直） 否 是 85 900
Acq_SingleBaseAreaBayer 1 BASE x: 4
y: 1		 每色頻 12 位元 BGR 24, 48 Bayer Pattern 是，水平與垂直 1、2、4（水平與垂直） 是，High Quality Extended (HQe) 是 255 1800
Acq_SingleBaseAreaGray 1 BASE x: 4
y: 1		 16 Grayscale 8, 16 Grayscale 是，水平與垂直 1、2、4（水平與垂直） 否 否 255 1800
Acq_SingleBaseAreaRGB 1 BASE x: 8
y: 1		 每色頻 8 位元 BGR 24 RGB 是，水平與垂直 1、2、4（水平與垂直） 否 是 85 1800
Acq_SingleFullAreaBayer 1 FULL x: 8
y: 1		 每色頻 10 位元 BGR 24,or 48 Bayer Pattern 是，水平 8、10（水平） 是，High Quality Extended (HQe) 是 850 1800
Acq_SingleFullAreaGray 1 FULL x: 16
y: 1		 10 Gray-scale 8, 10 packed, or 16 Grayscale 是，水平 8、10（水平） 否 否 850 1800
Acq_SingleFullAreaRGB 1 FULL x: 4
y: 1		 每色頻 10 位元 BGR 24, or 48 RGB 是，水平 1、2、4（水平與垂直） 否 是 284 1800
Acq_SingleMediumAreaBayer 1 MEDIUM x: 4
y: 1		 每色頻 12 位元 BGR 24, or 48 Bayer Pattern 是，水平與垂直 1、2、4（水平與垂直） 是，High Quality Extended (HQe) 是 340 1800
Acq_SingleMediumAreaGray 1 MEDIUM x: 4
y: 1		 12 Grayscale 8, or 16 Grayscale 是，水平與垂直 1、2、4（水平與垂直） 否 否 340 1800
Acq_SingleMediumAreaRGB 1 MEDIUM x: 4
y: 1		 每色頻 12 位元 BGR 24, or 48 RGB 是，水平與垂直 1、2、4（水平與垂直） 否 是 170 1800

線陣取像 Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_SingleBaseLineGray
  • Acq_SingleBaseLineRGB
  • Acq_SingleFullLineBayer_RB_GG
  • Acq_SingleFullLineBayer_RG_GB
  • Acq_SingleFullLineGray
  • Acq_SingleFullLineRGB
  • Acq_SingleMediumLineGray
  • Acq_SingleMediumLineRGB
  • Acq_DualBaseLineBayer_RG_GB
  • 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 1 2 Grayscale Acq_SingleBaseLineGray x: 4
y: 1		 單一相機、單一連接埠、灰階
1 1 2 RGB Acq_SingleBaseLineRGB x: 1
y: 1		 單一相機、單一連接埠、RGB
1 2 2 Bayer Pattern Acq_SingleFullLineBayer_RB_GG
Acq_SingleFullLineBayer_RB_GB		 x: 8; y: 1
x: 8; y: 1		 單相機、雙連接埠、Bayer 格式
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		 單相機、雙連接埠、RGB
2 1 2 Bayer Pattern Acq_DualBaseLineBayer_RG_GB x: 4
y: 1		 雙相機、雙連接埠、Bayer 格式
2 1 2 Grayscale Acq_DualBaseLineGray x: 4
y: 1		 雙相機、雙連接埠、灰階
2 1 2 RGB Acq_DualBaseLineRGB x: 1
y: 1		 雙相機、雙連接埠、RGB

所有線陣取像 Applets 的通用規格#
相機時脈 85 MHz
Image Selector 是
LUT 完整解析度

不同線陣取像 Applets 之間的規格差異#

影像大小 [px] b 相機連接埠 相機類型 ROI 步長 [px] 位元深度處理 [bit] 位元深度輸出 [bit] Mode 鏡射 Tap Geometry Sorting Bayer Color Reconstruction (HQe) 白平衡 頻寬：每台相機平均值 [MP/s] 總 DMA 頻寬 [MB/s] c
Acq_DualBaseLineBayer_RG_GB 16k x 64k 2 BASE x: 4
y: 1		 每色頻 8 位元 BGR 24 Bayer Pattern 否 否 是 (2 行) 是 566 900
Acq_DualBaseLineGray 48k x 16M 2 BASE x: 4
y: 1		 12 Grayscale 8, or 16 Grayscale 是，水平 1、2、3、4 (水平) 否 否 250 900
Acq_DualBaseLineRGB 32k x 16M 2 BASE x: 1
y: 1		 每色頻 8 位元 BGR 24 RGB 是，水平 1、2、4 (水平) 否 是 85 900
Acq_SingleBaseLineGray 48k x 16M 1 BASE x: 4
y: 1		 16 Grayscale 8, or 16 Grayscale 是，水平 1、2、3、4 (水平) 否 否 255 1800
Acq_SingleBaseLineRGB 64k x 16M 1 BASE x: 1
y: 1		 每色頻 8 位元 BGR 24 RGB 是，水平 1、2、4 (水平) 否 是 85 1800
Acq_SingleFullLineBayer_RB_GG 16k x 16M 1 FULL x: 8
y: 1		 每色頻 8 位元 BGR 24 Bayer Pattern 是，水平 8、10（水平） 是 (2 行) 是 850 1800
Acq_SingleFullLineBayer_RG_GB 16k x 16M 1 FULL x: 8
y: 1		 每色頻 8 位元 BGR 24 Bayer Pattern 是，水平 8、10（水平） 是 (2 行) 是 566 1800
Acq_SingleFullLineGray 51k x 16M 1 FULL x: 8
y: 1		 10 Grayscale 8, or 16 Grayscale 是，水平 8、10（水平） 否 否 850 1800
Acq_SingleFullLineRGB 32k x 16M 1 FULL x: 4
y: 1		 每色頻 10 位元 BGR 24, or 48 RGB 是，水平 1、2、4 (水平) 否 是 284 1800
Acq_SingleMediumLineGray 48k x 16M 1 MEDIUM x: 8
y: 1		 12 Grayscale 8, or 16 Grayscale 是，水平 1、2、3、4 (水平) 否 否 340 1800
Acq_SingleMediumLineRGB 32k x 16M 1 MEDIUM x: 4
y: 1		 每色頻 12 位元 BGR 24, or 48 RGB 是，水平 1、2、4 (水平) 否 是 170 1800

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 新增至主機檔案系統：

  1. 取得您收到的 Applet 檔案 (*.dll)。
  2. 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)。

  1. Framegrabber SDK 5.9 版不支援 mE5 取像卡 ↩

  2. 在此情況下，k Px 和 M Px 是指二進位格式。二進位計算的範例為：

    16M px = 16384k px = 16777216 px

    8M px = 8192k px = 8388608 px

    64k px = 65536 px

    48k px = 49152 px

    32k px = 32768 px

    16k px = 16384 px ↩↩

  3. 實際的 DMA 頻寬取決於主機電腦的特定主機板與晶片組。 ↩↩