PDF417 Code Reader vTool#

PDF417 Code Reader vTool 允許您偵測影像中的 PDF417 條碼並進行解碼。

PDF417 Code Reader 可以偵測並解碼透過 Image 輸入接腳接收到的影像中的 PDF417 條碼。它會透過 Regions 和 Texts 輸出接腳輸出結果。

區域輸出包含找到 PDF417 條碼的區域。文字輸出則是由 PDF417 條碼編碼的文字字串。

如果您在偵測前使用 ROI Creator vTool 來指定興趣區域，PDF417 Code Reader 會透過其 Roi 輸入接腳接收 ROI 資料。這會縮小 PDF417 Code Reader 搜尋條碼的影像區域，有助於排除錯誤的候選目標。同時，這也會使處理速度更快、更具強韌性。

PDF417 Code Reader vTool 可以單獨購買授權（Basic 或 Pro），或是作為 Code Reader Bundle 授權的一部分。若要購買授權，請造訪 Basler 網站。

PDF417 Code Reader 版本#

PDF417 Code Reader 提供兩種版本。下表顯示不同版本之間的差異。按一下表格標題中的某個版本，即可直接跳至本主題中的相關章節。

運作原理#

根據 PDF417 Code Reader 的版本，您可以在一張影像中偵測最多三個或無限個 PDF417 codes。

您可以指定逾時時間，以在經過特定時間後結束偵測。如果您知道影像中只包含一個 PDF417 code，將 PDF417 Code Reader 設定為僅尋找一個 code 可以節省處理時間。

常見使用案例#

• 讀取 PDF417 codes：在這種情況下，您只需要連接 Texts 輸出 pin 來輸出解碼後的字串。
• 確定 PDF417 codes 的位置：使用由 Regions 輸出 pin 傳回的 PDF417 codes 位置和大小進行後續處理。

PDF417 Code Reader Basic#

您可以在一張影像中偵測最多三個 PDF417 codes。將數量限制為影像中預期的 code 數量可以節省處理時間。

檢測條件#

若要讓 PDF417 codes 被偵測和解碼，必須符合以下條件：

• Module size：單個 module 的邊長必須介於 3 到 15 個像素之間。
• 列和欄限制：詳細資訊請參閱 PDF417 Code Reader Versions 表格。
• 極性：PDF417 codes 必須是深色背景上的淺色圖案。若為淺色背景上的深色圖案，請執行前處理步驟來反轉輸入影像，例如透過使用 Gray Value Transformer vTool。
• 鏡射：可以偵測垂直、水平或雙向鏡射的 PDF417 codes。
• Legibility: Code 必須沒有視覺瑕疵（例如無反光或污漬），且必須具備足夠的解析度。

逾時#

對於時間緊迫的應用，您可以指定逾時時間。當處理時間變動或無法預測（例如影像不包含 PDF417 code）時，逾時設定會很有幫助。一旦超過指定的逾時時間，偵測程序就會停止並繼續處理下一張影像。

Basler 建議將逾時設定得比預期的時間限制稍低一些。這是因為 vTool 不會立即停止偵測程序。因此，請將逾時設定為預期時間限制的 70–80 %。

設定 vTool#

若要設定 PDF417 Code Reader Basic vTool：

1. 在 vTool Settings 區域的 Recipe Management 面板中，按一下 Open Settings 或按兩下該 vTool。
   隨即會開啟 PDF417 Code Reader Basic 對話方塊。
2. 在 Number of PDF417 Codes 區域中，選取您想要偵測的 PDF417 碼數量。
3. 在 Timeout 區域中，指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時，請取消勾選 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

您可以在 pin data view 中檢視 PDF417 Code Reader Basic 的結果。在此您可以選取要顯示的輸出。

PDF417 Code Reader PRO#

您可以在影像中偵測無限數量的 PDF417 碼。將數量限制為影像中預期的碼數可以節省處理時間。

檢測條件#

若要讓 PDF417 codes 被偵測和解碼，必須符合以下條件：

• 模組大小：在「增強 偵測模式」下，各模組的邊長必須介於 2 至 100 像素之間。在「最大 偵測模式」下，各模組的邊長必須介於 1 至 100 像素之間。
• 列和欄限制：詳細資訊請參閱 PDF417 Code Reader Versions 表格。
• Polarity: PDF417 碼可以是白底黑字、黑底白字或兩者的混合圖案。
• 鏡射：可以偵測垂直、水平或雙向鏡射的 PDF417 codes。
• 可讀性：可偵測到存在視覺瑕疵（例如反光或污漬）以及解析度較低的條碼。

檢測模式#

標準： This is a fast detection mode but deformed or low-resolution data codes won't be detected.

Enhanced: 在此偵測模式下，PDF417 Code Reader Pro 對 PDF417 碼的 Quality 具有更高的容忍度。這表示可以偵測到未完全符合所有偵測條件的碼。啟用此選項會減慢偵測程序。

Maximum: 在此偵測模式下，除了 Enhanced 偵測模式的優點外，PDF417 Code Reader Pro 還能接受較小的模組尺寸，並且在偵測較小模組時更具穩健性。這表示可以偵測到更多未完全符合所有偵測條件的碼。啟用此選項會減慢偵測程序。

逾時#

對於時間緊迫的應用，您可以指定逾時時間。當處理時間變動或無法預測（例如影像不包含 PDF417 code）時，逾時設定會很有幫助。一旦超過指定的逾時時間，偵測程序就會停止並繼續處理下一張影像。

Basler 建議將逾時設定得比預期的時間限制稍低一些。這是因為 vTool 不會立即停止偵測程序。因此，請將逾時設定為預期時間限制的 70–80 %。

設定 vTool#

若要設定 PDF417 Code Reader Pro vTool：

1. 在 vTool Settings 區域的 Recipe Management 面板中，按一下 Open Settings 或按兩下該 vTool。
   隨即會開啟 PDF417 Code Reader Pro 對話方塊。
2. 在 Number of PDF417 Codes 區域中，選取您想要偵測的 PDF417 碼數量。如果不知道要偵測的最大代碼數量，請選取 Unlimited。
3. 在 Detection Mode 區域中，選取所需的偵測模式。
4. 在 Polarity 下拉式清單中，選取適用於您應用的選項。
   如果應用程式中的碼具有特定的極性，請據此選取設定。如果影像中碼的極性未知，或出現具有不同極性的多個碼，請選取 Any。
5. 在 Timeout 區域中，指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時，請取消勾選 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

您可以在 pin data view 中檢視 PDF417 Code Reader Pro 的結果。在此您可以選取要顯示的輸出。

Inputs#

Image#

直接接收來自 Camera vTool 或輸出影像之 vTool（例如 Image Format Converter vTool）的影像。

• 資料類型：Image
• 影像格式：8 位元單色或彩色影像。彩色影像會在內部轉換為單色影像。

ROI#

接收來自 ROI Creator vTool 或任何其他輸出區域或矩形的 vTool 的興趣區域 (ROI)。多個矩形或區域會在內部合併，以形成單一興趣區域。

• 資料類型：RectangleF、RectangleF Array、Region、Region Array

Outputs#

文字#

傳回編碼在 PDF417 碼中的文字字串。

• 資料類型：String Array

Regions#

為找到的每個 PDF417 碼傳回一個 Region。該 Region 為矩形形狀。可用於視覺化目的或後續的 Region Feature Extraction。

• 資料類型：Region Array

OrientedBoxes_px#

為找到的每個 PDF417 碼傳回一個導向邊界方塊。

• 資料類型：RectangleF 陣列

相關 vTools#

典型前置項目#

• 攝影機vTool
• Image Format Converter vTool

典型後續元件#

• Region Feature Extraction vTool
  允許您決定找到的 PDF417 碼的中心、大小與方向。