Aztec Code Reader vTool#
Aztec Code Reader는 Image 입력 핀을 통해 수신한 이미지에서 Aztec 코드를 감지하고 디코딩할 수 있습니다. 결과는 Regions 및 Texts 출력 핀을 통해 출력됩니다.
영역 출력에는 Aztec 코드가 발견된 영역이 포함됩니다. 텍스트 출력은 Aztec 코드로 인코딩된 텍스트 문자열입니다.
감지 전에 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는 두 가지 버전으로 제공됩니다. 다음 표는 버전 간의 차이점을 보여줍니다. 이 항목의 관련 섹션으로 바로 이동하려면 표 제목의 버전을 클릭하세요.
| Basic | Pro | |
|---|---|---|
| 몇 개의 Aztec 코드를 감지할 수 있습니까? | 3 | 무제한 |
| GS1 Aztec 코드를 감지할 수 있습니까? | Yes | Yes |
| 감지에 대한 시간 초과(timeout)를 지정할 수 있나요? | Yes | Yes |
| 어떤 모듈 크기가 허용되나요? | 변 길이는 6~20픽셀 사이입니다. | 1~100픽셀의 한 변 길이 |
| 모듈 간 간격이 허용되나요? | 예, 작은 간격 | 예, 큰 간격 |
| Finder pattern의 tolerance을 높일 수 있습니까? | No | Yes |
| light-on-dark Aztec Code를 감지할 수 있습니까? | 아니요 전처리 단계가 필요합니다. | Yes |
| mirrored Aztec Code를 감지할 수 있습니까? | Yes | Yes |
| Enhanced 감지 모드를 사용할 수 있습니까? | No | Yes |
| Maximum 감지 모드를 사용할 수 있습니까? | No | Yes |
| Roi 입력 핀에 유효한 데이터 형식 | RectangleF, RectangleF Array, Region, Region Array | RectangleF, RectangleF Array, Region, Region Array |
| 라이선스 구매 | Basler 웹사이트 방문 | Basler 웹사이트 방문 |
작동 원리#
Aztec Code Reader의 버전에 따라 이미지에서 최대 3개 또는 무제한 개수의 Aztec Code를 감지할 수 있습니다.
정해진 시간이 지난 후 감지가 종료되도록 타임아웃을 지정할 수 있습니다. 이미지에 Aztec Code가 하나만 포함되어 있는 것을 아는 경우, Aztec Code Reader가 하나의 코드만 찾도록 구성하면 처리 시간을 절약할 수 있습니다.
일반적인 사용 사례#
- Aztec Code 읽기: 이 경우 디코딩된 문자열을 출력하려면 Texts output pin만 연결하면 됩니다.
- Aztec Code의 위치 결정: 후속 처리를 위해 Regions output pin에서 반환되는 Aztec Code의 위치와 크기를 사용합니다.
Aztec Code Reader Basic#
이미지에서 최대 3개의 Aztec Code를 감지할 수 있습니다. 이미지에 예상되는 코드 수로 개수를 제한하면 처리 시간을 절약할 수 있습니다.
검출 기준#
Aztec Code가 감지 및 디코딩되려면 다음 기준을 충족해야 합니다.
- 코드 구조: Aztec Code Reader Basic은 표준 Aztec Code 구조(11~151개의 행과 열로 이루어진 매트릭스)를 지원합니다.
- 모듈 크기: 개별 모듈의 변 길이는 6~20픽셀 사이여야 합니다.
- 모듈 간 간격: 모듈 간의 작은 간격이 허용됩니다.
- Finder pattern tolerance: 이미지에서 finder pattern의 모든 링이 선명하게 보여야 합니다.
- 극성: Aztec Code는 dark-on-light 패턴이어야 합니다. light-on-light 패턴의 경우, 예를 들어 Gray Value Transformer vTool을 사용하여 입력 이미지를 반전시키는 전처리 단계를 실행하세요.
- 미러링: 수직, 수호 또는 양방향으로 미러링된 Aztec Code를 감지할 수 있습니다.
- 가독성: 코드는 반사나 얼룩 등의 시각적 결함이 없어야 하며 충분한 해상도를 가져야 합니다.
데이터 코드 유형#
Data Code Type 드롭다운 목록에서 찾으려는 데이터 코드 유형을 선택할 수 있습니다.
- Aztec Codes
- GS1 Aztec Codes
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을 구성하려면:

- vTool Settings 영역의 Recipe Management 창에서 Open Settings를 클릭하거나 vTool을 더블 클릭합니다.
이면 Aztec Code Reader Basic 대화 상자가 열립니다. - Data Code Type 드롭다운 목록에서 원하는 데이터 코드 유형을 선택합니다.
- Number of Aztec Codes 영역에서 감지할 Aztec Code 개수를 선택합니다.
- Timeout 영역에서 특정 시간이 지난 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 확인란의 선택을 해제하고 입력란에 원하는 타임아웃을 입력합니다.
pin data view에서 Aztec Code Reader Basic의 결과를 볼 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.
Aztec Code Reader Pro#
이미지에서 무제한 개수의 Aztec Code를 검출할 수 있습니다. 검출할 코드의 예상 개수만큼만 제한하면 처리 시간을 단축할 수 있습니다.
검출 기준#
Aztec Code가 감지 및 디코딩되려면 다음 기준을 충족해야 합니다.
- Code structure: Aztec Code Reader PRO는 표준 Aztec Code 구조(11~151개의 행과 열로 이루어진 매트릭스)를 지원합니다.
- Module size: Enhanced detection mode에서는 개별 모듈의 변 길이가 2~100픽셀 사이여야 합니다. Maximum detection mode에서는 개별 모듈의 변 길이가 1~100픽셀 사이여야 합니다.
- Gaps between modules: 모듈 사이의 간격이 넓어도 허용됩니다.
- Finder pattern tolerance: 파인더 패턴의 링은 이미지에서 최소한 일부분이라도 보여야 합니다.
- Polarity: Aztec Code는 밝은 배경의 어두운 패턴, 어두운 배경의 밝은 패턴 또는 이들이 혼합된 형태로 구성될 수 있습니다.
- 미러링: 수직, 수호 또는 양방향으로 미러링된 Aztec Code를 감지할 수 있습니다.
- Legibility: 반사나 얼룩 등의 시각적 결함이 있거나 해상도가 낮은 코드도 감지할 수 있습니다.
데이터 코드 유형#
Data Code Type 드롭다운 목록에서 찾으려는 데이터 코드 유형을 선택할 수 있습니다.
- Aztec Codes
- GS1 Aztec Codes
Aztec Code와 GS1 Aztec Code의 심볼 구조는 동일하지만 코딩 방식은 다릅니다.
표준 Aztec Code를 디코딩할 때 Aztec Code Reader PRO는 원본 문자열을 출력합니다. GS1 Aztec Code를 선택하면 Aztec Code Reader PRO는 GS1 표준을 준수하는 형식으로 문자열을 디코딩합니다.
검출 모드#
Standard: 빠른 감지 모드이지만 변형되었거나 저해상도의 데이터 코드는 감지되지 않습니다.
Enhanced: 이 검출 모드에서는 Aztec Code Reader PRO가 Aztec Code의 Quality에 대해 더 관대하게 작동합니다. 즉, 모든 검출 조건을 충족하지 않는 코드도 검출할 수 있습니다. 이 옵션을 활성화하면 검출 프로세스가 느려집니다.
Maximum: 이 검출 모드에서는 Enhanced 검출 모드의 장점 외에도 더 작은 모듈 크기가 허용되며 더 작은 모듈 검출 시 견고성이 향상됩니다. 즉, 모든 검출 조건을 충족하지 않는 더 많은 코드를 검출할 수 있습니다. 이 옵션을 활성화하면 검출 프로세스가 느려집니다.
타임아웃#
시간이 중요한 애플리케이션의 경우 타임아웃을 지정할 수 있습니다. 예를 들어 이미지에 Aztec Code가 포함되어 있지 않아 처리 시간이 다양하거나 예상할 수 없는 경우 타임아웃이 유용합니다. 지정된 타임아웃을 초과하면 감지 프로세스가 중지되고 다음 이미지로 이동합니다.
Basler는 원하는 시간 제한보다 약간 낮게 타임아웃을 설정할 것을 권장합니다. 이는 vTool이 감지 프로세스를 즉시 중단하지 않기 때문입니다. 따라서 타임아웃을 원하는 시간 제한의 70~80%로 설정하세요.
vTool 설정하기#
Aztec Code Reader PRO vTool을 설정하려면:

- vTool Settings 영역의 Recipe Management 창에서 Open Settings를 클릭하거나 vTool을 더블 클릭합니다.
Aztec Code Reader PRO 대화상자가 열립니다. - Data Code Type 드롭다운 목록에서 원하는 데이터 코드 유형을 선택합니다.
- Number of Aztec Codes 영역에서 검출할 Aztec Code의 개수를 선택합니다. 검출할 최대 개수를 알 수 없는 경우 Unlimited를 선택합니다.
- Detection Mode 영역에서 원하는 감지 모드를 선택합니다.
- Polarity 드롭다운 목록에서 애플리케이션에 적합한 옵션을 선택합니다.
애플리케이션의 코드가 특정 극성을 가지고 있는 경우 그에 따라 설정을 선택합니다. 이미지 내 코드의 극성을 알 수 없거나 극성이 다른 여러 코드가 발생하는 경우 Any를 선택합니다. - Timeout 영역에서 특정 시간이 지난 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 확인란의 선택을 해제하고 입력란에 원하는 타임아웃을 입력합니다.
Aztec Code Reader PRO의 결과는 pin data view에서 확인할 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.
입력#
이미지#
Camera vTool 또는 이미지를 출력하는 vTool(예: Image Format Converter vTool)에서 직접 이미지를 허용합니다.
- 데이터 형식: 이미지
- Image format: 8비트 모노 또는 컬러 이미지. 컬러 이미지는 내부적으로 모노 이미지로 변환됩니다.
ROI#
ROI Creator vTool 또는 영역이나 직사각형을 출력하는 기타 vTool에서 ROI를 허용합니다. 여러 직사각형 또는 영역이 내부적으로 병합되어 단일 ROI를 형성합니다.
- Data type: RectangleF, RectangleF Array, Region, Region Array
출력#
텍스트#
Aztec Code에 인코딩된 텍스트 문자열을 반환합니다.
- 데이터 타입: String Array
Regions#
찾은 각 Aztec Code에 대한 영역을 반환합니다. 영역은 사각형 모양이며 시각화 용도 또는 후속 Region Feature Extraction에 사용할 수 있습니다.
- 데이터 타입: Region Array
OrientedBoxes_px#
찾은 각 Aztec Code에 대한 방향이 지정된 경계 상자를 반환합니다.
- Data type: RectangleF Array
관련 vTools#
일반적인 선행 vTools#
Typical Successors#
- Region Feature Extraction vTool
찾은 Aztec Code의 중심, 크기, 방향을 확인할 수 있습니다.