pylon Software Suite 26.10 Release Notes#
Binary Compatibility#
- Data Processing = 6.0.0
Applications built with earlier versions of the Data Processing are incompatible. - pylon C SDK = 10.1.0
Applications built with 10.1.x or earlier 10.x.x versions of the pylon C SDK are compatible. - pylon .NET SDK = 9.0.0
Applications built with earlier versions of the pylon .NET SDK are incompatible.
New Features / Changes#
- vTools: [360948] Added the Pattern OCR vTool. To use the vTool, the pylon Supplementary Package for pylon AI version 1.6.1 or higher is required.
- GigE: [369750] Added the AutoFrameRetention parameter. When enabled, it automatically calculates the FrameRetention value based on the current frame rate, including a fixed safety margin.
- GenTL/GigE: [369750] Added the AutoFrameRetention parameter. This automatically calculates the FrameRetention value based on the current frame rate, including a fixed safety margin.
- GigE: [347002] The pylon GigE Configurator now automatically disables Energy-Efficient Ethernet (EEE) on optimized network adapters, since EEE-induced link transitions during idle periods have been observed to cause connection and transmission errors with GigE Vision cameras. On Windows, the original setting is restored when the tool exits. Adapters whose driver exposes no EEE control are skipped silently.
- GigE: [335939] Updated the pylon GigE Configurator for multi-camera GigE setups on Windows. All recommendations from application note AW00194001000 have been implemented.
- GigE: [371519] Updated the pylon GigE Filter Driver to version 5.7.0.1310. The driver now contains GenDC support.
- pylon .NET SDK: [369354] Added IDataContainer.GetFirstImageDataComponent() and TryGetFirstImageDataComponent() to retrieve the first matching image data component from a (GenDC) data container.
- pylon .NET SDK: [369354] Added zero-copy access to pixel data via IDataComponent.AsPixelDataView() and a new DataSize property.
- pylon .NET SDK: [369354] Updated all grab samples to read image data through IDataContainer/IDataComponent so they work correctly with GenDC-enabled cameras as well as classic grab results.
- Data Processing: [370224] Extended BuildersRecipe::SaveAs to allow controlling the detail level of settings data.
- pylon Event Logger: [366731] The maximum number of messages displayed in the message view can now be changed after a capturing session has been started. For this, the session needs to be paused.
- Workbench: [371341] Added the pylon Lean Runtime Recipe option. This allows saving recipes in the Workbench with only the information required for runtime operation.
- vTools: [369524] Added the pylon Lean Runtime Recipe option. This allows saving recipes in the Workbench with only the information required for runtime operation. Lean Runtime Recipes that contain Matching Basic, Matching Pro, or Calibration vTools are not backward-compatible.
- PylonVToolCreatorRuntime: [370222] Added Settings::GetDetailLevel() for determining the recipe save detail level.
Corrections#
- GigE: [368428] Fixed GigE Vision packet resend so every missing packet range still present in the receive map is requested when one receive batch contains multiple gaps.
- GigE: [335939] Corrected Windows DHCP state changes and rejected unsupported RSS CPU counts. On systems with multiple processor groups, RSS placement now uses logical processors in the supported group.
- GigE: [335939] Corrected the –dry-run option of the pylon GigE Configurator. It no longer requires administrator or root privileges. On Linux and macOS, it also no longer opens system files for writing, and failures while optimizing the system settings are now reflected in the exit code.
- pylon Viewer: [369747] Fixed an issue that prevented user-defined feature tabs from being edited correctly.
- pylon Viewer: [369748] Fixed incorrect streaming button states after reattaching a camera. The Start, Stop, and Single Shot buttons now correctly reflect the camera's current acquisition state.
- pylon Viewer: [360865] Improved firmware compatibility checks of the Firmware Updater. This resulted in clearer error messages for inaccessible cameras, invalid update files, and incompatible firmware. Compatibility is now checked automatically when opening the update selection page and can be checked again manually.
- pylon Viewer: [369409] Improved camera compatibility detection and initialization for Flat-Field Correction. Conflicting HDR settings are now disabled automatically for block-based correction, and initialization errors are reported more clearly.
- pylon Viewer: [368551] Fixed an issue that could cause the application to become unresponsive while running the analysis in the Bandwidth Manager. Throughput updates no longer trigger unintended changes to the inter-packet delay.
- pylon Viewer: [371680] Fixed an issue where the count of images recorded by the pylon Viewer displayed a trailing percent sign.
- Workbench: [350603] Fixed an issue where the Pin Data View drop-down showed incorrect pins enabled/disabled until clicked.
Restrictions#
- pylon Viewer: Images grabbed by Stereo ace 2 cameras can't be displayed yet.
- pylon Viewer: On computers with an Intel HD graphics card, it may be necessary to update the graphics driver to the current version.
- 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: 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: 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.
- 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).
- 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.
- 3D: Using Stereo ace 3D cameras requires the pylon Supplementary Package for Stereo ace to be installed. The pylon Supplementary Package for Stereo ace is available for download on the Basler website.
- 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.
- 3D: Using Stereo mini 3D cameras requires the pylon Supplementary Package for Stereo mini to be installed. The pylon Supplementary Package for Stereo mini is available for download on the Basler website.
- 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.
- 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:
- Enable advanced settings by executing the following command:
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - Change the LPM settings in the power options.
- Open the Power Options in the control panel.
- Click "Change plan settings" for the selected power plan.
- Click "Change advanced power settings".
- In the "Power Options" dialog on the "Advanced settings" tab, select "USB settings".
- Set "USB 3 Link Power Management" to "Off".
- Enable advanced settings by executing the following command:
- GenTL: Limited GenTL support for producers with GenTL version 1.4 and below.
- 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.
- GigE: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool.
- 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.
- 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);
- 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: 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: 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 .NET SDK: Updating to this version of the .NET API requires you to update your .NET project files to reference the new assembly. This is required due to the VB2015 compatibility fix (interface class Basler.Pylon.IParameterListEnum was changed to ref class Basler.Pylon.ParameterListEnum).
- pylon .NET SDK: If native debugging is enabled for your .NET project and if your project is referencing pylon assemblies, the application may crash when running it under the Visual Studio 2012 or Visual Studio 2013 debugger. To avoid this issue, enable the Managed Compatibility mode in the Visual Studio Debugger options.
- vTools: If the recipe contains the Color Classifier vTool and one or more of the Region vTools (Region Morphology, Region Selection, Region Feature Extraction), the Blob Analysis Basic license is listed for purchase as well as the Color Blob Analysis Basic license.
- vTools: If a recipe contains the Measurements Basic vTool as well as one or more of the Measurements Pro vTools, the Measurements Basic license is listed for purchase as well as the Measurements Pro license.
- GigE: When using the Nebula Matrix SmartNIC driver, streaming with Extended ID is not supported. The images will become corrupted.
Download#
You can download this version of the pylon Software Suite here.