pylon Software Suite 26.03 릴리스 노트#

릴리스 날짜: 2026-03-20

바이너리 호환성#

Data Processing = 4.1.2
Data Processing 4.1.x 또는 이전 4.x.x 버전으로 빌드된 애플리케이션과 호환됩니다.
pylon C++ SDK = 11.4.0
pylon C++ SDK 11.4.x 또는 이전 11.x.x 버전으로 빌드된 애플리케이션과 호환됩니다.
pylon C SDK = 10.1.0
10.1.x 또는 이전 10.x.x 버전의 pylon C SDK로 빌드한 애플리케이션은 호환됩니다.
pylon .NET SDK = 9.0.0
이전 버전의 pylon .NET SDK로 빌드한 애플리케이션은 호환되지 않습니다.

새로운 기능 / 변경 사항#

pylon Viewer: [349641] 지원되는 카메라에 블록 기반 Flat-Field Correction 기능을 추가했습니다.
pylon C++ SDK: [242242] 지원이 중단된 Basler Performance Driver를 제거했습니다.
pylon C++ SDK: [344267] GUI_QtMultiCam 샘플에 사용되는 샘플 GUI의 레이아웃을 개선했습니다.
pylon C++ SDK: [333934] Image Format Converter에 RGBA8 출력 포맷을 추가했습니다.
GigE: [356880] 여러 네트워크 인터페이스가 있는 시스템에서 GigE 장치 검색 기능을 개선했습니다. 이제 pylon이 여러 NIC에서 사용 가능한 카메라를 올바르게 열거합니다.
GigE: [353458] Intel(R) Network Connections Software, Release 30.5를 추가했습니다.
vTools: [338476] AI vTools는 처리량을 늘리기 위해 여러 추론 작업을 병렬로 실행할 수 있습니다. 이 기능은 고급 사용자를 위한 것이며, 동작 및 성능은 하드웨어 및 모델 아키텍처에 따라 다릅니다.
CXP12-IC-1C: [none] IC1C를 Static 1.2 P0으로 업그레이드하기 위한 펌웨어 파일
vTools: [356573] Data Synchronizer vTool에 Complete Input Set 동기화 모드가 추가되었습니다. 이를 통해 예를 들어 동시에 트리거되는 카메라의 출력을 동기화할 수 있습니다. 입력이 누락되는 경우에 대비해 시간 초과(timeout)를 지정할 수도 있습니다. 그 외에도 Trigger 및 Discard Input Data 명령이 추가되었습니다. 전자는 언제든지 동기화를 트리거할 수 있게 해주며, 후자는 현재 보유하고 있는 모든 입력 데이터를 폐기할 수 있게 해줍니다.
vTools: [355384] 이제 MiniScript vTool이 레시피를 저장할 때 'Filename'을 저장합니다. 상대 경로를 사용하는 경우 레시피 파일의 위치를 기준으로 해결됩니다.
vTools: [351356] Region Inverter vTool이 추가되었습니다. 이 vTool은 입력 영역을 반전시킵니다. 즉, 출력 영역에는 입력 영역에 속하지 않는 모든 픽셀이 포함됩니다.

수정 사항#

pylon Viewer: [354832] 단일 샷(single shot) 촬영 후 Save Image 기능이 비활성화된 상태로 유지되던 문제를 해결했습니다.
pylon Viewer: [352230] 라인 스캔 카메라 사용 시 Recording 기능이 작동하지 않던 문제를 해결했습니다.
Workbench: [354844] 레시피를 로드한 후 연결이 입력 및 출력 핀에서 분리된 것처럼 표시되던 문제를 해결했습니다.
Workbench: [353962] Terminal Pin Information 영역의 카메라 할당 메시지를 개선했습니다.
GenTL/CXP: [347266] 플랫폼 라이브러리 내 LC_ALL 로케일 환경 변수 복원을 수정했습니다.
GenTL/CXP: [353004] 잘못된 GenApi 노드 이름으로 인해 생성된 GenTL Interface XML을 GenApi에서 로드할 수 없었던 문제를 해결했습니다. 이제 애플릿 파일 이름에 공백이나 영숫자가 아닌 문자가 포함되어 있더라도 생성된 XML이 GenApi에서 로드됩니다.
GenTL/CXP: [352489] microDisplayX의 링크 구성 뷰를 수정했으며, 이제 CXP 카메라 속성 변경 이벤트가 microDisplayX로 올바르게 전송됩니다.
GenTL/CXP: [351348] CXP 검색이 더욱 견고해졌으며, 특히 멀티 링크 카메라의 경우 더욱 그렇습니다. 일부 시스템 구성에서 하나 이상의 슬레이브 링크가 마스터 링크보다 약간 늦게 검색되던 타이밍 문제를 해결했습니다.
GenTL/CXP: [350617] 포트 인덱스 리소스에 간격이 있는 HAP 파일에서 CXP 검색을 수정하여, 할당되지 않은 중간 포트 인덱스가 있는 파일이 이제 올바르게 처리되도록 했습니다.
pylon C++ SDK: [353965] Flat-Field Correction 샘플에서 평균 픽셀 값 계산을 수정했습니다.
GigE: [352234] 최대 프레임 속도가 2fps인 카메라를 지원하기 위해 FrameRetention 기본값을 500밀리초로 변경했습니다.
GenTL/GigE: [267556] 청크(chunk) 데이터를 사용할 수 없을 때 DsGetBufferChunkData의 반환 코드가 GEV_ERR_NO_DATA가 아니었던 문제가 수정되었습니다.
Data Processing: [355946] 대형 이미지를 티치 파라미터로 사용할 때 성능이 저하되던 문제가 해결되었습니다.
vTools: [356573] Data Synchronizer vTool이 이제 오류가 있는 데이터를 올바르게 처리합니다. 이전에는 오류 상태의 입력 데이터가 무시되었습니다.

제한 사항#

pylon Viewer: Stereo ace 2 카메라로 획득한 이미지는 아직 표시할 수 없습니다.
pylon Viewer: Intel HD 그래픽 카드가 장착된 컴퓨터에서는 그래픽 드라이버를 최신 버전으로 업데이트해야 할 수 있습니다.
pylon Viewer: 컴퓨터가 매우 느리거나 부하가 큰 경우 등 특정 상황에서는 pylon Viewer에서 카메라가 이미 열려 있으면 Color Calibrator가 작동하지 않을 수 있습니다. 이를 방지하려면 Color Calibrator를 사용하기 전에 카메라를 닫으십시오.
pylon Viewer: Color Calibrator는 모든 Basler 컬러 카메라를 지원하지 않습니다. 카메라 기능 세트의 차이로 인해 Basler dart 및 boost V 카อล러 카메라는 지원되지 않습니다.
pylon Viewer: 전반적인 안정성과 성능을 향상하기 위해 pylon Viewer에 새로운 이미지 스로틀이 구현되었습니다. 이로 인해 pylon Viewer의 비디오 녹화 기능에 새로운 제한이 도입됩니다. 이미징 파이프라인에서 카메라당 초당 250개의 이미지만 허용되므로 이 한도를 초과할 경우 모든 프레임을 녹화하는 기능이 제한됩니다.
Workbench: Workbench의 통계 기능은 vTools의 실행 시간을 측정합니다. 통계 기능에서 측정된 시간은 시스템 구성 및 전반적인 CPU 부하에 따라 달라질 수 있습니다. 이는 현재 부하에 따라(예: 동적 주파수 Scaling으로 인해) CPU가 다른 주파수로 실행될 수 있기 때문입니다.
Workbench: Workbench에서 데이터를 활발히 표시하는 여러 핀 데이터 뷰를 사용하면 CPU 부하가 증가하고 전반적인 성능이 저하될 수 있습니다. 가능하면 더 적은 수의 핀 데이터 뷰를 사용할 것을 권장합니다.
pylon C++ SDK: GenICam File Access 기능을 사용하여 GigE 카메라에서 파일을 다운로드할 때 파일 크기가 4로 나누어떨어지지 않으면 현재 0바이트 크기의 파일이 다운로드됩니다. 이로 인해 특히 사용자 데이터(예: Vignetting Correction 데이터, Shading Correction 데이터, 3D 데이터)가 포함된 캘리브레이션 및 설정 파일과 관련하여 문제가 발생할 수 있습니다.
3D: Stereo ace 3D 카메라를 사용하려면 Stereo ace용 pylon Supplementary Package를 설치해야 합니다. Stereo ace용 pylon Supplementary Package는 Basler 웹사이트에서 다운로드할 수 있습니다.
3D: Basler blaze 3D 카메라를 사용하려면 pylon Supplementary Package for blaze가 설치되어 있어야 합니다. pylon Supplementary Package for blaze는 Basler 웹사이트에서 다운로드할 수 있습니다.
MP4: MP4 동영상 녹화를 수행하려면 pylon Supplementary Package for MPEG-4가 설치되어 있어야 합니다. pylon Supplementary Package for MPEG-4는 Basler 웹사이트에서 다운로드할 수 있습니다.
MP4: 해상도가 20 MP 이상인 카메라로 비디오 파일을 녹화할 때 Quality Property을 80% 이상으로 설정하면 녹화가 실패할 수 있습니다. 해결 방법으로 Quality Property을 더 낮은 값으로 설정하십시오.
MP4: 녹화 기능은 ace 2 Pro 카메라에서 Compression Beyond 기능을 지원하지 않습니다. 녹화가 시작되고 Compression Beyond 기능이 활성화된 경우 pylon Viewer는 먼저 카메라에서 Compression Beyond 기능을 비활성화한 후 녹화를 시작합니다.
USB: Basler U3V 장치의 동기화가 해제될 수 있으므로 Intel USB 호스트에서 사용하는 Power Management를 꺼야 합니다. 이 경우 시스템 부팅 후 Basler U3V 장치를 사용하지 못할 수 있습니다. 다음 단계에 따라 USB3 버스에서 LPM 패키지를 비활성화하십시오.
1. 다음 명령을 실행하여 고급 설정을 활성화하십시오:
  powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE
2. 전원 옵션에서 LPM 설정을 변경합니다.
  1. 제어판에서 전원 옵션을 엽니다.
  2. 선택한 전원 관리 계획에 대해 "요금제 설정 변경" 또는 "설정 변경"을 클릭합니다.
  3. "고급 전원 관리 옵션 설정 변경"을 클릭합니다.
  4. "전원 옵션" 대화 상자의 "고급 설정" 탭에서 "USB 설정"을 선택합니다.
  5. "USB 3 절전 모드"를 "사용 안 함"으로 설정합니다.
GenTL: GenTL 버전 1.4 이하인 Producer의 경우 GenTL 지원이 제한됩니다.
GigE: Basler의 ace 2 5GigE 및 1GigE 카메라를 최적으로 사용하려면 듀얼 채널 DDR4-3600 RAM 이상을 사용할 것을 권장합니다. 더 느린 RAM을 사용하면 버퍼 언더런 및 이미지 손실이 발생할 수 있습니다. 또한 전체 설정을 최적화하기 위해 pylon GigE Configurator 툴을 사용할 것을 권장합니다.
pylon C++ SDK: InstantCameraArray 클래스는 최대 21대의 카메라에서 이미지를 취득할 수 있습니다.
GigE: IP Configurator 툴에서는 단일 네트워크 인터페이스상의 여러 IP 구성을 완전히 지원하지 않습니다.
GigE: "Failed to allocate resources." 오류 메시지가 보고된 경우, Basler에서는 pylon GigE Configurator 툴을 사용하여 NIC와 카메라의 IP 구성을 최적화할 것을 권장합니다.
pylon C++ SDK: 일부 ace 2 카메라는 이벤트 알림을 위해 일반적인 열거형 대신 부울 Property을 사용할 수 있습니다. 이 문제를 해결하기 위해 다음 코드 조각을 사용할 수 있습니다. C++의 경우 camera.EventNotification.TrySetValue(EventNotification_On); 외에도 CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);를 사용할 수 있습니다.
pylon C++ SDK: Visual Studio 2017을 사용할 때 MSB4211 경고가 발생할 수 있습니다. 이 경고를 제거하려면 Release 및 Debug 프로젝트 Property(Configuration Properties -> General -> Windows SDK Version)에서 Windows SDK의 버전을 지정하십시오.
pylon C++ SDK: CMake를 사용하여 샘플을 빌드할 때 운영 체제의 경로 길이 제한과 관련된 문제가 발생할 수 있습니다. 경로가 최대 경로 길이인 260자를 초과한다는 빌드 오류가 발생할 수 있습니다. 이는 CMake 빌드 디렉터리의 절대 경로가 80자를 초과하는 경우에 발생할 수 있습니다. 빌드 디렉터리는 현재 작업 디렉터리이거나 cmake를 호출할 때 '-B' 옵션으로 지정한 디렉터리입니다. 이 오류가 발생하는 경우, 사용자 프로필 C:\Users\ 아래에 직접 위치하는 등 80자를 초과하지 않는 더 짧은 경로의 빌드 디렉터리를 사용하십시오.\Samples. Windows 10, 버전 1607 이상에서는 긴 경로를 활성화할 수 있습니다. 자세한 내용은 Microsoft 설명서를 참조하십시오.
GenTL/GigE: GigE Vision용 GenTL Producer는 액션 명령을 지원하지 않습니다.
pylon C SDK: pylon C API는 아직 GenDC 및 Basler blaze 3D 카메라를 사용할 수 있는 편리한 기능을 제공하지 않습니다.
pylon C SDK: GenTL Consumer를 사용하기 위해(예: CoaXPress와 함께) 스트리밍을 명시적으로 시작하고 중지할 수 있는 추가 기능이 pylon C에 추가되었습니다. 이 기능은 아직 pylon C 프로그래머 가이드에 문서화되어 있지 않습니다. pylon C++ 프로그래머 가이드("이전 버전에서 마이그레이션 - IStreamGrabber API의 변경 사항" 장 참조) 또는 pylonC OverlappedGrab 프로그래밍 샘플을 참조하십시오.
pylon .NET SDK: 이 버전의 .NET API로 업데이트하려면 새 어셈블리를 참조하도록 .NET 프로젝트 파일을 업데이트해야 합니다. 이는 VB2015 호환성 수정 사항(인터페이스 클래스 Basler.Pylon.IParameterListEnum이 ref 클래스 Basler.Pylon.ParameterListEnum으로 변경됨) 때문에 필요합니다.
pylon .NET SDK: .NET 프로젝트에서 네이티브 디버깅이 활성화되어 있고 프로젝트가 pylon 어셈블리를 참조하는 경우, Visual Studio 2012 또는 Visual Studio 2013 디버거에서 실행할 때 애플리케이션이 중단될 수 있습니다. 이 문제를 방지하려면 Visual Studio 디버거 옵션에서 관리 호환성 모드를 활성화하십시오.
CXP12-IC-1C: 라인스캔 애플릿의 경우, 라인 주기 및 라인 노출 범위가 제대로 처리되지 않습니다. 최대값이 예상보다 낮을 수 있습니다.
GenTL/CXP: 이제 Visual Studio 2022로 컴파일이 수행되므로, 라이브러리를 로드하려면 Visual Studio 2022 재배포 가능 패키지를 설치해야 합니다.
GenTL/CXP: 실제 버퍼 크기 제한은 2Gbit이므로 프로듀서의 Width 및 Height 허용 값에 제한이 생기며, 그 결과 이미지의 최대 크기는 2GB가 됩니다.
GenTL/CXP: fps 제한은 버퍼 수와 이미지 크기에 따라 50.000 fps에서 90.000 fps 사이입니다. 보다 자세한 대략적인 값으로, 버퍼 10개와 최소 이미지 크기 48x1의 경우 약 50,000 FPS의 제한이 있고, 버퍼 50개와 최소 이미지 크기 48x1의 경우 약 90,000 FPS의 제한이 있으며, 버퍼 50개와 이미지 크기 8192x1의 경우 약 50,000 FPS의 제한이 있습니다.
GenTL/CXP: 이미지 취득 중에 카메라 파라미터가 변경되면 이 변경 사항이 프레임 그래버에 반영되지 않습니다. 이는 GenTL Producer가 취득을 시작하기 전에 관련 파라미터(너비, 높이, 이미지 포맷 등)를 검색하여 이를 프레임 그래버와 동기화하기 때문입니다.
GenTL/CXP: GenTL 표준에 따르면 장치 ID는 두 세션 사이에서 일정하게 유지되어야 합니다. 그러나 애플릿이 변경되면 GenTL 장치 ID가 변경됩니다. 따라서 장치 ID는 장치 ID가 생성된 애플릿과 동일한 이름을 가진 애플릿인 경우에만 재사용할 수 있습니다.
GenTL/CXP: 컴퓨터에 pylon과 Framegrabber SDK가 모두 설치되어 있는 경우, Basler는 pylon 설치에서 CXP 옵션을 선택 해제할 것을 권장합니다. 충돌하는 CXP 프로듀서로 인해 발생하는 문제를 방지하려면 pylon 또는 Framegrabber SDK 중 하나만 Basler 프레임 그래버 및/또는 인터페이스 카드를 제어해야 합니다.
GenTL/CXP: Linux에서 보안 부팅(UEFI 모드)을 사용하려면 신뢰할 수 있는 인증서로 서명된 드라이버가 필요합니다. 드라이버가 소스 코드로 제공되므로 신뢰할 수 있는 Basler 인증서로 서명할 방법이 없습니다. 드라이버로 작업하려면 보안 부팅을 비활성화할 수 있습니다. 또는 다음 Ubuntu 블로그 항목에 설명된 대로 드라이버에 자체 서명할 수 있습니다: https://ubuntu.com/blog/how-to-sign-things-for-secure-boot
GenTL/CXP: 그래빙에 사용되는 버퍼를 할당할 때, 버퍼 주소는 8바이트 단위로 정렬되어야 합니다. 힙 메모리를 사용하는 경우 이는 자동으로 처리됩니다.
GenTL/CXP: Basler CXP-12 Interface Card 1C를 사용하여 50000 fps를 초과하는 매우 높은 프레임 레이트로 그래빙하는 것은 지원되지 않습니다.
GenTL/CXP: 드물게 컴퓨터 부팅 후 카라메를 찾지 못하는 경우가 있습니다. 이 문제를 해결하려면 카메라의 전원을 재부팅(Power-cycle)하십시오.
GenTL/CXP: 카메라의 DeviceUserID가 변경된 경우, GenTL API를 통해 변경 사항이 반영되도록 하려면 GenTL Producer를 재시작해야 합니다. GUI를 사용하여 GenTL을 통해 카메라와 상호 작용하는 경우(예: pylon Viewer), 변경 사항이 표시되도록 해당 애플리케이션을 재시작해야 합니다.
GenTL/CXP: Applet을 변경하는 동안, 인터페이스 카드에 연결된 카메라는 더 이상 액세스할 수 없음에도 불구하고 장치 목록에 계속 표시됩니다. 이 상태에서 카메라를 열려고 하면 오류 메시지가 발생합니다.
GenTL/CXP: DSGetBufferInfo를 통해 쿼리할 수 있는 GenTL BUFFER_INFO_FRAME_ID에는 CXP 이미지 헤더의 소스 태그가 포함되지 않습니다. 대신 컴퓨터로 전송된 모든 프레임에 대한 카운터가 포함됩니다.
GenTL/CXP: 버퍼 오버플로로 인해 인터페이스 카드에서 이미지 손실이 발생하는 경우(예: 사용자 응용 프로그램이 이미지를 전달하기 위해 버퍼를 충분히 빠르게 (재)대기열에 넣지 못하는 경우), 손실된 이미지는 다음에 전달되는 버퍼에 표시됩니다. 손실된 이미지는 INCOMPLETE로 표시되며, 파일 크기는 0이 되고, 사용자 지정 오류 코드 BUFFER_INFO_BASLER_XAPI_ERROR_CODE는 42로 설정됩니다. 또한 손실된 프레임 하나가 스트림 정보에 추가됩니다. 오버플로로 인해 손실된 프레임 수와 관계없이 정확히 하나의 손실된 프레임만 추가된다는 점에 유의하십시오.
GenTL/CXP: Basler CXP-12 Interface Card 1C/2C/4C 및 imaWorx CXP-12 Quad 캡처 카드는 PCIe Gen 3 x8(Direct Memory Access) 이상의 호스트 인터페이스가 필요합니다. 더 느린 호스트 인터페이스를 사용하면 카메라의 Acquisition Frame Rate가 저하되고 이미지 손실이 발생할 수 있습니다.
CXP12-IC-1C: 하나의 포트에서 CXP 링크 속도가 자주 변경되는 경우 속도 변경이 더 이상 작동하지 않는 현상이 발생할 수 있습니다. 이 경우 "Failed to set bitrate of uplink transceivers" 및 "Failed to set bitrate of downlink transceivers" 오류 메시지가 기록됩니다. 카메라 검색은 연결되지 않은 포트를 프로빙하고 이에 따라 링크 속도를 변경하므로, 응용 프로그램이 연결되지 않은 포트에서 새 카메라를 자주 검색하려고 할 때 이 문제가 발생할 수 있습니다.

다운로드#

pylon Software Suite의 이 버전은 여기서 다운로드할 수 있습니다.