PDF417 Code Reader vTool#

PDF417 Code Reader vTool 可協助您在圖像中偵測 PDF417 條碼並進行解碼。

PDF417 Code Reader 能夠偵測並解碼透過Image輸入腳位接收的影像中的 PDF417 條碼，並透過Regions和Texts輸出腳位輸出結果。

「區域」輸出欄位包含偵測到 PDF417 條碼的區域。「文字」輸出欄位則是 PDF417 條碼所編碼的文字字串。

若您使用 ROI Creator vTool 在檢測前指定感興趣區域（ROI），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 條碼。

您可以設定超時時間，讓系統在經過一段時間後結束偵測。如果您確定影像中僅包含一個 PDF417 條碼，將「PDF417 Code Reader 」設定為僅搜尋一個條碼，可節省處理時間。

常見應用情境#

• 讀取PDF417 條碼：在此情況下，您只需連接「Texts」輸出腳位，即可輸出解碼後的字串。
• 確定 PDF417 條碼的位置：請使用「Regions」輸出腳位所回傳的 PDF417 條碼位置與尺寸，以進行後續處理。

PDF417 Code Reader Basic#

您最多可在單張圖像中偵測到三個 PDF417 條碼。將偵測數量限制在圖像中預期的條碼數量內，可節省處理時間。

偵測準則#

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

• 模組尺寸：各模組的邊長必須介於 3 至 15 像素之間。
• 行與列的限制：詳情請參閱PDF417 Code Reader 中的「版本」表格。
• 極性：PDF417 條碼必須為「深色底上淺色」的圖案。若為「淺色底上深色」的圖案，請執行預處理步驟以反轉輸入影像，例如使用 Gray Value Transformer vTool。
• 鏡像處理：可偵測垂直、水平或同時垂直與水平鏡像的 PDF417 條碼。
• 可讀性：Code 必須沒有視覺瑕疵（例如沒有反光或汙點），並且必須具備足夠的解析度。

逾時#

對於對時間要求嚴格的應用，您可以設定超時時間。當處理時間不固定或無法預測時（例如，當影像中未包含 PDF417 碼時），設定超時時間便能發揮作用。一旦超過指定的超時時間，偵測程序便會停止，並轉而處理下一張影像。

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

設定 vTool#

要設定「PDF417 Code Reader 」基本 vTool：

1. 在vTool「設定」區域的「配方管理」窗格中，按一下「開啟設定」或雙擊該 vTool。
   此時將開啟「PDF417 Code Reader Basic」對話方塊。
2. 在「PDF417 條碼數量」區域中，請選擇您要偵測的 PDF417 條碼數量。
3. 在 Timeout 區域中，指定您是否希望偵測在經過特定時間後結束。如果您想要指定逾時，請清除 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

您可以在引腳資料檢視中查看「PDF417 Code Reader Basic」的結果。在此處，您可以選擇要顯示哪些輸出。

PDF417 Code Reader PRO#

您可以在一張圖像中偵測到不限數量的 PDF417 條碼。若將偵測數量限制在圖像中預期的條碼數量內，可節省處理時間。

偵測準則#

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

• 模組尺寸：在「增強 偵測模式」下，各模組的邊長必須介於 2 至 100 像素之間。在「最大 偵測模式」下，各模組的邊長必須介於 1 至 100 像素之間。
• 行與列的限制：詳情請參閱PDF417 Code Reader 中的「版本」表格。
• 極性：PDF417 條碼可採用深色底上淺色條碼、淺色底上深色條碼，或兩者的混合模式。
• 鏡像處理：可偵測垂直、水平或同時垂直與水平鏡像的 PDF417 條碼。
• 可讀性：可偵測到存在視覺瑕疵（例如反光或污漬）以及解析度較低的條碼。

偵測模式#

標準：這是一種快速檢測模式，但無法偵測到變形或低解析度的資料碼。

增強模式：在此偵測模式下，PDF417 Code Reader Pro 對 PDF417 條碼的品質具有較高的容錯度。這表示即使條碼未完全符合所有偵測標準，仍可被偵測到。啟用此選項會使偵測過程變慢。

最大值：在此檢測模式下，除了具備「增強型」檢測模式的優勢外，「PDF417 Code Reader Pro」還能支援更小的模組尺寸，並在檢測較小模組時表現得更為穩定。這意味著能夠檢測到更多不符合所有檢測標準的條碼。啟用此選項會使檢測過程變慢。

逾時#

對於對時間要求嚴格的應用，您可以設定超時時間。當處理時間不固定或無法預測時（例如，當影像中未包含 PDF417 碼時），設定超時時間便能發揮作用。一旦超過指定的超時時間，偵測程序便會停止，並轉而處理下一張影像。

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

設定 vTool#

要設定「PDF417 Code Reader Pro」vTool：

1. 在vTool「設定」區域的「配方管理」窗格中，按一下「開啟設定」，或雙擊該 vTool。
   此時將開啟「PDF417 Code Reader Pro」對話方塊。
2. 在「PDF417 條碼數量」區域中，請選擇您要偵測的 PDF417 條碼數量。若無法確定要偵測的條碼最大數量，請選擇「無限制」。
3. 在 Detection Mode 區域中，選取所需的偵測模式。
4. 在 Polarity 下拉式清單中，選取適合您應用程式的選項。
   如果應用程式中的條碼具有特定極性，請相應地選取設定。如果影像中條碼的極性未知，或出現多個具有不同極性的條碼，請選取 Any。
5. 在 Timeout 區域中，指定您是否希望偵測在經過特定時間後結束。如果您想要指定逾時，請清除 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

您可以在引腳資料檢視中查看「PDF417 Code Reader Pro」的檢測結果。在此處，您可以選擇要顯示哪些輸出。

Inputs#

Image#

可直接從「相機」vTool 或任何能輸出影像的 vTool（例如「Image Format Converter 」vTool）接收影像。

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

Roi#

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

• 資料類型：RectangleF、RectangleF 陣列、Region、Region 陣列

Outputs#

Texts#

回傳以 PDF417 碼編碼的文字字串。

• 資料類型：字串陣列

Regions#

針對每個找到的 PDF417 條碼，回傳一個區域。該區域呈矩形，可用於視覺化呈現或後續的特徵提取。

• 資料類型：區域陣列

OrientedBoxes_px#

針對每組找到的 PDF417 條碼，回傳一個具有方向的包圍框。

• 資料類型：RectangleF 陣列

相關 vTool#

典型前置元件#

• 攝影機vTool
• Image Format Converter vTool

典型後續元件#

• Region Feature Extraction vTool
  讓您能夠確定所找到的 PDF417 條碼的中心位置、尺寸及方向。