Operator ImageNumber

Operator Library: Base

ImageNumber 연산자는 입력 링크의 현재 이미지에 해당하는 출력 링크의 인덱스를 제공합니다. 따라서 입력의 각 픽셀은 이미지의 인덱스, 즉 이미지 번호로 대체됩니다. 실제 입력 픽셀 값은 사용되지 않습니다. 이 연산자는 입력에 새로운 이미지가 들어올 때마다 증가하는 카운터 역할을 합니다. 카운터는 프로세스 시작 시('다중 프로세스') 또는 최대값에 도달한 후에 재설정됩니다. 첫 번째 이미지의 이미지 인덱스는 0입니다.

카운터 폭은 출력 링크 O의 비트 폭을 변경하여 정의할 수 있습니다. 카운터가 최대값에 도달하면 다시 0부터 시작하게 되며, 이를 ‘랩어라운드’ 상태라고 합니다. 예를 들어, 출력 비트 폭이 8비트인 경우 카운터 값은 0에서 255 사이가 됩니다.

SingleShot 매개변수를 사용하면, 카운터가 순환 조건에 도달하더라도 초기화되지 않습니다. 카운터 값 출력은 최대값을 유지합니다. 따라서 8비트 이미지 카운터의 경우, 카운터 값은 최대값인 255를 유지하게 됩니다.

이 연산자는 종종 다음 연산자와 함께 사용됩니다. RemoveImage 연산자와 함께 사용되어 시퀀스의 처음 N개 이미지를 제거합니다.

Operator 제한 사항

  • 이 연산자는 빈 이미지를 지원합니다. 이 연산자는 해당 빈 이미지를 카운트합니다. 그러나 빈 이미지의 경우, 빈 프레임의 출력에는 픽셀이 전혀 포함되어 있지 않으므로 출력에서 카운터 값을 제공할 수 없습니다. 다음 비어 있지 않은 이미지가 나타나면 출력 링크를 통해 올바른 카운터 값이 제공됩니다.

I/O Properties

Property Value
Operator Type O
Input Link I, data input
Output Link O, data output

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 [1, 64]
Arithmetic {unsigned, signed} unsigned
Parallelism any as I
Kernel Columns any 1
Kernel Rows any 1
Img Protocol VALT_IMAGE2D as I
Color Format any VAF_GRAY
Color Flavor any FL_NONE
Max. Img Width any as I
Max. Img Height any as I

1

입력 Bit Width의 범위는 [1, 64]입니다. Signed 입력의 경우 범위는 [2, 64]입니다. Unsigned 컬러 입력의 경우 범위는 [3, 63]이며, Signed 컬러의 경우 범위는 [6, 63]입니다.

Parameters

SingleShot
Type static parameter
Default OFF
Range {OFF, ON}

이 매개변수는 카운터 순환 조건을 제어합니다. 이 매개변수를 OFF로 설정하면 카운터는 처리되는 각 이미지마다 무한히 증가하며, 즉, 출력 링크 비트 폭에 의해 정의된 최대 카운터 값에 도달하면 카운터가 순환됩니다.

ON으로 설정하면 카운터는 가능한 최대값에 도달할 때까지 계속 카운트합니다. 카운터는 최대값에 도달하면 카운트를 중단합니다.

사용 예제

The use of operator ImageNumber is shown in the following examples: