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 파라미터가 다음으로 설정된 경우에만 Light Control 기능과 함께 사용할 수 있음을 명시했습니다. true, 다음 파라미터가 읽기 전용으로 전환됩니다:

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

• 카메라 모델에서 BslMultipleROIRowsEnable 파라미터가 다음으로 설정된 경우에만 Light Control 기능과 함께 사용할 수 있음을 명시했습니다. true, 다음 파라미터가 읽기 전용으로 전환됩니다:

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

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

• The 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를 사용하여 파라미터를 손쉽게 설정할 수도 있습니다.