pylon Software Suite 8.0.0 Release Notes#

Release date: 2024-09-24

Binary Compatibility#

Data Processing = 3.0.1
Applications built with 3.0.x or earlier 3.x.x versions of the Data Processing are compatible.
pylon C SDK = 9.0.0
Applications built with earlier versions of the pylon C SDK are incompatible.
pylon C++ SDK = 9.0.0
Applications built with earlier versions of the pylon C++ SDK are incompatible.
pylon .NET SDK = 1.2.0
Applications built with 1.2.x or earlier versions of the pylon .NET SDK are compatible.

New Features / Changes#

General: [311182] Following Semantic Versioning 2.0, the pylon SDK library names now only state the major version number and not the minor version number anymore.
pylon AI Agent: [286592] The pylon AI Agent is used to deploy models to AI vTools. You can choose between deploying models via the pylon AI Platform or from storage. Models can be deployed on local or remote computers.
vTools: [286272, 286412, 285715, 285681] The following vTools have been added: - Object Detection - Classification - Semantic Segmentation - Instance Segmentation
pylon Viewer: [314565] Added pylon Event Logger as external tool in Tools menu.
pylon Viewer: [311582] The Automatic Image Adjustment feature is now available on dart M cameras.
pylon Viewer: [313572] Panes can now be closed via a context menu.
pylon Viewer: [308989] Added AI topics to the New Features and Learn More dialogs.
pylon Viewer: [305588] The Line Profile can now be reset to its initial position via the context menu of the image window.
pylon Viewer: [297026] Added a context menu to the Line Profile pane.
Workbench: [308021] The pin data view applies "Zoom to Fit" for the first image displayed.
Workbench: [308968] The "Zoom to Fit" feature in pin data views now scales seamlessly.
Workbench: [308991] On the Licensing tab of the Welcome dialog, added links for AI vTools. In the Workbench menu, an entry for the pylon AI agent has been added.
CXP IC: [298766] Added BoardStatus section with features providing information about the board status.
CXP IC: [298766] Added Errors section with features providing information about errors.
CXP IC: [298766] Added CameraStatus event to provide information about missing frames lost in transmission to the frame grabber.
CXP IC: [298766] Renamed CorrectedErrorCount to CameraCorrectedErrorCount.
CXP IC: [298766] Renamed UncorrectedErrorCount to CameraUncorrectedErrorCount.
CXP IC: [306774] Solved communication issue to Opto-Coupled Trigger 5 boards.
CXP IC: [220218] Fixed incorrect values in status operators which caused issues with CXP status and port status.
CXP IC: [303278] CustomSignalEvent0 and CustomSignalEvent1 now allow using FrontGPI2 and FrontGPI3 as source.
Data Processing: [289432] Improved performance by optimizing the internal handling of data types.
Data Processing: [274754] CRegion::GetBuffer() behavior has been changed to implement copy-on-write.
Data Processing: [300937] Added sample demonstrating how to receive chunks and events from the Camera vTool.
pylon C SDK: [298881] There is now a separate CMake finder (pylonC) for the pylon C interface. pylon C content has been removed from the existing pylon CMake finder.
pylon C++ SDK: [296692] Added sample demonstrating the use of the shading correction feature of racer 2 line scan cameras.
pylon C++ SDK: [314002] The CBaslerUniversalInstantCamera class has been updated.
pylon C++ SDK: [303027] The GrabResult object now has an additional member, and CPylonDataComponent was extended to support multipart data components.
pylon C++ SDK: [298881] pylon C content has been removed from the pylon CMake finder. There is now a separate CMake finder for pylon C.
pylon C++ SDK: [304030] Added new log4cpp logappender to support the new Basler logging system ELT.
pylon C++ SDK: [303896,303897] Improved logging to support the pylon Event Logger, especially with regard to GenTL and CXP.
vTools: [307646] Added more calibration plate sizes: 800 mm, 1200 mm, 1600 mm, and 2400 mm
vTools: [309025] Added the option to save absolute paths to image source folders in the Image Loading vTool.
vTools: [285172] In the Camera vTool, output pins can be added to output camera chunk data.
vTools: [285171] In the Camera vTool, output pins can be added to output camera event data.
vTools: [275698] The Image Loading vTool now supports using relative paths to image source folders in recipes.

Corrections#

pylon Viewer: [285047] When the Color Calibrator fails to successfully complete the second step, the Continuous Shot check box remains checked.
pylon Viewer: [312899] Fixed Histogram panning when using color images.
pylon Viewer: [312817] Fixed alignment of the Y axis label in the Line Profile pane.
pylon Viewer: [308356] Increased the wait time to rediscover a camera after performing a firmware update.
pylon Viewer: [290732] Improved error message when exceeding limits using Static Defect Pixel Correction.
pylon Viewer: [307521] Line scan cameras will now use the correct acquisition mode when using the single shot feature.
pylon Viewer: [304190] Fixed an issue which caused overlapping of the text and buttons in the title of image window tabs.
Workbench: [291903] Fixed an issue which caused input pins of vTools being added falsely as data source of pin data views.
Workbench: [312967] Fixed an issue which caused an error when loading recipes without vTools.
Workbench: [311609] Fixed an issue that may have been causing the pylon Viewer to crash when closing it while there is a Camera vTool with allocated.
Workbench: [299047] Fixed some display issues regarding the pin data view, including the RGB info and the full-screen mode after a recipe has been stopped.
Workbench: [307585] Fixed an issue that could cause the text in the pin data view to be displayed incorrectly.
CXP: [304411] - 'Fixed: Before fixing this issue, applet event timestamps weren't correct. They were divided by 2. This has been fixed. Now, the applet event timestamps have the correct values.
Data Processing: [312880] Fixed an issue that prevented the renaming of input and output terminal pins when the names of pins that were created later started with the name of the first pin.
Data Processing: [309051] Changed nested namespace definition in GenericOutputObserver.h to match other header files.
Camera Link: [307793] Added missing Basler_CameraLink.zip, which contains a required XML file, to pylon runtime.
GigE: [314339] Fix for out of encoded data error when using Compression Beyond when using the Socket Driver. This is also fixed for pylon GEV Driver Version 5.4.1.1260.
Twain: [308082] Fixed a hang on load in the TWAIN driver.
vTools: [314717, 314714, 314713, 314707, 314716, 314724, 314710, 314709] Updated error handling for vTools that use Transformation Data.
vTools: [314724] Get help in the vTools-documentation for OCR-vTool opens the correct documentation-page.
vTools: [305245] In the Calibration Basic/Pro vTools, the graphical display of the image coordinates is correct if the operating system's screen- scaling feature is enabled.
vTools: [303977] Fixed dialog text for rotation angle in the Template Matching Basic vTool.
vTools: [311250] Removed obsolete node map entry and updated vTool documentation for the Document Cropper vTool.
vTools: [301657] Improved support for manual machine calibration in the Calibration Basic and Pro vTools.
vTools: [305510] Updated dialog appearance of the Template Matching Basic vTool.
vTools: [306903] In the Gray value Transformer Starter vTool, parameter names have been updated.

Restrictions#

pylon Viewer: A new image throttle has been implemented in the pylon Viewer to improve overall stability and performance. This introduces a new restriction which affects the video recording feature of the pylon Viewer. Allowing only 250 images per second and camera in the imaging pipeline limits the ability to record every frame when exceeding this limit.
pylon Viewer: The Color Calibrator does not support all Basler color cameras. Due to a different camera feature set, Basler dart and boost V cameras are not supported.
pylon Viewer: Under certain circumstances, e.g., a very slow or busy computer, the Color Calibrator may not work if the camera has already been opened in the pylon Viewer. To prevent this, close the camera before using the Color Calibrator.
pylon Viewer: On computers with an Intel HD graphics card, it may be necessary to update the graphics driver to the current version.
Workbench: Using multiple pin data views actively displaying data in the Workbench may cause an increase of the CPU load and degradation of the overall performance. Basler recommends using fewer pin data views whenever possible.
Workbench: The Statistics feature of the Workbench measures the execution times of vTools. The times measured in the Statistics feature may vary depending on the configuration of your system and the overall CPU load. This is so, because CPUs may run with different frequencies depending on the current load (e.g., due to dynamic frequency scaling).
CXP IC: For line scan applets, ranges of line period and line exposure aren't handled properly. The maximum values may be lower than expected.
pylon C SDK: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera yet.
pylon C SDK: For using the GenTL Consumer (e.g., with CoaXPress), additional functionality was added to pylon C to be able to start and stop streaming explicitly. This functionality has not been documented in the pylon C programmer's guide yet. Please refer to the pylon C++ programmer's guide (see chapter "Migrating from Previous Versions - Changes in the IStreamGrabber API") or the pylonC OverlappedGrab programming sample.
pylon C++ SDK: When building samples using CMake, you may run into a path length limitation of the operating system. You may get build errors stating the paths exceed the maximum path length of 260 characters. This may happen if the absolute path of your CMake build directory exceeds 80 characters. The build directory is the current working directory or the directory specified by the '-B' option when you call cmake. If you experience this error, use a build directory with a shorter path not exceeding 80 characters, i.e., directly in your user profile C:\Users\\Samples. You can enable long paths on Windows 10, Version 1607, and later. See the Microsoft documentation for more information.
pylon C++ SDK: Using Visual Studio 2017, you may get the MSB4211 warning. To remove the warning, specify the version of the Windows SDK in the Release and Debug project properties (Configuration Properties -> General -> Windows SDK Version).
pylon C++ SDK: Some ace 2 cameras may use a Boolean parameter instead of the usual enumeration for event notifications. The following code snippets can be used to work around this issue. For C++ you can use: CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true); in addition to: camera.EventNotification.TrySetValue(EventNotification_On);
GigE: In case the error message "Failed to allocate resources." has been reported, Basler recommends using the pylon GigE Configurator tool to optimize the IP configuration of NICs and cameras.
GigE: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool.
pylon C++ SDK: The InstantCameraArray classes can acquire images from a maximum of 21 cameras.
GigE: For optimum use of Basler's ace 2 5GigE and 1GigE cameras, Basler recommends using dual-channel DDR4-3600 RAM or better. Using slower RAM may cause buffer underruns and image loss. In addition, Basler recommends using the pylon GigE Configurator tool to optimize the complete setup.
GenTL: Limited GenTL support for producers with GenTL version 1.4 and below.
USB: The Power Management used by the Intel USB host must be turned off since Basler U3V devices may get desynchronized. If this is the case, the Basler U3V devices may be not available after booting the system in some cases. Disable LPM packages on the USB3 bus with the following steps:
1. Enable advanced settings by executing the following command:
  powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE
2. Change the LPM settings in the power options.
  1. Open the Power Options in the control panel.
  2. Click "Change plan settings" for the selected power plan.
  3. Click "Change advanced power settings".
  4. In the "Power Options" dialog on the "Advanced settings" tab, select "USB settings".
  5. Set "USB 3 Link Power Management" to "Off".
MP4: MP4 video recording requires the pylon Supplementary Package for MPEG-4 to be installed in order to work. The pylon Supplementary Package for MPEG-4 is available for download on the Basler website.
MP4: Recording of video files with cameras with resolutions of 20 MP or higher may fail, if the Quality parameter is set to 80 % or more. As a workaround, set the Quality parameter to a lower value.
MP4: The Recording feature doesn't support the Compression Beyond feature in ace 2 Pro cameras. When recording is started and the Compression Beyond feature is enabled, the pylon Viewer first disables the Compression Beyond feature in the camera and then starts recording.
3D: Using Basler blaze 3D cameras requires the pylon Supplementary Package for blaze to be installed. The pylon Supplementary Package for blaze is available for download on the Basler website.
Direct Show: CoaXPress cameras are not supported with DirectShow driver.
Twain: CoaXPress cameras are not supported with Twain driver.
pylon AI Agent: With certain resolutions and scaling settings, buttons may not be visible.

Download#

You can download this version of the pylon Software Suite here.