Painter vTool#
Painter vTool은 Image 입력 핀을 통해 이미지를 받고, Data 입력 핀을 통해 그리기용 데이터를 받습니다. 이 데이터는 예를 들어 Texts 또는 Regions와 같은 다른 vTool의 출력 핀 데이터로 정의됩니다. vTool은 Image 출력 핀을 통해 데이터가 그려진 이미지를 출력합니다.
Painter vTool을 사용하려면 pylon Software Suite를 다운로드하십시오.
작동 원리#
이미지에 추가하려는 데이터의 vTool 출력 핀을 Painter vTool의 Data 입력 핀 중 하나(예: Barcode Reader vTool의 Texts 출력 핀)에 연결합니다. Num Input Data Pins 파라미터를 통해 필요한 만큼 Data 입력 핀 개수를 지정할 수 있습니다.
Painter vTool은 이미지에 다음과 같은 데이터를 그립니다.
- 기하학적 도형: 직사각형, 원, 타원, 선, 점, 영역
- 텍스트: 문자열, 정수, 부동소수점 수, 부울 값. 선택적으로 기하학적 데이터, 이미지, 변환 데이터의 텍스트 표현도 그릴 수 있습니다.
이러한 유형의 배열도 지원됩니다. 기하학적 배열은 요소별로 그려집니다. 일치하는 좌표 배열이 제공되지 않는 한 문자열, 숫자 또는 부울 배열은 하나의 텍스트 블록으로 결합됩니다.
Input Data Pin Selector 파라미터를 사용하여 설정할 Data 핀을 선택합니다. 그리기, 색상, 텍스트 배치는 핀별로 설정됩니다. 자세한 내용은 아래의 Configuration Settings를 참조하십시오.
레시피가 실행되는 동안 Features - All 창을 사용하여 설정을 테스트할 수 있습니다.
Configuration Settings#
- Num Input Data Pins: v투리 제공하는 Data 입력 핀의 개수를 지정합니다. 최대 100개의 핀을 추가할 수 있습니다. 이 파라미터는 레시피가 실행되는 동안에는 변경할 수 없습니다.
- Input Data Pin Selector: 설정을 구성할 Data 핀을 설정합니다. vTool 전체에 적용되는 Output Pixel Format을 제외하고, 아래 파라미터들은 선택한 핀에 적용됩니다.
- Pin Description: 연결된 항목을 기록하는 등 선택한 핀에 대한 선택적 메모입니다. 이 값은 사용자 참고용으로만 사용되며 그리기에 사용되지 않습니다.
- Draw Enable: 선택한 핀에 대한 그리기를 활성화 또는 비활성화합니다.
- Draw Outline Enable: 선택한 핀의 직사각형, 원, 타원, 영역 경계 상자에 대한 외곽선 그리기를 활성화 또는 비활성화합니다.
- Draw Center Enable: 선택한 핀의 직사각형, 원, 타원, 영역 경계 상자에 대한 중심 표시 그리기를 활성화 또는 비활성화합니다.
- ToString Enable: 선택한 핀에 기하학적 데이터, 이미지, 변환 데이터의 텍스트 표현 그리기를 활성화 또는 비활성화합니다. 문자열, 정수, 부동소수점 수, 부울 값은 이 설정과 관계없이 항상 텍스트로 그려집니다.
- Pen Color Red / Green / Blue / Alpha: 선택한 핀의 외곽선, 채우기(Fill), 중심 표시, 텍스트에 사용되는 색상입니다. 알파 구성 요소는 영역을 채울 때 사용됩니다.
- Pen Width: 그려진 선의 너비입니다. 점의 경우 이 값은 그려지는 마커의 크기도 결정합니다.
- Font Size: 선택한 핀에 그려지는 텍스트의 크기입니다.
- Size Offset: 그려진 외곽선이 관심 영역과 겹치지 않도록 직사각형, 원, 타원, 영역 경계 상자의 크기에 추가되는 오프셋입니다.
- Text Offset X / Text Offset Y: 텍스트 영역의 원점에 추가되는 오프셋입니다.
- Text Position: 선, 직사각형, 원, 타원 또는 영역 경계 상자에 상대적인 텍스트 영역의 원점입니다.
- Top Left: 텍스트 영역의 원점이 도형의 왼쪽에서 시작됩니다.
- Top Right: 텍스트 영역의 원점이 도형의 오른쪽에서 시작됩니다.
- Bottom Left: 텍스트 영역의 원점이 도형 아래쪽의 왼쪽에서 시작됩니다.
- Bottom Right: 텍스트 영역의 원점이 도형 아래쪽의 오른쪽에서 시작됩니다.
- Center: 텍스트 영역의 원점이 도형의 중앙에서 시작됩니다.
- Text Coordinate Data Pin Index: 선택한 핀의 텍스트를 배치하는 데 지오메트리가 사용되는 다른 Data 핀의 인덱스입니다. 예를 들어, 이를 사용하여 다른 핀에서 수신된 영역이나 직사각형 옆에 바코드 텍스트를 배치할 수 있습니다. 인덱스를 0으로 설정하면 이 기능이 꺼지며, 선택한 핀 자체의 데이터를 사용하여 텍스트 위치가 결정됩니다.
- Text Box Origin: 텍스트 작성이 시작되는 모서리입니다.
- Top Left: 왼쪽 위에서부터 텍스트가 작성됩니다.
- Bottom Left: 왼쪽 아래에서부터 텍스트가 작성됩니다.
- Text Format: 텍스트를 그릴 때 인쇄되는 내용을 정의합니다. 이 파라미터가 비어 있으면 데이터의 기본 표현이 사용됩니다. 다음과 같은 자리표시자는
{Width},{Height},{Center_X},{Radius}및{_Hour_}데이터의 값으로 대체됩니다. 편집기의 형식을 파라미터의 편집 상자로 복사하는 경우 줄바꿈 문자가 지원됩니다. 전체 자리표시자 목록을 보려면 Text Format 항목을 선택하고 Feature Documentation 창을 확인하십시오. - Output Pixel Format: 그려진 출력 이미지의 Pixel Format입니다. 입력 이미지는 그리기 전에 이 형식으로 변환됩니다.
- BGR8: 컬러 출력 이미지
- Mono8: 모노 출력 이미지
vTool 설정하기#
Painter vTool을 구성하려면 Workbench에서 해당 툴을 더블 클릭하십시오. 사용 가능한 모든 설정이 표시되는 대화 상자가 열립니다. 또는 Features - All 창에서도 동일한 설정을 찾을 수 있습니다.
Painter vTool의 결과는 pin data view에서 확인할 수 있습니다.
입력#
이미지#
Camera vTool 또는 이미지를 출력하는 vTool(예: Image Format Converter vTool)에서 직접 이미지를 허용합니다.
- 데이터 형식: 이미지
- Image format: 입력 이미지는 드로잉 전에 Output Pixel Format 파라미터로 선택된 포맷(BGR8 또는 Mono8)으로 변환됩니다.
Data1#
Data type: 이미지에 그려질 수 있는 모든 유형의 데이터를 수용합니다. Num Input Data Pins 파라미터에 따라 추가 Data 입력 핀이 활성화됩니다.
- Data type: 초기에는 Value입니다. 연결이 이루어지면 입력 핀은 연결된 출력 핀의 데이터 타입을 갖게 됩니다.
출력#
이미지#
추가 콘텐츠가 그려진 이미지를 반환합니다.
- 데이터 형식: 이미지
- Image format: Output Pixel Format 파라미터에 따라 BGR8 또는 Mono8 형식이 됩니다.
관련 vTools#
일반적인 선행 vTools#
Typical Successors#
- Image 데이터 타입을 입력으로 받는 모든 vTool.