Barcode Reader vTool#
Barcode Reader 可以偵測並解碼透過 Image 輸入引腳接收到的影像中的條碼。它透過 Regions、Texts 和 Types 輸出引腳輸出結果。
region 輸出包含找到條碼的區域。text 輸出是由條碼編碼的文字字串。type 輸出則表示找到的條碼類型。
如果您在偵測前使用 ROI Creator vTool 來指定感興趣區域 (ROI),Barcode Reader 將透過其 Roi 輸入引腳接收 ROI 資料。這會縮小 Barcode Reader 搜尋條碼的影像區域,有助於排除錯誤的候選目標。同時,這也能加快處理速度並提高穩健性。
Barcode Reader vTool 可以作為單一授權(Basic 或 Pro)購買,或作為 Code Reader Bundle 授權的一部分購買。若要購買授權,請造訪 Basler website。

Barcode Reader 版本#
Barcode Reader 提供三種版本。下表顯示各版本之間的差異。按一下表格標題中的某個版本,即可直接跳至本主題中的相關章節。
| Starter | Basic | Pro | |
|---|---|---|---|
| 您最多可以偵測多少個條碼? | 2 | 2 | 無限制 |
| 條碼的最小線寬 | 2 像素 | 2 像素 | 1 像素 |
| 可以為檢測指定 timeout 嗎? | 否 | 是 | 是 |
| 您可以搜尋個別條碼類型還是條碼群組? | 類型 | 群組 | 群組和類型 |
| 您可以同時搜尋多少個條碼群組? | 無,僅限個別條碼類型 | 1 | 無限制 |
| Enhanced 檢測模式可用嗎? | 否 | 否 | 是 |
| Roi 輸入接腳的有效資料類型 | RectangleF | RectangleF, RectangleF Array, Region, Region Array | RectangleF, RectangleF Array, Region, Region Array |
| 購買授權 | 包含在 pylon Software Suite 中 | 造訪 Basler 網站 | 造訪 Basler 網站 |
運作原理#
根據 Barcode Reader 的版本,您可以選擇條碼類型群組或個別條碼類型來進行偵測與解碼。影像中可偵測的條碼數量也取決於版本。
檢測條件#
條碼必須為淺底深色圖案。
如果您的條碼是以相反極性列印,請執行預處理步驟來反轉輸入影像,例如使用 Gray Value Transformer vTool。
最佳化條碼偵測#
根據 Barcourse Reader 版本,您具有以下選項來最佳化偵測程序:
- 限制要偵測的條碼數量:如果您知道影像中僅包含特定數量的條碼,將 Barcode Reader 設定為僅尋找該數量的條碼可能會節省處理時間。一旦找到指定數量的條碼,vTool 就會處理下一張影像。如果條碼數量會變動或未知,請將 Barcode Reader 設定為尋找更多條碼。
- 限制要偵測的條碼類型:Basler 建議僅選擇您預期在影像中找到的條碼類型。特別是選擇 MSI 和 PharmaCode 條碼可能會增加誤檢率。
- 逾時:您可以指定逾時時間,以在經過一定時間後結束偵測。如果超過逾時時間,偵測程序將會停止並移至下一張影像,即使尚未找到指定數量的條碼亦然。
Basler 建議將逾時時間設定得比所需的時限稍低一些。這是因為 vTool 不會立即停止偵測程序。因此,請將逾時時間設定為所需時限的 70–80 %。 - 指定 ROI:透過使用 ROI Creator vTool 指定感興趣區域,您可以縮小 Barcode Reader 搜尋條碼的區域,這有助於排除錯誤的候選項目。附帶好處是處理速度會更快且更穩定。
資訊
- 如果您首次開啟 Barcode Reader Basic 或 Barcode Reader Starter,將不會設定任何條碼類型。您必須先選擇一個條碼類型。如果未設定條碼,vTool 將針對透過 Image 輸入接腳接收到的每個輸入影像回報錯誤。
- 如果您首次開啟 Barcode Reader Pro,將會選取所有條碼群組,但 MSI 和 PharmaCode 除外。
- PharmaCode 條碼是具有潛在較少條碼數的代碼。請注意,在具有線條狀圖案背景的影像中,可能會誤判找到 PharmaCode。
- MSI 條碼是非自我檢查代碼。請注意,在某些影像中可能會誤判找到 MSI 代碼。
常見使用案例#
- 讀取條碼:在此情況下,您只需要連接 Texts 輸出接腳即可輸出解碼的字串。連接 Types 輸出接腳以了解解碼的是哪種條碼類型也可能會很有用。
- 判斷條碼的位置:使用由 Regions 輸出接腳傳回的條碼位置和大小進行後續處理。
Barcode Reader Starter#
Barcode Reader Starter 可以偵測個別條碼類型。
支援以下條碼類型:
- Codabar
- Code 128
- Code 39
- Code 93
- DataBar
- DataBar Expanded
- EAN-13
- EAN-8
- 2/5 Interleaved
- UPC-A
- UPC-E
您可以在影像中偵測一或兩個條碼。將數量限制為影像中預期的條碼數量有助於節省處理時間。
設定 vTool#
若要設定 Barcode Reader Starter vTool:

- 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
隨即會開啟 Barcode Reader Starter 對話方塊。 - 在 Barcode Types 區域中,選取您要尋找的條碼類型。
- 在 Number of Barcodes 區域中,選取您要偵測的條碼數量。
您可以在 pin data view 中檢視 Barcode Reader Basic 的結果。在此您可以選取要顯示的輸出。
Barcode Reader Basic#
Barcode Reader Basic 可以偵測多個條碼類型群組。這些群組大多包含數種不同的條碼類型。透過選取某個群組,即可偵測該群組所包含的所有類型。例如,選取 Code 39 時,即可在影像中偵測 Code 39 與 Code 93 類型。
支援下列條碼類型群組:
- EAN: EAN-8, EAN-8 Add-On 2, EAN-8 Add-On 5, EAN-13, EAN-13 Add-On 2, EAN-13 Add-On 5
- UPC: UPC-A, UPC-A Add-On 2, UPC-A Add-On 5, UPC-E, UPC-E Add-On 2, UPC-E Add-On 5
- GS1: Code 128, GS1-128, GS1 DataBar Omnidirectional, GS1 DataBar Stacked Omnidirectional, GS1 DataBar Stacked, GS1 DataBar Expanded, GS1 DataBar Expanded Stacked, GS1 DataBar Limited, GS1 DataBar Truncated
- 2/5: 2/5 Industrial, 2/5 Interleaved
- Code 39: Code 39, Code 93
- Codabar: Codabar
- MSI: MSI
- PharmaCode: PharmaCode
您可以選取一個條碼類型群組,並在影像中偵測一個或兩個條碼。將數量限制為影像中預期的條碼數量有助於節省處理時間。
資訊
如果影像中的條碼數量超過指定的上限,則讀取哪些條碼將無法確定。這意味著如果讀取多次,相同的影像可能會產生不同的結果。
設定 vTool#
若要設定 Barcode Reader Basic vTool:

- 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
隨即會開啟 Barcode Reader Basic 對話方塊。 - 在 Barcode Type Groups 區域中,選取您要尋找的條碼類型群組。
- 在 Number of Barcodes 區域中,選取您要偵測的條碼數量。
- 在 Timeout 區域中,指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時,請取消勾選 No timeout 核取方塊,並在輸入欄位中輸入所需的逾時時間。
您可以在 pin data view 中檢視 Barcode Reader Basic 的結果。在此您可以選取要顯示的輸出。
Barcode Reader Pro#
Barcode Reader Pro 可以偵測條碼類型群組或個別條碼類型。大多數條碼類型群組包含數個個別條碼類型。選取群組即可偵測該群組中包含的所有類型。例如,選取 Code 39 時,將會在影像中偵測 Code 39 和 Code 93 類型。
您可以根據需要選取任意數量的條碼類型群組或個別條碼類型。可偵測的條碼數量沒有限制。將數量限制為影像中預期的條碼數量有助於節省處理時間。
資訊
如果影像中的條碼數量超過指定的上限,則讀取哪些條碼將無法確定。這意味著如果讀取多次,相同的影像可能會產生不同的結果。
支援下列條碼類型群組:
- EAN: EAN-8, EAN-8 Add-On 2, EAN-8 Add-On 5, EAN-13, EAN-13 Add-On 2, EAN-13 Add-On 5
- UPC: UPC-A, UPC-A Add-On 2, UPC-A Add-On 5, UPC-E, UPC-E Add-On 2, UPC-E Add-On 5
- GS1: Code 128, GS1-128, GS1 DataBar Omnidirectional, GS1 DataBar Stacked Omnidirectional, GS1 DataBar Stacked, GS1 DataBar Expanded, GS1 DataBar Expanded Stacked, GS1 DataBar Limited, GS1 DataBar Truncated
- 2/5: 2/5 Industrial, 2/5 Interleaved
- Code 39: Code 32, Code 39, Code 93
- Codabar: Codabar
- MSI: MSI
- PharmaCode: PharmaCode
偵測模式#
在 Enhanced 偵測模式下,Barcode Reader Pro 對條碼 Quality 的容忍度更高。這意味著可以偵測到解析度較低的條碼。啟用此選項會降低偵測過程的速度。
設定 vTool#
若要設定 Barcode Reader Pro vTool:

- 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
隨即會開啟 Barcode Reader Pro 對話方塊。 - 在 Barcode Types 區域中,選取您要尋找的條碼類型群組或條碼類型。
- 在 Number of Barcodes 區域中,選取您要偵測的條碼數量。
- 如果需要,請選取 Enhanced detection 核取方塊。
- 在 Timeout 區域中,指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時,請取消勾選 No timeout 核取方塊,並在輸入欄位中輸入所需的逾時時間。
您可以在引腳資料檢視中查看「Barcode Reader Pro」的讀取結果。在此處,您可以選擇要顯示哪些輸出資料。
Inputs#
Image#
直接接收來自 Camera vTool 或輸出影像之 vTool(例如 Image Format Converter vTool)的影像。
- 資料類型:Image
- 影像格式:8 位元至 16 位元單色或彩色影像。彩色影像會在內部轉換為單色影像。
ROI#
接受來自 ROI Creator vTool 或任何其他輸出區域或矩形的 vTool 之興趣區域。多個矩形或區域會在內部合併,以形成單一興趣區域。Starter 版本僅接受 RectangleF。
- 資料類型:RectangleF、RectangleF Array、Region、Region Array
Outputs#
文字#
回傳以條碼編碼的文字字串。
- 資料類型:String Array
Regions#
回傳每個偵測到的條碼所對應的區域。該區域呈矩形,可用於視覺化呈現或後續的特徵提取。
- 資料類型:Region Array
OrientedBoxes_px#
針對每個找到的條碼,回傳一個具有方向的包圍框。
- 資料類型:RectangleF 陣列
類型#
回傳所找到的每個條碼的類型。
- 資料類型:String Array
相關 vTools#
典型前置項目#
典型後續元件#
- Region Feature Extraction vTool
讓您能夠確定所偵測到的條碼的中心點、大小及方向。