Counter#

Counter camera feature를 사용하면 획득한 이미지 수 등 특정 카메라 이벤트를 카운트할 수 있습니다.

기능 사용법#

이 기능의 구현 방식은 카메라에 따라 다릅니다.

• ace 2, boost R, dart M/R, racer 2 카메라
• ace Classic/U/L 카메라

ace 2, boost R, dart M/R, racer 2 카메라#

작동 원리#

카메라 모델에 따라 최대 4개의 Counter(Counter 1, Counter 2, Counter 3, Counter 4)를 사용할 수 있습니다.

모든 Counter는 다음과 같은 특성을 가집니다.

• 0에서 시작합니다.
• 카운트하기 전에 반드시 시작해야 합니다.
• 시작되면 특정 유형의 이벤트("event source")를 카운트할 수 있습니다. 예를 들어, 노출된 이미지 수를 카운트할 수 있습니다.
• 언제든지 0으로 reset할 수 있습니다.
• 현재 값은 다음의 값을 가져와서 확인할 수 있습니다. CounterValue 파라미터.
• 최대값은 다음 항목에 의해 정의됩니다. CounterDuration 파라미터 값(기본값: 4 294 967 295). 최대값에 도달하면 Counter는 카운트를 중지하므로 다음을 수행해야 합니다. reset.
• 현재 상태는 다음의 값을 가져와서 확인할 수 있습니다. CounterStatus 파라미터.
• 카메라를 껐다가 다시 켜면 0으로 reset됩니다.

Counter 값 가져오기#

Counter의 현재 값을 확인하려면 다음의 값을 가져옵니다. CounterValue 이 매개변수는 읽기 전용입니다.

Counter 시작하기#

Counter를 시작하려면:

1. 다음 값 중 하나로 CounterSelector 원하는 Counter에 대한 파라미터 (예: Counter2.
2. 다음 값 중 하나로 CounterTriggerSource Counter를 시작하는 데 사용할 소스에 대한 파라미터 (예: Line2.
3. 해당하는 경우 다음 설정으로 지정하세요. CounterTriggerActivation 매개변수를 다음 값 중 하나로 설정합니다:
   • RisingEdge (기본값): 신호가 발생할 때 Counter가 시작됩니다. 상승할 때, 즉 신호 상태가 low에서 high로 바뀔 때 Timer가 시작됩니다.
   • FallingEdge: 신호가 발생할 때 Counter가 시작됩니다. 하강할 때, 즉 신호 상태가 high에서 low로 바뀔 때 Timer가 시작됩니다.
   • AnyEdge: 신호가 발생할 때 Counter가 시작됩니다. 하강 또는 상승할 때.
   • LevelHigh: 신호가 다음과 같을 때 Counter가 시작됩니다. high. 신호가 low로 변경되면 Counter가 상태는 로 설정된 경우, CounterTriggerWait 그리고 반드시 시작 해야 합니다.
   • LevelLow: 신호가 다음과 같을 때 Counter가 시작됩니다. low. 신호가 high로 변경되면 Counter가 상태는 로 설정된 경우, CounterTriggerWait 그리고 반드시 시작 해야 합니다.
4. 선택한 Counter Trigger Source로 신호를 보내 Counter를 시작합니다.

시작될 때, Counter의 상태는 다음에서 변경됩니다. CounterTriggerWait (으)로 CounterActive.

Counter 증가시키기#

Counter가 시작되면 증가할 수 있으며, 즉 카운팅이 가능해집니다.

Counter를 증가시키려면:

1. 다음 값 중 하나로 CounterSelector 원하는 Counter에 대한 파라미터 (예: Counter2.
2. 다음 값 중 하나로 CounterEventSource 파라미터를 Counter를 증가시키는 데 사용할 소스로 설정합니다(예: Line2.
3. 해당하는 경우 다음 설정으로 지정하세요. CounterEventActivation 매개변수를 다음 값 중 하나로 설정합니다:
   • RisingEdge (기본값): 신호가 발생할 때 Counter가 카운팅됩니다. 상승할 때, 즉 신호 상태가 low에서 high로 바뀔 때 Timer가 시작됩니다.
   • FallingEdge: 신호가 발생할 때 Counter가 카운팅됩니다. 하강할 때, 즉 신호 상태가 high에서 low로 바뀔 때 Timer가 시작됩니다.
   • AnyEdge: 신호가 발생할 때 Counter가 카운팅됩니다. 하강 또는 상승할 때.
4. 다음 값 중 하나로 CounterDuration 파라미터를 원하는 최대값으로 설정합니다.
5. 선택한 Counter event source로 신호를 전송하여 Counter를 증가시킵니다.

카메라가 선택한 소스에서 신호를 감지할 때마다 Timer가 지정된 최대값까지 증가합니다.

Counter 재설정하기#

언제든지 Counter를 0으로 리셋할 수 있습니다.

Counter가 최대값(에 의해 정의됨)에 도달했고 이를 다시 사용하려는 경우 CounterDuration 파라미터 값) Counter를 리셋해야 합니다.

소프트웨어로 리셋#

소프트웨어로 Counter를 리셋하려면 다음을 실행하십시오. CounterReset 명령입니다.

또는 소프트웨어 신호를 리셋 소스로 설정할 수 있습니다(아래 참조).

리셋 소스를 사용하여 리셋#

이 CounterResetSource 파라미터를 사용하면 Counter를 리셋하는 소스를 지정할 수 있습니다.

리셋 소스를 사용하여 Counter를 리셋하려면:

1. 다음 값 중 하나로 CounterSelector 원하는 Counter에 대한 파라미터 (예: Counter2.
2. 다음 값 중 하나로 CounterResetSource 파라미터를 Counter를 리셋하는 데 사용할 소스로 설정합니다(예: Line2.
3. 해당하는 경우 다음 설정으로 지정하세요. CounterResetActivation 매개변수를 다음 값 중 하나로 설정합니다:
   • RisingEdge (기본값): 신호가 발생할 때 Counter가 리셋됩니다. 상승할 때, 즉 신호 상태가 low에서 high로 바뀔 때 Timer가 시작됩니다.
   • FallingEdge: 신호가 발생할 때 Counter가 리셋됩니다. 하강할 때, 즉 신호 상태가 high에서 low로 바뀔 때 Timer가 시작됩니다.
   • AnyEdge: 신호가 발생할 때 Counter가 리셋됩니다. 하강 또는 상승할 때.
4. 선택한 Counter reset source로 신호를 전송하여 Counter를 리셋합니다.

리셋되면 Counter의 상태는 변경 사항: CounterTriggerWait 그리고 반드시 시작 해야 합니다.

Counter 중지하기#

Counter를 중지하려면 다음 작업 중 하나를 수행하십시오.

• 선택한 event source에서 신호 전송을 중지합니다.
• 다음 값 중 하나로 CounterEventSource 매개변수: Off.
• Counter를 Reset합니다.

Counter 상태 가져오기#

Counter의 현재 상태를 확인하려면 다음의 값을 가져옵니다. CounterStatus 이 매개변수는 읽기 전용입니다.

가능한 값은 다음과 같습니다:

• CounterTriggerWait: Counter가 대기 중입니다. 시작.
• CounterActive: Counter가 선택한 항목에 의해 증가되기를 기다리고 있습니다. event source 또는 현재 카운트 중입니다.
• CounterCompleted: Counter가 다음 항목에 의해 정의된 최댓값에 도달했습니다. CounterDuration 파라미터.
• CounterIdle: Counter가 유휴 상태입니다. Counter는 다음 상태일 때 유휴 상태가 됩니다. CounterTriggerSource 로 설정된 경우 Off, 즉 Counter를 시작할 수 없습니다.

라인 스캔 GigE 카메라용 Counter 사용하기#

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

ace Classic/U/L 카메라#

작동 원리#

Counter 1과 Counter 2 등 두 개의 Counter를 사용할 수 있습니다.

한 가지 예외(아래 참조)를 제외하고 모든 Counter에는 다음과 같은 특성이 있습니다.

• 0에서 시작합니다.
• 특정 유형의 이벤트("event source")를 카운트합니다. 예를 들어 획득한 이미지 수를 카운트합니다. event source는 사전 설정되어 있으며 변경할 수 없습니다.
• 현재 값은 예를 들어 Frame Counter 청크와 같은 related data chunk를 검색하여 확인할 수 있습니다.
• 최댓값은 4,294,967,295입니다. 최댓값에 도달하면 Counter가 0으로 재설정된 후 카운트를 계속합니다.
• 수동으로 reset할 수 있습니다.
• 카메라를 껐다가 다시 켜면 0으로 reset됩니다.

예외: 일부 카메라 모델에서는 Counter 2를 사용하여 Sequencer를 제어할 수 있습니다. 이 Counter는 특정 목적 때문에 다른 특성을 갖습니다.

Counter 값 가져오기#

Counter의 현재 값을 확인하려면 Data Chunks 기능을 사용하여 related data chunk를 검색하십시오.

Counter 재설정하기#

Counter를 reset하려면:

다음 값 중 하나로 CounterSelector 원하는 Counter에 대한 파라미터 (예: Counter2.

다음 값 중 하나로 CounterResetSource 파라미터를 소프트웨어 소스(Software) 또는 하드웨어 소스(예: Line1).

2단계에서 선택한 소스에 따라 다음 중 하나를 수행하십시오.

1. 소프트웨어 소스를 설정한 경우, 다음을 실행하십시오. CounterReset 명령입니다.
2. 하드웨어 소스를 설정한 경우, 카메라의 입력 라인 중 하나에 전기적 신호를 인가하십시오.

추가 Parameters#

• 이 CounterEventSource parameter를 통해 현재 선택된 Counter의 이벤트 소스, 즉 Counter가 증가하는 조건을 확인할 수 있습니다.
• 이 CounterResetActivation parameter는 현재 아무런 기능도 수행하지 않습니다. 이 값은 다음으로 사전 설정되어 있습니다: RisingEdge. 이는 Counter가 하드웨어 리셋용으로 구성된 경우, 하드웨어 트리거 신호가 상승할 때 Counter가 리셋됨을 의미합니다.

세부 정보#

모든 카메라 모델 보기

샘플 코드#

ace 2, boost R, dart M/R, racer 2 카메라#

// Select Counter 1
camera.CounterSelector.SetValue(CounterSelector_Counter1);
// Specify that the counter starts when a software signal is sent via channel 1
camera.CounterTriggerSource.SetValue(CounterTriggerSource_SoftwareSignal1);
// Specify that the counter increases whenever a rising signal is detected on Line 1
camera.CounterEventSource.SetValue(CounterEventSource_Line1);
camera.CounterEventActivation.SetValue(CounterEventActivation_RisingEdge);
// Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.CounterResetSource.SetValue(CounterResetSource_Line2);
camera.CounterResetActivation.SetValue(CounterEventActivation_FallingEdge);
// Set the maximum value of the counter to 1000
camera.CounterDuration.SetValue(1000);
// Manually reset the counter
camera.CounterReset.Execute();
// Get the current status of the counter
CounterStatusEnums counterStatus = camera.CounterStatus.GetValue();
// Get the current value of the counter
int64_t i = camera.CounterValue.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Select Counter 1
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
// Specify that the counter starts when a software signal is sent via channel 1
CEnumParameter(nodemap, "CounterTriggerSource").SetValue("SoftwareSignal1");
// Specify that the counter increases whenever a rising signal is detected on Line 1
CEnumParameter(nodemap, "CounterEventSource").SetValue("Line1");
CEnumParameter(nodemap, "CounterEventActivation").SetValue("RisingEdge");
// Specify that the counter is reset whenever a falling signal is detected on Line 2
CEnumParameter(nodemap, "CounterResetSource").SetValue("Line2");
CEnumParameter(nodemap, "CounterResetActivation").SetValue("FallingEdge");
// Set the maximum value of the counter to 1000
CIntegerParameter(nodemap, "CounterDuration").SetValue(1000);
// Manually reset the counter
CCommandParameter(nodemap, "CounterReset").Execute();
// Get the current status of the counter
String_t counterStatus = CEnumParameter(nodemap, "CounterStatus").GetValue();
// Get the current value of the counter
int64_t i = CIntegerParameter(nodemap, "CounterValue").GetValue();

// Select Counter 1
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
// Specify that the counter starts when a software signal is sent via channel 1
camera.Parameters[PLCamera.CounterTriggerSource].SetValue(PLCamera.CounterTriggerSource.SoftwareSignal1);
// Specify that the counter increases whenever a rising signal is detected on Line 1
camera.Parameters[PLCamera.CounterEventSource].SetValue(PLCamera.CounterEventSource.Line1);
camera.Parameters[PLCamera.CounterEventActivation].SetValue(PLCamera.CounterEventActivation.RisingEdge);
// Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.Parameters[PLCamera.CounterResetSource].SetValue(PLCamera.CounterResetSource.Line2);
camera.Parameters[PLCamera.CounterResetActivation].SetValue(PLCamera.CounterEventActivation.FallingEdge);
// Set the maximum value of the counter to 1000
camera.Parameters[PLCamera.CounterDuration].SetValue(1000);
// Manually reset the counter
camera.Parameters[PLCamera.CounterReset].Execute();
// Get the current status of the counter
string counterStatus = camera.Parameters[PLCamera.CounterStatus].GetValue();
// Get the current value of the counter
Int64 i = camera.Parameters[PLCamera.CounterValue].GetValue();

/* 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 */
size_t len = 0;
char counterStatus_str[64] = {0};
int64_t i = 0;
/* Select Counter 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
/* Specify that the counter starts when a software signal is sent via channel 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterTriggerSource", "SoftwareSignal1");
CHECK(errRes);
/* Specify that the counter increases whenever a rising signal is detected on Line 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterEventSource", "Line1");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterEventActivation", "RisingEdge");
CHECK(errRes);
/* Specify that the counter is reset whenever a falling signal is detected on Line 2 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetSource", "Line2");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetActivation", "FallingEdge");
CHECK(errRes);
/* Set the maximum value of the counter to 1000 */
errRes = PylonDeviceSetIntegerFeature(hdev, "CounterDuration", 1000);
CHECK(errRes);
/* Manually reset the counter */
errRes = PylonDeviceExecuteCommandFeature(hdev, "CounterReset");
CHECK(errRes);
/* Get the current status of the counter */
len = sizeof(counterStatus_str);
errRes = PylonDeviceFeatureToString(hdev, "CounterStatus", counterStatus_str, &len);
CHECK(errRes);
/* Get the current value of the counter */
errRes = PylonDeviceGetIntegerFeature(hdev, "CounterValue", &i);
CHECK(errRes);

# Select Counter 1
camera.CounterSelector.Value = "Counter1"
# Specify that the counter starts when a software signal is sent via channel 1
camera.CounterTriggerSource.Value = "SoftwareSignal1"
# Specify that the counter increases whenever a rising signal is detected on Line 1
camera.CounterEventSource.Value = "Line1"
camera.CounterEventActivation.Value = "RisingEdge"
# Specify that the counter is reset whenever a falling signal is detected on Line 2
camera.CounterResetSource.Value = "Line2"
camera.CounterResetActivation.Value = "FallingEdge"
# Set the maximum value of the counter to 1000
camera.CounterDuration.Value = 1000
# Manually reset the counter
camera.CounterReset.Execute()
# Get the current status of the counter
counterStatus = camera.CounterStatus.Value
# Get the current value of the counter
i = camera.CounterValue.Value

ace Classic/U/L 카메라#

// Reset Counter 1 via software command
camera.CounterSelector.SetValue(CounterSelector_Counter1);
camera.CounterResetSource.SetValue(CounterResetSource_Software);
camera.CounterReset.Execute();
// Get the event source of Counter 1
camera.CounterSelector.SetValue(CounterSelector_Counter1);
CounterEventSourceEnums e = camera.CounterEventSource.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Reset Counter 1 via software command
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
CEnumParameter(nodemap, "CounterResetSource").SetValue("Software");
CCommandParameter(nodemap, "CounterReset").Execute();
// Get the event source of Counter 1
CEnumParameter(nodemap, "CounterSelector").SetValue("Counter1");
String_t e = CEnumParameter(nodemap, "CounterEventSource").GetValue();

// Reset Counter 1 via software command
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
camera.Parameters[PLCamera.CounterResetSource].SetValue(PLCamera.CounterResetSource.Software);
camera.Parameters[PLCamera.CounterReset].Execute();
// Get the event source of Counter 1
camera.Parameters[PLCamera.CounterSelector].SetValue(PLCamera.CounterSelector.Counter1);
string e = camera.Parameters[PLCamera.CounterEventSource].GetValue();

/* 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 */
size_t len = 0;
char e_str[64] = {0};
/* Reset Counter 1 via software command */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
errRes = PylonDeviceFeatureFromString(hdev, "CounterResetSource", "Software");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "CounterReset");
CHECK(errRes);
/* Get the event source of Counter 1 */
errRes = PylonDeviceFeatureFromString(hdev, "CounterSelector", "Counter1");
CHECK(errRes);
len = sizeof(e_str);
errRes = PylonDeviceFeatureToString(hdev, "CounterEventSource", e_str, &len);
CHECK(errRes);

# Reset Counter 1 via software command
camera.CounterSelector.Value = "Counter1"
camera.CounterResetSource.Value = "Software"
camera.CounterReset.Execute()
# Get the event source of Counter 1
camera.CounterSelector.Value = "Counter1"
e = camera.CounterEventSource.Value

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