跳至內容

用於 marathon ACX-QP 的 Acquisition Applets#

本主題將為您介紹適用於 marathon ACX-QP 擷取卡的擷取 Applet。

擷取卡的功用是由特定的硬體相關程式所定義。此硬體實作稱為 applet。針對每張擷取卡，均提供有多個 applet。

透過將 applet 載入擷取卡，您可以定義擷取卡的功能，並使其配合特定應用的需求。

marathon ACX-QP 的擷取 Applet 已包含在 Framegrabber SDK 中。

在 marathon 擷取卡上，只要將 applet 燒錄至擷取卡，即可使用。

要求#

  • 主機軟體：Framegrabber SDK（5.7、5.10a 或更高版本），搭配硬體相依的取像 applet
  • 硬體：marathon ACX-QP 擷取卡已連接至您的系統

限制

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

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

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

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

文件#

以下章節提供採集 applet 文件的連結：

面陣取像 Applets 線陣取像 Applets 測試 Applet
Acq_SingleCXP6x4AreaBayer PDF
Acq_SingleCXP6x4AreaGray PDF Acq_SingleCXP6x4LineGray PDF
Acq_SingleCXP6x4AreaRGB PDF Acq_SingleCXP6x4LineRGB PDF
Acq_DualCXP6x2AreaBayer PDF
Acq_DualCXP6x2AreaGray PDF Acq_DualCXP6x2LineGray PDF
Acq_DualCXP6x2AreaRGB PDF Acq_DualCXP6x2LineRGB PDF
Acq_QuadCXP6x1AreaBayer PDF
Acq_QuadCXP6x1AreaGray PDF Acq_QuadCXP6x1LineGray PDF
Acq_QuadCXP6x1AreaRGB PDF Acq_QuadCXP6x1LineRGB PDF
FrameGrabberTest PDF

面陣取像 Applet#

提供以下 Area Scan Acquisition Applets：

  • Acq_DualCXP6x2AreaBayer
  • Acq_DualCXP6x2AreaGray
  • Acq_DualCXP6x2AreaRGB
  • Acq_QuadCXP6x1AreaBayer
  • Acq_QuadCXP6x1AreaGray
  • Acq_QuadCXP6x1AreaRGB
  • Acq_SingleCXP6x4AreaBayer
  • Acq_SingleCXP6x4AreaGray
  • Acq_SingleCXP6x4AreaRGB

Applet 名稱中的「單台 (single)」、「雙台 (dual)」與「四台 (quad)」分母是指您可以連接的最大相機數量。如需詳細資訊，請參閱 Choosing the Right Area Scan Acquisition Applet。

選擇正確的面陣取像 Applet#

您必須為相機設定選擇正確的 applet。否則，從相機接收到的影像將無法正確處理或顯示，或者相機效能可能會大幅降低。

哪一個 applet 是正確的，取決於相機數量、每台相機的通道數以及所需的 ROI 步進大小。

ROI 遞增尺寸取決於影像前處理的 Parallelism，因此會因相機和擷取卡而異。

相機數量 相機連接埠數量 擷取卡連接埠數量 模式 Applet ROI 步進尺寸 [px] 拓樸
1 4 4 拜耳圖案 (Bayer Pattern) Acq_SingleCXP6x4AreaBayer x: 8
y: 1		 單相機、四連接埠、Bayer 格式
1 4 4 灰階 Acq_SingleCXP6x4AreaGray x: 16
y: 1		 單相機、四連接埠、灰階
1 4 4 RGB Acq_SingleCXP6x4AreaRGB x: 8
y: 1		 單相機、四連接埠、RGB
2 2 4 拜耳圖案 (Bayer Pattern) Acq_DualCXP6x2AreaBayer x: 8
y: 1		 雙相機、每台雙連接埠、Bayer 格式
2 2 4 灰階 Acq_DualCXP6x2AreaGray x: 16
y: 1		 雙相機、每台雙連接埠、灰階
2 2 4 RGB Acq_DualCXP6x2AreaRGB x: 4
y: 1		 雙相機、每台雙連接埠、RGB
4 1 4 拜耳圖案 (Bayer Pattern) Acq_QuadCXP6x1AreaBayer x: 4
y: 1		 四相機、四連接埠、Bayer 格式
4 1 4 灰階 Acq_QuadCXP6x1AreaGray x: 8
y: 1		 四相機、四連接埠、灰階
4 1 4 RGB Acq_QuadCXP6x1AreaRGB x: 4
y: 1		 四相機、四連接埠、RGB

所有面陣取像 Applets 的共用規格#
Camera Type CXP-6
Mirroring 是，水平與垂直
Event Generation 是
Image Selector 是
LUT 完整解析度
Bandwidth Total DMA [MB/s] b 1800

面陣取像 Applets 之間的相異規格#

Camera Ports [px] c ROI 步進尺寸 [px] Bit Depth Processing [bit] Bit Depth Output [bit] 模式 白平衡 Bandwidth: Mean per Camera [MP/s]
Acq_DualCXP6x2AreaBayer 16k x 64k x: 8
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 拜耳圖案 (Bayer Pattern) 是 1200
Acq_DualCXP6x2AreaGray 64k x 64k x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 1200
Acq_DualCXP6x2AreaRGB 64k x 64k x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 400
Acq_QuadCXP6x1AreaBayer 8k x 64k x: 4
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 拜耳圖案 (Bayer Pattern) 是 600
Acq_QuadCXP6x1AreaGray 64k x 64k x: 8
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 600
Acq_QuadCXP6x1AreaRGB 64k x 64k x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 200
Acq_SingleCXP6x4AreaBayer 48k x 64k x: 8
y: 1		 14 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 拜耳圖案 (Bayer Pattern) 是 2400
Acq_SingleCXP6x4AreaGray 64k x 64k x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 2400
Acq_SingleCXP6x4AreaRGB 64k x 64k x: 8
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 800

線陣取像 Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_DualCXP6x2LineGray
  • Acq_DualCXP6x2LineRGB
  • Acq_QuadCXP6x1LineGray
  • Acq_QuadCXP6x1LineRGB
  • Acq_SingleCXP6x4LineGray
  • Acq_SingleCXP6x4LineRGB

Applet 名稱中的「single」、「dual」和「quad」分母指的是您可以連接的最大相機數量。如需詳細資訊，請參閱 Choosing the Right Line Scan Acquisition Applet。

如何選擇正確的線陣取像 Applet#

您必須為相機設定選擇正確的 applet。否則，相機可能無法運作或相機效能可能會大幅降低。

哪一個 applet 是正確的，取決於相機數量、每台相機的通道數以及所需的 ROI 步進大小。

ROI 遞增尺寸取決於影像前處理的 Parallelism，因此會因相機和擷取卡而異。

相機數量 相機連接埠數量 擷取卡連接埠數量 模式 Applet ROI 步進尺寸 [px] 拓樸
1 4 4 灰階 Acq_SingleCXP6x4LineGray x: 16
y: 1		 單相機、四連接埠、灰階
1 4 4 RGB Acq_SingleCXP6x4LineRGB x: 8
y: 1		 單相機、四連接埠、RGB
2 2 4 灰階 Acq_DualCXP6x2LineGray x: 16
y: 1		 雙相機、每台雙連接埠、灰階
2 2 4 RGB Acq_DualCXP6x2LineRGB x: 4
y: 1		 雙相機、每台雙連接埠、RGB
4 1 4 灰階 Acq_QuadCXP6x1LineGray x: 8
y: 1		 四台相機，每台一個連接埠，灰階
4 1 4 RGB Acq_QuadCXP6x1LineRGB x: 4
y: 1		 四台相機，每台一個連接埠，RGB

所有線陣取像 Applets 的共用規格#
Max. Image Size [px] 64k x 8Mc
Camera Type CXP-6
Mirroring 是，水平與垂直
Event Generation 是
Image Selector 是
Bayer Color Reconstruction (HQe) 否
LUT 完整解析度
Bandwidth Total DMA [MB/s] b 1800

線陣取像 Applets 之間的相異規格#

Camera Ports ROI 步進尺寸 [px] Bit Depth Processing [bit] Bit Depth Output [bit] 模式 白平衡 Bandwidth: Mean per Camera [MP/s]
Acq_DualCXP6x2LineGray 2 x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 1200
Acq_DualCXP6x2LineRGB 2 x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 400
Acq_QuadCXP6x1LineGray 4 x: 8
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 600
Acq_QuadCXP6x1LineRGB 4 x: 4
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 200
Acq_SingleCXP6x4LineGray 1 x: 16
y: 1		 16 Grayscale 8, 10 packed, 12 packed, 14 packed, or 16 灰階 否 2400
Acq_SingleCXP6x4LineRGB 1 x: 8
y: 1		 16 per color component BGR 24, 30 packed, 36 packed, 42 packed, or 48 RGB 是 800

Frame Grabber Test Applet#

此 applet 為 Frame Grabber Test Applet。其用途是測試硬體。

此 applet 提供以下功能：

功能 說明
DMA 效能測試 測試針對不同記憶體大小和中斷速率的不同影像尺寸
RAM 測試 檢查錯誤與處理
檢查 Camera Port Image Acquisition 檢查相機連接埠影像擷取
傳送觸發訊號至相機 向相機傳送觸發訊號
GPIO Monitoring 監控 GPI 並設定 GPO
Event Test 產生軟體回呼事件
General Monitoring 監控 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 了。

測試影像擷取#

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

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

儲存 Applet 組態#

在 microDisplay X 中或透過 Framegrabber API 設定 Applet 後，您可以儲存設定。如需詳細資訊，請參閱 Other Tasks (microDisplay X)。

  1. Framegrabber SDK 5.9 版不支援 mE5 圖形擷取卡。 ↩︎

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

  3. 在此情況下，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 ↩︎↩︎