Array Element Iterator vTool#
Array Element Iterator 는 배열 입력 핀을 통해 이미지나 영역 등 다양한 유형의 배열을 받아들이며, 내부 인덱스(0부터 시작)의 위치에 따라 해당 요소 출력 핀을 통해 요소를 출력합니다. 이를 통해 배열의 개별 요소에 대해 이미지 처리를 수행할 수 있습니다.
xml-ph-0000@deepl.internal vTool을 pylon Software SuiteArray Element Iterator vTool을 사용하려면 파일을 다운로드하십시오.
작동 방식#
‘ Array Element Iterator ’을 사용하면 데이터 배열의 개별 요소를 분리할 수 있어, 각 요소에 대해 이미지 처리를 수행할 수 있습니다. 이후 ‘Array Creator ’ vTool을 사용하여 개별 요소를 다시 배열로 변환할 수 있습니다. 요소는 vTool의 내부 0을 기준으로 하는 인덱스에 따라 처리됩니다. 또한, 데이터를 변경하지 않고 그대로 전달하도록 구성할 수도 있습니다. 여기에는 배열이 참조하는 이미지나 영역, 또는 그 밖의 다른 데이터가 포함될 수 있습니다.
정보
두 개 이상의 입력 핀이 연결된 경우, 모든 입력은 동일한 데이터 소스에서 가져와야 합니다. 서로 다른 독립적인 처리 체인의 입력을 연결하는 것은 지원되지 않습니다. 이러한 입력을 결합해야 하는 경우, ‘ Array Element Iterator ’ 앞쪽에 ‘Data Synchronizer ’ vTool을 추가하여 입력 데이터를 동기화하십시오.
사용 가능한 매개변수는 다음과 같습니다:
- 배열 핀 수: 입력할 수 있는 배열의 수를 지정합니다. 이에 따라 동일한 수의 요소 출력 핀이 생성됩니다. 출력 핀은 입력 배열의 데이터형을 따릅니다. 예를 들어, RectangleF 배열을 입력하면 RectangleF 데이터형의 요소가 출력됩니다.
- 데이터 핀 수: 이 매개변수는 이미지, 영역 또는 기타 데이터와 같은 데이터를 전달하기 위한 데이터 입력 핀의 수를 정의합니다. 데이터 출력 핀도 동일한 수만큼 생성됩니다. 데이터 항목은 변경되지 않은 상태로 다음 vTool로 전달됩니다. 이 매개변수는 선택 사항입니다.
- 반복 모드: 배열의 모든 요소를 반복할지, 아니면 특정 범위만 반복할지 지정합니다. ‘범위’를 선택하면 범위의 시작과 끝을 지정할 수 있습니다.
반복 처리 시 가장 큰 입력 배열의 크기가 사용됩니다. ‘모든 요소’ 반복 모드에서는 vTool이 0부터 해당 크기에서 1을 뺀 값까지의 모든 인덱스를 순회합니다. 범위 기반 반복 모드에서는 설정된 범위 내의 인덱스만 순회됩니다. 이 범위는 가장 큰 배열 크기로 제한됩니다.
vTool은 입력 배열의 요소들을 순차적으로 처리하면서, 각 요소를 Element 핀을 통해 출력하고 해당 인덱스 위치를 Index 핀을 통해 출력합니다. 여러 배열이 입력되었을 때, 예를 들어 특정 배열이 다른 배열들보다 작아서 해당 인덱스가 존재하지 않는 경우, 해당 배열의 출력 핀에는 아무런 값도 전송되지 않습니다. LastIteration 출력 핀은 반복의 끝을 나타냅니다. 배열의 마지막 항목에 도달하면 true를 출력합니다. 여러 배열이 입력된 경우, 가장 큰 배열의 마지막 항목에 도달하면 true를 반환합니다.
오류 처리#
오류가 있는 배열: 배열 수준의 오류가 있는 배열이 배열 입력 핀 중 하나에 수신되면 반복 처리가 수행되지 않습니다. LastIteration은 true를 반환하고, Index는 오류 값을 반환하며, Element 및 Data 출력 핀에서는 데이터가 반환되지 않습니다.
오류가 있는 요소 및 데이터: 유효한 배열 내의 오류가 있는 요소와 데이터 입력 핀의 오류는 투명하게 전달됩니다. 이러한 요소와 데이터는 유효한 값과 차별 없이 처리됩니다.
배열 수신 없음: 배열 입력 핀 중 어느 곳에서도 배열을 수신하지 못하면 처리가 이루어지지 않으며, 아무것도 반환되지 않습니다. 데이터 입력 핀에 있는 모든 값은 무시됩니다.
반복 없음: 수신된 모든 배열이 비어 있거나, 설정된 인덱스 범위가 배열 범위를 완전히 벗어난 경우, LastIteration은 true를 반환하고, Index는 반환되지 않으며, 데이터 입력 값은 무시됩니다.
vTool 구성#
Array Element Iterator vTool을 구성하려면, ‘ Workbench ’에서 해당 vTool을 두 번 클릭하십시오. 사용 가능한 모든 설정이 표시된 대화 상자가 열립니다. 또는 다음 위치에서도 동일한 설정을 찾을 수 있습니다. 기능 - 전체 패널에서 찾을 수도 있습니다.
Inputs#
ArrayN#
반복 처리할 배열을 지원합니다. 최대 100개의 배열 입력 핀을 구성할 수 있습니다.
- 데이터 유형: 모든 단순 데이터 유형(Boolean, CircleF, EllipseF, Float, Image, Integer, LineF, PointF, RectangleF, Region, String, 변환 데이터)의 배열
DataN#
모든 반복 단계에서 변경 없이 그대로 통과될 모든 데이터(예: 이미지, 영역 또는 기타 데이터)를 수용합니다. 최대 100개의 데이터 핀을 구성할 수 있습니다.
- 데이터 유형: 모든 데이터 유형
Outputs#
ElementN#
해당 입력 배열의 개별 요소를 하나씩 반환합니다.
- 데이터 유형: Array 입력 핀에 입력된 데이터 유형과 동일하며, 즉 모든 단순 데이터 유형(Boolean, CircleF, EllipseF, Float, Image, Integer, LineF, PointF, RectangleF, Region, String, Transformation Data)
DataN#
각 단계에서 해당 입력으로 수신된 데이터(예: 이미지, 영역 또는 기타 데이터)를 변경 없이 반환합니다.
- 데이터 유형: 모든 데이터 유형
마지막 반복#
배열의 마지막 요소에 도달했는지 여부를 반환합니다. 마지막 요소를 제외한 모든 요소에 대해서는 false를 반환하고, 마지막 반복 시에는 true를 반환합니다. 또한 반복 처리가 이루어지지 않는 경우(예: 모든 배열이 비어 있거나, 가장 큰 배열보다 큰 범위가 지정되었거나, 오류가 있는 배열이 전달된 경우)에도 true를 반환합니다.
- 데이터 유형: 부울
Index#
현재 인덱스 위치를 반환합니다. 입력된 배열 중 하나라도 배열 수준의 오류가 있는 경우 오류 값을 반환합니다. 반복 처리가 이루어지지 않으면 아무것도 출력되지 않습니다.
- 데이터 유형: 정수