跳至內容

適用於 marathon ACX-QP 的 Acquisition Applets#

本主題將為您介紹適用於 marathon ACX-QP 取像卡（frame grabber）的 Acquisition Applets。

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

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

適用於 marathon ACX-QP 的 acquisition applets 已包含在 Framegrabber SDK 中。

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

Requirements#

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

限制

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

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

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

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

說明文件#

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

面陣取像 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

面陣掃描取像 Applets#

提供以下面陣翻拍 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，因此會因相機和擷取卡而異。

相機數量 相機連接埠數 擷取卡連接埠數 Mode Applet ROI 步長 [px] 拓樸
1 4 4 Bayer Pattern Acq_SingleCXP6x4AreaBayer x: 8
y: 1		 單一相機，四個連接埠，Bayer Pattern
1 4 4 Grayscale Acq_SingleCXP6x4AreaGray x: 16
y: 1		 單一相機，四個連接埠，Grayscale
1 4 4 RGB Acq_SingleCXP6x4AreaRGB x: 8
y: 1		 單一相機，四個連接埠，RGB
2 2 4 Bayer Pattern Acq_DualCXP6x2AreaBayer x: 8
y: 1		 兩台相機，每台兩個連接埠，Bayer Pattern
2 2 4 Grayscale Acq_DualCXP6x2AreaGray x: 16
y: 1		 兩台相機，每台兩個連接埠，Grayscale
2 2 4 RGB Acq_DualCXP6x2AreaRGB x: 4
y: 1		 兩台相機，每台兩個連接埠，RGB
4 1 4 Bayer Pattern Acq_QuadCXP6x1AreaBayer x: 4
y: 1		 四台相機，四個連接埠，Bayer Pattern
4 1 4 Grayscale Acq_QuadCXP6x1AreaGray x: 8
y: 1		 四台相機，四個連接埠，Grayscale
4 1 4 RGB Acq_QuadCXP6x1AreaRGB x: 4
y: 1		 四台相機，四個連接埠，RGB

所有面陣取像 Applets 的通用規格#
相機類型 CXP-6
鏡射 是，水平與垂直
事件生成 是
Image Selector 是
LUT 完整解析度
總 DMA 頻寬 [MB/s] b 1800

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

相機連接埠 [px] c ROI 步長 [px] 位元深度處理 [bit] 位元深度輸出 [bit] Mode 白平衡 頻寬：每台相機平均值 [MP/s]
Acq_DualCXP6x2AreaBayer 16k x 64k x: 8
y: 1		 每彩色分量 14 BGR 24、30 packed、36 packed、42 packed 或 48 Bayer Pattern 是 1200
Acq_DualCXP6x2AreaGray 64k x 64k x: 16
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 1200
Acq_DualCXP6x2AreaRGB 64k x 64k x: 4
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 48 RGB 是 400
Acq_QuadCXP6x1AreaBayer 8k x 64k x: 4
y: 1		 每彩色分量 14 BGR 24、30 packed、36 packed、42 packed 或 48 Bayer Pattern 是 600
Acq_QuadCXP6x1AreaGray 64k x 64k x: 8
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 600
Acq_QuadCXP6x1AreaRGB 64k x 64k x: 4
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 48 RGB 是 200
Acq_SingleCXP6x4AreaBayer 48k x 64k x: 8
y: 1		 每彩色分量 14 BGR 24、30 packed、36 packed、42 packed 或 48 Bayer Pattern 是 2400
Acq_SingleCXP6x4AreaGray 64k x 64k x: 16
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 2400
Acq_SingleCXP6x4AreaRGB 64k x 64k x: 8
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 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，因此會因相機和擷取卡而異。

相機數量 相機連接埠數 擷取卡連接埠數 Mode Applet ROI 步長 [px] 拓樸
1 4 4 Grayscale Acq_SingleCXP6x4LineGray x: 16
y: 1		 單一相機，四個連接埠，Grayscale
1 4 4 RGB Acq_SingleCXP6x4LineRGB x: 8
y: 1		 單一相機，四個連接埠，RGB
2 2 4 Grayscale Acq_DualCXP6x2LineGray x: 16
y: 1		 兩台相機，每台兩個連接埠，Grayscale
2 2 4 RGB Acq_DualCXP6x2LineRGB x: 4
y: 1		 兩台相機，每台兩個連接埠，RGB
4 1 4 Grayscale Acq_QuadCXP6x1LineGray x: 8
y: 1		 四台相機，每個連接埠一個，灰階
4 1 4 RGB Acq_QuadCXP6x1LineRGB x: 4
y: 1		 四台相機，每個連接埠一個，RGB

所有線陣取像 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_DualCXP6x2LineGray 2 x: 16
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 1200
Acq_DualCXP6x2LineRGB 2 x: 4
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 48 RGB 是 400
Acq_QuadCXP6x1LineGray 4 x: 8
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 600
Acq_QuadCXP6x1LineRGB 4 x: 4
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 48 RGB 是 200
Acq_SingleCXP6x4LineGray 1 x: 16
y: 1		 16 灰階 8、10 packed、12 packed、14 packed 或 16 Grayscale 否 2400
Acq_SingleCXP6x4LineRGB 1 x: 8
y: 1		 每彩色分量 16 BGR 24、30 packed、36 packed、42 packed 或 48 RGB 是 800

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. 實際的 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 ↩↩