2D 카메라
기능 설명
이 스텝은 산업용 2D 카메라를 통해 이미지를 획득하여 후속 검출, 측정 및 분석에 사용할 수 있습니다.
| 이 스텝을 사용하기 전에 2D 카메라 관리 창에서 사용할 2D 카메라를 추가하고 디버깅해 주세요. |
현재 다음 제조사의 2D 카메라만 지원하며, 아래 버전의 소프트웨어 및 SDK와의 호환성 검증을 완료했습니다.
| 제조사 | 소프트웨어 버전 | SDK 버전 |
|---|---|---|
화루이 |
Ver2.5.1.33_Build20250903 |
2.5.1.33.390167 |
다헝 |
3.2.2511.8201 |
2.5.2512.9221 |
하이크비전 |
V4.5.1 build20250227 |
V4.5.1.2 build20250317 |
바슬러(Basler) |
25.06.4.17077 |
10.3.1.606 |
|
다헝 또는 하이크비전 2D 카메라를 사용하려면 먼저 메뉴 바에서 를 선택한 후 camera2d_bsl 플러그인의 선택을 해제하고 소프트웨어를 다시 시작하여 설정을 적용하세요. 시스템은 기본적으로 위 네 제조사의 카메라 플러그인을 자동으로 로드합니다. 그러나 바슬러 카메라 플러그인은 다헝 및 하이크비전 카메라 플러그인과 충돌하므로, 바슬러 카메라 플러그인이 활성화된 상태에서는 다헝 또는 하이크비전 카메라를 2D 카메라 관리 창에서 검색할 수 없습니다. |
사용 시나리오
이 스텝은 일반적으로 프로젝트의 첫 번째 스텝으로 이미지 데이터를 획득하는 데 사용되며, 이미지 전처리, 위치 결정 등 관련 기능의 후속 스텝과 함께 자주 사용됩니다.
사용 방법
이 스텝의 사용 방법은 다음과 같습니다.
-
가상 모드를 활성화할지 여부를 선택합니다.
-
활성화하는 경우 가상 모드의 파라미터를 설정합니다.
-
-
스텝을 실행하여 이미지를 획득하고 다른 스텝으로 출력합니다.
파라미터 설명
카메라 설정
| 파라미터 | 설명 |
|---|---|
카메라 선택 |
드롭다운 옵션에서 연결할 2D 카메라를 선택합니다. 카메라 관리 버튼을 클릭하여 2D 카메라 관리 창을 열고, 현재 연결 가능한 2D 카메라와 카메라 파라미터를 관리할 수 있습니다. |
카메라 유형 |
산업용 2D 카메라 제조사를 표시하는 데 사용됩니다. 현재 다음 유형의 2D 카메라만 지원합니다.
|
기본 설정
자주 사용하는 파라미터
| 파라미터 | 설명 |
|---|---|
가상 모드 |
기본적으로 비활성화되어 있습니다. 로컬에 저장된 데이터로 프로젝트를 실행하려면 가상 모드를 활성화하세요. 활성화 후의 스텝 파라미터는 가상 모드를 참조하세요. |
보정 활성화 |
활성화한 후 보정 파라미터 그룹을 선택하면 2D 카메라 왜곡 보정 결과를 적용할 수 있습니다. 보정을 적용하면 이미지 왜곡을 보정하고 측정 정확도를 높일 수 있습니다. |
고급 파라미터
| 파라미터 | 설명 |
|---|---|
획득 타임아웃 시간 |
카메라가 정보를 수신한 시점부터 데이터를 클라이언트에 반환할 때까지의 최대 시간으로, 단위는 밀리초(ms)입니다. 타임아웃 시 이미지 획득이 자동으로 중지되어 프로세스가 막히는 것을 방지합니다. |
가상 모드의 파라미터
| 파라미터 | 설명 | ||
|---|---|---|---|
데이터 경로 |
이 파라미터는 이미지 데이터가 저장된 경로를 지정하는 데 사용되며, 스텝 실행 시 해당 경로에서 이미지를 읽습니다. |
||
재생 모드 |
이 파라미터는 이미지 읽기 방식을 지정하는 데 사용됩니다. 값 목록:
|
||
현재 재생 프레임 |
현재 읽고 있는 이미지의 이름을 표시하는 데 사용됩니다. |
이미지 획득 설정
| 스텝 실행 시 아래 표의 파라미터 중 2D 카메라 관리 창과 중복되는 파라미터는 스텝 파라미터 영역에 설정된 값이 우선 적용됩니다. |
| 파라미터 | 설명 |
|---|---|
노출 시간 |
이 파라미터는 이미지 밝기에 영향을 줍니다. 일반적으로 환경이 어두우면 노출 시간을 적절히 늘려 이미지를 더 밝게 하고, 환경이 밝으면 노출 시간을 줄여 과노출을 방지할 수 있습니다. |
게인 |
이 파라미터는 이미지 밝기를 높이는 데 사용되지만, 동시에 노이즈도 증폭합니다. 노출 시간을 조정해도 원하는 밝기에 도달하지 못할 때 사용할 수 있습니다. 검출 효과에 영향을 주지 않도록 게인을 지나치게 높게 설정하지 않는 것이 좋습니다. |
획득 횟수 |
촬영 실패 시 자동 재시도할 수 있는 최대 횟수로, 획득 성공률을 높이는 데 사용됩니다. 기본값은 3입니다. |
오류 분석
|
각 스텝의 공통 오류 코드는 오류 코드 목록을 참조하세요. 오류 코드가 오류 메시지와 일치하지 않으면 기술 지원에 문의해 도움을 받으세요. |
CV-E0201
오류: 카메라 연결에 실패했습니다.
가능한 원인:
-
카메라, IPC, 라우터/스위치 간 케이블 연결에 이상이 있습니다.
-
방화벽 또는 백신 소프트웨어가 소프트웨어 사용을 차단했습니다.
-
카메라 IP 주소가 변경되었습니다.
-
네트워크 카드 충돌이 발생했습니다.
해결 방법:
-
카메라, IPC, 라우터/스위치 측 케이블 연결을 점검하여 정상 연결인지 확인합니다.
-
PC 방화벽을 끄거나 Mech-MSR을 방화벽 허용 목록에 추가한 후, 백신 및 보안 소프트웨어를 종료합니다.
-
카메라 IP 주소가 올바른지 확인합니다.
-
PC에서 카메라에 연결된 포트를 제외한 다른 네트워크 포트를 비활성화한 뒤 Mech-MSR을 실행하고 카메라를 다시 연결합니다.
위 단계를 모두 시도한 후에도 카메라를 검색할 수 없다면 전원을 차단한 뒤 카메라를 다시 시작해 보세요.
CV-E0202
오류: 카메라 XXX에 대한 접근 권한이 없습니다.
해결 방법: 로그를 확인하여 네트워크가 정상인지, 그리고 다른 소프트웨어가 카메라를 점유하고 있지 않은지 확인한 후 다시 시도하세요. 그래도 해결되지 않으면 기술 지원에 문의하세요.
CV-E0204
오류: 카메라 XXX 연결에 실패했습니다.
가능한 원인: 해당 카메라가 다른 소프트웨어에서 GenICam 인터페이스 또는 USB 연결을 통해 점유 중입니다.
해결 방법: 다른 소프트웨어에서 GenICam 인터페이스 또는 USB 연결을 통해 해당 카메라를 점유하고 있지 않은지 확인하세요.
CV-W0208
오류: 카메라 연결에 실패했습니다.
해결 방법:
-
카메라가 사용 가능한 상태인지 확인하세요.
-
IPC와 카메라가 동일한 네트워크 대역에 있는지 확인하세요.
-
카메라를 점유할 수 있는 소프트웨어가 모두 종료되었는지 확인하세요.
-
방화벽이 꺼져 있는지 확인하거나, Mech-MSR을 방화벽 허용 목록에 추가하세요.
CV-W0215
오류: 이미지 획득에 실패했습니다.
가능한 원인:
-
획득 타임아웃 시간이 너무 짧게 설정되었습니다.
-
카메라 트리거 지연 시간이 너무 깁니다.
-
카메라가 응답하지 않거나 연결이 끊어졌습니다.
-
외부 트리거를 사용하는 경우, 외부 트리거 신호가 정상적으로 전송되지 않았습니다.
해결 방법:
-
획득 타임아웃 시간을 조정하여 충분히 길게 설정하세요.
-
카메라 트리거 지연 설정을 확인하세요.
-
카메라가 연결되어 있고 정상적으로 응답하는지 확인하세요.
-
외부 트리거를 사용하는 경우, 외부 트리거 신호가 정상인지 확인하세요.
CV-W0264
오류: 카메라와 IPC의 IP 주소가 동일한 네트워크 대역에 있지 않습니다.
해결 방법: 카메라 IP 주소와 IPC가 동일한 네트워크 대역에 있는지 확인하세요. 동일한 네트워크 대역에 있지 않다면 카메라 IP 주소를 IPC와 동일한 네트워크 대역으로 변경하세요.
CV-W0268
오류: 카메라를 찾을 수 없습니다.
가능한 원인:
-
네트워크 이상이 발생했습니다.
-
카메라 IP 주소와 현재 IPC가 동일한 네트워크 대역에 있지 않습니다.
해결 방법:
-
네트워크 연결이 정상인지 확인하세요.
-
카메라 IP 주소와 IPC가 동일한 네트워크 대역에 있는지 확인하세요.
CV-W0269
오류: 카메라 연결에 실패했습니다.
가능한 원인:
-
네트워크 이상이 발생했습니다.
-
카메라가 이미 점유되어 있습니다.
해결 방법:
-
네트워크 연결이 정상인지 확인하세요.
-
카메라가 점유되어 있지 않은지 확인하세요.
CV-W0271
오류: 카메라가 오프라인 상태입니다.
가능한 원인: 네트워크 연결 이상 또는 카메라 전원이 켜지지 않았습니다.
해결 방법: 네트워크 연결을 확인하고 카메라가 켜져 있는지 확인하세요.