跳至內容
測試伺服器
開發伺服器

Barcode Reader vTool#

透過 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 vTool

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:

Barcode Reader Starter vTool 設定

  1. 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
    隨即會開啟 Barcode Reader Starter 對話方塊。
  2. 在 Barcode Types 區域中,選取您要尋找的條碼類型。
  3. 在 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:

Barcode Reader Basic vTool 設定

  1. 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
    隨即會開啟 Barcode Reader Basic 對話方塊。
  2. 在 Barcode Type Groups 區域中,選取您要尋找的條碼類型群組。
  3. 在 Number of Barcodes 區域中,選取您要偵測的條碼數量。
  4. 在 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:

Barcode Reader Pro vTool 設定

  1. 在 vTool Settings 區域的 Recipe Management 窗格中,按一下 Open Settings 或按兩下 vTool。
    隨即會開啟 Barcode Reader Pro 對話方塊。
  2. 在 Barcode Types 區域中,選取您要尋找的條碼類型群組或條碼類型。
  3. 在 Number of Barcodes 區域中,選取您要偵測的條碼數量。
  4. 如果需要,請選取 Enhanced detection 核取方塊。
  5. 在 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

典型前置項目#

典型後續元件#