PDF417 Code Reader vTool#

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

PDF417 Code Reader 는 이미지 입력 핀을 통해 수신된 이미지 내의 PDF417 코드를 감지하고 디코딩할 수 있습니다. 결과값은 ‘Regions’ 및 ‘Texts’ 출력 핀을 통해 출력됩니다.

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

탐지 전에 ROI Creator vTool 탐지 전에 관심 영역(ROI)을 지정하면, PDF417 Code Reader 는 Roi 입력 핀을 통해 ROI 데이터를 수신합니다. 이를 통해 PDF417 Code Reader 가 코드를 검색하는 이미지 영역이 줄어들어 잘못된 후보를 제거하는 데 도움이 됩니다. 부수적인 효과로, 처리 속도가 빨라지고 안정성도 향상됩니다.

PDF417 Code Reader vTool은 단일 라이선스(Basic 또는 Pro)로 구매하거나 Code Reader Bundle 라이선스의 일부로 구매할 수 있습니다. 라이선스를 구매하려면 Basler 웹사이트를 방문하십시오.

PDF417 Code Reader 버전#

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

작동 방식#

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

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

일반적인 사용 사례#

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

PDF417 Code Reader Basic#

한 이미지에서 최대 3개의 PDF417 코드를 감지할 수 있습니다. 이미지당 예상되는 코드 수만큼만 감지 대상으로 제한하면 처리 시간을 단축할 수 있습니다.

감지 기준#

PDF417 코드를 감지하고 디코딩하려면 다음 기준을 충족해야 합니다:

• 모듈 크기: 개별 모듈의 한 변 길이는 3~15 픽셀 사이여야 합니다.
• 행 및 열 제한: 자세한 내용은 PDF417 Code Reader 의 ‘버전 ’ 표를 참조하십시오.
• 극성: PDF417 코드는 반드시 ‘밝은 바탕에 어두운 패턴’이어야 합니다. ‘어두운 바탕에 밝은 패턴’인 경우, 예를 들어 다음을 사용하여 입력 이미지를 반전시키는 전처리 단계를 수행하십시오. Gray Value Transformer vTool를 사용하는 방법 등이 있습니다.
• 미러링: 수직, 수평 또는 양방향으로 미러링된 PDF417 코드를 감지할 수 있습니다.
• 가독성: 코드에는 반사나 번짐과 같은 시각적 결함이 없어야 하며, 충분한 해상도를 갖추어야 합니다.

Timeout#

시간에 민감한 애플리케이션의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 처리 시간이 변동적이거나 예측할 수 없는 경우, 예를 들어 이미지에 PDF417 코드가 포함되어 있지 않은 경우 등에 유용합니다. 지정한 타임아웃 시간이 초과되면 감지 프로세스가 중단되고 다음 이미지로 넘어갑니다.

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

vTool 구성#

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

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

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

PDF417 Code Reader PRO#

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

감지 기준#

PDF417 코드를 감지하고 디코딩하려면 다음 기준을 충족해야 합니다:

• Module size: Enhanced detection mode에서는 개별 모듈의 변 길이가 2~100픽셀 사이여야 합니다. Maximum detection mode에서는 개별 모듈의 변 길이가 1~100픽셀 사이여야 합니다.
• 행 및 열 제한: 자세한 내용은 PDF417 Code Reader 의 ‘버전 ’ 표를 참조하십시오.
• 극성: PDF417 코드는 ‘어두운 배경에 밝은 패턴’, ‘밝은 배경에 어두운 패턴’ 또는 이 둘이 혼합된 형태로 표시될 수 있습니다.
• 미러링: 수직, 수평 또는 양방향으로 미러링된 PDF417 코드를 감지할 수 있습니다.
• 가독성: 반사나 번짐과 같은 시각적 결함이 있거나 해상도가 낮은 코드를 감지할 수 있습니다.

감지 모드#

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

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

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

Timeout#

시간에 민감한 애플리케이션의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 처리 시간이 변동적이거나 예측할 수 없는 경우, 예를 들어 이미지에 PDF417 코드가 포함되어 있지 않은 경우 등에 유용합니다. 지정한 타임아웃 시간이 초과되면 감지 프로세스가 중단되고 다음 이미지로 넘어갑니다.

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

vTool 구성#

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

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

PDF417 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#

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

• 데이터 유형: String Array

Regions#

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

• Data type: Region Array

OrientedBoxes_px#

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

• Data type: RectangleF Array

관련 vTools#

일반적인 선행 vTool#

• 카메라 vTool
• Image Format Converter vTool

일반적인 후행 vTool#

• Region Feature Extraction vTool
  이 도구를 사용하면 발견된 PDF417 코드의 중심, 크기 및 방향을 확인할 수 있습니다.