################################################################################ RELEASE NOTES ============== pylon Supplementary Package for blaze Version: 1.5.0 Release date: 2023-09-30 Preceding release: 1.3.1 Products affected: blaze-101 (order number 107796), revisions 03 or above blaze-102 (order number 108711) NEW FEATURES ------------ * Added support for new camera features introduced by blaze firmware version 5.0.0. * The GenTL producer for blaze cameras is compliant with the GenTL standard version 1.6. * Added the MultiCam/DepthFusion C++ programming sample illustrating how to calibrate a system consisting of multiple Basler blaze cameras. * Added the ColorAndDepth_SynchronousFreeRun Python programming sample illustrating how the PTP and the Synchronous Free Run features help you to capture data from a 2D and a blaze camera. * The installation packages for Linux ARM include Python samples as the Harvester's Python module, which is used for accessing blaze cameras, recently became available for Linux ARM. * Added C++ programming samples illustrating how to use the Aravis open source library for accessing blaze cameras. * The GenTL producer for blaze cameras provides the additional 'newestOnly' and 'oldestFirstOverwrite' buffer handling modes. CHANGES -------- * Increased performance of the ShowPointCloud Python programming sample. * Fixed bugs and increased performance of the ColorAndDepthFusion Python programming sample. * Fixed an issue causing the ROS node for blaze cameras to crash when receiving a kill signal. * Fixed an issue preventing the blaze Viewer to run on CPUs without AVX support, like some Intel Celeron CPUs. * Fixed an issue causing the blaze Viewer's File Save dialog to crash on some Ubuntu setups. * Fixed an issue causing a connection loss when issuing a PtpDataSetLatch command. * Fixed font size-related issues of the blaze Viewer on systems with high resolution displays. * Fixed an issue causing the blaze Viewer to save corrupted 16-bit .tiff images. * Fixed an issue preventing web browsers installed as snap packages from opening the blaze Programmer's Guide. This was the case for Mozilla Firefox on Ubuntu 22.04, for example. KNOWN LIMITATIONS ------------------ Windows, pylon versions below pylon 7.2.1: - If the Extended IDs feature is enabled, acquiring images is not possible. Either disable extended IDs or select the socket driver as stream grabber type. How to configure the stream grabber type: blaze Viewer: Data Stream -> Extended Stream Control -> Type of Stream Grabber C++: camera.GetStreamGrabberParams().Type.SetValue(Type_SocketDriver); C#: camera.Parameters[PLStream.Type].SetValue(PLStream.Type.SocketDriver); - Basler generally recommends using pylon 7.3 or above with blaze cameras. Linux - Programming samples using the Point Cloud Library (PCL) may crash depending on the versions of the PCL and VTK libraries installed on your system. The crash is due to a bug in the VTK libraries that are used by PCL for 3D visualization. Source: https://github.com/PointCloudLibrary/pcl/issues/5237 For example, Ubuntu 22.04 ships versions of the libraries showing the problem. Solution: PCL 1.13.1 contains fixes to work around the VTK bug. Uninstall the PCL libraries provided by your Linux distribution and build PCL version 1.13.1 or newer from sources (these are available on https://github.com/PointCloudLibrary/pcl). ################################################################################ Version: 1.3.1 Release date: 2022-11-09 Preceding release: 1.3.0 Products affected: blaze-101 (order number 107796), revisions 03 or above blaze-102 (order number 108711) CHANGES -------- Windows: - Fixed a bug causing the application to crash when there is a high amount of network packet losses and packets at the beginning of an image frame are lost. COMPATIBILITY ------------- *WARNING:* Because of bugs in pylon 7.1 and pylon 7.2.0, avoid using the blaze camera with pylon 7.1. or pylon 7.2.0. Using pylon 7.2.1 or above or pylon 7.0 or below is recommended. When using pylon 7.1, image acquisition may stop unexpectedly. When using pylon 7.2.0 on Windows systems, a blue screen may occur in case of network packet losses. KNOWN LIMITATIONS ------------------ Windows, pylon versions below pylon 7.2.1: - If the Extended IDs feature is enabled, acquiring images is not possible. Either disable extended IDs or select the socket driver as stream grabber type. How to configure the stream grabber type: blaze Viewer: Data Stream -> Extended Stream Control -> Type of Stream Grabber C++: camera.GetStreamGrabberParams().Type.SetValue(Type_SocketDriver); C#: camera.Parameters[PLStream.Type].SetValue(PLStream.Type.SocketDriver); ################################################################################ Version: 1.3.0 Release date: 2022-10-24 Preceding release: 1.2.1 Products affected: blaze-101 (order number 107796), revisions 03 or above blaze-102 (order number 108711) NEW FEATURES ------------- * Added support for Basler blaze-102 cameras. * Added support for new camera features introduced with blaze firmware version 4.3. * blaze Viewer: New point cloud window. To open a point cloud window that renders colored point clouds, select "New Point Cloud Windows (Confidence Color)" in the "Window" menu. In this point cloud window, the hue indicates the distance of a point and the intensity of the color visualizes the assigned confidence value. * Added the "ExtrinsicTranformation" C++ sample that demonstrates how to detect the main plane in a point cloud and how to configure the camera to appply a coordinate transformation. CHANGES -------- * Windows installer and binaries are code-signed to prevent Windows warnings about software from an unknown publisher. * Fixed C# code snippets displayed in the blaze Viewer's Documentation window. * Linux: Ubuntu 16.04 is no longer supported. * Linux: There are no separate installation packages without a blaze viewer anymore. COMPATIBILITY ------------- *WARNING:* Because of bugs in pylon 7.1 and pylon 7.2, avoid using the blaze camera with pylon 7.1. or pylon 7.2. Using pylon 7.0 or below is recommended. When using pylon 7.1, image acquisition may stop unexpectedly. When using pylon 7.2, image acquisition may be unstable. KNOWN LIMITATIONS ------------------ Windows: * If the Extended IDs feature is enabled, acquiring images is not possible. Either disable extended IDs or select the socket driver as stream grabber type. How to configure the stream grabber type: blaze Viewer: Data Stream -> Extended Stream Control -> Type of Stream Grabber C++: camera.GetStreamGrabberParams().Type.SetValue(Type_SocketDriver); C#: camera.Parameters[PLStream.Type].SetValue(PLStream.Type.SocketDriver); ################################################################################# Version: 1.2.1 Release date: 2022-07-13 Preceding release: 1.2.0 Products affected: blaze-101 (order number 107796), revision 03 or above, firmware version 3.0 or above. CHANGES ------- * Improved compatibility with the Basler pylon Camera Software Suite version 7.1. * C++ API, CBlazeCamera class: Added functionality to read the temperature information of the image sensor. * .NET API, blaze parameter list: Added functionality to read the temperature information of the image sensor. ################################################################################ Version: 1.2.0 Release date: 2022-05-06 Preceding release: 1.0.0 Products affected: blaze-101 (order number 107796), revision 03 or above, firmware version 3.0 or above. NEW FEATURES ------------ * Added support for the following camera features introduced with firmware version 4.2: - DistortionCorrection - HDRMode - ExposureTimeSelector - DeviceTemperatureSelector -> Sensor - PersistentLogging * Added C++ sample code demonstrating how to use PTP clock synchronization and the Synchronous Free Run feature to operate a Basler blaze and a Basler GigE color camera. * Added C++ sample code demonstrating how to disable distortion correction in order to use your own calibration data. * Added C++ class 'RgbdCamera' that allows you to combine a 2D color and a blaze camera and to use the two cameras like a single RGB-D camera. The combined cameras are triggered synchronously using PTP (IEEE 1588) and the Synchronous Free Run feature. * Added Python sample that illustrates how to calibrate a Basler GigE color camera and fuse the color image into a colored point cloud. * Added support for ARM 64-bit devices running Ubuntu 18.04 or above. The binaries may work on other distributions as well when the following requirements are met: - gcc Version 7.5 or above - binutils 2.30-21 or above - libc6 2.27-3 or above - libstdc++6 8.4.0 or above CHANGES -------- * Standardization of naming: Instead of 'range', the term 'depth' is now used for depth data. Further information on the image formats can be found in the Basler Product Documentation: https://docs.baslerweb.com/component-selector * ColorAndDepthFusion sample: Includes an occlusion detection that prevents incorrect coloring of occluded areas in the scene with color data. * Renaming of the PtpHelper library to MultiCamHelper and revision of the library with C++ samples with functions for operating multiple cameras using the Synchronous Free Run feature and support for synchronizing GigE color cameras. * Python samples adapted to be compatible with Harvester version 1.3.5 (or above). * Fixed issues related to thread local storage when an application uses the thread local storage implementation provided by boost C++ libraries under Linux. Issue occurred for example in Robot Operating System (ROS)-based applications. KNOWN LIMITATIONS ------------------ General: * Sample code for the Synchronous Free Run and Multi-Camera Channel features is currently available for C++ only. Although no samples are provided, the features are available when using C#, Visual Basic, and Python. Linux: * The Basler blaze Viewer is supported only on x64 systems running Ubuntu 18.04 or above. There may be other Linux distributions on which the blaze Viewer will run but Basler has only tested with Ubuntu Linux. ARM64: * Python samples are not available since they require the GenICam Harvester package that currently is not available for ARM platforms. * The documentation is not yet fully adapted to ARM devices. ################################################################################ Version: 1.0.0 Release date: 2021-07-12 Preceding release: n/a Products affected: blaze-101 (order number 107796), revision 03 or above, firmware version 3.0 or above. COMPATIBILITY/MIGRATION ------------------------ *WARNING*: This release is only compatible with blaze-101 cameras with firmware versions 3.0 or above. For blaze-101 cameras with firmware versions below 3.0, a firmware update is required. Mixing 2.x cameras with 3.x cameras in the same application is not possible. Firmware update packages and update instructions can be downloaded here: https://www.baslerweb.com/baslermedia/blaze-getting-started/?dir=Firmware KNOWN LIMITATIONS ------------------ General: * Sample code for the Synchronous Free Run and Multi-Camera Channel features is currently available for C++ only. Although no samples are provided, the features are available when using C#, Visual Basic, and Python. Linux: * The Basler blaze Viewer is supported only on x64 systems running Ubuntu 18.04 or above. There may be other Linux distributions on which the blaze Viewer will run but Basler has only tested with Ubuntu Linux. * The Basler blaze Viewer may crash on a virtual machine.