Multiple ROI#

Multiple ROI 카메라 기능을 사용하면 센서 어레이에서 단일 이미지로 전송될 여러 영역을 정의할 수 있습니다.

해당 영역의 픽셀 데이터만 전송됩니다. 이를 통해 카메라의 프레임 레이트가 향상됩니다.

Multiple ROI 기능은 Basler ace 카메라에서만 사용할 수 있는 Stacked ROI 기능과 유사합니다.

기능 사용법#

작동 원리#

Multiple ROI 기능을 사용하면 센서 어레이에서 영역을 정의할 수 있습니다. 최대 영역 수는 카메라 모델에 따라 다릅니다.

이미지가 획득되면 영역 내부의 픽셀 정보만 센서에서 판독되어 단일 이미지로 전송됩니다.

영역의 크기와 위치를 개별적으로 정의하는 대신 센서 어레이에서 행과 열을 정의합니다. 그런 다음 열과 행이 교차하는 각 지점에 영역이 생성됩니다.

아래 예시에서는 두 개의 행과 두 개의 열이 정의되어 있으며, 이를 통해 네 개의 영역이 생성됩니다.

Region 11, Region 21, Region 12, Region 22 내부의 픽셀 정보가 단일 이미지로 전송됩니다.

행 및 열 구성하기#

행과 열을 구성하려면 다음을 수행하십시오.

1. 카메라가 유휴 상태인지, 즉 이미지를 캡처하고 있지 않은지 확인하십시오.
2. Reverse X and Reverse Y 기능이 비활성화되어 있는지 확인하십시오.
   행과 열을 구성한 후 이미지 미러링을 다시 활성화할 수 있습니다.
3. 열을 구성합니다.
   1. 단일 열을 정의하려면:
      1. 다음 값 중 하나로 BslMultipleROIColumnsEnable 매개변수: false.
      2. 다음 값 중 하나로 OffsetX 파라미터를 원하는 열의 수평 오프셋으로 설정합니다. 이 값은 모든 영역에 적용됩니다.
      3. 다음 값 중 하나로 Width 파라미터를 원하는 열의 너비로 설정합니다. 이 값은 모든 영역에 적용됩니다.
   2. 여러 열을 정의하려면:
      1. 다음 값 중 하나로 BslMultipleROIColumnsEnable 매개변수: true.
      2. 다음 값 중 하나로 BslMultipleROIColumnSelector 파라미터를 원하는 열(예:)로 설정합니다. Column1.
      3. 다음 값 중 하나로 BslMultipleROIColumnOffset 파라미터를 원하는 열의 수평 오프셋(예: 100)으로 설정합니다.
      4. 다음 값 중 하나로 BslMultipleROIColumnSize 파라미터를 원하는 열의 너비(예: 50)로 설정합니다.
      5. 구성하려는 각 열에 대해 위의 단계를 반복합니다.
         참고: 원치 않는 부작용을 방지하려면 항상 오름차순으로 열을 구성하십시오(즉, 열 1부터 시작한 다음 열 2를 구성하는 방식).
4. 행을 구성합니다:
   1. 단일 행을 정의하려면:
      1. 다음 값 중 하나로 BslMultipleROIRowsEnable 매개변수: false.
      2. 다음 값 중 하나로 OffsetY 파라미터를 원하는 행의 수직 오프셋으로 설정합니다. 이 값은 모든 영역에 적용됩니다.
      3. 다음 값 중 하나로 Height 파라미터를 원하는 행의 높이로 설정합니다. 이 값은 모든 영역에 적용됩니다.
   2. 여러 행을 정의하려는 경우:
      1. 다음 값 중 하나로 BslMultipleROIRowsEnable 매개변수: true.
      2. 다음 값 중 하나로 BslMultipleROIRowSelector 파라미터를 원하는 행(예:)으로 설정합니다. Row1.
      3. 다음 값 중 하나로 BslMultipleROIRowOffset 매개변수를 원하는 행의 수직 오프셋(예: 100)으로 설정합니다.
      4. 다음 값 중 하나로 BslMultipleROIRowSize 매개변수를 원하는 행의 높이(예: 50)로 설정합니다.
      5. 구성하려는 모든 행에 대해 위 단계를 반복합니다.
         참고: 원치 않는 부작용을 방지하려면 항상 오름차순으로 행을 구성하십시오. 즉, 행 1부터 시작하여 행 2를 구성하는 방식으로 진행합니다.
5. 필요한 경우 Reverse X and Reverse Y를 다시 활성화합니다.
   이렇게 하면 열과 행의 위치가 미러링된 이미지에 자동으로 맞춰집니다.

Multiple ROI 기능 사용 시 고려 사항#

• 결합된 모든 영역, 즉 Multiple ROI 기능으로 생성된 이미지에는 센서별 최소 너비와 높이가 존재합니다. 설정 과정중, 카메라는 최소 너비와 높이를 충족하도록 매개변수 값과 범위를 자동으로 조정합니다. 마지막 열은 항상 최소 총 너비를 달성하는 데 사용됩니다. 증가분 BslMultipleROIColumnSize 매개변수도 고려되기 때문에 결과 총 너비가 최솟값보다 클 수 있습니다.
  예: 카메라의 센서 최소 총 너비가 530이며 최대 두 개의 열을 구성할 수 있다고 가정해 보겠습니다. 열 1의 너비를 200으로 설정하면 카메라는 열 2의 최소 너비를 330으로 자동으로 설정합니다.
  예 2: 위의 예와 동일한 센서를 사용한다고 가정해 보겠습니다. 또한 해당 센서의 해상도가 1920 x 1200이라고 가정합니다. 이제 열 0의 수직 오프셋을 900으로 설정하면 최소 너비 요구 사항을 충족하는 영역을 정의할 공간이 부족하게 됩니다. 따라서 카메라는 모든 열의 최대 수직 오프셋을 670으로 자동 설정합니다(1200 센서 너비에서 530 최소 총 영역 너비를 뺀 값).
• 위의 제약 사항 때문에 Basler에서는 열과 행을 오름차순으로 구성할 것을 강력히 권장합니다. 즉, 열 1부터 시작하여 열 2를 구성하는 방식으로 진행합니다.
• 컬러 카메라의 경우 픽셀 포맷이 디베이어링이 포함된 포맷(즉, RGB 또는 YCbCr 픽셀 포맷)으로 설정되어 있다면, 영역이 디베이어링 영역의 크기(예: 3x3 픽셀) 이상이어야 카메라가 의미 있는 색상 정보를 계산할 수 있다는 점을 고려해야 합니다.

• 만약 BslMultipleROIColumnsEnable 로 설정된 경우 true(으)로 설정하면 다음 매개변수가 읽기 전용이 됩니다.

  • OffsetX: 이 매개변수는 열 1의 수평 오프셋으로 설정됩니다.
  • Width: 이 매개변수는 모든 영역의 총 너비, 즉 Multiple ROI 기능으로 생성된 이미지의 너비로 설정됩니다.

• 만약 BslMultipleROIRowsEnable 로 설정된 경우 true(으)로 설정하면 다음 매개변수가 읽기 전용이 됩니다.

  • OffsetY: 이 매개변수는 행 1의 수직 오프셋으로 설정됩니다.
  • Height: 이 매개변수는 모든 영역의 총 높이, 즉 Multiple ROI 기능으로 생성된 이미지의 높이로 설정됩니다.

• Binning 또는 Pixel Beyond와 같이 이미지 크기에 영향을 주는 다른 카메라 기능은 Multiple ROI 기능 이후에 적용됩니다. 따라서 행과 열을 구성할 때 이러한 기능의 영향을 고려할 필요가 없습니다.

• 이 ROI 자동 기능 위치와 크기가 Multiple ROI 기능의 출력에 자동으로 맞춰집니다. 예를 들어 모든 영역의 결합된 너비가 500인 경우, AutoFunctionROIWidth 매개변수의 최댓값은 500이 됩니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.SetValue(true);
// Select column 1
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.SetValue(100);
camera.BslMultipleROIColumnSize.SetValue(300);
// Select column 2
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.SetValue(500);
camera.BslMultipleROIColumnSize.SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.SetValue(200);
camera.Height.SetValue(500);

INodeMap& nodemap = camera.GetNodeMap();
// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
CBooleanParameter(nodemap, "BslMultipleROIColumnsEnable").SetValue(true);
// Select column 1
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column1");
// The first region should have a horizontal offset of 100 and a width of 300 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(100);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(300);
// Select column 2
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column2");
// The second region should have a horizontal offset of 500 and a width of 400 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(500);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
CBooleanParameter(nodemap, "BslMultipleROIRowsEnable").SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
CIntegerParameter(nodemap, "OffsetY").SetValue(200);
CIntegerParameter(nodemap, "Height").SetValue(500);

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.Parameters[PLCamera.BslMultipleROIColumnsEnable].SetValue(true);
// Select column 1
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(100);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(300);
// Select column 2
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(500);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.Parameters[PLCamera.BslMultipleROIRowsEnable].SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.Parameters[PLCamera.OffsetY].SetValue(200);
camera.Parameters[PLCamera.Height].SetValue(500);

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* ** In this example, we define two regions in horizontal direction */
/* that will be transmitted as a single image. ** */
/* Enable the ability to configure multiple columns */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIColumnsEnable", 1);
CHECK(errRes);
/* Select column 1 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column1");
CHECK(errRes);
/* The first region should have a horizontal offset of 100 and a width of 300 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 100);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 300);
CHECK(errRes);
/* Select column 2 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column2");
CHECK(errRes);
/* The second region should have a horizontal offset of 500 and a width of 400 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 400);
CHECK(errRes);
/* We only need one row, so disable the ability to configure multiple rows */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIRowsEnable", 0);
CHECK(errRes);
/* Both regions should have a vertical offset of 200 and a height of 500 */
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetY", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 500);
CHECK(errRes);

# ** In this example, we define two regions in horizontal direction
# that will be transmitted as a single image. **
# Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.Value = True
# Select column 1
camera.BslMultipleROIColumnSelector.Value = "Column1"
# The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.Value = 100
camera.BslMultipleROIColumnSize.Value = 300
# Select column 2
camera.BslMultipleROIColumnSelector.Value = "Column2"
# The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.Value = 500
camera.BslMultipleROIColumnSize.Value = 400
# We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.Value = False
# Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.Value = 200
camera.Height.Value = 500

또한 pylon Viewer를 사용하여 파라미터를 손쉽게 설정할 수 있습니다.