################################################################################

RELEASE NOTES
==============

pylon Supplementary Package for blaze

Version:           1.7.2
Release date:      2024-12-02
Preceding release: 1.7.1
Products affected: blaze-101 (order number 107796), revisions 03 or above
                   blaze-102 (order number 108711)
                   blaze-112 (order number 109245)

CHANGES
------------

* Fixed a bug where the blaze Viewer didn't start reliably.
* Revised the ColorAndDepthFusion C++ sample to support more camera models.
  
KNOWN LIMITATIONS
------------------

Windows, pylon versions below pylon 7.2.1:
- 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 and above contain fixes to work around the VTK bug.
  Uninstall the PCL libraries provided by your Linux distribution and build PCL
  version 1.13.1 or above from sources (these are available on
  https://github.com/PointCloudLibrary/pcl).
  
################################################################################

RELEASE NOTES
==============

pylon Supplementary Package for blaze

Version:           1.7.1
Release date:      2024-09-27
Preceding release: 1.7.0
Products affected: blaze-101 (order number 107796), revisions 03 or above
                   blaze-102 (order number 108711)
                   blaze-112 (order number 109245)

CHANGES
------------

* Added support for the Basler pylon Camera Software Suite version 8.0.
  
KNOWN LIMITATIONS
------------------

Windows, pylon versions below pylon 7.2.1:
- 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 and above contain fixes to work around the VTK bug.
  Uninstall the PCL libraries provided by your Linux distribution and build PCL
  version 1.13.1 or above from sources (these are available on
  https://github.com/PointCloudLibrary/pcl).
  
################################################################################

RELEASE NOTES
==============

pylon Supplementary Package for blaze

Version:           1.7.0
Release date:      2024-09-12
Preceding release: 1.6.0
Products affected: blaze-101 (order number 107796), revisions 03 or above
                   blaze-102 (order number 108711)
                   blaze-112 (order number 109245)

NEW FEATURES
------------

* Added the ComponentIDValue parameter. This is a unique identifier that
  indicates the type of the component selected by the ComponentSelector 
  parameter.
* Added the Scan3dProjectionModel parameter that describes the mapping 
  function used for distortion correction.
* Added programming samples that illustrate how to access a blaze camera using
  Python and pypylon. pypylon is the official Python wrapper for the Basler
  pylon Software Suite. The samples have been added under Python/pypylon.

CHANGES
--------

* Fixed a bug where the point cloud in the blaze Viewer wasn't updated if the
  scene didn't provide valid measurement values.
* Fixed a bug where the blaze Viewer crashes when a point cloud window is
  closed.
* When saving an image sequence in the blaze Viewer, the camera configuration
  is no longer saved for each image but only once when the image sequence is
  stopped.
* The ColorAndDepthFusion C++ sample now saves the calibration data in the
  user data of the color camera and recognizes the matching camera pairs based
  on the DeviceUserID parameter values of the cameras.
  
KNOWN LIMITATIONS
------------------

Windows, pylon versions below pylon 7.2.1:
- 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 and above contain fixes to work around the VTK bug.
  Uninstall the PCL libraries provided by your Linux distribution and build PCL
  version 1.13.1 or above from sources (these are available on
  https://github.com/PointCloudLibrary/pcl).

################################################################################

Version:           1.6.0
Release date:      2024-05-03
Preceding release: 1.5.0
Products affected: blaze-101 (order number 107796), revisions 03 or above
                   blaze-102 (order number 108711)

NEW FEATURES
------------

* Improved handling of the GigE Vision heartbeat timeout. In case an application
  has been started under the control of a debugger, the connection to the camera
  is closed automatically when the application is terminated or crashes. This
  allows you to use the GigE camera again immediately after restarting the
  application. pylon 7.1 or above is required for the improved heartbeat timeout
  becoming effective.

CHANGES
--------

* Updated OpenCV and Point Cloud Library installation topics in the blaze
  C++ Programmer's Guide.
* Fixed an issue causing the producer to not acquire images when the Extended ID 
  feature is enabled (under Windows with pylon GigE Vision Performance Driver). 
  Note that the pylon GigE Vision Performance Driver has been discontinued. 
  You should use the pylon GigE Vision Filter Driver instead.
* Fixed an issue causing the blaze Viewer to crash when the content of the 
  feature tree search box was deleted.
* Fixed an issue causing the frame ID to only go up to 65535 when the Extended ID
  feature was enabled and then to overflow (under Windows with pylon GigE Vision 
  Filter Driver).
* Fixed an issue where the Gamma Correction feature didn't work properly when 
  using camera firmware version 4.x.
* Fixed the return type of GetBufferPartInfo BUFFER_PART_INFO_DATA_TYPE
  from int to size_t.
* Added the AutoPacketSize and UseExtendedIdWhenSupported parameters. Usage of
  GigE Vision Extended IDs is enabled by default.

KNOWN LIMITATIONS
------------------

Windows, pylon versions below pylon 7.2.1:
- 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 and above contain fixes to work around the VTK bug.
  Uninstall the PCL libraries provided by your Linux distribution and build PCL
  version 1.13.1 or above from sources (these are available on
  https://github.com/PointCloudLibrary/pcl).

################################################################################

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.
