pylon Software Suite 26.07 릴리스 노트#

릴리스 날짜: 2026-07-20

바이너리 호환성#

Data Processing = 5.1.0
이전 버전의 Data Processing으로 빌드한 애플리케이션은 호환되지 않습니다.
pylon C++ SDK = 12.0.0
12.0.x 또는 이전 12.x.x 버전의 pylon C++ SDK로 빌드한 애플리케이션은 호환됩니다.
pylon C SDK = 10.1.0
10.1.x 또는 이전 10.x.x 버전의 pylon C SDK로 빌드한 애플리케이션은 호환됩니다.
pylon .NET SDK = 9.0.0
이전 버전의 pylon .NET SDK로 빌드한 애플리케이션은 호환되지 않습니다.

새로운 기능 / 변경 사항#

데이터 처리: [361991] 모든 데이터 처리 데이터 타입에 새로운 HasError 및 ErrorDescription Property가 도입되었습니다.
데이터 처리: [361162] CError 클래스가 추가되었으며, CVariant가 GetError() 및 SetError(const CError&) 메서드로 확장되어 variant 값과 연결된 오류를 읽고 설정할 수 있게 되었습니다.
GenTL/CXP: [363699] DMA 채널이 없는 앱릿 프로세스를 위해 GenTL 의도치 않은(pseudo-devices) 장치가 추가되어 프로세스별 프레임 그래버 기능을 계속 사용할 수 있습니다.
GenTL/CXP: [364973] rapidxml이 버전 1.12에서 버전 1.13으로 업데이트되었습니다.
GenTL/CXP: [362795] TP_RT_CXP_OVERRIDE_DEFAULT_LINKCOUNT 조정(tweak) Property가 추가되었습니다.
vTools: [363194] vTool 사용 사례가 개선되었습니다. 이제 레시피는 압축된 레시피 형식을 사용하며, 샘플 이미지의 크기가 축소되었습니다.

수정 사항#

pylon Viewer: [361933] 이미지 취득이 시작될 때 이미지 디스플레이의 이미지가 자동으로 화면에 맞게 확대/축소되도록 개선되었습니다.
pylon Viewer: [361933] 색상 보정기(Color Calibrator)의 다양한 문제가 수정되었습니다. 색상 패치 오버레이 표시 실패, 간헐적인 충돌, 특히 연결된 카메라가 오류 상태일 때 연속 촬영을 중지하면 멈추는 현상이 해결되었습니다.
pylon Viewer: [364548] JPEG 스트리밍을 시작할 때 스트리밍이 시작되기 전에 "Unknown compression mode found" 오류 팝업이 표시되던 문제가 수정되었습니다.
vTools: [355663] 이제 Camera vTool에 다른 카메라가 할당되면 모든 구성 세트가 지워집니다. 이전에는 이전에 할당된 카메라의 구성 세트가 유지되어 새로 할당된 카메라에 적용되었으며, 이로 인해 호환되지 않는 설정이 발생하여 레시피가 시작되지 않을 수 있었습니다.
PylonVToolCreatorRuntime: [364627] GetSubValueCount가 배열 컨테이너에 대해 잘못된 요소 개수를 반환하던 문제가 수정되었습니다.

제한 사항#

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 부하가 증가하고 전반적인 성능이 저하될 수 있습니다. 가능하면 더 적은 수의 핀 데이터 뷰를 사용할 것을 권장합니다.
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 웹사이트에서 다운로드할 수 있습니다.
3D: Stereo mini 3D 카메라를 사용하려면 Stereo mini용 pylon Supplementary Package를 설치해야 합니다. Stereo mini용 pylon Supplementary Package는 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: 라인스캔 애플릿의 경우, 라인 주기 및 라인 노출 범위가 제대로 처리되지 않습니다. 최대값이 예상보다 낮을 수 있습니다.
iF2D100: 이 애플릿은 최대 8192바이트의 CXP 패킷 크기만 지원합니다.
GenTL/CXP: SDK가 다음 장치에 연결되도록 구성된 경우 pylon Event Logger, 초기화 직후 로깅이 닫히면 교착 상태가 발생할 수 있습니다. 일반적인 시나리오에는 다음이 포함됩니다. (1) Fg_FreeLibraries() 직후에 Fg_InitLibraries() 호출하기. (2) Fg_... 을 사용한 명시적 수명 관리 없이 Fg_InitLibraries() 및 Fg_FreeLibraries() 함수 호출하기. (3) GCCloseLib() 직후에 GCInitLib() 을(를) 통한 명시적 수명 관리 없이 작동합니다.
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" 오류 메시지가 기록됩니다. 카메라 검색은 연결되지 않은 포트를 프로빙하고 이에 따라 링크 속도를 변경하므로, 응용 프로그램이 연결되지 않은 포트에서 새 카메라를 자주 검색하려고 할 때 이 문제가 발생할 수 있습니다.
vTools: 레시피에 Color Classifier vTool 및 하나 이상의 Region vTool(Region Morphology, Region Selection, Region Feature Extraction)이 포함된 경우, Blob Analysis Basic 라이선스와 Color Blob Analysis Basic 라이선스가 모두 구매 목록에 표시됩니다.
vTools: 레시피에 Measurements Basic vTool과 하나 이상의 Measurements Pro vTool이 모두 포함된 경우, Measurements Basic 라이선스와 Measurements Pro 라이선스가 모두 구매 목록에 표시됩니다.

다운로드#

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