Counter#

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

기능 사용#

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

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

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

작동 방식#

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

• 0에서 시작합니다.
• 카운트하기 전에 시작해야 합니다.
• 일단 시작되면 특정 유형의 이벤트("이벤트 소스")를 카운트할 수 있습니다. 예를 들어 노출된 이미지 수를 카운트할 수 있습니다.
• 언제든지 0으로 재설정(reset)할 수 있습니다.
• 현재 값은 다음의 값을 가져와서 확인할 수 있습니다. CounterValue 파라미터에 HTML 로그 파일(*.html)의 경로와 이름을 지정할 수 있습니다.
• 최대값은 다음으로 정의됩니다. CounterDuration 파라미터 값(기본값: 4 294 967 295). 최대값에 도달하면 Counter가 카운트를 멈추며 다음을 수행해야 합니다. reset.
• 현재 상태는 다음의 값을 가져와서 확인할 수 있습니다. CounterStatus 파라미터에 HTML 로그 파일(*.html)의 경로와 이름을 지정할 수 있습니다.
• 카메라 전원을 껐다가 다시 켜면 0으로 재설정됩니다.

Counter 값 가져오기#

Counter의 현재 값을 확인하려면 다음의 값을 가져옵니다. CounterValue 파라미터. 이 파라미터는 읽기 전용입니다.

Counter 시작하기#

Counter를 시작하려면:

1. 파라미터를 원하는 CounterSelector 원하는 Counter에 대한 파라미터(예:) Counter2.
2. 파라미터를 원하는 CounterTriggerSource Counter를 시작하는 데 사용할 소스에 대한 파라미터(예:) Line2.
3. 해당하는 경우, 다음을 설정하세요. CounterTriggerActivation 파라미터를 설정하십시오:
   • RisingEdge (기본값): 신호가 발생할 때 Counter가 시작됩니다. 상승, 즉 신호 상태가 Low에서 High로 변경될 때.
   • FallingEdge: 신호가 발생할 때 Counter가 시작됩니다. 하강, 즉 신호 상태가 High에서 Low로 변경될 때.
   • AnyEdge: 신호가 발생할 때 Counter가 시작됩니다. 하강 또는 상승.
   • LevelHigh: 신호가 발생할 때 Counter가 시작됩니다. High. 신호가 Low로 바뀌면 Counter가 status 이 다음으로 설정된 경우 CounterTriggerWait 이며 다음을 수행해야 합니다. 시작되었습니다. 제거합니다.
   • LevelLow: 신호가 발생할 때 Counter가 시작됩니다. Low. 신호가 High 상태로 전환되면 Counter status 이 다음으로 설정된 경우 CounterTriggerWait 이며 다음을 수행해야 합니다. 시작되었습니다. 제거합니다.
4. 선택한 Counter Trigger Source로 신호를 보내어 Counter를 시작합니다.

시작되면 Counter의 status 이(가) CounterTriggerWait 에서 CounterActive.

Counter 증가시키기#

Counter가 시작되면 증가할 수 있으며, 즉 카운트할 수 있습니다.

Counter를 증가시키려면:

1. 파라미터를 원하는 CounterSelector 원하는 Counter에 대한 파라미터(예:) Counter2.
2. 파라미터를 원하는 CounterEventSource 파라미터를 Counter를 증가시키는 데 사용할 소스로 설정합니다(예: Line2.
3. 해당하는 경우, 다음을 설정하세요. CounterEventActivation 파라미터를 설정하십시오:
   • RisingEdge (기본값): 신호가 들어올 때 Counter가 카운트합니다. 상승, 즉 신호 상태가 Low에서 High로 변경될 때.
   • FallingEdge: 신호가 들어올 때 Counter가 카운트합니다. 하강, 즉 신호 상태가 High에서 Low로 변경될 때.
   • AnyEdge: 신호가 들어올 때 Counter가 카운트합니다. 하강 또는 상승.
4. 파라미터를 원하는 CounterDuration 파라미터를 원하는 최대값으로 설정합니다.
5. 선택한 Counter event source로 신호를 보내어 Counter를 증가시킵니다.

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

Counter 재설정하기#

언제든지 Counter를 0으로 재설정할 수 있습니다.

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

소프트웨어를 통한 재설정#

소프트웨어로 Counter를 재설정하려면 다음을 실행하십시오. CounterReset command.

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

재설정 소스를 사용한 재설정#

The CounterResetSource 파라미터를 사용하면 Counter를 재설정할 소스를 지정할 수 있습니다.

재설정 소스를 사용하여 Counter를 재설정하려면:

1. 파라미터를 원하는 CounterSelector 원하는 Counter에 대한 파라미터(예:) Counter2.
2. 파라미터를 원하는 CounterResetSource 파라미터를 Counter를 재설정하는 데 사용할 소스로 설정합니다(예: Line2.
3. 해당하는 경우, 다음을 설정하세요. CounterResetActivation 파라미터를 설정하십시오:
   • RisingEdge (기본값): 신호가 입력되면 Counter가 재설정됩니다. 상승, 즉 신호 상태가 Low에서 High로 변경될 때.
   • FallingEdge: 신호가 입력되면 Counter가 재설정됩니다. 하강, 즉 신호 상태가 High에서 Low로 변경될 때.
   • AnyEdge: 신호가 입력되면 Counter가 재설정됩니다. 하강 또는 상승.
4. 선택한 Counter reset source로 신호를 전송하여 Counter를 재설정합니다.

재설정 시 Counter의 status 이(가) 다음으로 변경됩니다: CounterTriggerWait 이며 다음을 수행해야 합니다. 시작되었습니다. 제거합니다.

Counter 중지하기#

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

• 선택한 event source로 신호 전송을 중지합니다.
• 파라미터를 원하는 CounterEventSource 파라메터 Off.
• Counter를 Reset합니다.

Counter 상태 가져오기#

Counter의 현재 상태를 확인하려면 다음의 값을 가져옵니다. CounterStatus 파라미터. 이 파라미터는 읽기 전용입니다.

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

• CounterTriggerWait: Counter가 대기 중입니다. 시작되었습니다..
• CounterActive: Counter가 선택한 event source 에 의해 증가하기를 기다리는 중이거나 현재 카운트 중입니다.
• CounterCompleted: Counter가 다음에 의해 정의된 최댓값에 도달했습니다. CounterDuration 파라미터에 HTML 로그 파일(*.html)의 경로와 이름을 지정할 수 있습니다.
• CounterIdle: Counter가 유휴 상태입니다. Counter는 다음 상태에 있을 때 유휴 상태가 됩니다. CounterTriggerSource 파라미터가 다음으로 설정된 경우에만 Light Control 기능과 함께 사용할 수 있음을 명시했습니다. 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는 사전 설정되어 있으며 변경할 수 없습니다.
• 관련 data chunk(예: Frame Counter 청크)를 검색하여 현재 값을 확인할 수 있습니다.
• 최댓값은 4,294,967,295입니다. 최댓값에 도달하면 Counter가 0으로 재설정된 후 카운트를 계속합니다.
• 수동으로 재설정할 수 있습니다.
• 카메라 전원을 껐다가 다시 켜면 0으로 재설정됩니다.

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

Counter 값 가져오기#

Counter의 현재 값을 확인하려면 Data Chunks 기능을 사용하여 관련 data chunk를 가져옵니다.

Counter 재설정하기#

Counter를 재설정하려면:

파라미터를 원하는 CounterSelector 원하는 Counter에 대한 파라미터(예:) Counter2.

파라미터를 원하는 CounterResetSource 파라미터를 소프트웨어 소스(Software) 또는 하드웨어 소스로 설정합니다(예: Line1).

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

1. 소프트웨어 소스를 설정한 경우, CounterReset command.
2. 하드웨어 소스를 설정한 경우, 카메라의 입력 라인 중 하나에 전기 신호를 인가합니다.

추가 파라미터#

• The CounterEventSource 파라미터를 사용하면 현재 선택된 Counter의 이벤트 소스를 가져올 수 있습니다. 즉, Counter가 증가하는 조건을 확인할 수 있습니다.
• The CounterResetActivation 파라미터는 현재 아무런 기능도 수행하지 않습니다. 기본값은 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를 사용하여 파라미터를 손쉽게 설정할 수도 있습니다.