pylon 6 Camera Software Suite for Linux RELEASE NOTES Note: Intermediate versions for Linux OS are not released publicly. All changes made in intermediate versions are included in the current version of pylon. ################################################################################ RELEASE DATE: 2020-05-12 VERSION: 6.1.1 ################################################################################ BINARY COMPATIBILITY ========================= Applications built with pylon 6.1.0 are compatible with pylon 6.1.1. CORRECTIONS ========================= * CXP: [155848] The CPU load has been reduced significantly. * CXP: [152270] The status LEDs of the Basler CXP-12 Interface Card 1C behave according to the CoaxPress 2.0 standard now. * CXP: [154516] Fixed an issue with the OpenMP interface that might have caused unexpected termination under circumstances. * CXP: [158241] Fixed an issue with memory leaks during device discovery. * CXP: [158248] Under rare circumstances, a race condition in the error handling may have caused an unexpected termination. RESTRICTIONS ========================= * pylon Viewer: To use the pylon Viewer, you must install the latest Mesa OpenGL driver for your system. On Debian-based platforms, you will also need to install the libgl1-mesa-dri and libgl1-mesa-glx packages. * pylon C: The pylon C API doesn't support the Basler Compression Beyond feature yet. * pylon C: 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 guides 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. * GenTL: [133711] Limited GenTL support to producers with GenTL version 1.5 and above. * CXP: In rare cases, the camera is not found after booting the computer. Power-cycle the camera to resolve this. * CXP: Grabbing with very high frame rates above 50000 fps using the Basler CXP-12 Interface Card 1C is not supported. * CXP: When allocating buffers used for grabbing, the buffer address must be aligned to 8-byte increments. This is automatically the case if you use heap memory. * CXP: If a version of the Silicon Software Runtime is installed on your computer, you may experience incompatibility issues when using CoaXPress cameras and interface cards. Therefore, Basler advises against installing pylon in parallel to Silicon Software Runtime. * 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 20 MPixel or higher resolution may fail if the Quality parameter is set to 80 % or more. To work around that, set the Quality parameter to a lower value. * MP4/AVI: [139274] 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, pylon will first disable the Compression Beyond feature in the camera and then start recording. * 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. * SDK: Kernel 3.x or higher is required to use the pylon C API. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configurations. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. * BPD: The Basler Product Documentation requires advanced JavaScript support. Please use a modern browser, e.g., Firefox 44 (or higher), or Chrome 49 (or higher). * GigE Vision: Assigning a static IP address to a camera that is not in the same subnet as the network adapter may make the camera unreachable. To prevent this, set the rp_filter (reverse path filter) to 2 ("loose mode") on the camera's network interface. For more information, see the Assigning an IP Address to a Camera topic in the Basler Product Documentation. ################################################################################ RELEASE DATE: 2020-03-11 VERSION: 6.1.0 ################################################################################ BINARY COMPATIBILITY ========================= Applications built with earlier versions of pylon are incompatible with pylon 6.1.0. NEW FEATURES / CHANGES ========================= * Setup: The structure of the pylon_*.tar.gz archives has been changed. The SDK Samples folder, the Doc folder, the README and ReleaseNotes.txt documents, the setup-usb.sh and 69-basler-cameras.rules scripts have been moved to /share/pylon. * General: [136833] pylon and GenICam libraries are built with the Ubuntu 16.04 toolchain. See README document for details. * CXP: [147817] Added support for CoaXPress 2.0 for Linux x86_64. This enables you to use the new Basler boost cameras and the Basler CXP-12 Interface Card 1C (firmware version 3.0 S1.1 P1 or newer), which are based on this standard. Please note that design-in cameras are not supported with pylon 6.1.0. For more information, please contact the Basler technical support. * GenTL: [127826] Added support for image decompression for Basler ace 2 Pro GigE Vision and USB3 Vision cameras that support the Compression Beyond feature. The pylon GigE Vision and USB3 Vision GenTL producers will now automatically decompress the image data before transferring it to any 3rd party GenTL consumers. * USB3: [55923] Added a new Usb setup script that can now set open file limit and usbfs memory. * USB3/pylon Viewer [134608]: The default value for MaximumTransferSize has been increased to 256 KBytes to improve CPU usage. * USB3: [55923] The Libusb error memory limit handling has been improved. * GigE Vision: [126099] Added mapping of YCbCr422_8 pixel type to Pylon::PixelType_YUV422_YUYV_Packed in GigE Vision transport layer for ace 2 GigE cameras. * pylon: [113461] The PylonFirmwareUpdater supports CoaXPress and ace 2 USB3 Vision and GigE Vision cameras. * pylon Viewer: [140269] The Features pane has been updated. By default, features are now presented on two feature tabs: Features - All and Features - Basic. The Features - All tab includes all features. It also allows, you to select from a list of Common Tasks which are intended to make easier camera evaluation easier. Use the Edit Feature Tabs button to create your own customized Feature tabs. Features - Basic provides direct access to basic features needed to set up cameras and start image acquisition quickly. * pylon Viewer: [139283] Added a new 'Welcome to pylon' dialog that contains the Data Privacy, New Features, and Learn More pages. * pylon Viewer: [137047] Added a new Data Privacy feature. This feature is part of the Basler product improvement program. * pylon Viewer: [144658] Added a new pylon introduction video. The video can be accessed in the 'Welcome to pylon' dialog on the Learn More page. To open the dialog, click Help > New features > Learn More. * pylon Viewer: [139275] Added statistics information in the status bar related the Compression Beyond feature of Basler ace 2 Pro cameras. * pylon Viewer: [151374] The pylon Viewer now also shows GigE Vision cameras with incorrect IP configuration. * pylon Viewer: [149595] Changed the default layout of the pylon Viewer. The Message Log pane is now docked on the right side of the pylon Viewer main window. * pylon Viewer: [133892] Save/Load Features are now inactive during image acquisition. * pylon Viewer: [108546] Changed the docking mechanism for dockable panes, e.g., Sharpness Indicator, Histogram, etc. * pylon Viewer: [66666] The slider control for the Exposure Time camera parameter now uses a logarithmic scale. * pylon Viewer: [120403] Camera event data, e.g., Exposure End Event, is displayed in the feature tree now. * pylon Viewer: [132170] An option to restore the window layout to default settings has been added in the Window menu. * pylon Viewer: [109495] Added the Show Cameras Only option in the Devices pane. When selected, all transport layers and interfaces are hidden and only camera devices are displayed. * pylon Viewer: [126270] The File Access feature now returns interactive feedback when uploading large amounts of user data, e.g., vignetting correction files. * pylon Viewer: [123228] The pylon Viewer has been optimized for monitors with 4k and higher resolution. * pylon Viewer: [129616] All icons in the toolbar, menus, panes, and tools have been updated. * pylon Viewer: [125571] The New Feature dialog has been updated to include the new CoaXPress 2.0 support. * pylon Viewer: [108521] Recording settings can now be found in the new Recording Settings pane that can be opened via the Window menu. * pylon Viewer: [121964] The User Level control in the Features pane has been removed. The Features pane now always shows all parameters of the selected camera. * pylon Viewer: [127346] The pylon Viewer (Monitor Mode) used for multicasting with GigE cameras has been removed. Instead, right-click the desired GigE camera in the Devices pane of the pylon Viewer and click Open Device... > Monitor Mode to run the pylon Viewer in Monitor Mode. * pylon Viewer: [123255] The Crosshair and Grid view options has been moved from the View menu to Tools > Options. * pylon Viewer: [134735] Added the Firmware Updater tool to the Tools menu. This enables you to update all Basler cameras that support the GenICam Firmware Update Standard Version 2018.06, e.g., Basler ace 2, Basler boost, Basler dart, Basler pulse. * pylon Viewer: [133876] After changing the device user ID of GigE cameras, the pylon Viewer now displays the new device user ID after refreshing the Devices tree. * pylon Viewer: [139161] The pylon Viewer returns additional information when loading of camera features has failed. * pylon Viewer: [139115] Added the shortcut CTRL+ALT+SHIFT+L for deleting the GenICam cache. The GenICam cache may need to be deleted when an error condition has been cached that prevents the proper operation of the pylon Viewer. * pylon Viewer: [139115] Added the shortcut CTRL+ALT+SHIFT+F7 that works as a toggle for switching off/switching on the display of images in pylon Viewer. Image acquisition must be running when the shortcut is initially used (switching off image display). * pylon Viewer: [153055] The Polling option in the Features pane is disabled by default now. * SDK: [136913] Added support for image decompression for Basler ace 2 Pro GigE Vision and USB3 Vision cameras that support the Compression Beyond feature. * SDK: [108723] The pylon Migration Mode supports Basler ace 2 GigE cameras now. The migration mode allows you to easily adapt existing applications that were written for GigE cameras based on GenICam SFNC 1.x so that they work with GigE cameras based on SFNC 2.x as well, e.g., Basler ace 2 GigE cameras. * SDK: [116863] Added the concept of interfaces to transport layers. An interface is used to represent a frame grabber board, a network card, etc. This object type is currently used mainly by the pylon GenTL Consumer transport layer. This is currently used for CoaXPress. * SDK: [139226] Added the Utility_IpConfig sample, which illustrates how to configure the IP address of GigE cameras. In addition, this sample can be used to automatically and programmatically configure multiple GigE Vision cameras. As the sample accepts command line arguments, it can be directly executed, e.g., from a batch script file. * SDK: [127827] Added the Utility_ImageDecompressor sample, which illustrates how to enable the compression feature in Basler ace 2 Pro cameras and how to decompress the images using the CImageDecompressor class. * SDK: [143319] Added the CInstantInterface class to handle interfaces, e.g., the Basler CXP-12 Interface Card. * SDK: [143319] Added the Utility_InstantInterface SDK sample for working with the Basler CXP-12 Interface Card. * SDK: [144475] New parameters for Basler ace 2 Pro camera and the Basler SLP Controller have been added to the CBaslerUniversalInstantCamera class. * SDK/USB3: [149732] A new stream grabber statistic parameter called “Statistic_Out_Of_Memory_Error_Count” has been added. It provides information about insufficient memory on the host. * SDK: [136974] Added GetBufferSize() function to GrabResultData and GrabResult to query the actual size of the grab result buffer. * SDK: [136974] Added additional enumeration entries with correct GrabStatus_ prefix to EGrabStatus to conform with the naming scheme of enumerations. Old entries can still be used for backwards compatibility. * SDK: [136974] Deprecated old pylon 2.x GrabStatus enumeration type. Please use EGrabStatus instead. * SDK: [113430] Added TLInfo, InterfaceID, and DeviceID to infos during enumeration for pylon C++ and pylonC. * SDK: [121880] Buffers can be cleared (filled with 0) using the ClearBufferModeEnable parameter of the InstantCamera class. * SDK: [120870] Calling AcquisitionStart and AcquisitionStop in InstantCamera can be enabled or disabled using the parameter AcquisitionStartStopExecutionEnable of the InstantCamera class. * SDK: [120589] Extended IStreamGrabber with IsStartAndStopStreamingMandatory(), StartStreamingIfMandatory(), and StopStreamingIfMandatory(). Calling the corresponding methods is mandatory for pylon C when using CoaXPress cameras. See the programmer's guides for more details. * SDK: [131024] Added method to retrieve current payload size from Stream Grabber for pylon C. * SDK: [133422] If the DeviceUserID of the camera is empty, an empty UserDefinedName entry will be added to the DeviceInfo object. * SDK: [132430] Added missing documentation for CTlFactory functions. * SDK: [153468] Standard C library define-directives are only applied by the pylon/Platform.h header file if not already defined previously in a translation unit. * BPD: [152178] Updated the Basler Product Documentation to version 32. DISCONTINUATION NOTICE ========================= * SDK: [120489] All device-specific InstantCamera classes, e.g., CBaslerGigEInstantCamera, have been deprecated. Please consider using CBaslerUniversalInstantCamera instead. * SDK: [120489] All device-specific device info classes, e.g., CBaslerGigEDeviceInfo, have been deprecated. You can use CDeviceInfo instead. * SDK: [120489] All device-specific C++ samples have been removed. These samples are replaced by the Universal C++ samples. * SDK: [120489] All Low Level camera classes, e.g., BaslerGigECamera, have been deprecated. Please consider using CBaslerUniversalInstantCamera instead. * SDK: [120489] All legacy C++ samples have been removed. MIGRATION NOTICE ========================= * With pylon 6.1.0, the following deprecated enumerations have been removed: Deprecated Use instead ---------------------------- PixelType EPixelType PixelColorFilter EPixelColorFilter AccessMode EDeviceAccessMode EOwnership ECleanup PayloadType EPayloadType GrabStatus EGrabStatus waitex_result_t EWaitExResult * In the GrabResult class, GetFrameNumber() has been deprecated. Use GetBlockID() instead. * In the InstantCamera class in the ECleanup enumeration, the Ownership_ExternalOwnership and Ownership_TakeOwnership members have been removed. Use Cleanup_None and Cleanup_Delete instead. * The BaslerCLSerDeviceClass device class has been removed. Use BaslerCameraLinkDeviceClass instead. * The IpCamDeviceClass device class has been removed. Use BaslerIpCamDeviceClass instead. * The IsValidRGB(EPixelType pixelType) helper function has been deprecated. Use the IsRGB and IsRGBA functions instead. However, this is no exact replacement. * The IsValidBGR(EPixelType pixelType) helper function has been deprecated. Use the IsBGR and IsBGRA functions instead. However, this is no exact replacement. * The PS_Undefined enumeration value has been deprecated. Instead, use the more secure BitPerPixel function which throws exceptions. * The PixelSize(EPixelType pixelType) helper function has been deprecated. Use the BitDepth and BitPerPixel functions instead. However, this is no exact replacement. * The following typedefs have been removed: Deprecated Use instead ---------------------------- char8_t int8_t uchar8_t uint8_t pcchar8_t const char * pchar8_t char * CORRECTIONS ========================= * GigE Vision/GenTL: [115981, 137745, 139280] Fixed an issue where changing the system clock could cause the GEV hearbeat timeout to expire unexpectedly. * GigE Vision: [96678] Fixed an issue where in rare cases the EnumerateDevices call could never return when grabbing images in parallel. * USB3: [140726] Fixed a race condition that could lead to crashes when using USB cameras. * SDK: [139672] PFS files can be loaded across all platforms now. * SDK: [148018] Fixed an issue when saving PNG images with bit depth higher than 8 bits/pixel. * SDK: [113396] Fixed an issue where cameras not supporting the Exposure End event, e.g., dart and racer, caused an unhandled exception in the Grab_UsingExposureEndEvent sample. * SDK: [121881] Fixed an issue where the buffer size determined by reading the PayloadSize feature of the camera device and the stream grabber could be too high when using the instant camera in conjunction with a frame grabber. * SDK: [123966] Fixed an issue in video encoder bit rate calculation. * SDK: [67178] Fixed an issue where the pylon C++ Programers Guide did show all instant camera classes correctly. * SDK: [133483] Fixed getting the alternative integer representation from float parameters. * SDK: [127836] Added additional validity checks on input parameters for functions taking GrabResultPre or IImage parameters. * GenTL: [137097] Fixed a GenICam related caching problem. * GenTL: [143194] Fixed an issue where the USB3 and GigE producers could return an incorrect event ID on the DeviceLost event. * GenTL: [143087] Fixed an issue where the USB3 and GigE producers could return GC_ERR_INVALID_PARAMETER when calling EventGetDataInfo when passing valid data. RESTRICTIONS ========================= * pylon Viewer: To use the pylon Viewer, you must install the latest Mesa OpenGL driver for your system. On Debian-based platforms, you will also need to install the libgl1-mesa-dri and libgl1-mesa-glx packages. * pylon C: The pylon C API doesn't support the Basler Compression Beyond feature yet. * pylon C: 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 guides 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. * GenTL: [133711] Limited GenTL support to producers with GenTL version 1.5 and above. * CXP: In rare cases, the camera is not found after booting the computer. Power-cycle the camera to resolve this. * CXP: Grabbing with very high frame rates above 50000 fps using the Basler CXP-12 Interface Card 1C is not supported. * CXP: When allocating buffers used for grabbing, the buffer address must be aligned to 8-byte increments. This is automatically the case if you use heap memory. * CXP: If a version of the Silicon Software Runtime is installed on your computer, you may experience incompatibility issues when using CoaXPress cameras and interface cards. Therefore, Basler advises against installing pylon in parallel to Silicon Software Runtime. * 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 20 MPixel or higher resolution may fail if the Quality parameter is set to 80 % or more. To work around that, set the Quality parameter to a lower value. * MP4/AVI: [139274] 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, pylon will first disable the Compression Beyond feature in the camera and then start recording. * 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. * SDK: Kernel 3.x or higher is required to use the pylon C API. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configurations. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. * BPD: The Basler Product Documentation requires advanced JavaScript support. Please use a modern browser, e.g., Firefox 44 (or higher), or Chrome 49 (or higher). * GigE Vision: Assigning a static IP address to a camera that is not in the same subnet as the network adapter may make the camera unreachable. To prevent this, set the rp_filter (reverse path filter) to 2 ("loose mode") on the camera's network interface. For more information, see the Assigning an IP Address to a Camera topic in the Basler Product Documentation. ################################################################################ RELEASE DATE: 2019-03-05 VERSION: 5.2.0 ################################################################################ BINARY COMPATIBILITY ========================= Applications built with earlier versions of pylon are incompatible with pylon 5.2.0. NEW FEATURES / CHANGES ========================= * pylon Viewer: [85311] Added the Sharpness Indicator feature which makes focusing of lenses easier. * pylon Viewer: [70176] Added the Action Commands feature to facilitate the evaluation and integration of GigE Action Commands and Scheduled Action Commands. * pylon Viewer: [68123] Added the Vignetting Correction feature which can remove vignetting artifacts (loss of brightness at the edges of images). The Vignetting Correction feature is available on selected ace L and ace U camera models only. * pylon Viewer: [100601] Added an SDK samples manual. * pylon Viewer: [100548] Updated the automatic image adjustment icon. * CamEmu: [102456] CamEmu now also supports BayerGR8, BayerRG8, BayerGB8, and BayerBG8 pixel formats. * SDK: [100038] Added CBaslerUniversalInstantCamera class, including support classes. This Universal Instant camera class provides users with a native parameter API that can be used for any interface. * SDK: [100038] Added new samples showing the use of CBaslerUniversalInstantCamera and changed existing samples to show the use of parameter classes. * SDK: [100038] Extended the C++ Programmer's Guide to include CBaslerUniversalInstantCamera and parameter classes. * SDK: [100038] Added parameter classes for simplifying access to GenApi parameters, e.g., CIntegerParameter. These can be used instead of GenApi::CXYZPtr classes. * SDK: [100038] Changed the existing configuration classes, e.g., CAcquireContinuousConfiguration, to use new parameter classes. * SDK: [100038] Access methods and keys of transport layer-specific device info classes have been merged into CDeviceInfo. * SDK: [102881] The image format converter now also supports the PixelType_YCbCr422_8_YY_CbCr_Semiplanar and PixelType_YCbCr420_8_YY_CbCr_Semiplanar input formats. * General: All start menu entries created by pylon on Linux Debian systems are placed together in the individual categories. DISCONTINUATION NOTICE ========================= Please note that the following changes are planned for the next release of pylon: * All PixelFormatConverter header files will be removed. It is recommended to switch to the CImageFormatConverter class instead. * The header files of all low-level camera classes, e.g., BaslerGigECamera.h, will be removed. pylon will provide a header-only replacement that can be copied to the code base of the program using pylon. * All device-specific camera classes will be replaced by the Universal Instant camera class. The header files will stay in place and redirect to the Universal Instant camera class. * All Legacy C++ samples will be removed. * All device-specific C++ samples will be removed. These samples are replaced by the Universal C++ samples. * All currently deprecated functions and classes, e.g., in PixelType.h, will be removed. CORRECTIONS ========================= * pylon Viewer: [97454] The maximum display rate has been limited to 25 Hz. * pylon Viewer: [105607] Fixed issues when using the Color Calibrator tool on GigE cameras and cameras with auto functions enabled, e.g., ExposureAuto. In the second step, the image is now displayed in black and white to achieve better calibration results. * pylon Viewer: [96663] Replaced parentheses and spaces in file names with an underscore when recording a sequence of still images. * pylon Viewer: [89451] The default setting of the Histogram pane is now linear scale instead of logarithmic. * pylon Viewer: [91757] Fixed an issue where the pylon Viewer could become unresponsive when grabbing with high frame rates. * pylon Viewer: [88327] Fixed issues with file suffix and file type options when using the Load/Save features in Japanese language. * pylon Viewer: [88327] Fixed an issue with file suffix when using the Histogram feature in Japanese language. * pylon Viewer: [88327] The grid overlay can now be displayed in full-screen mode. * USB3: [96739] Fixed an issue with the PylonFirmwareUpdater tool, which may have left a camera in the 'updater role' when using a USB hub. * SDK: [88327] Fixed color conversion for MP4 videos. * SDK: [88327] Fixed VideoWriter node map to not change the Quality setting if other features are changed. Quality is now the default compression option. * SDK: [96678] Fixed an issue where calling EnumerateDevices failed to discover cameras under certain circumstances. * SDK: [100534] Fixed a race condition that could lead to crashes when using PixelTypeConverter from multiple threads. * SDK: [103679] Fixed an issue where a CChunkParser could become invalid when UpdateBuffer was called before AttachBuffer. If you call UpdateBuffer without calling AttachBuffer first, an exception is thrown. * SDK: [100170] Minor corrections in the pylon C Programmer's Guide. * CamEmu: [105594] Fixed an issue where the PayloadSize has not been updated correctly. * BPD: [88433, 91101] Fixed issues when using the BPD offline version. RESTRICTIONS ========================= * pylon Viewer: To use the pylon Color Calibrator, you have to make sure that you have installed the latest Mesa OpenGL driver for your system. * 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: If the Polling option in the Features pane is enabled while displaying a continuous image stream, there may be a stutter noticeable in the image stream. Disable polling to avoid this effect. * SDK: Kernel 3.x or higher is required to use the pylon C API. * 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. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configurations. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. * BPD: The Basler Product Documentation requires advanced JavaScript support. Please use a modern browser, e.g., Firefox 44 (or higher), or Chrome 49 (or higher). * GigE Vision: Assigning a static IP address to a camera that is not in the same subnet as the network adapter may make the camera unreachable. To prevent this, set the rp_filter (reverse path filter) to 2 ("loose mode") on the camera's network interface. For more information, see the Assigning an IP Address to a Camera topic in the Basler Product Documentation. ################################################################################ RELEASE DATE: 2018-08-28 VERSION: 5.1.0 ################################################################################ BINARY COMPATIBILITY ========================= Applications built with earlier versions of pylon are incompatible with pylon 5.1.0. NEW FEATURES / CHANGES ========================= * General: [83440] Added support for Ubuntu 18.04. * General: [83753] The GenICam GenApi and FirmwareUpdate libraries have been updated to GenICam Package Version 2018.06. * General: [71530] pylon and GenICam libraries are built with the Ubuntu 14.04 toolchain. See README document for details. * pylon Viewer: [71213] Added a color calibration tool that allows easy color configuration of Basler MED ace cameras (requires the latest Mesa OpenGL driver). The Color Calibrator only becomes available in the pylon Viewer (Tools menu or context menu of the camera) when a Basler MED ace camera is connected. * pylon Viewer: [85569] Added a histogram pane. * pylon Viewer: [83752] A crosshair and grid can now be displayed in an image. * pylon Viewer: [72587, 83673] Added support for recording video files and image sequences in MP4 output format. * pylon Viewer: [77502] The user interface has been localized into Simplified Chinese, Japanese, and Korean. Languages can be switched in the Tools menu. * pylon Viewer: [83112] Tooltips and descriptions in the Feature Documentation pane have been localized into German. * pylon Viewer: [72578, 83488] Added translations of tooltips and descriptions of Host Transport Layer, Stream Parameters, and Image Format Conversion features in the Feature Documentation pane. * pylon Viewer: [87509] Camera emulation support can be enabled via the Options dialog. * pylon Viewer: [71709] The New Feature dialog can now accommodate more than one new feature. * pylon Viewer: [81066] Added icons for Contact Basler Support and About pylon Viewer menu options. * pylon Viewer: [78685] The Submit Feedback option can now be accessed via the context menus of cameras and features. * pylon Viewer: [86851] Split the View menu into View and Window menus and rearranged the menu options accordingly. * GigE Vision: [77502] The user interface of the pylon IP Configurator has been localized into Simplified Chinese, Japanese, and Korean. Languages can be switched in the Tools menu of the pylon Viewer tool. * USB3: [77502] The user interface of the pylon USB Configurator has been localized into Simplified Chinese, Japanese, and Korean. Languages can be switched in the Tools menu of the pylon Viewer tool. * SDK: [77491] Added a Video Writer class for writing MP4 video files. Requires the pylon Supplementary Package for MPEG-4, which is available for download on the Basler website. * SDK: [77491] Added the Utility_GrabVideo sample, which demonstrates how to create and write MP4 video files. * SDK: [71571] Added the YUV420planar, YUV422planar, and YUV444planar as output pixel formats of image format converter. * SDK: [71535] Replaced std::bitset from AccessModeSet with an alternative implementation (DeviceAccessMode.h). * BPD: [83110] Updated the Basler Product Documentation to version 15. * SDK: [88328] Updated static API header files. CORRECTIONS ========================= * General: [83825] Removed xs3p DSTC License from pylon_Third-Party_Licenses.html. xs3p is not used by pylon. * General: [85613] Fixed an issue where Basler ace camera models with basic feature set did not work. * pylon Viewer: [73444] The pylon Viewer now displays chunk data also for USB cameras. * pylon Viewer: [73444] Changed visibility of the ChunkData parameter from Beginner to Guru. * pylon Viewer: [82191] The DeviceReset parameter is now available in Features tree. * USB3: [78905] Fixed hard-coding of vendor name. Now, the vendor name provided by the camera device is used. * USB3: [87558] Fixed a bug in the GenTL USB Producer that occurred when detaching a camera while streaming. * BCON: [83482] Fixed an issue that prevented reading registers smaller than 4 bytes. * SDK: [71536] Added explicit destructors in certain C++ API classes. * GigE Vision: [87718] Fixed incorrect device enumeration when manually announcing devices (using AnnounceRemoteDevice) on Ubuntu 18.04. RESTRICTIONS ========================= * pylon Viewer: To use the pylon Color Calibrator, you have to make sure that you have installed the latest Mesa OpenGL driver for your system. * Under certain circumstances, e.g., a very slow or busy computer, the Color Calibrator may not workif the camera has already been opened in the pylon Viewer. To prevent this, close the camera before using the Color Calibrator. * pylon Viewer: If the Polling option in the Features pane is enabled while displaying a continuous image stream, there may be a stutter noticeable in the image stream. Disable polling to avoid this effect. * SDK: Kernel 3.x or higher is required to use the pylon C API. * 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. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configurations. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. * BPD: The Basler Product Documentation requires advanced JavaScript support. Please use a modern browser, e.g., Firefox 44 (or higher), or Chrome 49 (or higher). * GigE Vision: Assigning a static IP address to a camera that is not in the same subnet as the network adapter may make the camera unreachable. To prevent this, set the rp_filter (reverse path filter) to 2 ("loose mode") on the camera's network interface. For more information, see the Assigning an IP Address to a Camera topic in the Basler Product Documentation. ################################################################################ RELEASE DATE: 2018-04-10 VERSION: 5.0.12 ################################################################################ BINARY COMPATIBILITY ========================= Applications built with pylon 5.0.x are compatible with pylon 5.0.12. NEW FEATURES / CHANGES ========================= * BPD: The Basler Product Documentation (offline and online) can be accessed directly from tools of the pylon Camera Software Suite. * pylon Viewer: [70359] Tooltips and feature descriptions have been localized into multiple languages. Updated the layout of the Feature Documentation pane. * pylon Viewer: [64142] The pylon Viewer now displays chunk data provided by the camera. * pylon Viewer: [67994] The Bandwidth Manager will use 1500 as the lowest Packet Size parameter value. The Frame Transmission Delay parameter value has been optimized as well. * pylon Viewer: [66907] The user can pan the image window using the left mouse button and zoom into the image by pressing CTRL and using the mouse wheel. * pylon Viewer: [70341] The Basler Product documentation can be accessed from the pylon Camera Software Suite installation directory. * SDK: [66609] The features of nodemaps provided by pylon objects can be made persistent. * CamEmu: [71079] The camera emulation stream grabber loads images from directories sorted by file name in ascending order. CORRECTIONS ========================= * General: [70591] Corrected restrictions information in release notes of previous pylon versions. * pylon Viewer: [67649] Fixed an issue where the pylon Viewer returns a wrong count of search results. * pylon Viewer: [67625] Rearranged options in Tools and Camera menus. * pylon Viewer: [70727] Launching an external tool no longer prevents the pylon Viewer from closing. * CamEmu: [70810] The behavior of the camera emulation devices and stream objects is equivalent to that of other transport layers. * SDK: [70066] Fixed an issue where IsMono() / IsColorImage() returned true for PixelType_Undefined. * SDK: [70363] Fixed the signature of the ConfigurationEventPrinter::OnGrabError method in the C++ sample code. * GigE Vision: [69822] Fixed an issue where under certain conditions the stream grabber used a wrong port number. This would eventually cause effects like devices being removed or streaming of other cameras being stopped. * GigE Vision: [70515] Fixed an issue where the stream grabber would crash when starting the grabbing failed. RESTRICTIONS ========================= * pylon Viewer: If the Polling option in the Features pane is enabled while displaying a continuous image stream, there may be a stutter noticeable in the image stream. Disable polling to avoid this effect. * SDK: Kernel 3.x or higher is required to use the pylon C API. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configurations. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. * BPD: The Basler Product Documentation requires advanced JavaScript support. Please use a modern browser, e.g., Firefox 44 (or higher) or Chrome 49 (or higher). ################################################################################ RELEASE DATE: 2017-11-06 VERSION: 5.0.11 ################################################################################ NEW FEATURES / CHANGES ========================= * GigE Vision and USB3 Vision: A GenTL producer is now available that allows using Basler cameras (GigE or USB 3.0) with applications supporting GenTL. The producer is compliant with GenTL 1.5. * pylon Viewer: [64888] The Bandwidth Manager now supports GigE cameras. * pylon Viewer: [64822] Renamed "Transport Layer" to "Host Transport Layer". * pylon Viewer: [64819,64820,65008] Added link to pylon IP Configurator in the Tools menu. * pylon Viewer: [64818] Added links to "C++ Programmer's Guide" and "C Programmer's Guide" in the help menu. * pylon Viewer: [64783] The Basler logo is now displayed in the image display area. * pylon Viewer: [55223] Images can now be saved in raw image format. * pylon Viewer: [64563] Added full-screen mode and support for multiple screens. Note that the look depends on your window manager. * SDK: [55223] pylon API now allows saving images in raw image format. CORRECTIONS ========================= * BCON: [65916] Fixed an issue where the BCON Adapter shared object was not unloaded. RESTRICTIONS ========================= * pylon Viewer: If the Polling option in the Features pane is enabled while displaying a continuous image stream, there may be a stutter noticeable in the image stream. Disable polling to avoid this effect. * SDK: Kernel 3.x or higher is required to use the pylon C API. * USB3: Currently, pylon has been tested with Renesas and Intel Ivy Bridge USB3 host controllers. pylon may work with other controllers, but some functionalities may not work as expected. * USB3: For optimum performance, install the latest driver and firmware for your USB 3.0 host controller. * USB3: NEC USB 3.0 host controllers are not supported. * GenTL: The GenTL producer for GigE Vision does not support action commands. * GenTL: The GenTL producer for GigE Vision does not support multicast configuration. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. ################################################################################ RELEASE DATE: 2017-06-01 VERSION: 5.0.9 ################################################################################ NEW FEATURES / CHANGES ========================= * General: Added support for arm64 platform. * General: Added GUI support (pylon Viewer, IP Configurator) for armhf and arm64 platforms. * General: The pylon Viewer GUI Tools have been updated to QT 5.6 including small improvements of the layout. * General: Made loading of transport layers via symlink possible. * General: Enumerated devices are now sorted by device type (USB first, then GigE, CameraLink, 1394, BCON) and serial number. * General: Update to GenICam V3.0.1 and GenICam Firmware Update Standard Version 0.5 (SVN revision 4513). * pylon Viewer: Added the USB Bandwidth Manager. * pylon Viewer: The pylon Viewer feature tree now offers a search function. * Setup: pylon Debian packages are now available. * USB3: Changed the Grab_UsingSequencer sample because after turning on the sequencer when using newer camera models, the pixel format cannot be changed anymore. * USB3: Improved error message if opening the camera fails due to hardware problems. * SDK: Added Extend option to the InconvertibleEdgeHandling parameter of the CImageFormatConverter class. With this option, rows and columns that cannot be converted are extrapolated for Bayer images. CORRECTIONS =========== * General: Moved the documentation folder to /opt/pylon5/share/doc/. * General: Fixed an issue in the pylon-start-with-logging.sh script. * pylon Viewer: Removed the help button where no help is available. * pylon Viewer: Fixed an issue where the feature tree was not refreshed correctly. * IP Configurator: Fixed an issue where bad IP addresses were suggested. * GigE Vision: Fixed an issue where the IP address and the port in the IP configuration settings of the stream grabber were always zero initially. * GigE Vision: Fixed an issue where changing the heartbeat timeout did not work. * GigE Vision: Fixed an issue where certain network settings could cause a segmentation fault. * BCON: Fixed an issue where device enumeration returned an incomplete list of devices. * SDK: Fixed the format of lists in the CImageFormatConverter documentation. * SDK: Fixed an issue in the Grab_UsingSequencer sample for cameras with the SequenceConfigurationMode feature. * SDK: Fixed an issue where the waiting in a WaitObject instance could be interrupted. RESTRICTIONS ============ * Setup: Debian packages must be installed using the dpkg command line tool. * SDK: Kernel 3.x or higher is required to use the pylon C API. * USB3: Currently, pylon has been tested with Renesas and Intel Ivy Bridge USB3 host controllers. pylon may work with other controllers, but some functionalities may not work as expected. * USB3: For optimum performance, install the latest driver and firmware for your USB 3.0 host controller. * USB3: NEC USB 3.0 host controllers are not supported. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. ################################################################################ RELEASE DATE: 2016-08-17 VERSION: 5.0.5 ################################################################################ NEW FEATURES / CHANGES ====================== * General: Added BCON transport layer. * General: Updated to GenICam version 3.0.1 (SVN revision 3890). * General: Improved processing performance of the GenICam description file. Improved processing performance when creating devices. * General: New license agreement for this pylon release (see pylon License.html) * pylon Viewer: When saving an image during image capture, the display will be frozen until the image is saved. * pylon Viewer: The device list will now display a "No camera interface has been installed" message if there are no interfaces/TLs available. * pylonC: Added pylon C support including documentation and samples. CORRECTIONS =========== * General: Fixed an issue where waiting for more than 21 cameras in a single wait operation resulted in an error. * pylon Viewer: Fixed an issue where the zoom feature did not work for some image sizes. * pylon Viewer: The zoom steps have been optimized. * pylon Viewer: Fixed an issue where the parameters of the pixel format converter could be modified without having any effect. * USB3: Fixed an issue where a timeout occurred when the waiting time for an image or a camera event exceeded 10 minutes. * SDK: Corrected the documentation of the CInstantCamera::StartGrabbing method's maxImages parameter. * SDK: Corrected timeout message text that occurred when the 'GrabStrategy_UpcomingImage' grab strategy was used. * SDK: Fixed an issue where the parameters of the image format converter nodemap could be modified without having any effect. * SDK: The included documentation can now be searched. * SDK: Fixed an issue when using address-sanitizer with libusb. * SDK: Fixed several minor issues. * GenICam: Fixed an issue that caused special characters to be escaped in XML output (issue 1583). * GenICam: The content of the node is accessible (issue 1582). * GenICam: Removed 'void _LoadXMLFromFile(Vendor, Model);' excess method declaration (issue 1584). * GenICam: Eliminated exception that occurred when running GenICam without logging or caching (issue 1579). * GenICam: Removed duplicate definition of GetGenICamRoot (issue 1580). RESTRICTIONS ============ * SDK: Kernel 3.x or higher is required to use the pylon C API. * USB3: Currently, pylon has been tested with Renesas and Intel Ivy Bridge USB3 host controllers. pylon may work with other controllers, but some functionalities may not work as expected. * USB3: For optimum performance, install the latest driver and firmware for your USB 3.0 host controller. * USB3: NEC USB 3.0 host controllers are not supported. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool. ################################################################################ RELEASE DATE: 2015-12-18 VERSION: 5.0.1 ################################################################################ NEW FEATURES / CHANGES ====================== !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ATTENTION! pylon 5 introduces breaking changes regarding the C++ API. Existing code must be reviewed and changed where necessary even if it compiles without errors. Basler strongly recommends reading the Migration topic in the pylon C++ API documentation that gets installed with pylon to find out the exact nature of the changes. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! * pylon Camera Software Suite: Updated to the latest GenICam reference implementation v3.0, introducing big improvements in performance and reduced memory footprint. * pylon Camera Software Suite: The config file registry is now optional and will not be installed anymore. It is possible to add a folder named ConfigFileRegistry in the share/pylon/ directory for adding additional binding rule files if needed. The name of a binding rule file must start with the prefix "Rules". * The folder layout of the installation has been changed to simplify copy deployment. * The pylon binaries can now be executed directly without a surrounding script setting some environment variables. * SDK: pylon now supports copy deployment. * SDK: Deprecated C++ header files have been removed. * SDK: Names of C/C++ shared objects have changed. Therefore, project settings need to be adjusted. * SDK: C++ Exceptions are no longer derived from std::exception. * SDK: PylonInitialize() and PylonTerminate() C++ API functions are now reference counted. Each call to PylonInitialize() must be balanced by a call to PylonTerminate(). * SDK: Added support for recent versions of Basler USB 3.0 and GigE cameras. * SDK: Added support for BayerGR10p, BayerGB10p, BayerRG10p, and BayerBG10p pixel formats. * SDK: CInstantCamera has been extended by the CanWaitForFrameTriggerReady() method for better support of dart and pulse camera models. * SDK: The C++ sample code has been improved for better support of dart and pulse camera models. * pylon Viewer: The Save Image dialog now remembers the selected image type. Additionally, the image name is preset to a unique default each time you save an image. * USB3: Changed the default value for 'Maximum Transfer Size' for USB2 cameras to 64 kB. * USB3: Support for dart and pulse camera devices has been added. * pylon Viewer: Added the "Automatic Image Adjustment" feature to automatically make all settings necessary to get a good image under current conditions. This feature is available for ace, dart and pulse cameras. * pylon Viewer: Favorites: For faster access to frequently used features, features can be placed in the "Favorites" category either by using the context menu or by using drag & drop. * pylon Viewer: Improved the fps display. * SDK: Added support and samples for the sequencer feature of USB cameras. * pylon Viewer: Throughput and bandwidth values are now consistently depicted in MB/s (1,000,0000 Byte/s) instead of MiB/s (1,048,576 Byte/s). * pylon Viewer: Added context menus to the entries in the "Devices" pane. * pylon Viewer: Cameras can be explicitly opened and closed. Please note that a camera is no longer opened automatically by a single click. To open a camera, double-click the desired entry in the "Devices" group, or select the desired entry and open the camera via the context menu or toolbar button. * pylon Viewer: Added a message log window informing the user about notes, warnings, and errors. * pylon Viewer: By default, the viewer now displays incompletely grabbed or corrupted frames. The number of successfully grabbed and corrupted frames is shown in the status bar of the image windows. * USB3: Added error message texts to the statistics parameters provided by the pylon USB Transport Layer and Stream Grabber objects. * GigE Vision: The Stream Grabber's statistic data remains readable after the grabbing has stopped. * SDK: "Legacy" samples have been added illustrating how to add USB 3.0 support to applications still using the pylon low-level API. * SDK: Added a feature called "migration mode" to simplify the transition of existing applications to USB 3.0. * SDK: Added documentation and sample that illustrate the Buffer Factory. The Buffer Factory enables the Instant Camera classes to use memory provided by the application. * GigE Vision: Added support for action commands and scheduled action commands allowing to trigger multiple cameras simultaneously. * USB3: Added/improved samples demonstrating event handling. * IP Configurator: Added facilities for providing user feedback and contacting Basler support by email. * Documentation: Updated migration guide. * SDK: CameraArray classes for USB and GigE Cameras have been added. * SDK: pylon-config has been added to simplify the inclusion of pylon in different build systems. * SDK: Log messages now contain meaningful content instead of the error number only. * SDK: No environment variables are required anymore to run pylon. CORRECTIONS =========== * pylon Viewer: Fixed an issue where the pylon Viewer could crash when closing a camera. * IP Configurator: Fixed message text in Contact Support dialog. * USB3: Fixed an issue where accessing camera parameters could introduce lag to image streaming. * GigE: Fixed an issue that caused the enumeration of the cameras to fail when using a very large number of network adapters. * SDK: Fixed missing entry for Mono10p pixel type in Pylon::CPixelTypeMapper class. Mono10p can now be displayed by the pylon Viewer. * pylon Viewer: Fixed a problem that caused the pylon Viewer to generate additional CPU load in idle state. * SDK: The SoftwareTrigger Configuration class did not work correctly with linescan cameras. * GigE: The device enumeration mechanism may have missed cameras if a certain number of connected cameras was exceeded. * USB3: Fixed a memory leak that occurred when IDeviceFactory::IsDeviceAccessible for USB 3.0 cameras was called. * SDK: ITransportLayer::ReleaseTl() did not always free the resources allocated by a transport layer. This fix may affect applications accidentally calling ReleaseTl() too often. Ensure that for every call of CTlFactory::CreateTl() there is only one ReleaseTl() call. * SDK: Fixed thread-safety issues with the CTlFactory class. * pylon Viewer: No camera features were shown if a device could only be opened at second attempt. * pylon Viewer: Fixed problems occurring when enabling the Line Pitch camera feature. * pylon Viewer: The "Copy Camera Features" menu entry only became available after the first image had been grabbed. * USB3: Exception may have been thrown when closing the camera. * USB3: Fixed problems occurring when enabling the Line Pitch camera feature. * USB3: Statistics: Incomplete frames were counted as 'missed frames'. * GigE: Fixed resource leak that occurred when using action commands. * USB3: Fixed a bug in the device enumeration which may have caused an incomplete USB 3.0 device list. * pylon Viewer: Fixed an issue which might cause the pylon Viewer to block in case of transmission errors caused by the usage of inappropriate USB cables. * GigE Vision: Fixed a bug which prevents devices to be enumerated when the PC is not connected to a network. * SDK: Fixed a memory leak that occurred when device-specific event handlers were registered. * SDK: Fixed a potential crash in the pylon Image Window. * SDK: Improved Instant Camera chunk data support. Instant Camera objects now can deal with an image stream consisting of both, frames with and frames without chunk data. * pylon Viewer: Fixed an issue which may have caused the viewer to hang or crash when removing a USB camera. * USB3: Fixed an issue that could cause a deadlock when removing a USB camera. * IP Configurator: The IP Configurator now refuses IP addresses from the reserved address range 0.0.0.0/8. * pylon Viewer: Fixed an issue where the parameters of the pixel format converter could be modified without having an effect. * pylon Viewer: The viewer now suggests appropriate directories for saving feature settings and images. * pylon Viewer: Fixed a bug causing the viewer to terminate prematurely. * pylon Viewer: Fixed a bug that might have led to an endless sequence of error message boxes. * USB3: Fixed off-by-one error in stream grabber statistics. * SDK: Fixed spelling in pixel type mapper strings. * SDK: Added missing chunk image sample for USB 3. * SDK: Fixed incompatibility with some UVC devices. * SDK: Fixed assertion which occurred on long running GigE grabs. * SDK: Fixed an issue where enumerating/opening cameras failed if a lot of devices are connected to the USB bus. * SDK: Fixed issue where pylon would not shut down without killing the application. * SDK: Fixed issue where pylon crashes on machines without USB controller. RESTRICTIONS ============ * SDK: The InstantCameraArray classes cannot acquire images from more than 21 cameras. * USB3: Currently, pylon has been tested with Renesas and Intel Ivy Bridge USB3 host controllers. pylon may work with other controllers, but some functionalities may not work as expected. * USB3: For optimum performance, make sure to install the latest driver and firmware for your USB 3.0 host controller. * USB3: NEC USB 3.0 host controllers are not supported. * GigE Vision: Multiple IP configurations on a single network interface are not fully supported by the IP Configurator tool.