QR Code Reader vTool#
QR Code Reader 能夠偵測並解碼透過「影像輸入」接腳接收的影像中的 QR 碼，並透過「區域」與「文字」輸出接腳輸出結果。
「區域」輸出欄位包含發現 QR 碼的區域。文字輸出欄位則是 QR 碼所編碼的文字字串。
若您使用 ROI Creator vTool 在檢測前指定感興趣區域 (ROI)，QR Code Reader 會透過其Roi輸入腳位接收 ROI 資料。這能縮小QR Code Reader 搜尋 QR 碼的影像範圍，有助於排除錯誤候選項。此外，這也能使處理速度更快且更穩健。
QR Code Reader vTool 可購買單一授權（Basic 或 Pro），或作為 Code Reader Bundle 授權方案的一部分。如欲購買授權，請造訪Basler 網站。
QR Code Reader 版本#
QR Code Reader 共有三種版本。下表列出了各版本之間的差異。請點擊表格標題中的某個版本，即可直接跳轉至本主題中的相關段落。
| Starter | Basic | Pro | |
|---|---|---|---|
| 你能辨識多少個 QR 碼？ | 3 | 3 | 不限 |
| 您能辨識GS1 和 Micro QR 碼嗎？ | 否 | 是 | 是 |
| 您可以指定檢測的 timeout 嗎？ | 否 | 是 | 是 |
| 允許哪些 module sizes？ | 邊長介於 2 至 80 像素之間 | 邊長介於 6–20 個像素之間 | 邊長介於 1–100 個像素之間 |
| 是否允許模組之間存在 gaps？ | 是的，小間隙 | 是的，小間隙 | 是的，大間隙 |
| 必須顯示多少個定位圖案？ （僅適用於 QR 碼，不適用於微型 QR 碼。） | 這三者 | 這三者 | 2 |
| 你能辨識「淺色背景上的深色」QR 碼嗎？ | 否 這需要前置處理步驟。 | 否 這需要前置處理步驟。 | 是 |
| 你能辨識鏡像QR 碼嗎？ | 是 | 是 | 是 |
| 關於影像的對比度是否有任何限制？ | 影像中的深色與淺色部分之間必須具備足夠的對比度。 | 影像中的深色與淺色部分之間必須具備足夠的對比度。 | 影像中明亮部分與暗部之間的灰階差異必須至少為 10 級。 |
| Enhanced detection mode 是否可用？ | 否 | 否 | 是 |
| 是否提供 Maximum detection mode？ | 否 | 否 | 是 |
| Roi 輸入 pin 的有效資料類型 | RectangleF | RectangleF, RectangleF Array, Region, Region Array | RectangleF, RectangleF Array, Region, Region Array |
| 購買授權 | 包含在 pylon Software Suite 中 | 造訪 Basler website | 造訪 Basler website |
運作原理#
資訊
QR Code Reader Starter vTool 不支援 GS1 或 Micro QR 碼的偵測。
視「QR Code Reader 」的版本而定，您最多可偵測到三組，或無限制數量，的 QR 碼。
在 Basic 和 Pro 版本中，您可以設定超時時間，使系統在經過一定時間後停止偵測。如果您確定圖片中僅包含一個 QR 碼，將「QR Code Reader 」設定為僅搜尋一個 QR 碼，可節省處理時間。
常見應用情境#
- 讀取QR 碼：在此情況下，您只需將「Texts」輸出腳位連接起來，即可輸出解碼後的字串。
- 確定 QR碼的位置：利用「Regions」輸出腳位所回傳的 QR 碼位置與尺寸，進行後續處理。
QR Code Reader 開胃菜#
您最多可在一張圖片中偵測到三個 QR 碼。將偵測數量限制在圖片中預期的 QR 碼數量內，可節省處理時間。本功能不支援偵測 GS1 或 Micro QR 碼。若需此功能，您需要使用 vTool 的Basic或Pro版本。
偵測準則#
要讓 QR 碼能夠被偵測並解碼，必須符合以下條件：
- 程式碼結構： QR Code Reader Starter 支援 1 至 40 個符號的標準範圍，這對應於 21 x 21 至 177 x 177 個模組。
- 模組大小：程式碼中各模組的邊長必須介於 2 至 80 像素之間。
- 模組之間的間隙：模組之間允許留有小間隙。
- 定位圖案數量：此 QR 碼包含 3 個定位圖案。必須能清楚看見這 3 個定位圖案，才能讀取此 QR 碼。
- 極性：QR 碼必須採用「深色底上淺色圖案」的模式。若為「淺色底上深色圖案」的模式，請執行預處理步驟以反轉輸入影像，例如使用 Gray Value Transformer vTool。
- 鏡像處理：系統可偵測垂直、水平或兩者皆有的鏡像 QR 碼。
- 對比度：影像中的明暗部分之間必須具備足夠的對比度。
- 可讀性：條碼不得有任何視覺瑕疵，例如不得有反光或污漬，且必須具備足夠的解析度與對比度。
設定 vTool#
要設定「QR Code Reader Starter」vTool：
- 在vTool「設定」區域的「配方管理」窗格中，按一下「開啟設定」或雙擊該 vTool。
此時將開啟「QR Code Reader 啟動」對話方塊。 - 在「QR 碼數量」區域中，請選擇您要偵測的 QR 碼數量。
您可以在引腳資料視圖中檢視「QR Code Reader 」入門套件的結果。在此處，您可以選擇要顯示哪些輸出。
QR Code Reader Basic#
您最多可在一張圖片中偵測到三個 QR 碼。將偵測數量限制在圖片中預期的 QR 碼數量內，可節省處理時間。
偵測準則#
要讓 QR 碼能夠被偵測並解碼，必須符合以下條件：
- 程式碼結構： QR Code Reader Basic 支援 1 至 40 個符號的標準範圍，這對應於 21 x 21 至 177 x 177 個模組。
- 模組大小：程式碼中個別模組的邊長必須介於 2 至 100 像素之間。
- 模組之間的間隙：模組之間允許留有小間隙。
- 定位圖案數量：此 QR 碼包含 3 個定位圖案。必須能清楚看見這 3 個定位圖案，才能讀取此 QR 碼。
- 極性：QR 碼必須採用「深色底上淺色圖案」的模式。若為「淺色底上深色圖案」的模式，請執行預處理步驟以反轉輸入影像，例如使用 Gray Value Transformer vTool。
- 鏡像處理：系統可偵測垂直、水平或兩者皆有的鏡像 QR 碼。
- 對比度：影像中的明暗部分之間必須具備足夠的對比度。
- 可讀性：條碼不得有任何視覺瑕疵，例如不得有反光或污漬，且必須具備足夠的解析度與對比度。
資料代碼類型#
您可以使用 Data Code Type 下拉式清單來選取您想要尋找的資料碼類型：
- QR 碼
- GS1 條碼
- 微型 QR 碼
QR 碼與 GS1 QR 碼的符號結構完全相同，但其編碼方案卻有所不同。
在解碼標準 QR 碼時，QR Code Reader Basic 會輸出原始字串。若選擇 GS1 QR 碼，QR Code Reader Basic 則會將字串解碼為符合 GS1 標準的格式。
逾時#
對於對時間要求嚴格的應用，您可以設定超時時間。當處理時間不固定或無法預測時（例如，當影像中未包含 QR 碼時），設定超時時間便能發揮作用。一旦超過指定的超時時間，偵測程序便會停止，並轉而處理下一張影像。
Basler 建議將逾時時間設定得比所需的時限稍低一點。這是因為 vTool 不會立即停止偵測程序。因此，請將逾時設定為所需時限的 70–80%。
設定 vTool#
要設定「QR Code Reader 」基本版 vTool：
- 在vTool「設定」區域的「配方管理」窗格中，按一下「開啟設定」，或雙擊該 vTool。
此時將開啟「QR Code Reader Basic」對話方塊。 - 在「資料碼類型」下拉式清單中，選取所需的資料碼類型。
- 在「QR 碼數量」區域中，請選擇您要偵測的 QR 碼數量。
- 在 Timeout 區域中，指定您是否希望偵測在經過特定時間後結束。如果您想要指定逾時，請清除 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。
您可以在引腳資料檢視中查看「QR Code Reader Basic」的結果。在此處，您可以選擇要顯示哪些輸出。
QR Code Reader PRO#
您可以在一張圖片中偵測到不限數量的 QR 碼。若將偵測數量限制在圖片中預期的 QR 碼數量內，可能會節省處理時間。
偵測準則#
要讓 QR 碼能夠被偵測並解碼，必須符合以下條件：
- 程式碼結構： QR Code Reader Pro 支援 1 至 40 個符號的標準範圍，對應的模組尺寸為 21 x 21 至 177 x 177。
- 模組尺寸：在「增強 偵測模式」下，各模組的邊長必須介於 2 至 100 像素之間。在「最大 偵測模式」下，各模組的邊長必須介於 1 至 100 像素之間。
- Gaps between modules: 允許模組之間存在較大的間隙。
- 定位圖案數量：此 QR 碼包含 3 個定位圖案。必須能看見其中 2 個，才能讀取該 QR 碼。
- 極性：QR 碼的圖案可以是深色底上印淺色，或是淺色底上印深色，亦或是兩者的混合。
- 鏡像處理：系統可偵測垂直、水平或兩者皆有的鏡像 QR 碼。
- 對比度：影像中明亮部分與暗部之間的差異必須至少為 10 個灰階值。
- 可讀性：可偵測到存在視覺瑕疵（例如反光或污漬）以及解析度或對比度偏低的條碼。
資料代碼類型#
您可以使用 Data Code Type 下拉式清單來選取您想要尋找的資料碼類型：
- QR 碼
- GS1 條碼
- 微型 QR 碼
QR 碼與 GS1 QR 碼的符號結構完全相同，但其編碼方案卻有所不同。
在解碼標準 QR 碼時，QR Code Reader Pro 會輸出原始字串。若選擇 GS1 QR 碼，QR Code Reader Pro 則會將字串解碼為符合 GS1 標準的格式。
偵測模式#
標準：這是一種快速檢測模式，但無法偵測到變形或低解析度的資料碼。
增強模式：在此偵測模式下，QR Code Reader Pro 對 QR 碼的品質具有較高的容錯度。這表示即使 QR 碼未完全符合所有偵測標準，仍可被偵測到。啟用此選項會使偵測過程變慢。
最大值：在此檢測模式下，除了具備「增強型檢測模式」的優勢外，「QR Code Reader Pro」還能接受更小的模組尺寸，並在檢測較小模組時表現得更為穩健。這意味著能夠檢測到更多不符合所有檢測標準的條碼。啟用此選項會使檢測過程變慢。
逾時#
對於對時間要求嚴格的應用，您可以設定超時時間。當處理時間不固定或無法預測時（例如，當影像中未包含 QR 碼時），設定超時時間便能發揮作用。一旦超過指定的超時時間，偵測程序便會停止，並轉而處理下一張影像。
Basler 建議將逾時時間設定得比所需的時限稍低一點。這是因為 vTool 不會立即停止偵測程序。因此，請將逾時設定為所需時限的 70–80%。
設定 vTool#
要設定「QR Code Reader Pro」vTool：
- 在vTool「設定」區域的「配方管理」窗格中，按一下「開啟設定」，或雙擊該 vTool。
「QR Code Reader Pro」對話方塊隨即開啟。 - 在「資料碼類型」下拉式清單中，選取所需的資料碼類型
- 在「QR 碼數量」區域中，請選擇您要偵測的 QR 碼數量。若無法確定要偵測的 QR 碼最大數量，請選擇「無限制」。
- 在 Detection Mode 區域中，選取所需的偵測模式。
- 在 Polarity 下拉式清單中，選取適合您應用程式的選項。
如果應用程式中的條碼具有特定極性，請相應地選取設定。如果影像中條碼的極性未知，或出現多個具有不同極性的條碼，請選取 Any。 - 在 Timeout 區域中，指定您是否希望偵測在經過特定時間後結束。如果您想要指定逾時，請清除 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。
您可以在引腳資料檢視中查看「QR Code Reader Pro」的結果。在此處，您可以選擇要顯示哪些輸出。
Inputs#
Image#
可直接從「相機」vTool 或任何能輸出影像的 vTool（例如「Image Format Converter 」vTool）接收影像。
- 資料類型：圖片
- 影像格式：8 位元單色或彩色影像。彩色影像會在系統內部轉換為單色影像。
Roi#
可接受來自「ROI Creator vTool 」或任何其他能輸出區域或矩形的 vTool 所提供的感興趣區域。多個矩形或區域會在內部合併，形成單一的感興趣區域。Starter 版本僅接受 RectangleF。
- 資料類型：RectangleF、RectangleF 陣列、Region、Region 陣列
Outputs#
Texts#
回傳以 QR 碼編碼的文字字串。
- 資料類型：字串陣列
Regions#
針對每個找到的 QR 碼，回傳一個區域。該區域呈矩形。此區域可用於視覺化呈現，或作為後續特徵擷取之用。
- 資料類型：區域陣列
OrientedBoxes_px#
針對每個找到的 QR 碼，回傳一個具有方向的包圍框。
- 資料類型：RectangleF 陣列
相關 vTool#
典型前置元件#
典型後續元件#
- Region Feature Extraction vTool
讓您能夠確定所偵測到的 QR 碼的中心點、大小及方向。