Stacked ROI#

Stacked ROI camera feature를 사용하면 센서 어레이 상에서 높이는 다양하고 너비는 동일한 여러 영역을 단일 이미지로 전송되도록 정의할 수 있습니다.

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

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

기능 사용법#

작동 원리#

Stacked ROI 기능을 사용하면 센서 어레이에 너비가 동일하고 수직으로 정렬된 영역을 정의할 수 있습니다. 최대 영역 수는 your camera model에 따라 다릅니다.

이미지가 획득되면 정의된 영역 내의 픽셀 정보만 센서에서 읽어옵니다. 그런 다음 픽셀 정보가 적층되어 단일 이미지로 전송됩니다.

영역의 너비는 항상 동일하며 수직으로 정렬됩니다. 영역을 구성하려면 Basler에서는 다음 절차를 권장합니다.

1. 모든 영역에 유효한 너비와 수평 오프셋을 정의합니다.
2. 개별 영역의 높이와 수직 오프셋을 정의합니다.

ROI 영역 설정#

1. 카메라가 유휴 상태인지, 즉 이미지를 캡처하고 있지 않은지 확인하십시오.
2. 다음 값 중 하나로 OffsetX 파라미터를 원하는 수평 오프셋으로 설정합니다. 이 값은 다음 항목에 적용됩니다. 모든 영역.
3. 다음 값 중 하나로 Width 파라미터를 원하는 영역 너비로 설정합니다. 이 값은 다음 항목에 적용됩니다. 모든 영역.
4. 다음 값 중 하나로 ROIZoneSelector 파라미터를 구성하려는 영역으로 설정합니다(예:). Zone0.
5. 다음 값 중 하나로 ROIZoneOffset 파라미터를 원하는 수직 오프셋으로 설정합니다. 이 값은 4단계에서 선택한 영역에 적용됩니다.
6. 다음 값 중 하나로 ROIZoneSize 파라미터를 원하는 영역 높이로 설정합니다. 이 값은 4단계에서 선택한 영역에 적용됩니다.
7. 다음 값 중 하나로 ROIZoneMode 매개변수: On 영역을 활성화합니다.
8. 구성하려는 각 영역에 대해 4단계부터 7단계까지 반복합니다.

Stacked ROI 기능을 사용할 때의 고려사항#

• 원하는 순서대로 영역을 활성화할 수 있습니다. 예를 들어 영역 1, 3, 5를 활성화하고 영역 0, 2, 4를 비활성화할 수 있습니다.
• 센서 주변에 영역을 자유롭게 배치할 수 있습니다. 예를 들어 영역 0을 하단 근처에, 영역 2를 상단 근처에, 영역 1을 중앙에 배치할 수 있습니다. 그러나 카메라는 항상 센서의 가장 상단 영역에서 픽셀 데이터 읽기 및 전송을 시작한 후 하단쪽으로 진행합니다.
• 수직으로 겹치는 영역을 정의할 수 있습니다. 두 영역이 겹치면 병합된 단일 영역으로 전송됩니다. 겹치는 영역의 픽셀 데이터는 한 번만 읽혀서 전송됩니다.
• 하나 이상의 영역이 정의되면 다음 파라미터는 읽기 전용이 됩니다.
  • OffsetY: 파라미터가 가장 상단 영역의 수직 오프셋으로 설정됩니다.
  • Height: 파라미터가 최종 이미지의 높이, 즉 모든 영역 높이의 합으로 설정됩니다.
  • CenterY
  • Sequencer 기능과 관련된 모든 파라미터.
• 영역을 설정한 후 Binning을 활성화하면, 영역의 위치와 크기가 자동으로 조정됩니다. 파라미터 값은 해당 binning factor로 나누어진 후 내림 처리됩니다.
• Stacked ROI 기능을 사용한 후 모든 영역을 비활성화하면, Image ROI의 크기와 위치는 마지막으로 비활성화된 영역의 크기와 위치로 설정됩니다. 예를 들어 영역 0, 1, 2가 활성화되어 있다고 가정해 보겠습니다. 그런 다음 2, 1, 0 순서로 영역을 비활성화합니다. 결과적으로 Image ROI의 크기와 위치는 비활성화된 영역 0의 크기와 위치로 설정됩니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

// Configure width and offset X for all zones
camera.Width.SetValue(200);
camera.OffsetX.SetValue(100);
// Select zone 0
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone0);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(100);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(100);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);
// Select zone 1
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone1);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(250);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(200);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);

INodeMap& nodemap = camera.GetNodeMap();
// Configure width and offset X for all zones
CIntegerParameter(nodemap, "Width").SetValue(200);
CIntegerParameter(nodemap, "OffsetX").SetValue(100);
// Select zone 0
CEnumParameter(nodemap, "ROIZoneSelector").SetValue("Zone0");
// Set the vertical offset for the selected zone
CIntegerParameter(nodemap, "ROIZoneOffset").SetValue(100);
// Set the height for the selected zone
CIntegerParameter(nodemap, "ROIZoneSize").SetValue(100);
// Enable the selected zone
CEnumParameter(nodemap, "ROIZoneMode").SetValue("On");
// Select zone 1
CEnumParameter(nodemap, "ROIZoneSelector").SetValue("Zone1");
// Set the vertical offset for the selected zone
CIntegerParameter(nodemap, "ROIZoneOffset").SetValue(250);
// Set the height for the selected zone
CIntegerParameter(nodemap, "ROIZoneSize").SetValue(200);
// Enable the selected zone
CEnumParameter(nodemap, "ROIZoneMode").SetValue("On");

// Configure width and offset X for all zones
camera.Parameters[PLCamera.Width].SetValue(200);
camera.Parameters[PLCamera.OffsetX].SetValue(100);
// Select zone 0
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone0);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(100);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(100);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);
// Select zone 1
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone1);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(250);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(200);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);

/* 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 */
/* Configure width and offset X for all zones */
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetX", 100);
CHECK(errRes);
/* Select zone 0 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone0");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 100);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 100);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);
/* Select zone 1 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone1");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 250);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 200);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);

# Configure width and offset X for all zones
camera.Width.Value = 200
camera.OffsetX.Value = 100
# Select zone 0
camera.ROIZoneSelector.Value = "Zone0"
# Set the vertical offset for the selected zone
camera.ROIZoneOffset.Value = 100
# Set the height for the selected zone
camera.ROIZoneSize.Value = 100
# Enable the selected zone
camera.ROIZoneMode.Value = "On"
# Select zone 1
camera.ROIZoneSelector.Value = "Zone1"
# Set the vertical offset for the selected zone
camera.ROIZoneOffset.Value = 250
# Set the height for the selected zone
camera.ROIZoneSize.Value = 200
# Enable the selected zone
camera.ROIZoneMode.Value = "On"

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