Operator DynamicROI

Operator Library: Base

DynamicROI 오퍼레이터는 입력 링크 I에서 관심 영역(ROI) 직사각형을 추출합니다. 출력 이미지 높이와 라인 폭은 ROI 이미지 파라미터인 Ylength 및 Xlength로 정의됩니다. 이 ROI의 크기는 4개의 입력 링크 Xoffset, Yoffset, Xlength 및 Ylength에 의해 동적으로 정의됩니다. 이 오퍼레이터의 목적은 이미지 처리 단계의 결과에 맞추어 ROI 치수와 위치를 조정하는 것입니다. ROI의 모든 파라미터는 이미지마다 다를 수 있습니다.

I에서 O로의 이미지 스트림은 4개의 링크 Xoffset, Yoffset, Xlength 및 Ylength에 의해 제어됩니다. 이 4개의 링크는 (O 타입 오퍼레이터의 임의의 네트워크를 통해 동일한 M 타입 오퍼레이터가 소스를 제공하는) 완전 동기식 방식뿐만 아니라 (서로 다른 M 타입 오퍼레이터가 소스를 제공하는) 완전 비동기식 방식으로도 작동할 수 있습니다. 출력 O에서 ROI를 출력하려면 5개의 입력 모두에 이미지가 제공되어야 합니다. 이미지가 이미 제공된 입력은 모든 입력에 이미지가 제공될 때까지 차단됩니다. 개별 입력, 특히 입력 링크 I에서의 버퍼링 요소는 강력히 권장됩니다. DynamicROI의 동작은 모든 입력에 이미지가 제공되는 경우에만 열리는 밸브로 생각할 수 있습니다.

4개의 제어 입력 각각에 이미지가 도착할 때마다, 각 제어 링크의 맨 마지막 픽셀이 DynamicROI에 의해 캡처됩니다. DynamicROI가 제어 입력에서 모든 이미지를 수신하자마자 밸브가 열리고 이미지가 I에서 O로 통과하도록 허용됩니다. 이제 캡처된 ROI 좌표가 ROI를 추출하는 데 사용됩니다. ROI 이미지가 O로 전송된 후, 밸브가 다시 닫히고 제어 링크에 나타날 다음 이미지 ROI 좌표 세트를 기다립니다.

이 오퍼레이터의 중요한 용도 중 하나는 CreateBlankImage 및 CoefficientBuffer와 함께 사용하거나 Object Detection 구현 결과와 함께 사용하는 것입니다. 파라미터를 사용하여 ROI 좌표를 제어하는 오퍼레이터는 SelectROI입니다.

Operator 제한 사항

  • Xlength가 링크 I와 O의 Parallelism의 정수 배가 아닌 경우, 오퍼레이터는 Parallelism에 맞추기 위해 ROI 폭을 확장합니다. 더미 픽셀이 각 라인의 끝에 추가됩니다. 해당 더미 픽셀의 값은 정의되어 있지 않습니다. VA 시뮬레이션에서는 시인성을 높이기 위해 더미 픽셀이 0으로 설정됩니다.
  • ROI 좌표가 잘못된 경우, 즉 Xlength 및/또는 Ylength가 0이거나 오프셋이 이미지 경계를 초과하는 경우, 오퍼레이터는 빈 이미지를 잘라서 출력하거나 이미지를 제거합니다. 이 동작은 파라미터 SuppressEmptyRoI를 사용하여 제어할 수 있습니다.
  • 오프셋 좌표는 유효하지만 Xlength 및/또는 Ylength 좌표가 이미지 경계를 초과하는 경우, 오퍼레이터는 ROI를 이미지 경계에 맞게 축소합니다.
  • 높이와 폭이 0인 ROI 프레임과 같이 빈 좌표 세트가 ROI 입력에 제공되는 경우, DynamicROI 오퍼레이터는 이러한 빈 ROI를 유효하지 않은 좌표를 가진 ROI로 취급합니다. 오퍼레이터는 빈 이미지를 잘라서 출력하거나 이미지를 제거합니다. 이 동작은 파라미터 SuppressEmptyRoI를 사용하여 제어할 수 있습니다.
  • 포트 I의 빈 이미지는 지원되지 않습니다.
  • 포트 I에 있는 각 입력 이미지의 라인은 길이가 같아야 합니다. 따라서 라인 길이가 다른 이미지는 허용되지 않습니다.

I/O Properties

Property Value
Operator Type M
Input Links I, 이미지 입력
Xoffset, x-오프셋 입력
Yoffset, y-오프셋 입력
Xlength, x-길이 입력
Ylength, y-길이 입력
Output Link O, data output

동기 및 비동기 입력

  • 모든 입력은 비동기식입니다. 즉, 서로 다른 M-타입 오퍼레이터가 소스를 제공할 수 있습니다.

Supported Link Format

Link Parameter Input Link I 입력 링크 Xoffset 입력 링크 Yoffset 입력 링크 Xlength 입력 링크 Ylength Output Link O
Bit Width [1, 64]1 auto2 auto3 auto4 auto5 as I
Arithmetic {unsigned, signed} unsigned unsigned unsigned unsigned as I
Parallelism any any any any any as I
Kernel Columns any any any any any as I
Kernel Rows any any any any any as I
Img Protocol VALT_IMAGE2D VALT_IMAGE2D VALT_IMAGE2D VALT_IMAGE2D VALT_IMAGE2D as I
Color Format any VAF_GRAY VAF_GRAY VAF_GRAY VAF_GRAY as I
Color Flavor any FL_NONE FL_NONE FL_NONE FL_NONE as I
Max. Img Width any any any any any as I
Max. Img Height any any any any any as I

1

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

2 3 4 5

제어 입력에서 허용되는 Bit Width는 입력 링크 I의 최대 이미지 치수로부터 자동으로 결정됩니다.

Parameters

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

이 파라미터는 ROI 좌표가 잘못된 경우 오퍼레이터의 출력에서 빈 이미지의 제거를 제어합니다. 자세한 내용은 Operator Restrictions를 참조하십시오.

사용 예제

DynamicROI 오퍼레이터의 사용법은 다음 예제에 나와 있습니다.

  • 'Blob2D ROI Selection'

    예시 - 블롭 분석 연산자가 입력 카메라 이미지에 적용됩니다. 이 애플릿은 애플릿 내에서 블롭 데이터의 사용법을 보여줍니다. 이 경우 최대 면적을 가진 객체가 위치 지정되며, 해당 좌표를 사용하여 원본 이미지에서 객체를 잘라냅니다.