Data Chunks#

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

기능 사용법#

작동 원리#

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

이미지 데이터도 하나의 "chunk"로 취급됩니다. 이 "image data chunk"는 비활성화할 수 없으며 카메라에서 항상 가장 먼저 전송되는 chunk입니다. 하나 이상의 Data Chunks가 활성화된 경우, 이들 chunk는 chunk 2, chunk 3 등의 순서로 전송됩니다.

아래 그림은 선행 이미지 data chunk와 추가된 Data Chunks로 구성된 chunk 세트를 보여줍니다. 이 예시는 CRC Checksum Chunk 기능이 활성화되어 있다고 가정합니다.

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

추가 메타데이터#

카메라는 Data Chunks 외에도 이미지 높이, 이미지 너비, Image ROI 오프셋, 사용된 Pixel Format 등 추가 메타데이터를 개별 이미지에 추가합니다. 이 정보는 pylon API를 통해 그랩 결과 데이터에 접근하여 검색할 수 있습니다.

Data Chunks 활성화 및 검색#

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

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

Data Chunks 및 Counter 기능을 트리거 설정과 함께 사용하면 어떤 라인이 프레임에 속하고 어떤 프레임이 올바른 테스트 대상에 속하는지 지정할 수 있습니다. 트리거, 카운터, Data Chunks 설정의 조합을 통해 기록된 프레임과 해당 chunk 데이터 간의 일관성을 확립할 수 있습니다.
Data Chunks 및 카운터 사용 방법에 대한 자세한 내용은 GigE Line Scan Use Case Descriptions and Diagrams 항목을 참조하십시오.

사용 가능한 Data Chunks#

Auto Brightness Status Chunk#

이 chunk를 사용할 수 있고 활성화된 경우, 카메라는 모든 이미지에 target brightness adjustments 상태를 추가합니다.

목표 밝기 조정은 Exposure Auto 또는 Gain Auto 자동 기능 중 하나 또는 둘 다 활성화될 때 수행됩니다.

• On ace 2, boost, dart M/R 카메라, BslChunkAutoBrightnessStatus 파라미터를 사용할 수 있습니다. 다음 열거형(enumeration)을 사용하여 자동 밝기 상태를 나타냅니다:

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

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

  • 0: 다음과 같습니다. Disabled 상태(위 참조).
  • 1: 다음과 같습니다. TargetNotReached 상태(위 참조).
  • 2: 다음과 같습니다. TargetReached 상태(위 참조).

Counter Value Chunk#

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

• On ace 2, boost, dart M/R 카메라, ChunkCounterSelector 파라미터를 사용할 수 있습니다. 이 파라미터를 사용하면 데이터를 가져올 Counter를 선택할 수 있습니다. 이를 위해 파라미터를 다음과 같이 설정합니다. Counter1 또는 Counter2.
• 기타 카메라의 경우 카메라는 항상 획득한 이미지의 수를 세는 Counter 1의 현재 값을 가져옵니다.

CRC Checksum Chunk#

이 청크가 활성화된 경우, 카메라는 CRC-16(Cyclic Redundancy Check) 체크섬을 모든 이미지에 추가합니다.

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

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

Encoder Value Chunk#

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

Exposure Time Chunk#

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

데이터 청크에는 다음이 포함됩니다. ExposureTime 그리고 다음을 설정하십시오: ChunkExposureTimeSelector 파라미터 값입니다.

이 ChunkExposureTimeSelector 파라미터는 Exposure Time 청크에 포함될 Exposure Time을 선택합니다.

Focus Indicator Chunk#

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

값의 범위는 0.0에서 4095.0까지입니다. 값이 높을수록 초점 수준이 높음을 나타냅니다. 계산은 5×5 선명도 감지 알고리즘을 기반으로 합니다.

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

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

Focus Indicator ROIs#

기본적으로 카메라는 초점 수준을 계산하기 위해 거의 전체 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

Frame Counter Chunk#

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

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

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

Frame ID Chunk#

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

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

Gain Chunk (= GainAll Chunk)#

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

데이터 청크에는 다음이 포함됩니다. Gain 파라미터 값입니다.

Line Status All Chunk#

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

데이터 청크에는 다음이 포함됩니다. LineStatusAll 파라미터 값입니다.

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

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

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

Timestamp Chunk#

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

• On ace 2, boost, dart M/R 카메라, timestamp가 포함된 파라미터의 이름은 BslChunkTimestampValue.
  또한 BslChunkTimestampSelector 파라미터를 사용할 수 있으며, 이를 통해 timestamp가 참조할 이벤트 유형을 선택할 수 있습니다.

  • FrameStart: BslChunkTimestampValue 파라미터는 현재 이미지의 획득이 시작된 시점을 나타냅니다.
  • ExposureStart: BslChunkTimestampValue 파라미터는 현재 이미지의 Exposure Time가 시작된 시점을 나타냅니다. rolling shutter 카메라에서 이 파라미터는 첫 번째 행의 Exposure Time가 시작된 시점을 나타냅니다.
  • ExposureEnd: BslChunkTimestampValue 파라미터는 현재 이미지의 Exposure Time가 종료된 시점을 나타냅니다. rolling shutter 카메라에서는 이 파라미터가 아무런 기능도 하지 않으며 0으로 사전 설정되어 있습니다.

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

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