Array Creator vTool#

Array Creator vTool은 하나 또는 여러 소스에서 요소를 수집하여 이를 별도의 출력 배열로 결합합니다.

Array Creator 는 요소 입력 핀을 통해 이미지나 영역 등 다양한 유형의 요소를 받아들이며, 배열 출력 핀을 통해 결합된 요소를 출력합니다.

xml-ph-0000@deepl.internal vTool을 pylon Software SuiteArray Creator vTool을 사용하려면 파일을 다운로드하십시오.

작동 방식#

Array Creator 는 레시피에서 유연한 배열 처리를 위해 Array Element Iterator 레시피에서 유연한 어레이 처리를 위해, 하지만 다른 vTools와 함께 단독으로도 사용할 수 있습니다.

업데이트가 발생할 때마다, 즉 Element 입력 핀에 데이터가 도착할 때마다, Array Creator 는 인덱스를 읽은 후 각 Element 입력 핀의 값을 해당 위치의 출력 배열에 기록합니다. 특정 인덱스의 값이 여러 번 기록되는 경우, 가장 최근에 수신된 값이 이전의 모든 값을 덮어씁니다. 최대 100개의 Element 입력 핀을 생성할 수 있으며, 이와 동일한 수의 Array 출력 핀이 생성됩니다.

Index 입력 핀은 각 새로운 요소가 해당 출력 배열에 기록될 위치를 지정합니다. LastIteration 입력 핀은 시퀀스의 끝을 알리며, 이 시점에서 수집된 배열들이 출력됩니다.

Array 출력 핀의 데이터 유형은 Element 입력 핀으로 입력된 데이터 유형과 동일합니다.

LastIteration 입력 핀에서 ‘true’ 신호가 수신되고 Index 입력 핀에서 유효한 입력이 수신되면, 수신된 요소들은 평소와 같이 저장된 후 모든 배열이 출력됩니다. LastIteration 입력 핀에서 ‘true’ 신호가 수신되었으나 Index 입력이 수신되지 않은 경우, Element 입력 핀에서 들어오는 모든 값은 무시되고, 지금까지 수집된 모든 값을 포함하는 배열이 있는 그대로 출력됩니다. 출력 후, 모든 내부 배열은 비워진 상태로 초기화됩니다.

Error Handling#

필수 연결 누락: LastIteration 또는 Index 입력 핀 중 하나가 연결되지 않은 경우, 업데이트할 때마다 모든 출력 핀에서 배열 수준의 오류가 발생한 배열이 생성되며(LastIteration 및 Index 입력 핀은 모두 연결되어야 함), 데이터가 수집되지 않습니다.

오류가 발생한 마지막 반복(LastIteration): LastIteration 입력 핀이 오류 상태의 값을 수신하면, 리소스 관리기( Array Creator )는 모든 출력 핀을 통해 배열 수준 오류(LastIteration 입력에서 오류가 있는 요소 수신)가 포함된 배열을 출력하고 내부 상태를 초기화합니다.

마지막 반복에서 인덱스 오류: LastIteration 핀에서 ‘true’ 신호가 수신되었으나 인덱스 값이 유효하지 않은 경우(음수이거나, 구성된 최대 요소 수 한도를 초과하거나, 오류 상태인 경우), 모든 출력 핀을 통해 배열 수준 오류(인덱스 범위 초과)가 발생한 배열이 출력됩니다. 이전에 수집된 모든 값은 버려집니다.

마지막 반복이 아닌 단계에서 인덱스 오류: LastIteration 핀에서 false (또는 값 없음)가 수신되고 인덱스 값이 유효하지 않은 경우(음수이거나, 구성된 최대 요소 수 한도를 초과하거나, 오류 상태인 경우), Array Creator 는 오류를 기록하고 업데이트를 무시합니다. 이전에 수집된 값은 유지됩니다.

입력 핀에 오류가 있는 요소: 오류 상태인 입력 요소는 유효한 값과 다르게 처리되지 않으며, 투명하게 출력 배열로 전달됩니다.

초기화되지 않은 위치: 인덱스 입력으로 인해 출력 배열에 공백이 발생하는 경우(예: 인덱스가 0에서 3으로 건너뛰는 경우), 중간 위치(예: 1, 2)에는 오류 값(이 위치에서 요소를 수신하지 못함)이 채워집니다.

vTool 구성#

Array Creator vTool을 구성하려면, ‘ Workbench ’에서 해당 vTool을 두 번 클릭하십시오. 사용 가능한 모든 설정이 표시된 대화 상자가 열립니다. 또는, 다음 위치에서도 동일한 설정을 찾을 수 있습니다. 기능 - 전체 패널에서도 확인할 수 있습니다.

Inputs#

ElementN#

모든 vTool에서 데이터를 수신합니다. 핀의 데이터 유형은 처음 제공된 입력에 따라 자동으로 조정됩니다. 모든 단순 데이터 유형(예: String, Float, Boolean, Integer, PointF2D 등)이 지원되지만, 배열 유형은 지원되지 않습니다.

• 데이터 유형: 부울, CircleF, EllipseF, Float, Image, Integer, LineF, PointF, RectangleF, Region, String, 변환 데이터

LastIteration#

다음 매개변수로부터 true 또는 false 값을 받아, Array Element Iterator 이 핀은 현재 요소가 배열을 완성하는 마지막 요소인지 여부를 나타냅니다. true 값이 수신되면 Array Creator 는 수집된 배열을 출력하고, 다음 시퀀스를 준비하기 위해 내부 버퍼를 초기화합니다. 업데이트 중에 이 핀을 통해 값이 수신되지 않으면 vTool은 false (마지막 반복이 아님) 로 간주합니다.

• 데이터 형식: Boolean

Index#

ElementN 입력 핀을 통해 수신된 입력과 관련된 인덱스 위치(정수)를 받아들입니다. 그런 다음 해당 요소가 출력 배열의 해당 인덱스 위치에 기록됩니다. 수신된 인덱스가 배열의 현재 크기를 초과하는 경우, 배열의 크기가 그에 따라 조정됩니다. 사용되지 않은 위치는 오류 값으로 채워집니다.

• 데이터 형식: Integer

Outputs#

ArrayN#

Element 입력 핀 하나당 하나의 배열을 반환합니다. 이 배열에는 반복 시퀀스 전반에 걸쳐 해당 입력 핀에서 수집된 모든 값이 포함됩니다. 배열은 LastIteration 입력 핀에서 true 신호가 수신되면 출력됩니다. 한 번도 쓰기 작업이 수행되지 않은 위치의 요소에는 오류 값이 채워집니다.

• 데이터 유형: 해당 Element 핀을 통해 입력된 데이터 유형의 배열