주식회사 화인스텍

FLIR_Spinnaker SDK 프로그래밍 가이드

1. 소개 SDK 소개 Spinnaker SDK는 머신 비전 개발자를 위해 구축된 FLIR의 차세대 API라이브러리 입니다. GigE, 10GigE, USB3 Vision 인터페이스만 연결이 가능합니다. Spinnaker SDK 주요 구성 AdapterConfigGUI 네트워크 어댐터 및 카메라 IP설정을 도와주는 툴입니다. SpinView 다수의 카메라 이미지 취득과 제어를 할 수 있는 툴입니다. 지원 환경 2. SDK 환경 설정 라이브러리 참조 방법 ‘프로젝트 속성 > C/C++ > 일반 > 추가 포함 디렉터리’에 라이브러리 include 경로를 추가합니다. 기본 경로: C:\Program Files\FLIR Systems\Spinnaker\include ‘프로젝트 속성 > 링커 > 일반 > 추가 라이브러리 디렉터리’에 라이브러리 lib 경로를 추가합니다. 기본 경로: C:\Program Files\FLIR Systems\Spinnaker\lib64\vs2015 ‘프로젝트 속성 > 링커 > 입력 > 추가 종속성’에 lib 파일을 추가합니다. lib 파일: Spinnakerd_v140.lib(Debug 용) / Spinnaker_v140.lib(Release 용) C# ‘프로젝트 > 참조’에 SpinnakerNET_v140.dll 을 추가합니다. (Debug Mode는 SpinnakerNETd_v140.dll ) 만약, GUI를 사용한다면 SpinnakerNETGUI_v140.dll 을 추가합니다. 기본 경로: C:\Program Files\FLIR Systems\Spinnaker\bin64\vs2015 다음의 네임스페이스를 추가합니다. 3. 예제 코드 설명 공식 예제 코드 및 레퍼런스 메뉴얼 기본 설치 경로에 언어 별 예제 코드가 제공 됩니다. 언어 별 레퍼런스 메뉴얼은 아래 경로에 제공 됩니다. 주요 예제 코드 Acquisition 카메라를 연결/해제하고 이미지 데이터를 취득하는 예제 코드. AcquisitionUserBuffer 카메라를 연결/해제하고 이미지 데이터를 사용자 버퍼로 연결하는 예제 코드. AcquisitionMultipleCameraRecovery 동작 중 카메라 연결이 끊겼을 때 이벤트와 다시 연결하는 방법을 보여주는 예제 코드. ExceptionHandling SDK 예외 처리 방법을 보여주는 예제 코드. Exposure 카메라의 노출 시간을 설정하는 예제 코드. Trigger 카메라를 트리거 모드로 변경하고 이벤트에 따라 이미지 데이터를 취득하는 예제 코드. SpinSimpleGUI_MFC WPF GUI 모듈을 사용하는 예제 코드. 디버그 모드에서는 사용 불가. Spinnaker GUI Spinnaker SDK는 WPF GUI 모듈을 제공합니다. Image Drawing Window Camera Selection Window Property Grid Window 설정 방법 WOF 기반으로 제작된 객체이기 때문에 MFC 프로젝트에서 사용 시 별도의 설정이 필요합니다. MFC InitInstance() 함수에 아래 코드를 삽입 합니다. "프로젝트 속성 > 링커 > 입력 > 추가 종속성"에 아래의 lib 파일을 추가합니다. lib 파일: SpinnakerGUI_WPFd_v140.lib(Debug 용) / SpinnakerGUI_WPF_v140.lib(Release 용) ‘프로젝트 속성 > 링커 > 입력 > 지연 로드된 DLL’에 아래의 dll 파일을 추가합니다. 주의 사항 코드 사용 방법은 SpinSimpleGUI MFC 예제 코드를 참고 합니다. Debug 모드에서 실행하면 액세스 위반 에러 메세지가 발생 합니다. WPF GUI 모듈은 Release 모드로 빌드한 exe 파일을 실행했을 때에만 정상 동작 합니다. 화인스텍 예제 코드 사용자가 쉽게 SDK를 사용할 수 있도록 Wrapping Class를 제공한 예제 코드를 제공 합니다. 예제 코드 이름 : FTech_SpinnakerEx MFC Dialog 기반 솔루션 구성 예제 코드 이름 : FTech_SpinnakerEx LostAndRecovery 카메라 끊김 및 재연결 예제 코드. MultiCamera_Async 최대 4대의 카메라를 연결하는 예제 코드. 카메라의 이미지 획득과 버퍼 획득이 비순차적으로 수행되는 예제 코드. SingleCamera_Sync 1대의 카메라를 연결하는 예제 코드. 카메라의 이미지 획득과 버퍼 획득이 순차적으로 수행되는 예제 코드. LostAndRecovery 카메라를 연결하면 DeviceLostThread가 동작하고, Device Lost 상태를 체크합니다. 만약 Device Lost가 발생하면 카메라 핸들을 해제 (Close) 합니다. 그리고 Re-Open을 N회 시도 합니다. 동작 흐름 MultiCamera_Async 동작 설명 카메라가 이미지를 그랩(Grab)하는 것과 이미지 버퍼를 취득하는 동작이 비동기적(Asynchronous)으로 진행됩니다. 최대 4대의 카메라를 연결할 수 있도록 구현되어 있습니다. OnBnClickedBtnConnection() 함수에 카메라 연결이 구현되어 있습니다. SetEnableImageCallback(true)를 호출하여 카메라 객체의 이미지 콜백을 활성화합니다. 카메라 객체는 가장 마지막 버퍼를 보관하고 있습니다. 이미지 그랩 여부는 m_grabDone 핸들로 확인합니다. 카메라 연결 후 Main Dialog에서 DisplayThread를 구동합니다. "Bayer To color" 버튼의 체크 여부에 따라 Mono(Bayer8) 또는 RGB24 영상이 그려집니다. Color Conversion이 필요한 경우 체크합니다. SingleCamera Sync 동작 설명 카메라가 이미지를 그랩(Grab)하는 것과 이미지 버퍼를 취득하는 동작이 동기적(Synchronous)으로 진행됩니다. 1대의 카메라를 연결할 수 있도록 구현되어 있습니다. OnBnClickedBtnConnection() 함수에 카메라 연결이 구현되어 있습니다. SetEnableImageCallback(false)를 호출합니다. 이미지 콜백을 사용하지 않는 설정입니다. Start() 후 Grab() 함수를 호출하여 타임아웃 시간 내에 버퍼를 취득합니다. Acquisition Start인 Start() 함수를 호출합니다. Software Trigger Mode라면 트리거 이벤트인 TriggerSoftware를 호출합니다. Color Conversion이 필요한 경우 ColorConversion() 함수를 호출합니다.

2022.10.24