pylon Software Suite 26.09 릴리스 노트#
Binary Compatibility#
- 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로 빌드된 애플리케이션은 호환되지 않습니다.
새로운 기능 / 변경 사항#
- GenTL/GigE: [368940] pylon GigE 전송 계층과 일치하도록 데이터 스트림 노드 맵에 'Auto Packet Size' 및 'Probe Packet Size' 기능이 추가되었습니다.
- GenTL/GigE: [368940] 런타임에 제어 채널 하트비트 타임아웃을 검사하고 변경할 수 있도록 디바이스 노드 맵에 'Heartbeat Timeout' 기능이 추가되었습니다.
- GenTL/USB: [369125] 일반 보안 개선
- pylon .NET SDK: [369125] 이제 pylon .NET 어셈블리 및 샘플이 .NET Framework 4.0 대신 .NET Framework 4.7.2를 타겟으로 합니다. pylon .NET API를 사용하는 애플리케이션은 .NET Framework 4.7.2 이상을 타겟으로 해야 합니다.
- Camera Emulation: [362356] pylon Camera Emulator 스트림 그라버에 블록 ID 생성 기능이 추가되었습니다.
- Camera Emulation: [362356] ExposureEnd 및 Test 이벤트를 지원하는 pylon Camera Emulator 전송 계층에 이벤트 그라버 지원이 추가되었습니다. 테스트 및 개발 용도로 사용됩니다.
- pylon C++ SDK: [362356] Added an API extension to the CInstantCamera class for more control over camera event grabbing, including the ability to grab events in a separate thread and to receive them via a callback function.
- pylon C++ SDK: [367973] Sobel 필터링 기반의 새로운 GPU 이미지 처리 샘플이 추가되었습니다. 모든 플랫폼에서 사용 가능한 Vulkan 샘플과 Windows 및 Linux에서 사용 가능한 CUDA 샘플이 포함됩니다.
- General: [356845] Python pypylon 샘플과 pypylon 시작 가이드를 제공하는 README가 추가되었습니다.
- pylon .NET 5+ SDK: [366344] 이미지 데이터 액세스가 이전 버전과 일관되게 작동하도록 GrabResult의 GenDC 지원이 개선되었습니다.
- pylon .NET 5+ SDK: [369354] (GenDC) 데이터 컨테이너에서 첫 번째 일치하는 이미지 데이터 컴포넌트를 검색하기 위해 IDataContainer.GetFirstImageDataComponent() 및 TryGetFirstImageDataComponent()가 추가되었습니다.
- pylon .NET 5+ SDK: [369354] IDataComponent.AsSpan()/AsReadOnlySpan() 및 새로운 DataSize property를 통한 픽셀 데이터의 제로 코피(zero-copy) 액세스가 추가되었습니다.
- pylon .NET 5+ SDK: [369354] GenDC 지원 카메라는 물론 클래식 그랩 결과에서도 올바르게 작동하도록 모든 그랩 샘플이 IDataContainer/IDataComponent를 통해 이미지 데이터를 읽도록 업데이트되었습니다.
- vTools: [368419] 이제 Calibration Basic 및 Calibration Pro vTools에서 사용자 정의 캘리브레이션 플레이트 선택 시 .cpd 확장명을 가진 HALCON 캘리브레이션 플레이트 설명 파일을 지원합니다.
- vTools: [367744] 노드 맵을 통해 기준점을 수동으로 정의할 수 있도록 Geometric Pattern Matching Basic, Geometric Pattern Matching Pro, Template Matching Basic vTools의 노드 맵에 ReferencePointManual, ReferencePointRow, ReferencePointColumn 파라미터가 추가되었습니다.
- vTools: [369588] Painter vTool이 vTools 창의 Experimental에서 Supporters로 이동되었습니다.
- vTools: [361368] Image Stitcher vTool에서 Padding Value의 값 범위가 0~255로 변경되었습니다. 16비트 이미지의 경우 지정된 값이 자동으로 조정됩니다(257 곱하기 계수 적용).
- vTools: [362361] Image Stitcher vTool의 이름이 Image Concatenation vTool로 변경되었습니다.
수정 사항#
- GenTL/GigE: [368940] use-after-free 크래시가 수정되었으며, 완료된 취득 버퍼를 검색할 때 제출 순서에 의존하지 않도록 버퍼 식별이 수정되었습니다.
- GenTL/GigE: [368940] pylon GigE 전송 계층의 동작과 일치하도록 호스트와 다른 서브넷에 있는 카메라가 다시 검색되도록 디바이스 검색 기능이 수정되었습니다.
- GenTL/GigE: [368940] 실제 사용된 드라이버(예: macOS의 GigE Accelerator) 대신 빈 값/매핑되지 않은 값을 보고하던 'Type' 스트림 그래버 셀렉터 노드를 수정했습니다.
- GigE: [370746] GigE 카메라에 대한 자동 패킷 크기 협상 안정성을 개선했습니다. 카메라가 지원하는 패킷 크기만 시도됩니다. 협상이 실패하면 스트리밍 채널과 패킷 크기가 올바르게 복원됩니다.
- GigE: [368940] 설정된 LinkCommandTimeout과 관계없이 첫 번째 시도(그리고 LinkCommandRetryCount가 0으로 설정된 경우 유일한 시도)에서 제어 채널 명령 타임아웃이 200ms로 조용히 제한되던 문제를 수정했습니다.
- pylon C++ SDK: [362356] CCameraEventHandler::OnCameraEvent 문서의 오류를 수정했습니다. 해당 함수는 카메라 락 외부에서 호출된다고 잘못 기술되어 있었으나, 항상 카메라 락 내부에서 호출되어 왔습니다.
- pylon .NET 5+ SDK: [364409] PixelDataConverter 클래스를 사용할 때 발생하던 메모리 누수를 수정했습니다.
- pylon .NET 5+ SDK: [369354] 네이티브 객체 래퍼의 해제 후 사용(use-after-free)/이중 해제, IRawParameter.ReadRaw의 범위를 벗어난 네이티브 Memory 접근 등 여러 수명 주기 및 스레드 안전성 문제를 수정했습니다.
/WriteRaw , GrabResult.Clone() 상태 복사 대신 공유, FileAdapterStream.Write의 누수된 GCHandle, 무효화된 중복 파일 핸들 보호 기능, 네이티브 라이터를 해제하지 않던 AviVideoWriter.Dispose, 그리고 PylonLibrary 참조 횟수 누수를 유발하는 Interface/VideoWriter의 누락된 파이널라이저를 수정했습니다. - pylon .NET 5+ SDK: [369354] 상호 운용성 경계 전반에서 반환된 네이티브 C++ 배열이 올바르게 해제되도록 네이티브 배열 할당/소유권 처리를 수정하여 누수 및 이중 해제를 방지했습니다.
- pylon Viewer: [370057] 카메라 기능의 Get help 링크가 Basler Product Documentation의 해당 기능 항목으로 올바르게 리디렉션되지 않던 문제를 수정했습니다.
- pylon Viewer: [368631] USB Configurator의 Fix Driver Installation 링크가 pylon USB3 Vision 드라이버를 불필요하게 재설치하던 문제를 수정했습니다. 이제 USB Configurator를 관리자 권한으로 재시작하고 올바ر른 드라이버를 자동으로 다시 연결하여 이미 설치된 pylon USB3 Vision 드라이버를 Basler USB3 Vision 장치에 다시 바인딩합니다.
- pylon Viewer: [368882] Tile 모드를 활성화할 때 Devices 트리의 카메라 선택이 예기치 않게 변경되던 문제를 수정했습니다.
- vTools: [368685] Geometric Pattern Matching Basic 및 Template Matching Basic vTools의 Positions_px 핀에서 출력되는 상대 좌표가 이제 전체 픽셀 단위로 반올림됩니다.
- vTools: [289634] 모든 Measurements Basic 및 Pro vTools에서 InverseTf 입력 데이터를 사용할 때 잘못 처리되던 좌표 문제를 수정했습니다. 이전에는 영역이 제대로 변환되지 않았습니다. 이제 원래 입력 이미지 좌표로 변환됩니다.
- vTools: [363246] Array Element Iterator vTool에서 StartIndex 및 EndIndex 파라미터는 이제 IterationMode 파라미터가 Range로 설정된 경우에만 사용할 수 있습니다.
- vTools: [289634] Measurement Basic 및 Pro vTools의 수정된 좌표 처리에 따라 InverseTf를 올바르게 적용하도록 레시피를 업데이트했습니다.
제한 사항#
- 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에 새로운 이미지 스로틀(throttle)이 구현되었습니다. 이로 인해 pylon Viewer의 비디오 녹화 기능에 영향을 미치는 새로운 제한 사항이 도입되었습니다. 이미징 파이프라인에서 카메라당 초당 250개의 이미지만 허용되므로 이 제한을 초과할 경우 모든 프레임을 녹화하는 기능이 제한됩니다.
- Workbench: Workbench의 Statistics 기능은 vTool의 실행 시간을 측정합니다. Statistics 기능에서 측정된 시간은 시스템 구성 및 전반적인 CPU 부하에 따라 달라질 수 있습니다. 이는 현재 부하에 따라 CPU가 서로 다른 주파수(예: 동적 frequency scaling으로 인해)로 작동할 수 있기 때문입니다.
- Workbench: Workbench에서 데이터를 활발하게 표시하는 여러 핀 데이터 뷰를 사용하면 CPU 부하가 증가하고 전반적인 성능 저하가 발생할 수 있습니다. 바슬러(Basler)에서는 가능한 한 적은 수의 핀 데이터 뷰를 사용할 것을 권장합니다.
- 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 카메라를 사용하려면 pylon Supplementary Package for Stereo mini를 설치해야 합니다. pylon Supplementary Package for Stereo mini는 Basler 웹사이트에서 다운로드할 수 있습니다.
- MP4: MP4 동영상 녹화를 수행하려면 pylon Supplementary Package for MPEG-4를 설치해야 합니다. pylon Supplementary Package for MPEG-4는 Basler 웹사이트에서 다운로드할 수 있습니다.
- MP4: 해상도가 20 MP 이상인 카메라로 비디오 파일을 녹화할 때 Quality 파라미터가 80% 이상으로 설정되어 있으면 녹화가 실패할 수 있습니다. 해결 방법으로 Quality 파라미터를 더 낮은 값으로 설정하십시오.
- MP4: 녹화 기능은 ace 2 Pro 카메라의 Compression Beyond 기능을 지원하지 않습니다. 녹화가 시작되고 Compression Beyond 기능이 활성화된 경우, pylon Viewer는 먼저 카메라에서 Compression Beyond 기능을 비활성화한 다음 녹화를 시작합니다.
- USB: Basler U3V 장치들의 동기화가 해제될 수 있으므로 Intel USB 호스트에서 사용하는 Power Management를 꺼야 합니다. 이 경우 시스템 부팅 후 일부 상황에서 Basler U3V 장치들을 사용하지 못할 수 있습니다. 다음 단계에 따라 USB3 버스에서 LPM 패키지를 비활성화하십시오.
- 다음 명령을 실행하여 고급 설정을 활성화합니다.
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 전원 옵션에서 LPM 설정을 변경합니다.
- 제어판에서 전원 옵션을 엽니다.
- 선택한 전원 관리 계획에 대해 "설정 변경"을 클릭합니다.
- "고급 전원 관리 옵션 설정 변경"을 클릭합니다.
- "전원 옵션" 대화 상자의 "고급 설정" 탭에서 "USB 설정"을 선택합니다.
- "USB 3 절전 모드 설정"을 "사용 안 함"으로 설정합니다.
- 다음 명령을 실행하여 고급 설정을 활성화합니다.
- GenTL: GenTL 버전 1.4 이하 프로듀서에 대한 GenTL 지원이 제한됩니다.
- GigE: Basler ace 2 5GigE 및 1GigE 카메라를 최적으로 사용하려면 듀얼 채널 DDR4-3600 RAM 이상을 사용할 것을 권장합니다. 더 느린 RAM을 사용하면 버퍼 언더런 및 이미지 손실이 발생할 수 있습니다. 또한 Basler는 전체 설정을 최적화하기 위해 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 카메라는 이벤트 알림에 일반적인 열거형 대신 부울(Boolean) 파라미터를 사용할 수 있습니다. 이 문제를 해결하기 위해 다음 코드 스니펫을 사용할 수 있습니다. C++의 경우 camera.EventNotification.TrySetValue(EventNotification_On); 외에도 CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);를 사용할 수 있습니다.
- pylon C++ SDK: Visual Studio 2017을 사용할 때 MSB4211 경고가 발생할 수 있습니다. 이 경고를 제거하려면 Release 및 Debug 프로젝트 속성(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 설명서를 참조하십시오. - pylon C SDK: pylon C API는 아직 GenDC 및 Basler blaze 3D 카메라를 사용할 수 있는 편리한 기능을 제공하지 않습니다.
- pylon C SDK: (CoaXPress 등에서) GenTL Consumer를 사용할 수 있도록 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 디버거 옵션에서 Managed Compatibility 모드를 활성화하십시오.
- 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는 여기서 다운로드할 수 있습니다.