PDF417 Code Reader vTool#
PDF417 Code Reader는 Image 입력 핀을 통해 수신한 이미지에서 PDF417 코드를 감지하고 디코딩할 수 있습니다. 결과는 Regions 및 Texts 출력 핀을 통해 출력됩니다.
영역 출력에는 PDF417 코드가 발견된 영역이 포함됩니다. 텍스트 출력은 PDF417 코드로 인코딩된 텍스트 문자열입니다.
ROI Creator vTool을 사용하여 감지 전에 관심 영역을 지정하면 PDF417 Code Reader는 Roi 입력 핀을 통해 ROI 데이터를 수신합니다. 이를 통해 PDF417 Code Reader가 코드를 검색하는 이미지 영역이 줄어들어 오탐지 후보를 제거하는 데 도움이 됩니다. 부수적인 효과로 처리 속도가 빨라지고 안정성이 향상됩니다.
PDF417 Code Reader vTool은 단일 라이선스(Basic 또는 PRO)로 구매하거나 Code Reader Bundle 라이선스의 일부로 구매할 수 있습니다. 라이선스를 구매하려면 Basler 웹사이트를 방문하십시오.
PDF417 Code Reader 버전#
PDF417 Code Reader는 두 가지 버전으로 제공됩니다. 다음 표는 버전 간의 차이점을 보여줍니다. 이 항목의 관련 섹션으로 바로 이동하려면 표 머리글에서 버전을 클릭하십시오.
| Basic | Pro | |
|---|---|---|
| 감지할 수 있는 PDF417 코드 수는 몇 개인가요? | 3 | 무제한 |
| 감지에 대한 시간 초과(timeout)를 지정할 수 있나요? | Yes | Yes |
| 어떤 모듈 크기가 허용되나요? | 3~15픽셀의 한 변 길이 | 1~100픽셀의 한 변 길이 |
| 허용되는 열(column) 수는 몇 개인가요? | 1~20 | 1~30 |
| 허용되는 행(row) 수는 몇 개입니까? | 5~45 | 3~90 |
| 허용되는 최대 종횡비(가로 대 세로)는 얼마입니까? | 1:4 | 1:10 |
| 어두운 배경 위의 밝은(light-on-dark) PDF417 Code를 감지할 수 있습니까? | 아니요 전처리 단계가 필요합니다. | Yes |
| 대칭(mirrored) PDF417 Code를 감지할 수 있습니까? | Yes | Yes |
| Enhanced 감지 모드를 사용할 수 있습니까? | No | Yes |
| Maximum 감지 모드를 사용할 수 있습니까? | No | Yes |
| Roi 입력 핀에 유효한 데이터 형식 | RectangleF, RectangleF Array, Region, Region Array | RectangleF, RectangleF Array, Region, Region Array |
| 라이선스 구매 | Basler 웹사이트 방문 | Basler 웹사이트 방문 |
작동 원리#
PDF417 Code Reader 버전에 따라 이미지에서 최대 3개 또는 무제한의 PDF417 Code를 감지할 수 있습니다.
일정 시간이 지난 후 감지를 종료하도록 타임아웃을 지정할 수 있습니다. 이미지에 PDF417 Code가 하나만 포함되어 있다는 것을 아는 경우, PDF417 Code Reader가 하나의 코드만 찾도록 구성하면 처리 시간을 절약할 수 있습니다.
일반적인 사용 사례#
- PDF417 Code 읽기: 이 경우 디코딩된 문자열을 출력하려면 Texts 출력 핀만 연결하면 됩니다.
- PDF417 Code의 위치 결정: 후속 처리를 위해 Regions 출력 핀에서 반환된 PDF417 Code의 위치와 크기를 사용합니다.
PDF417 Code Reader Basic#
이미지에서 최대 3개의 PDF417 Code를 감지할 수 있습니다. 이미지에 예상되는 코드 수로 수를 제한하면 처리 시간을 절약할 수 있습니다.
검출 기준#
PDF417 Code를 감지하고 디코딩하려면 다음 기준을 충족해야 합니다.
- 모듈 크기: 개별 모듈의 한 변 길이는 3~15픽셀 사이여야 합니다.
- 행 및 열 제한: 자세한 내용은 PDF417 Code Reader Versions 표를 참조하십시오.
- 극성: PDF417 Code는 밝은 배경 위의 어두운(dark-on-light) 패턴이어야 합니다. 어두운 배경 위의 밝은 패턴의 경우, 예를 들어 Gray Value Transformer vTool을 사용하여 입력 이미지를 반전시키는 전처리 단계를 실행하십시오.
- 대칭: 수직, 수호평 또는 둘 다 대칭인 PDF417 Code를 감지할 수 있습니다.
- 가독성: 코드는 반사나 얼룩 등의 시각적 결함이 없어야 하며 충분한 해상도를 가져야 합니다.
타임아웃#
시간이 중요한 애플리케이션의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 이미지에 PDF417 Code가 포함되어 있지 않은 경우와 같이 처리 시간이 다양하거나 예측할 수 없는 경우에 유용합니다. 지정된 타임아웃을 초과하면 감지 프로세스가 중지되고 다음 이미지로 이동합니다.
Basler는 원하는 시간 제한보다 약간 낮게 타임아웃을 설정할 것을 권장합니다. 이는 vTool이 감지 프로세스를 즉시 중단하지 않기 때문입니다. 따라서 타임아웃을 원하는 시간 제한의 70~80%로 설정하세요.
vTool 설정하기#
PDF417 Code Reader Basic vTool을 구성하려면:
- vTool Settings 영역의 Recipe Management 창에서 Open Settings를 클릭하거나 vTool을 더블 클릭합니다.
그러면 PDF417 Code Reader Basic 대화상자가 열립니다. - Number of PDF417 Codes 영역에서 감지할 PDF417 코드의 개수를 선택합니다.
- Timeout 영역에서 특정 시간이 지난 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 확인란의 선택을 해제하고 입력란에 원하는 타임아웃을 입력합니다.
PDF417 Code Reader Basic의 결과는 pin data view에서 확인할 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.
PDF417 Code Reader PRO#
이미지에서 무제한 개수의 PDF417 코드를 감지할 수 있습니다. 이미지에 있을 것으로 예상되는 코드 수로 개수를 제한하면 처리 시간을 절약할 수 있습니다.
검출 기준#
PDF417 Code를 감지하고 디코딩하려면 다음 기준을 충족해야 합니다.
- Module size: Enhanced detection mode에서는 개별 모듈의 변 길이가 2~100픽셀 사이여야 합니다. Maximum detection mode에서는 개별 모듈의 변 길이가 1~100픽셀 사이여야 합니다.
- 행 및 열 제한: 자세한 내용은 PDF417 Code Reader Versions 표를 참조하십시오.
- Polarity: PDF417 코드는 밝은 배경의 어두운 패턴, 어두운 배경의 밝은 패턴 또는 이 둘의 혼합일 수 있습니다.
- 대칭: 수직, 수호평 또는 둘 다 대칭인 PDF417 Code를 감지할 수 있습니다.
- Legibility: 반사나 얼룩 등의 시각적 결함이 있거나 해상도가 낮은 코드도 감지할 수 있습니다.
검출 모드#
Standard: 빠른 감지 모드이지만 변형되었거나 저해상도의 데이터 코드는 감지되지 않습니다.
Enhanced: 이 감지 모드에서 PDF417 Code Reader Pro는 PDF417 코드의 Quality 측면에서 더 관대합니다. 즉, 모든 감지 기준을 충족하지 않는 코드도 감지할 수 있습니다. 이 옵션을 활성화하면 감지 프로세스가 느려집니다.
Maximum: 이 감지 모드에서는 Enhanced 감지 모드의 장점 외에도 PDF417 Code Reader Pro가 더 작은 모듈 크기를 허용하며 더 작은 모듈 감지에 더 견고합니다. 즉, 모든 감지 기준을 충족하지 않는 더 많은 코드를 감지할 수 있습니다. 이 옵션을 활성화하면 감지 프로세스가 느려집니다.
타임아웃#
시간이 중요한 애플리케이션의 경우 타임아웃을 지정할 수 있습니다. 타임아웃은 이미지에 PDF417 Code가 포함되어 있지 않은 경우와 같이 처리 시간이 다양하거나 예측할 수 없는 경우에 유용합니다. 지정된 타임아웃을 초과하면 감지 프로세스가 중지되고 다음 이미지로 이동합니다.
Basler는 원하는 시간 제한보다 약간 낮게 타임아웃을 설정할 것을 권장합니다. 이는 vTool이 감지 프로세스를 즉시 중단하지 않기 때문입니다. 따라서 타임아웃을 원하는 시간 제한의 70~80%로 설정하세요.
vTool 설정하기#
PDF417 Code Reader Pro vTool을 구성하려면:
- vTool Settings 영역의 Recipe Management 창에서 Open Settings를 클릭하거나 vTool을 더블 클릭합니다.
그러면 PDF417 Code Reader Pro 대화상자가 열립니다. - Number of PDF417 Codes 영역에서 감지할 PDF417 코드의 개수를 선택합니다. 감지할 최대 코드를 알 수 없는 경우 Unlimited를 선택합니다.
- Detection Mode 영역에서 원하는 감지 모드를 선택합니다.
- Polarity 드롭다운 목록에서 애플리케이션에 적합한 옵션을 선택합니다.
애플리케이션의 코드가 특정 극성을 가지고 있는 경우 그에 따라 설정을 선택합니다. 이미지 내 코드의 극성을 알 수 없거나 극성이 다른 여러 코드가 발생하는 경우 Any를 선택합니다. - Timeout 영역에서 특정 시간이 지난 후 감지를 종료할지 여부를 지정합니다. 타임아웃을 지정하려면 No timeout 확인란의 선택을 해제하고 입력란에 원하는 타임아웃을 입력합니다.
PDF417 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
출력#
텍스트#
PDF417 코드에 인코딩된 텍스트 문자열을 반환합니다.
- 데이터 타입: String Array
Regions#
찾은 각 PDF417 코드에 대한 영역을 반환합니다. 영역은 직사각형 모양입니다. 시각화 목적 또는 후속 특징 추출에 사용할 수 있습니다.
- 데이터 타입: Region Array
OrientedBoxes_px#
검출된 각 PDF417 코드에 대한 방향성 바운딩 박스를 반환합니다.
- Data type: RectangleF Array
관련 vTools#
일반적인 선행 vTools#
Typical Successors#
- Region Feature Extraction vTool
검출된 PDF417 코드의 중심, 크기, 방향을 확인할 수 있습니다.