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

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

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.

pylon Supplementary Package for blaze


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.