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 및 명령줄(Command Line) 도구를 /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_triangultion.h
fgrab_blob.h

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

"depricated" 경고가 표시됩니다.
지원이 중단된 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 adapter
CVB

Cognex VisionPro Adapter 및 MVTec HALCON adapter는 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를 통한 카메라와 frame grabber 간의 통신 속도가 향상되었습니다. (티켓 ID: 236732)
microEnable 5 프레임 그랩버와의 통신이 확장되어 다양한 하드웨어 변형을 지원하게 되었습니다. (티켓 ID: 231003, 232694)
장치 검색 기능이 개선되었습니다. (티켓 ID: 238309)
CXP 및 Camera Link 카메라 검색 기능이 개선되었습니다(티켓 ID: 229754, 226742, 230948, 240393).

Fixed Issues#

이전에는 GenTL BUFFER_INFO_FRAME_ID(을)를 통해 쿼리할 수 있는 DSGetBufferInfo에 CXP 이미지 헤더의 소스 태그가 포함되어 있지 않았습니다. 대신 컴퓨터로 전달된 모든 프레임에 대한 카운터가 포함되어 있었습니다. 이 문제가 수정되었습니다. (티켓 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가 속성에서 올바른 공급업체 이름과 인터페이스 ID를 제공하지 않았습니다. 이 문제가 수정되었습니다. (티켓 ID: 225073)
발생할 수 있는 GenICam GenTL 교착 상태(deadlock) 문제가 수정되었습니다. (티켓 ID: 238352)
이전에는 microDisplay X에서 microEnable 5 프레임 그랩버의 앱릿을 변경하는 작업이 항상 작동하지는 않았습니다. 이 문제가 수정되었습니다. (티켓 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 어플릿의 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가 포함된 applet을 로드할 때 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)