Data Chunks#

Data Chunks 카메라 기능을 사용하면 부가적인 이미지 데이터를 생성하여 획득하는 모든 이미지에 추가할 수 있습니다.

기능 사용#

작동 방식#

Data Chunks를 사용하면 개별 이미지 획득 과정에 부가 정보를 추가할 수 있습니다. 원하는 부가 정보가 생성되어 Data Chunks 형태로 이미지 데이터에 추가됩니다.

이미지 데이터 역시 "chunk"로 간주됩니다. 이 "이미지 데이터 chunk"는 비활성화할 수 없으며 카메라에서 전송되는 항상 첫 번째 chunk입니다. 하나 이상의 Data Chunks가 활성화된 경우, 이 chunk들은 chunk 2, chunk 3 등의 순서로 전송됩니다.

아래 그림은 선행 이미지 데이터 chunk와 추가된 Data Chunks가 포함된 chunk 세트를 보여줍니다. 이 예제에서는 CRC Checksum Chunk 기능이 활성화되어 있다고 가정합니다.

Data Chunks가 컴퓨터로 전송된 후에는 정보를 얻기 위해 이를 검색해야 합니다. 정확한 절차는 카메라 모델과 애플리케이션에 사용된 프로그래밍 언어에 따라 다릅니다. Data Chunks 검색에 대한 자세한 내용은 pylon API Documentation을 참조하십시오.

추가 메타데이터#

데이터 청크 외에도 카메라는 개별 이미지에 이미지 높이, 이미지 너비, 이미지 ROI 오프셋, 사용된 픽셀 형식 등의 추가 메타데이터를 포함합니다. 이 정보는 pylon API 를 통해 그랩 결과 데이터에 접근하여 가져올 수 있습니다.

Data Chunks 활성화 및 검색#

1. 파라미터를 원하는 ChunkModeActive 파라메터 true.
2. 파라미터를 원하는 ChunkSelector 활성화하려는 청크 유형에 대한 매개변수 (사용 가능한 경우):
   • AutoBrightnessStatus
   • CounterValue
   • ExposureTime
   • FocusIndicator
   • Framecounter
   • FrameID
   • Gain
   • LineStatusAll
   • PayloadCRC16
   • SequenceSetIndex 또는 SequencerSetActive
   • Timestamp
   • Triggerinputcounter
3. 다음 설정을 지정하여 선택한 청크를 활성화합니다. ChunkEnable 파라메터 true.
4. 원하는 모든 청크에 대해 2단계와 3단계를 반복합니다.
5. 애플리케이션에 청크 검색 기능을 구현하십시오.
   청크 검색 구현에 대한 자세한 내용은 pylon API 문서를 참조하십시오.

라인 스캔 GigE 카메라용 Data Chunks 사용#

Data Chunks 및 Counter 기능을 트리거 설정과 함께 사용하면 어떤 라인이 특정 프레임에 속하는지, 그리고 어떤 프레임이 올바른 테스트 대상에 속하는지 지정할 수 있습니다. 트리거, 카운터 및 데이터 청크 설정을 조합하면 기록된 프레임과 해당 청크 데이터 간의 일관성을 확보할 수 있습니다.
데이터 청크 및 카운터 사용 방법에 대한 자세한 내용은 ‘GigE 라인 스캔 사용 사례 설명 및 다이어그램’ 항목을 참조하십시오.

사용 가능한 Data Chunks#

자동 밝기 상태 Chunk#

이 청크가 사용 가능하고 활성화된 경우, 카메라는 모든 이미지에 대상 밝기 조정 상태를 추가합니다.

목표 밝기 조정은 다음 중 하나에 해당할 때마다 수행됩니다. Exposure Auto 또는 Gain Auto 자동 기능이 활성화되거나 둘 다 활성화될 때마다 수행됩니다.

• On ace 2, boost 및 dart M/R 카메라, BslChunkAutoBrightnessStatus 매개변수가 제공됩니다. 이 매개변수는 다음 열거형을 사용하여 자동 밝기 상태를 나타냅니다:

  • Disabled: 목표 밝기 조정 기능이 비활성화되어 있습니다. 즉, Gain Auto 및 Exposure Auto 는 Off.
  • TargetNotReached: 목표 밝기 조정 기능이 활성화되어 있지만, 목표 밝기 값에 도달하지 않았습니다.
  • TargetReached: 목표 밝기 조정 기능이 활성화되었으며, 목표 밝기 값에 도달했습니다.

• 기타 카메라의 경우 상태는 다음 값으로 표시됩니다.

  • 0: 상태와 동일합니다(위 참조). Disabled 상태, 위 참조.
  • 1: 상태와 동일합니다(위 참조). TargetNotReached 상태, 위 참조.
  • 2: 상태와 동일합니다(위 참조). TargetReached 상태, 위 참조.

Counter 값 Chunk#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 모든 이미지에 카메라의 Counter 현재 값을 추가합니다.

• On ace 2, boost 및 dart M/R 카메라, ChunkCounterSelector 매개변수를 사용할 수 있습니다. 이 매개변수를 통해 데이터를 가져올 Counter를 선택할 수 있습니다. 이렇게 하려면 매개변수를 다음으로 설정하십시오. Counter1 또는 Counter2.
• 기타 카메라의 경우, 카메라는 획득한 이미지 수를 카운트하는 Counter 1의 현재 값을 항상 가져옵니다.

CRC 체크섬 Chunk#

이 청크가 활성화된 경우, 카메라는 모든 이미지에 CRC-16(순환 중복 검사) 체크섬을 추가합니다.

체크섬은 초기값 0x0000과 함께 다항식 x¹⁶ + x¹² + x⁵ + 1을 사용하여 계산됩니다. 동일한 알고리즘이 XMODEM 파일 전송 프로토콜에 사용됩니다. 체크섬에는 이미지 데이터와, 추가된 청크가 있는 경우 CRC 청크 자체를 제외한 모든 추가 청크가 포함됩니다.

CRC 체크섬 청크는 항상 이미지 데이터에 추가되는 마지막 청크입니다.

엔코더 값 Chunk#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 프레임의 첫 번째 노출 라인에 대한 인코더 위치 Counter 값을 모든 이미지에 추가합니다.
인코더 제어 및 모니터링에 대한 정보는 Encoder Control 항목을 참조하십시오.

Exposure Time Chunk#

이 청크가 활성화된 경우, 카메라는 이미지 취득에 사용된 Exposure Time을 모든 이미지에 추가합니다.

데이터 청크에는 다음이 포함됩니다. ExposureTime 그리고 다음을 설정합니다. ChunkExposureTimeSelector 파라미터 값.

The ChunkExposureTimeSelector 매개변수는 Exposure Time 청크에 포함할 Exposure Time을 선택합니다.

포커스 표시기 Chunk#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 취득한 모든 이미지에서 초점 수준을 나타내는 값을 추가합니다.

값은 0.0에서 4095.0 사이일 수 있습니다. 값이 높을수록 초점 수준이 높음을 나타냅니다. 계산은 5×5 선명도 감지 알고리즘을 기반으로 합니다.

초점 표시기 청크의 일반적인 사용 사례는 렌즈 초점이 맞춰지는 동안 청크 값의 변화를 모니터링하는 것입니다. 예를 들어, 값이 계속 증가하다가 감소하기 시작한다면 이는 양호한 초점 수준에 도달했음을 나타낼 수 있습니다.

장면의 변화(예: 밝기 증가)는 청크 값에 영향을 미칩니다. 따라서 청크 값을 모니터링하는 동안 대상 장면이 변경되지 않도록 하십시오.

Focus Indicator ROI#

기본적으로 카메라는 초점 수준을 계산하기 위해 거의 전체 Image ROI를 사용합니다.

이를 변경하여 초점 수준을 계산하는 데 사용할 센서 어레이의 부품을 최대 두 개까지 지정할 수 있습니다. 이는 Auto Function ROI를 설정하는 것과 유사합니다. 두 개의 Focus Indicator ROI를 사용할 수 있습니다.

Focus Indicator ROI를 구성하려면:

1. 파라미터를 원하는 BslFocusIndicatorROISelector 매개변수를 원하는 Focus Indicator ROI(예:)로 설정합니다. ROI1.
2. 파라미터를 원하는 BslFocusIndicatorROIEnable 파라메터 true 선택한 Focus Indicator ROI를 활성화합니다.
   기본적으로 ROI 1은 활성화되어 있고 ROI 2는 비활성화되어 있습니다.
3. 다음 파라미터의 값을 입력하여 위치 를 지정하십시오(선택한 포커스 인디케이터 ROI):
   • AutoFunctionROIOffsetX (아래 참고 참조)
   • AutoFunctionROIOffsetY
4. 다음 파라미터의 값을 입력하여 크기 를 지정하십시오(선택한 포커스 인디케이터 ROI):
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

프레임 Counter Chunk#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 획득한 이미지의 수를 모든 이미지에 추가합니다.

이를 위해 카메라는 Counter 2 카운터의 현재 값을 가져옵니다. Frame Counter 청크가 있는 카메라에서 Counter 2는 획득한 이미지의 수를 셉니다.

카운터를 수동으로 재설정하려면 Counter 2를 재설정하십시오.

프레임 ID Chunk#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 노출된 이미지의 번호를 나타내는 프레임 ID를 모든 이미지에 추가합니다.

프레임 ID는 0에서 시작하며 카메라 전원이 꺼질 때까지 노출된 이미지마다 1씩 계속 증가합니다. 최대값은 2^48입니다.

게인 Chunk(= GainAll Chunk)#

이 청크를 사용할 수 있고 활성화된 경우, 카메자는 이미지 획득에 사용된 게인을 모든 이미지에 추가합니다.

데이터 청크에는 다음이 포함됩니다. Gain 매개변수 값.

Line Status All Chunk#

이 청크가 활성화된 경우, 카메자는 이미지 획득이 트리거된 순간의 모든 I/O 라인의 상태를 모든 이미지에 추가합니다.

데이터 청크에는 다음이 포함됩니다. LineStatusAll 매개변수 값.

Sequencer Set Active Chunk(= Sequence Set Index Chunk)#

이 청크를 사용할 수 있고 활성화된 경우, 카메라는 이미지 획득에 사용된 Sequencer 세트를 모든 이미지에 추가합니다.

데이터 청크에는 다음이 포함됩니다. SequencerSetActive 또는 SequenceSetIndex 파라미터 값 (다음에 따라 다름: 따라).

Timestamp Chunk#

이 기능이 활성화되면 카메라는 모든 이미지에 특정 이벤트의 내부 Timestamp(틱 단위)를 추가합니다.

• On ace 2, boost 및 dart M/R 카메라, timestamp가 포함된 파라미터의 이름은 BslChunkTimestampValue.
  또한 BslChunkTimestampSelector 파라미터를 사용하는 것을 권장합니다.

  • FrameStart: BslChunkTimestampValue 파라미터는 현재 이미지의 취득이 시작된 시점을 나타냅니다.
  • ExposureStart: BslChunkTimestampValue 파라미터는 현재 이미지의 노출이 시작된 시점을 나타냅니다. rolling shutter 카메라의 경우, 이 파라미터는 첫 번째 행의 노출이 시작된 시점을 나타냅니다.
  • ExposureEnd: BslChunkTimestampValue 파라미터는 현재 이미지의 노출이 종료된 시점을 나타냅니다. rolling shutter 카메라에서는 이 파라미터가 작동하지 않으며 0으로 사전 설정되어 있습니다.

• On 기타 카메라, timestamp가 포함된 파라미터의 이름은 ChunkTimestamp. 이 파라미터는 항상 현재 이미지의 취득이 시작된 시점을 나타냅니다.

트리거 입력 Counter Chunk#

이 기능을 사용할 수 있고 활성화된 경우, 카메라는 수신된 하드웨어 프레임 시작 트리거 신호의 개수를 모든 이미지에 추가합니다.

이를 위해 카메라는 Counter 1 counter의 현재 값을 가져옵니다. Trigger Input Counter 청크가 있는 카메라에서 Counter 1은 수신된 하드웨어 트리거 신호의 개수를 셉니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

// Enable data chunks
camera.ChunkModeActive.SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
camera.ChunkSelector.SetValue(ChunkSelector_ExposureTime);
// Enable the selected chunk
camera.ChunkEnable.SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

INodeMap& nodemap = camera.GetNodeMap();
// Enable data chunks
CBooleanParameter(nodemap, "ChunkModeActive").SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
CEnumParameter(nodemap, "ChunkSelector").SetValue("ExposureTime");
// Enable the selected chunk
CBooleanParameter(nodemap, "ChunkEnable").SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

// Enable data chunks
camera.Parameters[PLCamera.ChunkModeActive].SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
camera.Parameters[PLCamera.ChunkSelector].SetValue(PLCamera.ChunkSelector.ExposureTime);
// Enable the selected chunk
camera.Parameters[PLCamera.ChunkEnable].SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

/* 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 */
/* Enable data chunks */
errRes = PylonDeviceSetBooleanFeature(hdev, "ChunkModeActive", 1);
CHECK(errRes);
/* Select a chunk, e.g., the Exposure Time chunk */
errRes = PylonDeviceFeatureFromString(hdev, "ChunkSelector", "ExposureTime");
CHECK(errRes);
/* Enable the selected chunk */
errRes = PylonDeviceSetBooleanFeature(hdev, "ChunkEnable", 1);
CHECK(errRes);
/* Now, you must implement chunk retrieval in your application. */
/* For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and */
/* "Chunks" code samples in the pylon API Documentation */

# Enable data chunks
camera.ChunkModeActive.Value = True
# Select a chunk, e.g., the Exposure Time chunk
camera.ChunkSelector.Value = "ExposureTime"
# Enable the selected chunk
camera.ChunkEnable.Value = True
# Now, you must implement chunk retrieval in your application.
# For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
# "Chunks" code samples in the pylon API Documentation

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