콘텐츠로 바로 가기
STAGING SERVER
DEVELOPMENT SERVER

Aztec Code Reader vTool#

Aztec Code Reader vTool을 사용하면 이미지 내의 Aztec 코드를 탐지하고 이를 해독할 수 있습니다.

Aztec Code Reader 는 이미지 입력 핀을 통해 수신된 이미지에서 아즈텍 코드를 감지하고 해독할 수 있습니다. 해독 결과는 영역 및 텍스트 출력 핀을 통해 출력됩니다.

‘region’ 출력값에는 아즈텍 코드가 발견된 영역이 포함됩니다. ‘text’ 출력값은 아즈텍 코드로 인코딩된 텍스트 문자열입니다.

탐지 전에 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 vTool

Aztec Code Reader 버전#

Aztec Code Reader 에는 두 가지 버전이 있습니다. 다음 표에는 두 버전의 차이점이 나와 있습니다. 표의 표제에서 원하는 버전을 클릭하면 이 주제의 해당 섹션으로 바로 이동할 수 있습니다.

Basic Pro
아즈텍 코드를 몇 개나 찾아낼 수 있나요? 3 무제한
GS1 아즈텍 코드를 인식할 수 있나요? 예 예
검색에 대한 타임아웃(timeout)을 지정할 수 있습니까? 예 예
어떤 모듈 크기(module sizes)가 허용됩니까? 6~20픽셀 사이의 변 길이 1~100픽셀 사이의 변 길이
모듈 사이의 간격(gaps)이 허용됩니까? 예, 작은 간격 예, 큰 간격
파인더 패턴의 허용 오차를 좀 더 넓혀 주실 수 있나요? 아니요 예
어두운 배경에 밝은 색으로 표시된 아즈텍 코드를 식별할 수 있나요? 아니요
전처리가 필요합니다.
예
거울에 비친 아즈텍 문자를 알아볼 수 있나요? 예 예
향상된(Enhanced) 검출 모드를 사용할 수 있습니까? 아니요 예
최대(Maximum) 검출 모드를 사용할 수 있습니까? 아니요 예
Roi 입력 핀에 유효한 데이터 형식 RectangleF, RectangleF Array, Region, Region Array RectangleF, RectangleF Array, Region, Region Array
라이선스 구매 바슬러 웹사이트 방문하기 바슬러 웹사이트 방문하기

작동 방식#

Aztec Code Reader 의 버전에 따라, 이미지 내에서 최대 3개 또는 무제한의 아즈텍 코드를 감지할 수 있습니다.

특정 시간이 지나면 감지를 종료하도록 타임아웃을 지정할 수 있습니다. 이미지에 아즈텍 코드가 단 하나만 포함되어 있다는 것을 알고 있다면, ‘ Aztec Code Reader ’을 하나의 코드만 검색하도록 설정하면 처리 시간을 단축할 수 있습니다.

일반적인 사용 사례#

  • 아즈텍 코드 읽기: 이 경우, 디코딩된 문자열을 출력하려면 Texts 출력 핀을 연결하기만 하면 됩니다.
  • 아즈텍 코드의 위치 파악: 후속 처리를 위해 Regions 출력 핀에서 반환된 아즈텍 코드의 위치와 크기를 활용하십시오.

Aztec Code Reader 기본#

한 이미지에서 최대 세 개의 아즈텍 코드를 감지할 수 있습니다. 감지 개수를 해당 이미지에 포함될 것으로 예상되는 코드 수로 제한하면 처리 시간을 단축할 수 있습니다.

감지 기준#

아즈텍 코드를 탐지하고 해독하려면, 해당 코드가 다음 기준을 충족해야 합니다:

  • 코드 구조: Aztec Code Reader Basic은 표준 Aztec 코드 구조(행과 열이 11~151개인 행렬)를 지원합니다.
  • 모듈 크기: 개별 모듈의 한 변 길이는 6~20 픽셀 사이여야 합니다.
  • 모듈 간 간격: 모듈 간의 작은 간격은 허용됩니다.
  • 파인더 패턴 허용 오차: 파인더 패턴의 모든 고리가 이미지에서 선명하게 보여야 합니다.
  • 극성: 아즈텍 코드는 반드시 ‘어두운 색이 밝은 배경에 있는’ 패턴이어야 합니다. ‘밝은 색이 어두운 배경에 있는’ 패턴의 경우, 예를 들어 Gray Value Transformer vTool를 사용하는 등의 방법으로 입력 이미지를 반전시켜야 합니다.
  • 대칭 처리: 수직, 수평 또는 양방향으로 대칭 처리된 아즈텍 코드를 감지할 수 있습니다.
  • 가독성: 코드에는 반사나 번짐과 같은 시각적 결함이 없어야 하며, 충분한 해상도를 갖추어야 합니다.

데이터 코드 유형#

Data Code Type 드롭다운 목록을 사용하여 찾으려는 데이터 코드 타입을 선택할 수 있습니다.

  • 아즈텍 법전
  • GS1 아즈텍 코드

아즈텍 코드와 GS1 아즈텍 코드의 기호 구조는 동일하지만, 코딩 방식은 다릅니다.

표준 아즈텍(Aztec) 코드를 해독할 때, Aztec Code Reader Basic은 원시 문자열을 출력합니다. GS1 아즈텍 코드를 선택하면, Aztec Code Reader Basic은 GS1 표준을 준수하는 형식으로 문자열을 해독합니다.

Timeout#

시간에 민감한 응용 프로그램의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 처리 시간이 들쑥날쑥하거나 예측할 수 없는 경우, 예를 들어 이미지에 아즈텍 코드가 포함되어 있지 않은 경우에 유용합니다. 지정된 타임아웃 시간이 초과되면 감지 프로세스가 중단되고 다음 이미지로 넘어갑니다.

Basler에서는 타임아웃을 원하는 제한 시간보다 약간 낮게 설정할 것을 권장합니다. vTool이 감지 프로세스를 즉시 중단하지 않기 때문입니다. 따라서 타임아웃을 원하는 제한 시간의 70~80%로 설정하십시오.

vTool 구성#

Aztec Code Reader Basic vTool을 구성하려면:

Aztec Code Reader vTool 기본 설정

  1. vTool 설정 영역의 ‘레시피 관리’ 창에서 ‘설정 열기’를 클릭하거나 vTool을 두 번 클릭합니다.
    ‘Aztec Code Reader Basic’ 대화 상자가 열립니다.
  2. '데이터 코드 유형 ' 드롭다운 목록에서 원하는 데이터 코드 유형을 선택하십시오.
  3. “아즈텍 코드 수” 영역에서 감지할 아즈텍 코드의 개수를 선택하십시오.
  4. Timeout 영역에서 일정 시간이 경과한 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 체크 박스를 해제하고 입력 필드에 원하는 타임아웃을 입력합니다.

Aztec Code Reader Basic의 결과는 핀 데이터 보기에서 확인할 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.

Aztec Code Reader Pro#

이미지 내에서 아즈텍 코드를 무제한으로 탐지할 수 있습니다. 탐지 수를 이미지에 포함될 것으로 예상되는 코드 개수로 제한하면 처리 시간을 단축할 수 있습니다.

감지 기준#

아즈텍 코드를 탐지하고 해독하려면, 해당 코드가 다음 기준을 충족해야 합니다:

  • 코드 구조: Aztec Code Reader Pro는 표준 Aztec 코드 구조(행과 열이 11~151개인 행렬)를 지원합니다.
  • Module size: Enhanced detection mode에서는 개별 모듈의 변 길이가 2~100픽셀 사이여야 합니다. Maximum detection mode에서는 개별 모듈의 변 길이가 1~100픽셀 사이여야 합니다.
  • Gaps between modules: 모듈 사이의 간격이 넓어도 허용됩니다.
  • 파인더 패턴 허용 오차: 파인더 패턴의 고리가 이미지에서 적어도 부분적으로라도 보여야 합니다.
  • 극성: 아즈텍 코드는 밝은 바탕에 어두운 무늬, 어두운 바탕에 밝은 무늬, 또는 이 둘이 혼합된 형태일 수 있습니다.
  • 대칭 처리: 수직, 수평 또는 양방향으로 대칭 처리된 아즈텍 코드를 감지할 수 있습니다.
  • 가독성: 반사나 번짐과 같은 시각적 결함이 있거나 해상도가 낮은 코드를 감지할 수 있습니다.

데이터 코드 유형#

Data Code Type 드롭다운 목록을 사용하여 찾으려는 데이터 코드 타입을 선택할 수 있습니다.

  • 아즈텍 법전
  • GS1 아즈텍 코드

아즈텍 코드와 GS1 아즈텍 코드의 기호 구조는 동일하지만, 코딩 방식은 다릅니다.

표준 아즈텍(Aztec) 코드를 디코딩할 때, ‘ Aztec Code Reader Pro’는 원시 문자열을 출력합니다. GS1 아즈텍 코드를 선택하면, ‘ Aztec Code Reader Pro’는 GS1 표준을 준수하는 형식으로 문자열을 디코딩합니다.

감지 모드#

Standard: 빠른 감지 모드이지만 변형되었거나 저해상도의 데이터 코드는 감지되지 않습니다.

향상됨: 이 감지 모드에서 ‘ Aztec Code Reader Pro’는 아즈텍 코드의 품질에 대해 더 관대하게 처리합니다. 즉, 모든 감지 기준을 충족하지 않는 코드도 감지할 수 있습니다. 이 옵션을 활성화하면 감지 속도가 느려집니다.

최대: 이 감지 모드에서는 ‘향상된 감지’ 모드의 장점 외에도, ‘ Aztec Code Reader Pro’가 더 작은 크기의 모듈을 인식할 수 있으며, 소형 모듈 감지 시 더 뛰어난 안정성을 보여줍니다. 즉, 모든 감지 기준을 충족하지 않는 코드라도 더 많이 감지할 수 있습니다. 이 옵션을 활성화하면 감지 속도가 느려집니다.

Timeout#

시간에 민감한 응용 프로그램의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 처리 시간이 들쑥날쑥하거나 예측할 수 없는 경우, 예를 들어 이미지에 아즈텍 코드가 포함되어 있지 않은 경우에 유용합니다. 지정된 타임아웃 시간이 초과되면 감지 프로세스가 중단되고 다음 이미지로 넘어갑니다.

Basler에서는 타임아웃을 원하는 제한 시간보다 약간 낮게 설정할 것을 권장합니다. vTool이 감지 프로세스를 즉시 중단하지 않기 때문입니다. 따라서 타임아웃을 원하는 제한 시간의 70~80%로 설정하십시오.

vTool 구성#

Aztec Code Reader Pro vTool을 구성하려면:

Aztec Code Reader Pro vTool 설정

  1. vTool 설정 영역의 ‘레시피 관리’ 창에서 ‘설정 열기’를 클릭하거나 vTool을 두 번 클릭합니다.
    ‘Aztec Code Reader Pro’ 대화 상자가 열립니다.
  2. '데이터 코드 유형 ' 드롭다운 목록에서 원하는 데이터 코드 유형을 선택하십시오.
  3. “아즈텍 코드 수” 영역에서 감지할 아즈텍 코드의 개수를 선택하십시오. 감지할 코드의 최대 개수를 알 수 없는 경우 “무제한”을 선택하십시오.
  4. Detection Mode 영역에서 원하는 감지 모드를 선택합니다.
  5. Polarity 드롭다운 목록에서 애플리케이션에 적합한 옵션을 선택합니다.
    애플리케이션의 코드에 특정 극성이 있는 경우 그에 따라 설정을 선택합니다. 이미지 내 코드의 극성을 알 수 없거나 극성이 서로 다른 여러 개의 코드가 나타나는 경우 Any를 선택합니다.
  6. Timeout 영역에서 일정 시간이 경과한 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 체크 박스를 해제하고 입력 필드에 원하는 타임아웃을 입력합니다.

Aztec Code Reader Pro의 결과는 핀 데이터 보기에서 확인할 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.

Inputs#

Image#

Camera vTool 또는 이미지를 출력하는 vTool(예: Image Format Converter vTool)로부터 직접 이미지를 수신합니다.

  • Data type: Image
  • 이미지 형식: 8비트 모노 또는 컬러 이미지. 컬러 이미지는 내부적으로 모노 이미지로 변환됩니다.

Roi#

ROI Creator vTool 이나 영역 또는 사각형을 출력하는 다른 vTool에서 지정한 관심 영역을 받아들입니다. 여러 사각형이나 영역은 내부적으로 병합되어 하나의 관심 영역을 형성합니다.

  • 데이터 유형: RectangleF, RectangleF Array, Region, Region Array

Outputs#

Texts#

아즈텍 코드로 인코딩된 텍스트 문자열을 반환합니다.

  • 데이터 유형: String Array

Regions#

발견된 각 아즈텍 코드에 대해 하나의 영역을 반환합니다. 이 영역은 직사각형 형태입니다. 이 영역은 시각화 용도로 사용하거나 후속 특징 추출에 활용할 수 있습니다.

  • Data type: Region Array

OrientedBoxes_px#

검출된 각 아즈텍 코드에 대해 방향이 지정된 바운딩 박스를 반환합니다.

  • Data type: RectangleF Array

일반적인 선행 vTool#

일반적인 후행 vTool#