연산자 SelectROI

Operator Library: Base

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

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

오퍼레이터는 ROI가 완료되는 즉시 출력 이미지를 최종 처리합니다. ROI가 입력 이미지보다 작은 경우, 이로 인해 출력 이미지가 입력 이미지보다 더 일찍 최종 처리되는 동작이 발생할 수 있습니다. 이는 마지막 라인/픽셀을 기다려야 하는 RemoveLine 또는 RemovePixel 오퍼레이터와 대조됩니다.

오퍼레이터 제한 사항

X_Offset 및 X_Length 매개변수의 합은 링크 이미지의 최대 너비를 초과해서는 안 됩니다. Y_Offset 및 Y_Length 매개변수의 합은 링크 이미지의 최대 높이를 초과해서는 안 됩니다.

동적 ROI 파라미터 변경은 프로세스, 즉 획득이 중지된 상태에서만 허용됩니다. 획득이 실행되는 동안 변경하면 ROI에 영향을 주지 않습니다. 이렇게 하면 파라미터가 변경될 때 유효하지 않은 ROI가 생성되는 것을 방지할 수 있습니다.

각 입력 이미지의 라인은 길이가 같아야 합니다. 따라서 라인 길이가 다른 이미지는 허용되지 않습니다.

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

  • 입력 프레임이 지정된 ROI보다 작으면 오퍼레이터는 ROI의 사용 가능한 부분만 출력합니다.

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

I/O Properties

Property Value
Operator Type P
입력 링크 I, data input
출력 링크 O, data output

지원되는 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]이고, 부호 있는 컬러의 경우 범위는 [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 오퍼레이터의 사용법은 다음 예시에 나와 있습니다:

  이전     상위 레벨     다음  
콘텐츠 맨 위로 홈