Operator SelectROI

Operator Library: Base

SelectROI operator는 입력 링크의 프레임에서 직사각형 관심 영역(ROI)을 추출합니다. ROI는 X_Offset, X_Length, Y_Offset, Y_Length의 4가지 파라미터를 사용하여 지정됩니다. X 파라미터는 픽셀 단위로 지정해야 합니다. Y 파라미터는 라인 단위로 지정해야 합니다.

파라미터 대신 입력 링크를 사용하여 ROI 좌표를 설정해야 하는 경우, DynamicROI operator를 사용해야 합니다.

operator는 ROI가 완료되는 즉시 출력 이미지를 완료합니다. ROI가 입력 이미지보다 작은 경우 이는 입력 이미지가 완료되기 전에 출력 이미지가 일찍 완료되는 동작으로 이어질 수 있습니다. 이는 마지막 라인/픽셀을 대기해야 하는 RemoveLine 또는 RemovePixel operators와 대조됩니다.

Operator 제한 사항

X_Offset과 X_Length 파라미터의 합은 최대 링크 이미지 너비를 초과해서는 안 됩니다. Y_Offset과 Y_Length 파라미터의 합은 최대 링크 이미지 높이를 초과해서는 안 됩니다.

동적 ROI 파라미터 변경은 프로세스, 즉 획득이 중지된 경우에만 허용됩니다. 획득이 실행되는 동안 변경하면 ROI에 아무런 영향이 없습니다. 이는 파라미터가 변경될 때 잘못된 ROI가 생성되는 것을 방지합니다.

각 입력 이미지의 라인은 동일한 길이를 가져야 합니다. 따라서 라인 길이가 다른 이미지는 허용되지 않습니다.

  • VisualApplets에서는 한 라인의 픽셀 수, 즉 라인 너비가 항상 Parallelism의 배수여야 합니다. X_Length가 링크 Parallelism으로 나누어떨어지지 않으면 operator는 마지막 병렬 워드를 채우기 위해 더미 픽셀을 삽입합니다. 예를 들어 링크 Parallelism이 2이고, X_Offset이 0이며, X_Length가 5인 경우 operator는 6개의 픽셀을 출력하며 마지막 픽셀은 더미 픽셀이 됩니다. 해당 더미 픽셀의 값은 정의되지 않습니다. VA 시뮬레이션에서는 시인성을 높이기 위해 더미 픽셀이 0으로 설정됩니다.

  • 입력 프레임이 지정된 ROI보다 작을 경우 operator는 ROI의 사용 가능한 부분만 출력합니다.

  • 1D 모드에서 operator를 사용할 때 Y 파라미터는 operator에 아무런 영향을 미치지 않습니다. operator는 X 방향으로만 ROI를 잘라냅니다.

I/O Properties

Property Value
Operator Type P
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 as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns any as I
Kernel Rows any as I
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format any as I
Color Flavor any as I
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

X_Offset
Type static/dynamic 읽기/쓰기 매개변수
Default 0
Range [0, MaxImgWidth - X_Length]

이 파라미터 값은 (X_Offset과 함께) 픽셀 단위로 ROI의 왼쪽 모서리 위치를 정의합니다.

Y_Offset
Type static/dynamic 읽기/쓰기 매개변수
Default 0
Range [0, MaxImgHeight - Y_Length]

이 파라미터 값은 (Y_Offset과 함께) 픽셀 단위로 ROI의 위쪽 모서리 위치를 정의합니다.

X_Length
Type static/dynamic 읽기/쓰기 매개변수
Default 1024
Range [1, MaxImgWidth - X_Offset]

이 파라미터는 ROI의 너비를 정의합니다.

Y_Length
Type static/dynamic 읽기/쓰기 매개변수
Default 1024
Range [1, MaxImgHeight - Y_Offset]

이 파라미터는 ROI의 높이를 정의합니다.

사용 예제

SelectROI operator의 사용법은 다음 예시에 나와 있습니다:

  이전     상위 수준     다음  
콘텐츠 맨 위로 홈