Array Element Iterator vTool#
Array Element Iterator는 Array 입력 핀을 통해 이미지나 영역 등 다양한 유형의 배열을 입력받고 내부 (0부터 시작하는) 인덱스의 위치에 따라 해당하는 Element 출력 핀을 통해 요소를 출력합니다. 이를 통해 배열의 개별 요소에 대해 이미지 처리를 수행할 수 있습니다.
Array Element Iterator vTool을 사용하려면 pylon Software Suite를 다운로드하십시오.
작동 원리#
Array Element Iterator를 사용하면 데이터 배열의 개별 요소를 분리할 수 있으므로 개별 요소에 대한 이미지 처리가 가능합니다. 그 후 Array Creator vTool을 사용하여 개별 요소를 다시 배열로 변환할 수 있습니다. 요소는 vTool의 내부 0 기반 인덱스에 따라 처리됩니다. 또한 데이터를 변경하지 않고 그대로 전달하도록 구성할 수도 있습니다. 이는 배열이 참조하는 이미지나 영역 또는 기타 데이터일 수 있습니다.
정보
둘 이상의 입력 핀이 연결된 경우 모든 입력은 동일한 데이터 소스에서 와야 합니다. 서로 다른 독립적인 처리 체인의 입력을 연결하는 것은 지원되지 않습니다. 이러한 입력을 결합해야 하는 경우 Array Element Iterator 앞에 Data Synchronizer vTool을 추가하여 입력 데이터를 동기화하십시오.
사용 가능한 파라미터는 다음과 같습니다:
- Number Of Array Pins: 입력할 수 있는 배열의 수를 정의합니다. 동일한 수의 Element 출력 핀이 생성됩니다. 출력 핀은 입력 배열의 데이터 유형을 따릅니다. 예를 들어 RectangleF 배열을 입력하면 RectangleF 데이터 유형의 요소가 출력됩니다.
- Number Of Data Pins: 이미지, 영역 또는 기타 데이터를 전달하기 위한 Data 입력 핀의 수를 정의합니다. 동일한 수의 Data 출력 핀이 생성됩니다. 데이터 항목은 변경되지 않은 채 라인 내의 다음 vTool로 전달됩니다. 이 매개변수는 선택 사항입니다.
- Iteration Mode: 배열의 모든 요소를 반복할지 아니면 특정 범위만 반복할지 정의합니다. Range를 선택하는 경우 범위의 시작과 끝을 지정할 수 있습니다.
반복 시 가장 큰 입력 배열의 크기가 사용됩니다. All Elements 반복 모드에서 vTool은 0부터 해당 크기에서 1을 뺀 값까지의 모든 인덱스를 반복합니다. Range-based 반복 모드에서는 구성된 범위 내의 인덱스만 반복됩니다. 범위는 가장 큰 배열 크기에 맞춰 제한됩니다.
vTool이 입력 배열의 요소를 반복할 때 Element 핀을 통해 각 요소를 출력하고 Index 핀을 통해 해당 인덱스 위치를 출력합니다. 여러 배열이 입력되었고 다른 배열보다 작아서 배열에 인덱스가 존재하지 않는 경우 해당 배열의 출력에는 값이 전송되지 않습니다. LastIteration 출력 핀은 반복의 끝을 나타냅니다. 배열의 마지막 항목에 도달한 경우 true를 출력합니다. 여러 배열이 입력된 경우 가장 큰 배열의 마지막 항목에 도달하면 true를 반환합니다.
Error Handling#
Array with errors: 배열 입력 핀 중 하나에 배열 수준의 오류가 있는 배열이 수신되면 반복이 수행되지 않습니다. LastIteration은 true를 반환하고, Index는 오류 값을 반환하며, Element 및 Data 출력 핀에서는 데이터가 반환되지 않습니다.
Elements and data with errors: 유효한 배열 내의 오류가 있는 요소와 데이터 입력 핀의 오류는 투명하게 전달됩니다. 유효한 값과 다르게 취급되지 않습니다.
No array received: 배열 입력 핀 중 배열을 수신하는 핀이 없는 경우 처리가 수행되지 않으며 아무것도 반환되지 않습니다. 데이터 입력 핀의 모든 값은 무시됩니다.
No iteration: 수신된 모든 배열이 비어 있거나 구성된 인덱스 범위가 배열 범위를 완전히 벗어난 경우 LastIteration은 true를 반환하고, Index는 반환되지 않으며, 데이터 입력 값은 무시됩니다.
vTool 설정하기#
Array Element Iterator vTool을 구성하려면 Workbench에서 해당 vTool을 두 번 클릭하십시오. 사용 가능한 모든 설정이 표시되는 대화 상자가 열립니다. 또는 Features - All 창에서 동일한 설정을 찾을 수 있습니다.
입력#
ArrayN#
반복할 배열을 허용합니다. 최대 100개의 배열 입력 핀을 구성할 수 있습니다.
- 데이터 유형: 모든 단순 데이터 유형의 배열(Boolean, CircleF, EllipseF, Float, Image, Integer, LineF, PointF, RectangleF, Region, String, Transformation Data)
DataN#
모든 반복 단계에서 데이터를 (예: 이미지, 영역 또는 기타 데이터) 변경하지 않고 그대로 전달합니다. 최대 100개의 데이터 핀을 구성할 수 있습니다.
- 데이터 유형: 모든 데이터 유형
출력#
ElementN#
해당 입력 배열의 개별 요소를 하나씩 반환합니다.
- 데이터 유형: Array 입력 핀에 입력된 데이터 유형과 동일하며, 즉 모든 단순 데이터 유형(Boolean, CircleF, EllipseF, Float, Image, Integer, LineF, PointF, RectangleF, Region, String, Transformation Data)입니다.
DataN#
각 단계에서 해당 입력으로 수신된 데이터(예: 이미지, 영역 또는 기타 데이터)를 변경하지 않고 그대로 반환합니다.
- 데이터 유형: 모든 데이터 유형
LastIteration#
배열의 마지막 요소에 도달했는지 여부를 반환합니다. 마지막 요소를 제외한 모든 요소에 대해 false를 반환하고, 최종 반복에서는 true를 반환합니다. 또한 반복이 발생하지 않는 경우에도(예: 모든 배열이 비어 있거나, 가장 큰 배열보다 큰 범위가 지정되었거나, 오류가 있는 배열이 수신된 경우) true를 반환합니다.
- 데이터 형식: Boolean
색인#
현재 인덱스 위치를 반환합니다. 배열 입력에 배열 수준 오류가 있는 경우 오류 값을 반환합니다. 반복이 발생하지 않으면 아무것도 출력되지 않습니다.
- 데이터 형식: Integer