跳至內容

針對 imaWorx CXP-12 Quad 的 Acquisition Applets#

本主題將為您介紹適用於 imaWorx CXP-12 Quad 擷取卡的 acquisition applet。

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

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

imaWorx CXP-12 Quad 的 acquisition applet 已包含在 Framegrabber SDK 以及 pylon Software Suite 中。

所有隨附的 Applets 都已內建於 imaWorx CXP-12 Quad 張量擷取卡（frame grabber）中，但預設僅會啟用一個。如果您想在 imaWorx CXP-12 Quad 上啟用不同的 Applet，請依照 使用 Framegrabber SDK 啟用 Applet 或 使用 pylon 設定張量擷取卡 中的說明進行操作。

除了 Acquisition Applets 之外，您也可以使用 Enhanced Applets。Enhanced Applets 為原型版本，僅限透過您當地的 Basler 業務代表或現場應用工程師 提出申請後取得。所有 Enhanced Applets 皆具備下列額外功能：

要求#

  • 主機軟體：Framegrabber SDK（5.9 或更高版本）或 pylon Software Suite（6.3 或更高版本），並搭配相依於硬體的 acquisition applets
  • 硬體：您的系統已連接 imaWorx CXP-12 Quad 張量擷取卡

限制

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

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

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

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

文件#

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

面陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_TripleCXP12Area PDF Acq_TripleCXP12Area PDF
Acq_QuadCXP12Area PDF Acq_QuadCXP12Area PDF

線陣取像 Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_TripleCXP12Line PDF Acq_TripleCXP12Line PDF
Acq_QuadCXP12line PDF Acq_QuadCXP12line PDF

Frame Grabber Test Applet#

GenTL Fglib
Frame Grabber Test Applet PDF Frame Grabber Test Applet PDF

面陣取像 Applet#

提供以下 Area Scan Acquisition Applets：

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_TripleCXP12Area
  • Acq_QuadCXP12Area

Applet 名稱中的「single」、「dual」、「triple」和「quad」分母指的是您可以連接的相機最大數量。如需詳細資訊，請參閱選擇正確的面陣相機 Acquisition Applet。

選擇正確的面陣取像 Applet#

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

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

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

最大相機數量 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步進尺寸 [px]
4 1 Acq_QuadCXP12Area x: 8
y: 1
4 2 Acq_QuadCXP12Area x: 8
y: 1
4 3 Acq_QuadCXP12Area x: 8
y: 1
4 4 Acq_QuadCXP12Area x: 8
y: 1
3 1 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Areab x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
2 1 Acq_DualCXP12Areaa x: 16
y: 1
2 2 Acq_DualCXP12Areaa x: 16
y: 1
2 1 1 Acq_DualCXP12Area x: 16
y: 1
2 1 Acq_DualCXP12Areac x: 16
y: 1
2 2 Acq_DualCXP12Area x: 16
y: 1
1 1 Acq_SingleCXP12Areaa x: 32
y: 1
1 1 Acq_SingleCXP12Aread x: 32
y: 1
1 1 Acq_SingleCXP12Area x: 32
y: 1

所有面陣取像 Applets 的共用規格#
Max. Image Size [px] 32k x 64ke
Camera Ports 4
Camera Type CXP-12
Bit Depth Processing [bit] 16（Bayer Demosaicing 則為 14）
Pixel Format Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
Mirroring 是，水平與垂直
Image Selector 是
Bayer Color Reconstruction (HQe) Yes, High Quality Extended (HQe)
白平衡 是
LUT 完整解析度
Pixel Format Conversion RGB 或 Bayer 轉單色，
Bayer 或單色轉 RGB
總 DMA 頻寬 [MB/s] f 7200

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

ROI 步進尺寸 [px] Bandwidth: Mean per Camera [MP/s] 抽頭幾何結構排序
Acq_SingleCXP12Area x: 32
y: 1		 4850 1X-1Y, 1X-2YE
Acq_DualCXP12Area x: 16
y: 1		 2400 1X-1Y, 1X-2YE
Acq_TripleCXP12Area x: 8
y: 1		 前兩台相機為 1200
第三台相機為 2400		 僅限 1X-1Y
Acq_QuadCXP12Area x: 8
y: 1		 1200 僅限 1X-1Y

線陣取像 Applets#

提供以下 Line Scan Acquisition Applets：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_TripleCXP12Line
  • Acq_QuadCXP12Line

Applet 名稱中的「single」、「dual」、「triple」和「quad」分母指的是您可以連接的相機最大數量。如需詳細資訊，請參閱選擇正確的線陣相機 Acquisition Applet。

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

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

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

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

最大相機數量 1 通道相機數量 2 通道相機數量 4 通道相機數量 Applet ROI 步進尺寸 [px]
4 1 Acq_QuadCXP12Line x: 8
y: 1
4 2 Acq_QuadCXP12Line x: 8
y: 1
4 3 Acq_QuadCXP12Line x: 8
y: 1
4 4 Acq_QuadCXP12Line x: 8
y: 1
3 1 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Lineh x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
2 1 Acq_DualCXP12Lineg x: 16
y: 1
2 2 Acq_DualCXP12Lineg x: 16
y: 1
2 1 Acq_DualCXP12Line x: 16
y: 1
2 1 1 Acq_DualCXP12Linei x: 16
y: 1
2 2 Acq_DualCXP12Line x: 16
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1
1 1 Acq_SingleCXP12Line x: 32
y: 1

所有線陣取像 Applets 的共用規格#
Max. Image Size [px] 32k x 8Me
Camera Ports 4
Camera Type CXP-12
Bit Depth Processing [bit] 16（BiColor 轉換為 BGR/RGB 時為 12 位元）
Pixel Format Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
Mirroring 是，水平與垂直
抽頭幾何結構排序 僅限 1X-1Y
Image Selector 是
Color Array Filter 是，兩條雙色（BiColor）線
白平衡 否
LUT 完整解析度
Pixel Format Conversion RGB 或 BiColor 轉單色，
單色或 BiColor 轉 RGB
頻寬：總 DMA [MB/s] f 7200

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

ROI 步進尺寸 [px] Bandwidth: Mean per Camera [MP/s]
Acq_SingleCXP12Line x: 32
y: 1		 4850
Acq_DualCXP12Line x: 16
y: 1		 2400
Acq_TripleCXP12Line x: 16
y: 1		 前兩台相機為 1200
第三台相機為 2400
Acq_QuadCXP12Line x: 4
y: 1		 1200

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 使用 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)。

搭配 pylon 使用 Acquisition Applets#

若想配合 pylon 使用 Applet，請參閱使用 pylon 設定擷取卡。

  1. 僅在您需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 QuadCXP12Area。 ↩↩↩↩↩↩

  2. 不建議使用，請改用 DualCXP12Area。 ↩

  3. 僅在您需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 TripleCXP12Area（僅限單通道相機）。 ↩

  4. 僅在您需要鏡射像素超過 21840 的影像時建議使用。否則，請使用 DualCXP12Area。 ↩

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

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

  7. 僅在您需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 QuadCXP12Line。 ↩↩↩↩↩

  8. 不建議使用，請改用 DualCXP12Line。 ↩

  9. 僅在您需要鏡射像素超過 8K 的影像時建議使用。否則，請使用 TripleCXP12Line（僅限單通道相機）。 ↩