Framegrabber SDK 5.10.0의 변경 사항 및 해결된 문제#

이 섹션에서는 Basler Framegrabber SDK 버전 5.10.0의 변경 사항 및 수정된 문제에 대한 정보를 제공합니다.

일반#

제품 이름이 Basler Runtime에서 Basler Framegrabber SDK로 변경되었습니다.
Framegrabber SDK가 이제 Windows 11(64비트) 및 Linux Ubuntu 22.04(64비트)를 지원합니다. (티켓 ID: 231590 및 244875)
The Framegrabber SDK installer for Windows has been updated. Among others, installation paths (e.g. <Basler>), environment variables (e.g. BASLER_FG_SDK_DIR) 및 이름이 변경되었습니다. 자세한 내용은 다음을 참조하십시오. 환경 변수 및 헤더 파일 이름 변경. (티켓 ID: 218027 및 227082)
이제 Windows 32비트 라이브러리가 Windows 64비트 설치 프로그램에 통합되었습니다. (티켓 ID: 253234)
Framegrabber SDK의 GenICam 참조 구현 라이브러리가 메인 설치 폴더로 이동되었습니다. (티켓 ID: 236467)
Linux에서는 microDisplay X, FirmwareUpdater 등 모든 GUI 및 명령줄 도구를 /bin 아래에 있는 관련 스크립트를 통해 실행해야 합니다. (티켓 ID: 250971 및 253097)

환경 변수 및 헤더 파일 이름 변경#

설치 중에 설정되는 환경 변수의 이름이 변경되었습니다:

SISODIR5 이(가) 다음으로 변경되었습니다. BASLER_FG_SDK_DIR.

다음 헤더 파일들의 이름이 변경되었습니다:

기존 이름	새 이름	포함 항목
fgrab_define.h	fg_define.h 및 fg_error_codes.h	basler_fg.h
fgrab_struct.h	fg_struct.h	basler_fg.h
fgrab_prototyp.h	basler_fg.h

다음 헤더 파일의 구조가 개편되었습니다:

파일 이름	변경 사항
fgrab_define.h	fgrab_define.h의 주요 부분이 이제 이름이 변경된 파일인 fg_define.h로 존재합니다.
fgrab_define.h	이전에 fgrab_define.h에 있던 에러 정의가 이제 새로운 헤더 파일인 fg_error_define.h에 있습니다.

다음 헤더 파일들이 제거되었습니다:

fgrab_triangulation.h
fgrab_blob.h

fgrab_define.h, fgrab_struct.h, 및 fgrab_prototyp.h 파일은 최소한의 헤더로 여전히 존재합니다. 지원이 중단된 헤더 파일 중 하나를 포함하면 다음 현상이 발생합니다.

"deprecated" 경고가 표시됩니다.
지원이 중단된 fgrab_ 파일 대신 새로운 해당 fg_ 파일이 자동으로 포함됩니다.

Framegrabber SDK 버전 5.10부터는 basler_fg.h만 사용해야 합니다.

단종 사항#

Windows 32-bit#

Framegrabber SDK는 이제 Windows 32비트 및 Linux 32비트 운영 체제를 지원하지 않습니다. (티켓 ID: 231590)

Frame Grabbers#

다음 프레임 그래버에 대한 지원이 중단되었습니다:

microEnable IV
microEnable 5 marathon CLHS
microEnable 5 ironman

단종된 모든 제품에 대한 자세한 내용은 Basler 단종 제품 페이지를 참조하십시오.

타사 인터페이스#

다음 타사 인터페이스가 중단되었습니다:

LabView(API 예제 참조)
독점 Cognex VisionPro Adapter
독점 MVTec HALCON 어댑터
CVB

Cognex VisionPro Adapter 및 MVTec HALCON 어댑터는 GenTL 인터페이스로 대체할 수 있습니다. (티켓 ID: 231588, 212114, 212120, 255221)

Framegrabber API#

애플릿을 찾을 수 없는 경우에 대한 로깅 메시지 문구가 개선되었습니다. (티켓 ID: 225003)

microDiagnostics 및 microDisplay X 도구#

microDisplay X의 Help 메뉴 위치가 변경되었습니다. 이제 Help 메뉴가 다음 위치에 있습니다.

(티켓 ID: 230984)
이전에는 펌웨어가 플래싱되지 않은 상태에서 microDiagnostics를 닫을 때, 종료 대화 상자에서 "firmware" 대신 "applets"을 플래싱할 것인지 물어보았습니다. 종료 대화 상자의 문구가 수정되었습니다. (티켓 ID: 212124)

API 예제#

이제 C/C++ SDK 예제를 Visual Studio 2019 이상과 같은 최신 Microsoft Visual Studio 버전으로 빌드할 수 있습니다. (티켓 ID: 226757, 249321, 227119)
National Instruments LabView 예제 프로그램이 Framegrabber SDK 배포판에서 제거되었습니다. 필요한 경우 NI LabView용 예제 프로그램을 얻으려면 Basler 기술 지원팀에 문의하십시오. (티켓 ID: 231588 및 227110)

드라이버#

imaWorx CXP-12 Quad frame grabber용 드라이버의 자동 중지 동작이 개선되었습니다. 이제 카메라가 요청된 프레임 수를 전달하면 수집이 중지됩니다. 또한 더미 버퍼로 들어간 프레임도 이제 고려됩니다. 이전에는 사용자가 사용자 버퍼에서 요청한 수의 프레임을 받았을 때 수집이 중지되었습니다. (티켓 ID: 235859)
microEnable 5 frame grabbers용 드라이버에 이제 프레임 번호를 가져오는 API가 포함되어 있습니다. (티켓 ID: 227072)
microEnable 5 드라이버의 버퍼 처리가 개선되었습니다. (티켓 ID: 235850 및 236981)
ClSerComWrapper2를 통한 카메라와 프레임 그래버 간의 통신 속도가 향상되었습니다. (티켓 ID: 236732)
microEnable 5 프레임 그래버와의 통신이 확장되어 다양한 하드웨어 변형을 지원합니다. (티켓 ID: 231003, 232694)
디바이스 검색 기능이 개선되었습니다. (티켓 ID: 238309)
CXP 및 Camera Link 카메라 검색 기능이 개선되었습니다 (티켓 ID: 229754, 226742, 230948, 240393).

해결된 문제#

이전에 GenTL BUFFER_INFO_FRAME_ID, 다음을 통해 쿼리할 수 있습니다. DSGetBufferInfo에 CXP 이미지 헤더의 소스 태그가 포함되어 있지 않았습니다. 대신 컴퓨터로 전달된 모든 프레임에 대한 Counter가 포함되어 있었습니다. 이 문제가 해결되었습니다. (티켓 ID: 197430)
이전에는 CXP 카메라 XML의 URL을 읽을 때 Framegrabber SDK가 256바이트의 레지스터 크기를 가정했습니다. 그러나 카메라 XML의 URL을 읽을 때 특정 레지스터 크기를 가정하는 것은 CXP 표준을 위반하는 것입니다. 이 문제가 해결되었습니다. 이제 레지스터 크기를 가정하지 않으며 Framegrabber SDK가 CXP 표준을 준수합니다. (티켓 ID: 228438)
이전에 CXP 카메라 XML의 URL을 읽을 때 Framegrabber SDK는 XML 루트 요소가 대문자 "L"로 시작하는 "Local"일 것으로 가정했습니다. 그러나 CXP 표준에 따르면 URL은 대소문자를 구분하지 않습니다. 이 문제가 해결되었습니다. 이제 대소문자에 관계없이 작동하도록 URL 구문 분석 방식이 변경되었습니다. (티켓 ID: 228439)
이전에는 GenICam GenTL Producer가 모든 노드에 대해 "Selecting" 값을 제공하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 212118)
이전에 GenICam GenTL Producer는 Property에서 올바른 공급업체 이름과 Interface ID를 제공하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 225073)
발생할 수 있는 GenICam GenTL 교착 상태(deadlock) 문제가 해결되었습니다. (티켓 ID: 238352)
이전에 microEnable 5 프레임 그래버의 앱릿 변경이 microDisplay X에서 항상 제대로 작동하던 것은 아니었습니다. 이 문제가 해결되었습니다. (티켓 ID: 229736)
ROI 기능의 동작이 최적화되었습니다. (티켓 ID: 229952)
이전에는 -h를 통해 명령줄 도구 gpioTool의 Help 기능을 열 때 표시된 예제가 잘못되었고 작동하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 221628)
이전에는 FirmwareUpdate 도구의 일부 오류 메시지가 오해의 소지가 있거나 오탈자가 있었습니다. 따라서 오류 메시지의 문구가 개선되었습니다. (티켓 ID: 223690, 223689)
이전에는 Linux 20.04에서 microDisplay X 및 microDiagnostics를 시작할 때 도구가 오류와 함께 종료되었습니다. 이 문제가 해결되었습니다. (티켓 ID: 233534)
이전에 microDisplay X는 앱릿을 로드한 후 언로드할 때 오류를 반환했습니다. 이 문제가 해결되었습니다. (티켓 ID: 212132)
이전에는 microDisplay X가 앱릿을 변경할 때 이미지 획득을 중지하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 220077)
이전에는 microDisplay X의 Save Parameters 및 Load Parameters 버튼이 제대로 작동하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 238752)
이전에는 PC 재부팅 후 microDisplay X에서 앱릿을 로드하면 오류가 발생했습니다. 이 문제가 해결되었습니다. (티켓 ID: 236228)
이전에 일련의 이미지를 로드할 때 microDisplay X가 중단되었습니다. 이 문제가 해결되었습니다. (티켓 ID: 212616)
이전에 microDisplay X에서 변환 루프 파라미터가 올바르게 표시되지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 234064)
이전에는 microDisplay X가 Basler 듀얼 채널 CXP-12 카메라를 인식하지 못했습니다. 이 문제가 해결되었습니다. (티켓 ID: 235720)
이전에 이미지 취득 중 창을 스크롤하면 microDisplay X가 중단되었습니다. 이 문제가 해결되었습니다. (티켓 ID: 238904)
이전에는 imaWorx CXP-12 Quad에서 HAP 파일을 로드할 때 microDisplay X가 충돌했습니다. 이 문제가 해결되었습니다. (티켓 ID: 235946)
이전에 microDisplay X에 파라미터 Property에 대한 설명이 표시되지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 242207)
이전에는 microDisplay가 대형 이미지(예: 10500 x 43500 픽셀)를 올바르게 표시하지 못했습니다. 이 문제가 해결되었습니다. (티켓 ID: 246410)
이전에 microEnable 5 프레임 그래버의 microDiagnostics X에서 HDR0을 로드하는 작업이 항상 올바르게 작동하던 것은 아닙니다. 이 문제가 해결되었습니다. (티켓 ID: 234254)
이전에는 Linux Ubuntu 시스템의 imaWorx CXP-12 Quad에서 앱릿을 초기화할 때 Fg_init 실패했습니다. 이 문제가 해결되었습니다. (티켓 ID: 234499)
이전에는 LookupTable에서 imaWorx CXP-12 Quad용 앱릿의 값을 설정하거나 선택하는 기능이 작동하지 않았습니다. 이 문제가 해결되었습니다. (티켓 ID: 221621)
이전에 일부 imaWorx CXP-12 Quad 앱릿의 Image ROI 너비를 증가시키면 오류가 발생했습니다. 이 문제가 해결되었습니다. (티켓 ID: 249177)
이전에는 호출 시 Fg_AllocMemHead imaWorx CXP-12 Quad에서 이 함수를 여러 번 호출한 후 각 호출마다 실행 시간이 증가했습니다. 이 문제가 해결되었습니다. (티켓 ID: 247416)
이전에는 호출 시 Sgc_(re)storeLowLevelLinkProfile() imaWorx CXP-12 Quad에서 오류가 발생했습니다. 이 문제가 해결되었습니다. (티켓 ID: 246768)
이제 프레임 그래버 라이브러리 이벤트가 스레드로부터 안전합니다(Thread-safe). (티켓 ID: 236809)
이전에 카메라당 두 개 이상의 DMA가 있는 앱릿을 로드하면 microDisplay X에서 오류가 발생했습니다. 이 문제가 해결되었습니다 (티켓 ID: 237342)
이전에는 HAP 파일 로드 실패로 인해 프레임 그래버 초기화가 실패했습니다. 이 문제가 해결되었습니다. (티켓 ID: 237013)
켜기/끄기 시 관련 파라미터의 가시성이 AutomaticROIControl 파라미터가 이제 올바르게 작동합니다. (티켓 ID: 217774)
Fg_getSWVersion() 이제 설치된 Framegrabber SDK의 올바른 버전 번호를 반환합니다. (티켓 ID: 202240)
MVTec HALCON용 기존 독점 어댑터의 최신 버전 13.0.11이 최대 4 GBytes 전송을 지원하도록 개선되었습니다. 이 어댑터는 Framegrabber SDK 5.10.0부터 단종되며, Basler는 대신 GenICam GenTL 인터페이스를 사용할 것을 권장합니다. (티켓 ID: 231049, 231326, 218503)
이전에는 MVTec HALCON용 기존 전용 어댑터를 사용할 때 이미지 취득이 예기치 않게 중단되었습니다. 이 문제가 해결되었습니다. 이 어댑터는 Framegrabber SDK 5.10.0부터 단종되었으며, Basler는 대신 GenICam GenTL 인터페이스를 사용할 것을 권장합니다. (티켓 ID: 229938)