Aztec Code Reader vTool#

使用 Aztec Code Reader vTool，您可以在影像中偵測 Aztec code 並進行解碼。

Aztec Code Reader 可以偵測並解碼透過 Image 輸入引腳接收到的影像中的 Aztec code。它透過 Regions 和 Texts 輸出引腳輸出結果。

區域輸出包含找到 Aztec code 的區域。文字輸出則是 Aztec code 編碼的文字字串。

如果您在偵測前使用 ROI Creator vTool 來指定興趣區域，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 Code。

您可以指定 timeout 以在一定時間後結束檢測。如果您知道影像中只包含一個 Aztec code，將 Aztec Code Reader 設定為僅尋找一個 Code 可以節省處理時間。

常見使用案例#

• 讀取 Aztec Code：在這種情況下，您只需要連接 Texts 輸出接腳即可輸出解碼後的字串。
• 確定 Aztec Code 的 positions：使用由 Regions 輸出接腳傳回的 Aztec Code 位置和大小進行後續處理。

Aztec Code Reader Basic#

您可以在影像中檢測最多三個 Aztec Code。將數量限制為影像中預期的 Code 數量可以節省處理時間。

檢測條件#

為了檢測和解碼 Aztec Code，它們必須符合以下條件：

• Code 結構：Aztec Code Reader Basic 支援標準的 Aztec Code 結構（具有 11 到 151 行和列的矩陣）。
• Module size：個別模組的邊長必須介於 6 到 20 像素之間。
• 模組間的間隙：允許模組之間存在小間隙。
• 定位圖案容差：定位圖案的所有環都必須在影像中清晰可見。
• 極性：Aztec Code 必須是深色背景上的淺色圖案或淺色背景上的深色圖案。對於深色背景上的淺色圖案，請執行預先處理步驟以反轉輸入影像，例如使用 Gray Value Transformer vTool。
• Mirroring: 可以偵測經過垂直、水平或同時進行鏡射的 Aztec Code。
• Legibility: Code 必須沒有視覺瑕疵（例如無反光或污漬），且必須具備足夠的解析度。

資料代碼類型#

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

• Aztec Code
• GS1 Aztec Code

Aztec Code 與 GS1 Aztec Code 的符號結構相同，但其編碼機制不同。

在解碼標準 Aztec Code 時，Aztec Code Reader Basic 會輸出原始字串。如果您選取 GS1 Aztec Code，Aztec Code Reader Basic 會以符合 GS1 標準的格式解碼字串。

逾時#

針對時間緊迫的應用，您可以指定逾時。當處理時間會變動或無法預測時（例如影像中未包含 Aztec Code），逾時設定將能發揮作用。一旦超過指定的逾時時間，偵測程序便會停止並移至下一張影像。

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

設定 vTool#

若要設定 Aztec Code Reader Basic vTool：

1. 在 vTool Settings 區域的 Recipe Management 窗格中，按一下 Open Settings 或按兩下該 vTool。
   隨即會開啟 Aztec Code Reader Basic 對話方塊。
2. 在 Data Code Type 下拉式清單中，選取所需的 Data Code 類型。
3. 在 Number of Aztec Codes 區域中，選取您要偵測的 Aztec Code 數量。
4. 在 Timeout 區域中，指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時，請取消勾選 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

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

Aztec Code Reader Pro#

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

檢測條件#

為了檢測和解碼 Aztec Code，它們必須符合以下條件：

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

資料代碼類型#

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

• Aztec Code
• GS1 Aztec Code

Aztec Code 與 GS1 Aztec Code 的符號結構相同，但其編碼機制不同。

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

檢測模式#

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

Enhanced: 在此偵測模式下，Aztec Code Reader Pro 對 Aztec Code 的 Quality 具有更高的容忍度。這表示即使是不符合所有偵測條件的碼也可以被偵測到。啟用此選項會減慢偵測程序。

Maximum: 在此偵測模式下，除了 Enhanced 偵測模式的優點外，Aztec Code Reader Pro 還能接受更小的模組尺寸，並且在偵測較小模組時更具穩健性。這表示可以偵測到更多不符合所有偵測條件的碼。啟用此選項會減慢偵測程序。

逾時#

針對時間緊迫的應用，您可以指定逾時。當處理時間會變動或無法預測時（例如影像中未包含 Aztec Code），逾時設定將能發揮作用。一旦超過指定的逾時時間，偵測程序便會停止並移至下一張影像。

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

設定 vTool#

若要設定 Aztec Code Reader Pro vTool：

1. 在 Recipe Management 窗格的 vTool Settings 區域中，按一下 Open Settings 或按兩下該 vTool。
   隨即會開啟 Aztec Code Reader Pro 對話方塊。
2. 在 Data Code Type 下拉式清單中，選取所需的 Data Code 類型。
3. 在 Number of Aztec Codes 區域中，選取您要偵測的 Aztec Code 數量。如果不知道要偵測的最大程式碼數量，請選取 Unlimited。
4. 在 Detection Mode 區域中，選取所需的偵測模式。
5. 在 Polarity 下拉式清單中，選取適用於您應用的選項。
   如果應用程式中的碼具有特定的極性，請據此選取設定。如果影像中碼的極性未知，或出現具有不同極性的多個碼，請選取 Any。
6. 在 Timeout 區域中，指定您是否希望偵測在經過一定時間後結束。如果您想要指定逾時，請取消勾選 No timeout 核取方塊，並在輸入欄位中輸入所需的逾時時間。

您可以在 pin data view 中檢視 Aztec Code Reader Pro 的結果。在這裡，您可以選取要顯示的輸出。

Inputs#

Image#

直接接收來自 Camera vTool 或輸出影像之 vTool（例如 Image Format Converter vTool）的影像。

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

ROI#

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

• 資料類型：RectangleF、RectangleF Array、Region、Region Array

Outputs#

文字#

傳回編碼於 Aztec Code 中的文字字串。

• 資料類型：String Array

Regions#

為找到的每個 Aztec Code 傳回一個 Region。該 Region 為矩形形狀。它可以用於視覺化目的或後續的 Region Feature Extraction。

• 資料類型：Region Array

OrientedBoxes_px#

為找到的每個 Aztec Code 傳回一個導向邊界方框 (oriented bounding box)。

• 資料類型：RectangleF 陣列

相關 vTools#

典型前置項目#

• 攝影機vTool
• Image Format Converter vTool

典型後續元件#

• Region Feature Extraction vTool
  允許您決定所找到的 Aztec Code 的中心、大小和方向。