구조광 3D 카메라
기능
이 스텝은 구조형 광 3D 카메라를 제어하여 데이터를 획득하거나, 로컬에 저장된 데이터를 불러옵니다.
일반적으로 Mech-MSR 프로젝트는 Mech-Eye 산업용 3D 카메라(이하 '카메라')에 연결하여 이미지 데이터를 획득하는 스텝부터 시작됩니다.
사용 방법
이 스텝의 사용 방법은 다음과 같습니다.

-
실제 카메라를 사용할지, 아니면 로컬에 저장된 데이터를 로드할지를 결정합니다.
-
실제 요구에 맞게 카메라에 연결하거나 로컬 데이터 경로를 선택합니다.
-
파라미터를 설정합니다.
실제 카메라를 사용하는 경우
사용 절차
-
구조광 3D 카메라 스텝을 프로젝트 편집 구역으로 드래그합니다.
-
파라미터 패널의 카메라 ID에서 카메라 선택을 클릭하여 사용할 카메라 및 캘리브레이션 파라미터 그룹 선택 페이지에 들어갑니다.
-
카메라 리스트에서 연결할 카메라를 찾아 카메라 ID에 커서를 놓고
를 클릭하여 카메라에 연결합니다.
에서
로 되면 카메라 연결이 성공했음을 의미합니다.
-
카메라가 성공적으로 연결된 후 캘리브레이션 파라미터 그룹의 드롭다운 리스트에서 캘리브레이션 파라미터 그룹을 선택하고 확인 버튼을 클릭합니다. 일부 파라미터는 파라미터 패널에서 자동으로 업데이트됩니다.
-
파라미터를 설정합니다.
-
이 스텝을 실행하면 카메라에 연결하여 데이터를 획득할 수 있습니다.
로컬 데이터 로드
준비 작업
카메라를 사용하여 데이터를 획득하고 저장합니다. 관련 내용은 데이터 획득 및 확인 및 와 데이터 저장을 참조하세요.
사용 절차
-
구조광 3D 카메라 스텝을 프로젝트 편집 영역으로 드래그한 다음, 파라미터 패널에서 가상 모드를 활성화합니다.
-
데이터 경로 파라미터 아래에 있는
를 클릭합니다.
-
팝업 창에서 데이터를 저장할 폴더를 선택하고 폴더 선택 버튼을 클릭합니다.
-
가상 모드에서는 이미지 파일의 이름과 형식은 아래 요구 사항을 충족해야 하며, 컬러 맵과 뎁스 맵은 동일한 이미지 번호를 가져야 합니다.
-
컬러 맵 :
rgb_image_xxxx.jpg
-
뎁스 맵 :
depth_image_xxxx.png
-
-
다음 조건을 충족하면 가상 카메라 도우미가 자동으로 실행되어 이미지 데이터 선택을 도와줍니다.
-
데이터 경로에서 경로를 입력하지 않았습니다.
-
선택한 폴더에 여러 개의 데이터 세트가 있습니다.
-
선택한 폴더에 컬러 맵, 뎁스 맵 또는 내부/외부 파라미터 데이터가 없습니다.
가상 카메라 도우미 창에서 데이터 경로를 선택해야 합니다.
-
파라미터 그룹 경로를 선택하세요. 그런 다음 확인 버튼을 클릭하면 "카메라 파라미터 그룹이 업데이트되었습니다"라는 메시지가 나타납니다.
-
뎁스 맵과 컬러 맵의 경로를 순서대로 선택합니다. 선택한 후 확인을 클릭합니다.
-
-
-
-
파라미터를 설정합니다.
-
이 스텝을 실행하면 로컬에 저장된 데이터를 로드할 수 있습니다.
파라미터
파라미터 | 설명 | ||
---|---|---|---|
카메라 유형 |
Mech-Eye만 지원됩니다. 즉, Mech-Eye 산업용 3D 카메라만 사용할 수 있습니다. |
||
가상 모드 |
기본적으로 비활성화되어 있습니다. 로컬 데이터로 프로젝트를 실행해야 하는 경우, 가상 모드를 활성화하고 관련 파라미터를 설정할 수 있습니다. |
||
카메라 ID |
연결할 카메라 ID를 결정합니다. 카메라 선택 버튼을 클릭하여 연결할 카메라를 선택합니다. 자세한 내용은 작업 절차 섹션을 참조하세요. |
||
카메라 모델 |
사용 중인 카메라 모델입니다. 자세한 내용은 카메라 모델 섹션을 참조하세요. |
||
캘리브레이션 파라미터 그룹 |
선택된 카메라에서 사용되는 캘리브레이션 파라미터 그룹입니다. |
||
파라미터 그룹 |
Mech-Eye Viewer에서 구성한 파라미터 그룹을 의미하며, 카메라는 이 그룹의 파라미터를 기반으로 데이터를 수집합니다. |
||
카메라 재연결 횟수 |
스텝 실행 시 카메라 연결에 실패하면, 이 파라미터는 소프트웨어가 카메라에 재연결을 시도하는 최대 횟수를 지정하는 데 사용됩니다. 기본값 : 3
|
||
IP 주소 |
카메라의 IP 주소입니다.
|
||
타임아웃(Timeout) |
이 파라미터는 카메라가 데이터를 수신한 후, 클라이언트로 전송하기까지 허용되는 최대 응답 시간(ms)을 설정하는 데 사용됩니다. 타임아웃에는 아래 두 가지 유형이 있습니다.
기본값 : 10000ms |
||
캡처 횟수 |
이 파라미터는 카메라가 제한 시간 내에 이미지를 캡처하지 못할 경우, 이미지를 캡처하기 위해 시도하는 총 횟수를 설정하는 데 사용됩니다. |
||
투영 파라미터 자동 계산 |
직교 투영을 통해 포인트 클라우드를 표면 데이터(뎁스 맵 및 광도 이미지 포함)로 변환할 수 있습니다. 이 파라미터를 선택하면 스텝이 실행될 때마다 투영 관련 파라미터가 자동으로 계산되어 계산 비용이 증가합니다. 투영 파라미터는 아래와 같습니다.
|
'가상 모드’에서만 표시되는 파라미터
파라미터 | 설명 | ||
---|---|---|---|
플레이백 모드 |
이 파라미터는 이미지의 읽기 모드를 지정하는 데 사용됩니다. 값 리스트
|
||
현재 프레임 이름 |
이 파라미터는 현재 이미지의 명칭을 표시하는 데 사용됩니다. |
오류 분석
|
CV-E0201
오류 : 카메라에 연결하지 못했습니다.
가능한 원인:
-
카메라, IPC, 라우터/스위치의 케이블 연결이 비정상입니다.
-
방화벽 또는 바이러스 백신 소프트웨어가 종료되지 않았습니다.
-
카메라의 IP 주소가 변경되었습니다.
-
컴퓨터의 여러 이더넷 포트가 동일한 서브넷 내 IP 주소를 사용하고 있습니다.
해결 방법:
-
케이블이 올바르게 연결되어 있는지 확인하세요.
-
컴퓨터 방화벽을 비활성화하거나 Mech-MSR을 컴퓨터 방화벽 허용 목록에 추가한 다음, 바이러스 백신 소프트웨어를 비활성화하세요.
-
카메라 IP 주소가 올바른지 확인합니다.
-
카메라 연결에 사용되지 않는 컴퓨터의 다른 이더넷 포트를 비활성화한 후, Mech-MSR을 다시 실행하고 카메라를 재연결하세요.
여전히 카메라가 감지되지 않으면, 카메라의 전원을 껐다가 다시 켜보세요.
CV-E0202
오류 : 카메라 XXX에 액세스 권한이 없습니다.
해결 방법 : 로그를 확인하여 네트워크 또는 카메라의 펌웨어가 모두 정상인지 확인한 후 다시 시도하세요. 문제가 지속되면 기술 지원팀에 문의하세요.
CV-E0203
오류 : 카메라를 연결할 수 없습니다: XXX. 카메라가 응답하지 않습니다.
가능한 원인 : 카메라 IP 및 포트가 올바르지 않습니다.
해결 방법 : 카메라 IP 및 포트가 올바른지 확인합니다.
CV-E0204
오류 : 카메라를 연결할 수 없습니다: XXX. 카메라는 GenICam 인터페이스를 통해 타사 소프트웨어로 연결됩니다.
해결 방법 : 카메라가 GenICam 인터페이스를 통해 타사 소프트웨어로 연결되지 않도록 합니다.
CV-E0205
오류 : 현재 버전의 카메라 펌웨어는 지원되지 않습니다.
해결 방법 : Mech-Eye Viewer를 사용하여 카메라와 연결하기 전에 카메라 펌웨어 버전을 업그레이드하세요.
CV-E0208
오류 : 데이터 획득 장치 연결에 실패하였습니다.
해결 방법:
-
장치를 사용할 수 있는지 확인합니다.
-
IPC와 데이터 획득 장치가 동일한 서브넷에 있는지 확인합니다.
-
데이터 획득 장치를 점유 중인 모든 소프트웨어를 종료합니다.
-
방화벽이 차단하고 있지 않은지 확인 또는 Mech-MSR을 방화벽 화이트리스트에 추가하세요.
CV-E0215
오류 : 카메라가 뎁스 맵 또는 컬러 맵을 획득하지 못했습니다.
가능한 원인:
-
네트워크 연결에 문제가 발생했습니다.
-
'타임아웃' 파라미터 설정에 문제가 있습니다.
해결 방법:
-
해결 방법 : 네트워크 연결이 정상인지 확인합니다.
-
'타임아웃' 파라미터를 조정합니다.
-
소프트웨어나 카메라를 다시 시작합니다.
-
문제가 지속되면 기술 지원팀에 문의하세요.
CV-E0216
오류 : 이미지 후처리 과정에서 오류가 발생했습니다.
가능한 원인 : 컬러 맵의 크기와 뎁스 맵의 크기가 일치하지 않습니다.
해결 방법 : 카메라의 파라미터 설정을 확인한 후, 이미지 데이터를 다시 획득해 보세요. 문제가 지속될 경우, 기술 지원팀에 문의하시기 바랍니다.
CV-E0217
오류 : 카메라를 통해 획득한 이미지의 크기가 외부 파라미터 파일에 있는 이미지의 크기와 일치하지 않습니다.
가능한 원인 : 카메라 파라미터 설정이 잘못되었습니다.
해결 방법 : 카메라의 파라미터 설정을 확인한 후, 이미지 데이터를 다시 획득해 보세요. 문제가 지속될 경우, 기술 지원팀에 문의하시기 바랍니다.
CV-E0218
오류 : 수신된 모든 뎁스 값이 포함된 이미지 데이터는 NaN입니다.
가능한 원인:
-
카메라 노출이 부족합니다.
-
대상 물체가 카메라의 작업 거리 밖에 있습니다.
-
카메라 위치가 올바르지 않습니다.
해결 방법:
-
카메라 노출 설정을 조정하거나 조명을 높입니다.
-
대상 물체가 카메라의 작업 거리 내에 있는지 확인합니다.
-
카메라의 위치를 조정합니다.
CV-E0261
오류 : 데이터 획득 장치 연결에 실패하였습니다.
가능한 원인:
-
데이터 획득 장치가 IPC에 연결되어 있지 않습니다.
-
입력한 IP 주소가 Mech-Eye 장치와 일치하지 않습니다.
해결 방법:
-
데이터 획득 장치가 IPC에 연결되어 있는지 확인합니다.
-
입력한 IP 주소가 Mech-Eye 장치와 일치하는지 확인합니다.
CV-E0263
오류 : 이 작업은 지원되지 않습니다.
가능한 원인:
-
카메라 펌웨어 버전이 Mech-Eye API과 일치하지 않습니다.
-
현재 사용하고 있는 카메라는 이 작업을 지원하지 않습니다.
해결 방법:
-
펌웨어 버전이 소프트웨어 버전과 일치하는지 확인합니다.
-
사용할 카메라가 수행할 작업을 지원하는지 확인합니다.
CV-E0265
오류 : 소프트웨어 내부 오류가 발생했습니다.
가능한 원인: Mech-MSR 소프트웨어 내부에 알 수 없는 오류가 발생하였습니다.
해결 방법: 카메라를 다시 시작하고 재연결합니다. 문제가 계속되면 기술 지원에 문의하시기 바랍니다.
CV-E0267
오류 : 소프트웨어 내부 오류가 발생했습니다.
가능한 원인: Mech-MSR 소프트웨어 내부에 알 수 없는 오류가 발생하였습니다.
해결 방법: 카메라를 다시 시작하고 재연결합니다. 문제가 계속되면 기술 지원에 문의하시기 바랍니다.
CV-E0269
오류 : 현재 작업 시간이 초과되었습니다.
가능한 원인 : 데이터를 검색하거나 데이터 획득 장치에 연결하는 데 걸리는 시간이 설정된 '타임아웃’을 초과했습니다.
해결 방법:
-
Mech-MSR에서 이미지 데이터를 정상적으로 검색할 수 있는지 확인합니다.
-
'타임아웃’을 적절하게 설정합니다.