Aztec Code Reader vTool#

Aztec Code Reader vTool 可讓您偵測影像中的 Aztec 碼並將其解碼。

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

「區域」輸出欄位包含發現 Aztec 碼的區域。文字輸出欄位則是經由 Aztec 碼編碼後的文字字串。

若您使用 ROI Creator vTool 在檢測前指定感興趣區域（ROI），Aztec Code Reader 會透過其Roi輸入引腳接收 ROI 資料。此舉可縮小Aztec Code Reader 搜尋條碼的影像範圍，有助於排除錯誤候選條碼。此外，這還能使處理速度更快且更穩健。

Aztec Code Reader vTool 可購買單一授權（Basic 或 Pro），或作為 Code Reader Bundle 授權方案的一部分。如欲購買授權，請造訪Basler 網站。

Aztec Code Reader 版本#

Aztec Code Reader 共有兩個版本。下表列出了各版本之間的差異。請點擊表格標題中的版本名稱，即可直接跳轉至本主題中的相關段落。

運作原理#

視「Aztec Code Reader 」的版本而定，您可以在一張圖片中偵測到最多三個或不限數量的阿茲特克碼。

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

常見應用情境#

• 解讀阿茲特克密碼：在此情況下，您只需將「Texts」輸出腳位連接起來，即可輸出解碼後的字串。
• 確定 Aztec 條碼的位置：利用Regions輸出針腳所傳回的 Aztec 條碼位置與尺寸，進行後續處理。

Aztec Code Reader 基礎#

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

偵測準則#

阿茲特克編碼若要被偵測並解碼，必須符合以下條件：

• 編碼結構： Aztec Code Reader Basic 支援標準的 Aztec 編碼結構（行數與列數介於 11 至 151 之間的矩陣）。
• 模組尺寸：個別模組的每邊長度必須介於 6 至 20 像素之間。
• 模組之間的間隙：模組之間允許留有小間隙。
• 定位圖案容差：影像中必須能清楚看見定位圖案的所有環狀結構。
• 極性：阿茲特克碼必須採用「深色底上淺色圖案」的模式。若為「淺色底上深色圖案」的模式，請執行預處理步驟以反轉輸入影像，例如使用 Gray Value Transformer vTool。
• 鏡像處理：可偵測到垂直、水平或同時進行垂直與水平鏡像處理的阿茲特克密碼。
• 可讀性：Code 必須沒有視覺瑕疵（例如沒有反光或汙點），並且必須具備足夠的解析度。

資料代碼類型#

您可以使用 Data Code Type 下拉式清單來選取您想要尋找的資料碼類型：

• 阿茲特克法典
• GS1 阿茲特克碼

Aztec 條碼與 GS1 Aztec 條碼的符號結構完全相同，但其編碼方案卻有所不同。

在解碼標準 Aztec 條碼時，Aztec Code Reader Basic 會輸出原始字串。若選擇 GS1 Aztec 條碼，Aztec Code Reader Basic 則會將字串解碼為符合 GS1 標準的格式。

逾時#

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

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

設定 vTool#

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

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

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

Aztec Code Reader Pro#

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

偵測準則#

阿茲特克編碼若要被偵測並解碼，必須符合以下條件：

• 條碼結構： Aztec Code Reader Pro 支援標準的 Aztec 條碼結構（行數與列數介於 11 至 151 之間的矩陣）。
• 模組尺寸：在「增強 偵測模式」下，各模組的邊長必須介於 2 至 100 像素之間。在「最大 偵測模式」下，各模組的邊長必須介於 1 至 100 像素之間。
• 模組之間的間距：模組之間允許有較大的間距。
• 尋星圖樣容差：尋星圖樣的同心環在影像中必須至少部分可見。
• 極性：阿茲特克圖案可以是深色底配淺色圖案、淺色底配深色圖案，或是兩者的混合。
• 鏡像處理：可偵測到垂直、水平或同時進行垂直與水平鏡像處理的阿茲特克密碼。
• 可讀性：可偵測到存在視覺瑕疵（例如反光或污漬）以及解析度較低的條碼。

資料代碼類型#

您可以使用 Data Code Type 下拉式清單來選取您想要尋找的資料碼類型：

• 阿茲特克法典
• GS1 阿茲特克碼

Aztec 條碼與 GS1 Aztec 條碼的符號結構完全相同，但其編碼方案卻有所不同。

在解碼標準 Aztec 條碼時，Aztec Code Reader Pro 會輸出原始字串。若選擇 GS1 Aztec 條碼，Aztec Code Reader Pro 則會將字串解碼為符合 GS1 標準的格式。

偵測模式#

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

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

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

逾時#

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

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

設定 vTool#

要設定「Aztec Code Reader Pro」vTool：

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

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

Inputs#

Image#

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

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

Roi#

可接受來自「ROI Creator vTool 」或任何其他能輸出區域或矩形的 vTool 所提供的感興趣區域。多個矩形或區域會在內部合併，以形成單一的感興趣區域。

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

Outputs#

Texts#

回傳以阿茲特克編碼編碼的文字字串。

• 資料類型：字串陣列

Regions#

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

• 資料類型：區域陣列

OrientedBoxes_px#

針對每個找到的阿茲特克碼，回傳一個具有方向的包圍框。

• 資料類型：RectangleF 陣列

相關 vTool#

典型前置元件#

• 攝影機vTool
• Image Format Converter vTool

典型後續元件#

• Region Feature Extraction vTool
  讓您能夠確定所找到的 Aztec 條碼的中心點、大小及方向。