pylon 7 Camera Software Suite for Linux RELEASE NOTES Note: Patch versions of pylon for Linux OS are not released publicly. All changes made in patch versions are included in the following minor or major version of pylon. The version number scheme for pylon is as follows: x.y.z * First digit (x): Major version * Second digit (y): Minor version * Third digit (z): Patch version ################################################################################ RELEASE DATE: 2023-04-26 VERSION: 7.3.0 (x86_64, aarch64) ################################################################################ BINARY COMPATIBILITY ==================== * pylon C++ API = 7.3.0: Applications built with earlier versions of the pylon C++ API are incompatible. * pylon C API = 7.3.0: Applications built with earlier versions of the pylon C API are incompatible. * pylon Data Processing API = 1.2.0: Applications built with earlier versions of the pylon Data Processing API are incompatible. NEW FEATURES / CHANGES ====================== * CXP: [240824] Added support for Basler boost quad-channel CoaXPress cameras with GMAX sensors. These cameras are for use with the Basler CXP-12 Interface Card 4C or imaWorx CXP-12 Quad acquisition cards, which require a host interface with PCIe Gen 3 x8 (Direct Memory Access) or better. * CXP/GenTL: [246795] The CXP GenTL Producer, ProducerCXP.cti, has been updated to version 5.11. It supports the EVENT_NUM_IN_QUEUE event info now. * CXP: [246795] The applet for Basler CXP-12 Interface Card 1C with static version S1.2 has been updated to version 5.0.5. * CXP: [246795] The applets for Basler CXP-12 Interface Card 2C, 4C, and imaWorx CXP-12 Quad with static version S1.0 have been updated to version 2.1.6. The internal applet structures have been updated for a better overflow and memory bandwidth handling. * vTools: The following licensable vTools have been added: - Barcode Reader Starter - Data Matrix Code Reader Starter - QR Code Reader Starter - Template Matching Starter - Image Alignment - ROI Creator - Image Smoothing Basic - Image Morphology Basic - Gray Value Transformer Basic - Image Combiner Basic - Line Measurements Pro - Circle Measurements Pro - Ellipse Measurements Pro - Rectangle Measurements Pro * vTools: The functionality of the following vTools has been extended. They now provide alignment transformation data (via the AlignmentTf output pin). This can be used for aligning images using the Image Alignment vTool: - Template Matching Basic - Geometric Pattern Matching Basic - Geometric Pattern Matching Pro * vTools: The following vTools accept inverse transformation data (via the InverseTf input pin) from the Image Alignment vTool to provide real world coordinates: - Measurements Basic - Line Measurements Pro - Circle Measurements Pro - Ellipse Measurements Pro - Rectangle Measurements Pro * vTools: The following vTools accept a region of interest (ROI) as input to restrict the image area processed: - Barcode Reader Starter - Data Matrix Code Reader Starter - QR Code Reader Starter - Template Matching Starter - Image Smoothing Basic - Image Morphology Basic - Gray Value Transformer Basic - Barcode Reader Basic - QR Code Reader Basic - Data Matrix Code Reader Basic - Absolute Thresholding Basic - Auto Thresholding Basic - Relative Thresholding Basic - Color Classifier Basic - Template Matching Basic - Geometric Pattern Matching Basic - Barcode Reader Pro - Data Matrix Code Reader Pro - QR Code Reader Pro - Geometric Pattern Matching Pro * vTools: [8589, 8945] For Region Selection, Absolute Thresholding Basic, and Relative Thresholding Basic, the behavior of range sliders and value handling has been improved. * vTools: [10341] For Region Morphology, mask sizes can only be entered in increments of x.0 and x.5. * vTools: [10325] For Region Morphology, the maximum possible mask size has been set to 1001. Also, only odd mask sizes are allowed now. * vTools: [9419] The free Image Loading vTool has been added. It enables loading of images from the hard drive. * vTools: [10430] Added support for multithreading in the Image Format Converter vTool. * vTools - Measurements Basic [11429]: Renamed the "Length" and "Width" parameters to "Width" and "Height" to be consistent with all other vTools. In case you have already programmed against these parameters, you will have to adapt your code accordingly. * vTools: [11605] New recipe templates have been added. * Data Processing: [9347] Added the CircleF, EllipseF, and LineF data types (as single values and arrays). * Data Processing: [8276] Added support for programmatically creating and modifying recipes via the CBuildersRecipe class in the Data Processing SDK. * pylon Viewer: [11410] The pylon Camera API Generator tool has been added in the Tools menu of the pylon Viewer. This GUI tool provides functionality to easily create specialized camera classes. * pylon Viewer: [9162] The pylon Viewer GUI tools have been updated to Qt 5.15.5. * pylon Viewer: [7509] The pylon Static Defect Pixel Correction tool has been localized into Simplified Chinese, Japanese, and Korean. Languages can be switched via the Tools > Options menu. * pylon Viewer: [7249] Improved the overall performance of the pylon Viewer. * pylon Viewer: The New Features tab in the 'Welcome to pylon' dialog has been updated. * Workbench: [11411] Added zooming to the Workbench pane. You can use the zoom buttons and slider in the lower left corner of the Workbench or the mouse wheel + CTRL/CMD key. * Workbench: [10167] Increased the size of the context menu of the Workbench pane. * pylon: All GUI tools, e.g., pylon Viewer, pylon IP Configurator, etc., have been built against Ubuntu 20.04 LTS. Use Ubuntu 20.04 LTS or above to be able to use the pylon GUI tools. * pylon: [236190, 267192, 264293] The CImageFormatConverter supports multithreding now. By default, the CImageFormatConverter uses four threads. Under certain circumstances, a further increase of the number of threads may be required. This may reduce the latency and improve the performance but may cause higher CPU load. Using the CImageFormatConverter with enabled multithreading is recommended when using Basler ace 2 5GigE and CoaXPress cameras. * SDK: [264292] The Utility_ImageFormatConverter SDK sample has been updated to demonstrate the use of multithreading with the CImageFormatConverter. * SDK: [256690] The following C++ SDK samples have been updated to support the new boost quad-channel CoaXPress cameras: - ParametrizeCamera_GenericParameterAccess - ParametrizeCamera_NativeParameterAccess - GUI_Sample - GUI_SampleMultiCam - ParametrizeCamera_LoadAndSave Note: Other SDK samples may not work due to the different camera feature sets. * SDK: [245850, 266733] The pylon SDK samples can be built with CMake now. Use the PylonFinder.cmake to do so. * SDK: [246793] The CBaslerUniversalInstantCamera class has been updated. * Camera Emulation: [247315, 247316] The pylon Camera Emulation has been updated with multiple new parameters to better reflect the behavior of recent Basler cameras, e.g., ace 2 camera models. * BPD: [253752] The use of the Static Defect Pixel Correction camera feature when used via the pylon API has been documented. * BPD: Updated the offline Basler Product Documentation. DISCONTINUATION NOTICE ========================= * Linux Ubuntu 18.04 LTS is no longer supported. CORRECTIONS =========== * vTools: Measurements Basic: - [8947] Fixed the output reset on input image error. - Fixed the output in world coordinates. * vTools: [9766] All vTools with image editors: The scrolling behavior has been improved. * vTools: [10676] Barcode Reader Pro: Spaces in the identifier of enum entries have been removed. * vTools: [8588] Calibration Basic: Fixed trigger of machine calibration in settings dialog. * Workbench: Fixed a bug which caused the pin data view to not show any data when only a subset of selected vTool pins provided valid data. * Data Processing: [11365] Fixed an issue when removing certain vTools. * pylon Viewer: Improved support for high-resolution displays. * CXP/GenTL: [265133] The GenTL CXP Producer has been improved to better support multithreaded applications. * CXP/GenTL: [246795] The behavior after a device removal has been improved. * CXP/GenTL: [246795] Fixed an issue with PoCXP not being able to be turned off. * CXP/GenTL: [246795] The vantage point is reset and set to unavailable while AutomaticROIControl is active. * CXP/GenTL: [246795] SensorHeight and SensorWidth are set to unavailable while AutomaticROIControl is active. * CXP/GenTL: [246795] Fixed an issue with FG_HEIGHT and FG_WIDTH not following the camera's SensorHeight and SensorWidth. * CXP/GenTL: [265890] The GenTL Consumer returns detailed information in case of image acquisition errors now. * GigE: [265902] The error message reported in case of image loss has been updated to account for buffer underrun, too. * SDK: [266608] An issue with PylonTerminate() after calling EnumerateDevices() has been fixed. * SDK: [267955] An issue with the Static Defect Pixel Correction feature has been fixed. * SDK: [255638] Minor general improvements have been made. * pylon C: [225060] Some spelling corrections in the pylon C SDK samples have been made. RESTRICTIONS ============ * GigE Vision: [259058] 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. * CXP: The Basler CXP-12 Interface Card 1C/2C/4C and imaWorx CXP-12 Quad acquisition cards require a host interface with PCIe Gen 3 x8 (Direct Memory Access) or better. Using slower host interfaces may reduce the camera's asquisition frame rate and cause image loss. * 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). * Workbench: In case of display errors or missing symbols in the Workbench, check and update your graphics card driver or install the OpenGL software emulation softpipe/llvmpipe. * CXP: Using secure boot (UEFI mode) with Linux requires a driver that is signed with a trusted certificate. Since the driver is provided as source code, there is no way to sign it with a trusted Basler certificate. To work with the driver, secure boot can be disabled. Alternatively, the driver can be self-signed as described in this Ubuntu blog entry: https://ubuntu.com/blog/how-to-sign-things-for-secure-boot * CXP: When camera parameters are changed during image acquisition, the change is not reflected in the interface card. * CXP: If images are lost on the interface card due to a buffer overflow, e.g., when the user application doesn't (re)queue buffers fast enough to deliver the images, the images lost are indicated by the next delivered buffer. The lost images are marked as INCOMPLETE, their file size will be 0, and the custom error code BUFFER_INFO_BASLER_XAPI_ERROR_CODE is set to 42. Additionally, one lost frame is added to the stream info. Note that exactly one lost frame is added regardless of how many frames were lost due to the overflow. * CXP: According to the GenTL standard, the device ID should remain constant between two sessions. However, the GenTL device ID changes when the applet is changed. Therefore, the device ID that was queried with one applet can be used with a different board and a different applet only if the applet has the same name as the original one with which the device ID was generated. * CXP: The GenTL BUFFER_INFO_FRAME_ID, which can be queried via DSGetBufferInfo, doesn't contain the source tag from the CXP image header. Instead, it contains a counter for all frames that have been delivered to the computer. * CXP: During an applet change, the cameras attached to an interface card are still displayed in the devices list even though they are not accessible anymore. An attempt to open a camera in this state leads to an error message. * CXP: When the DeviceUserID of a camera is changed, a restart of the GenTL Producer is required for the change to be reflected via the GenTL API. When using a GUI to interact with the camera via GenTL (i.e., the pylon Viewer), a restart of that application is required for the change to become visible. * CXP: When the CXP link speed is changed frequently on one port, at some point a speed change has no effect anymore. In that case, the error messages "Failed to set bitrate of uplink transceivers" and "Failed to set bitrate of downlink transceivers" are logged. To work around that, either reload the applet by loading a different applet and then loading the original one again or set the value of the environment variable SISO_FORCE_RELOAD_APPLET to 'yes'. * 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 Basler Framegrabber SDK 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 the Framegrabber SDK. * 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. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. 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 Viewer: To use the pylon Viewer, you must install the latest Mesa OpenGL driver for your system. On Debian-based platforms, you also need to install the following packages: libgl1-mesa-dri, libgl1-mesa-glx, libxcb-xinerama0, and libxcb-xinput0. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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: [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 first disables the Compression Beyond feature in the camera and then starts recording. * General: 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. * 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. * BPD: The Basler Product Documentation (BPD) requires advanced JavaScript support. Open the Basler Product Documentation in a modern browser, e.g., Firefox 44 (or higher) or Chrome 49 (or higher). * BPD: On Ubuntu 22.04 (or newer), the offline Basler Product Documentation (BPD) may not be accessible when using Firefox due to permission restrictions. To work around that this issue, you can set the environment variable TMPDIR to a location in the user's home directory, use a different browser, or install Firefox from a different source than snap. ################################################################################ RELEASE DATE: 2022-11-08 VERSION: 7.2.1 (x86_64, aarch64) ################################################################################ BINARY COMPATIBILITY ==================== * pylon C++ API=7.2.1 - Applications built with earlier versions of the pylon C++ API are incompatible. * pylon C API=7.2.1 - Applications built with earlier versions of the pylon C API are incompatible. * pylon Data Processing API=1.1.1 - Applications built with earlier versions of the pylon Data Processing API are incompatible. CORRECTIONS =========== * GigE Vision: [255475] The GEV streaming library has been improved to better handle the retrieval of lost streaming packets. This could have caused an unexpected termination or the image acquisition to stop after massive resends. * GigE Vision: [255254] The GEV streaming library has been improved to retrieve the correct range of lost streaming packets. * Data Processing: [8901] The pylon Data Processing C++ SDK sample programs have been updated to reflect changes in the pylon Camera Emulation. ################################################################################ RELEASE DATE: 2022-10-18 VERSION: 7.2.0 (x86_64, aarch64) ################################################################################ BINARY COMPATIBILITY ==================== * pylon C++ API=7.2.0 - Applications built with earlier versions of the pylon C++ API are incompatible. * pylon C API=7.2.0 - Applications built with earlier versions of the pylon C API are incompatible. * pylon Data Processing API=1.1.1 - Applications built with earlier versions of the pylon Data Processing API are incompatible. NEW FEATURES / CHANGES ====================== * vTools: The pylon vTools are officially supported on aarch64 now. * vTools: The following licensable vTools have been added: - Barcode Reader Pro - Data Matrix Code Reader Pro - QR Code Reader Pro - Geometric Pattern Matching Basic - Template Matching Basic * vTools: The following licensable vTools have been renamed for convenience: - Calibration => Calibration Basic - Measurements => Measurements Basic - Barcode Reader => Barcode Reader Basic - Data Matrix Code Reader => Data Matrix Code Reader Basic - QR Code Reader => QR Code Reader Basic - Absolute Thresholding => Absolute Thresholding Basic - Auto Thresholding => Auto Thresholding Basic - Relative Thresholding => Relative Thresholding Basic - Color Classifier => Color Classifier Basic * vTools: [6677] Measurements Basic: The enum values of Transition have been renamed to "Dark to Light" and "Light to Dark". This leads to incompatibilities with recipes created with pylon 7.1.0 or older that include the Measurements vTool and use this feature. * Workbench: [6493] The user interface has been localized into Simplified Chinese, Japanese, and Korean languages. Languages can be switched from the Tools > Options menu. * pylon Viewer: [6140] The pylon Static Defect Pixel Correction tool has been added in the Camera menu of the pylon Viewer. This GUI tool provides a simplified interface to correct defect camera sensor pixels. * pylon Viewer: [7832] The link to the pylon SDK Samples Manual has been removed from the Help menu of the pylon Viewer. This manual is available in the Basler Product Documentation now. * pylon Viewer: [7831] The link to the pylon Deployment Guide has been removed from the Help menu of the pylon Viewer. This guide is available in the Basler Product Documentation now. * CXP: [247590] The applets for the Basler CXP-12 Interface Card 2C, 4C, and imaWorx CXP-12 Quad frame grabber with static version S1.0 have been updated to version 2.0.5. * CXP: [247590] The applet for the Basler CXP-12 Interface Card 1C with static version S1.2 has been updated to version 5.0.5. * CXP: [247590] All updated applets now support internal overflow handling and events. The FrameID now holds a 16 bit value generated from the camera instead of a counter generated in the applet. * CXP/GenTL: [247590] The CXP GenTL Producer, ProducerCXP.cti, has been updated to version 5.10.0. It now supports events with and without payload. * GenTL: [232982, 232983] The pylon GenTL Consumer supports events now. * GenTL: [246740] The pylon GenTL Consumer now sets the correct grab result payload type when images with chunk data are received. * Camera Emulation: [239196, 239198, 239199, 239200, 239201, 239203, 239204, 239207, 247311, 247312] The pylon Camera Emulation has been updated with several new parameters to better reflect the behavior of recent Basler cameras, e.g., ace 2 camera models. * BPD: [245922] The pylon SDK Samples Manual has been moved to the Basler Product Documentation. * BPD: [248413] The pylon GigE Configurator chapter has been expanded by the charter "Affected Network Parameters". * BPD: [246033] The "Migrating from Previous Versions" section of the pylon C++ Programmer's Guide has been updated. * BPD: Updated the offline Basler Product Documentation. CORRECTIONS =========== * vTools: [5777] Geometric Pattern Matching Pro: Fixed the application of transformation model. * vTools: [5543] Measurements: Fixed an issue with a slider. * vTools: [7316] Fixed a multi-threading issue in the Camera vTool free resources implementation. * Workbench: [6180] Fixed an issue with the context menu in License Dialog. * Workbench: [5778] Fixed an issue using wrong libstdc++6 version on Linux platforms. * Workbench: [6134] Fixed an issue in vTool dialogs that were not destroyed correctly. * Workbench: [3753] Fixed an issue with the diplay of the correct queue size. * Workbench: [5263] Fixed a display issue for connections after load of recipe. * Workbench: [3289] Improved displaying the documentation of vTools. * Data Processing: [6037] Fixed an issue that occurred when destroying vTools on aarch64 processor platforms. * Data Processing: [6134] Fixed an issue in vTool dialogs that were not destroyed correctly. * pylon Viewer: [6994] Updated translations for the pylon Viewer application. * pylon Viewer: [5898] Fixed an issue with generated documentation for IParameter nodes. * pylon Viewer: [4512] The scaling handling for pylon GigEConfigurator has been improved. * pylon Viewer: [6006] The feedback function for pylon Viewer has been improved. * pylon Viewer: [5778] Fixed an issue using wrong libstdc++6 version on Linux platforms. * CXP/GenTL: [247590] Fixed an issue, which appeared sometimes when closing the pylon Viewer while loading an applet. * CXP/GenTL: [247590] Chaned applet handling: An applet change during image acquisition is not possible anymore. * CXP/GenTL: [247590] Changed the names of some parameters in all imaWorx CXP-12 Quad frame grabber applets, e.g., TopLeft, TopRight, BottomLeft, BottomRight. * GigE Vision: [243746] The resend mechanism of the pylon GEV drivers has been optimized for handling of small images. * GigE Vision: [243739] The resend mechanism of the pylon GEV drivers has been optimized for specific use cases in which a camera is used in a triggered mode. * GigE Vision: [251256] The resend mechanism of the pylon GEV drivers has been optimized to efficiently use the available bandwidth. * GigE Vision: [251260] The resend mechanism of the pylon GEV drivers has been optimized to better recover ranges of lost stream packets. * GigE Vision: [251258] The Extended Status Code Capability is now enabled automatically whenever a GigE camera supports it. * GigE Vision: [250680] The pylon GEV drivers now correctly support ExtendedBlockID with 64-bit length. * GigE Vision: [250657] The documentation for the GetBlockID function has been updated. * GigE Vision: [252989] Fixed an issue of the resend mechanism that caused the image acquisition to stop after massive resends. RESTRICTIONS ============ * 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). * Workbench: In case of display errors or missing symbols in the Workbench, check and update your graphics card driver or install the OpenGL software emulation softpipe/llvmpipe. * CXP: Using secure boot (UEFI mode) with Linux requires a driver that is signed with a trusted certificate. Since the driver is provided as source code, there is no way to sign it with a trusted Basler certificate. To work with the driver, secure boot can be disabled. Alternatively, the driver can be self-signed as described in this Ubuntu blog entry: https://ubuntu.com/blog/how-to-sign-things-for-secure-boot * CXP: When camera parameters are changed during image acquisition, the change is not reflected in the interface card. * CXP: If images are lost on the interface card due to a buffer overflow, e.g., when the user application doesn't (re)queue buffers fast enough to deliver the images, these lost images are indicated by the next delivered buffer. The lost images are marked as INCOMPLETE, their fill size will be 0, and the custom error code BUFFER_INFO_BASLER_XAPI_ERROR_CODE is set to 42. Additionally, one lost frame is added to the stream info. Note that exactly one lost frame is added regardless of how many frames were lost due to the overflow. * CXP: According to the GenTL standard, the device ID should remain constant between two sessions. However, the GenTL device ID changes when the applet is changed. Therefore, the device ID that was queried with one applet can be used with a different board and a different applet only, if the applet has the same name as the original one with which the device ID was generated. * CXP: The GenTL BUFFER_INFO_FRAME_ID, which can be queried via DSGetBufferInfo, doesn't contain the source tag from the CXP image header. Instead, it contains a counter for all frames that have been delivered to the computer. * CXP: During an applet change, the cameras attached to an interface card are still displayed in the devices list even though they are not accessible anymore. An attempt to open a camera in this state leads to an error message. * CXP: When the DeviceUserID of a camera is changed, a restart of the GenTL Producer is required for the change to be reflected via the GenTL API. When using a GUI to interact with the camera via GenTL (i.e., the pylon Viewer), a restart of that application is required for the change to become visible. * CXP: When the CXP link speed is frequently changed on one port, it can happen that the speed change does not work anymore. In that case, the error messages "Failed to set bitrate of uplink transceivers" and "Failed to set bitrate of downlink transceivers" are logged. As a workaround, either reload the applet by loading a different applet and then loading the original one again; or set the value of the environment variable SISO_FORCE_RELOAD_APPLET to 'yes'. * 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 Basler Framegrabber SDK 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 the Basler Framegrabber SDK. * 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. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. 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 Viewer: To use the pylon Viewer, you must install the latest Mesa OpenGL driver for your system. On Debian-based platforms, you also need to install the libgl1-mesa-dri and libgl1-mesa-glx packages. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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: [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 first disables the Compression Beyond feature in the camera and then starts recording. * General: 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. * 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. * BPD: The Basler Product Documentation (BPD) requires advanced JavaScript support. Open the Basler Product Documentation in a modern browser, e.g., Firefox 44 (or higher) or Chrome 49 (or higher). * BPD: On Ubuntu 22.04 (or newer) the offline Basler Product Documentation (BPD) and may not be usable when using Firefox due to permission restrictions. To circumvent this issue you may set the environment variable TMPDIR to a location in the user's home directory, use a different browser or install Firefox from a different source than snap. ################################################################################ RELEASE DATE: 2022-07-19 VERSION: 7.1.0 (x86_64, aarch64) ################################################################################ BINARY COMPATIBILITY ==================== Applications built with earlier versions of pylon are incompatible with pylon 7.1.0. NEW FEATURES / CHANGES ====================== * General: [241922] Added support for Ubuntu 22.04. * GigE Vision: [241034] New Basler ace 2 5GigE cameras are supported. * GigE Vision: [201685] The pylon GEV socket driver has been updated. This driver supports all 1GigE, 5GigE, and 10GigE network adapters. Basler recommends using Basler network adapters for best performance and reliability. * GigE Vision: [201685] The updated pylon GEV socket driver supports the following new features: - GVSP Extended ID mode - GVCP Pending Acknowledge messages - Firewall traversal has been added to bypass a firewall for GVSP packets. * GigE Vision: [201091] The PylonGigEConfigurator command-line interface (CLI) tool has been added. The tool configures and optimizes the complete GigE setup for best usability and performance when used with Basler hardware components, e.g., network adapters and cameras. The following features are supported: - Optimization of network adapter performance parameters - Automatic or semi-automatic configuration of IP addresses of network adapters and cameras - Automatic optimization of the packet size of cameras - Automatic optimization of critical parameters of the operating system for real-time functionality and best performance The PylonGigEConfigurator tool ist located under \pylon\bin. * GigE Vision: [201093] A new handling of the GEV heartbeat timeout has been implemented. In case an application has been started in debug mode and is terminated, the control channel is closed automatically. This allows you to use the GigE camera again immediately after restarting the application. * pylon Viewer: [5568] The pylon GigE Configurator tool has been added in the Tools menu of the pylon Viewer. This GUI tool provides a simplified interface for the PylonGigEConfigurator CLI tool. To benefit from the automatic configuration modes of the GUI tool, the pylon Viewer must be started with administrator/sudo rights. To use the full functionality of the tool, use the PylonGigEConfigurator CLI tool. * pylon Viewer: [5561] The Bandwidth Manager tool has been updated to support 5GigE and 10GigE network adapters and cameras. * pylon Viewer: [5657] The links to the C++ and C Programmer's Guides have been removed from the Help menu of the pylon Viewer. These programmer's guides are available in the Basler Product Documentation now. * Setup: [5761] The pylon INSTALL file has been updated. * Setup: [239761] The pylon README file has been updated. * Setup: [241732] The pylon SDK Samples Manual has been updated. * SDK: [241729] The CBaslerUniversalInstantCamera class has been updated. * SDK: [230241] Added support for CMake 3.14 and before. * SDK: [230125] Added a C++ SDK sample for QT using multiple cameras. * CXP: [244549] The CXP driver has been updated to version 5.0.1. * CXP: [244549] The CXP GenTL Producer, ProducerCXP.cti, has been updated. * Camera Emulation: [191663] The pylon Camera Emulation has been updated with multiple new parameters to better reflect the behavior of recent Basler cameras, e.g., ace 2 camera models. * BPD: Updated the offline Basler Product Documentation. pylon vTools Developer Preview for aarch64 ========================================== The pylon Workbench, vTools, and Data Processing API represent the current state of development and may operate erratically. Therefore, they are not considered stable products and should only be used for evaluation purposes. Once stable operation has been achieved, the Workbench, vTools, and Data Processing API will be rolled out in a future pylon release. * Workbench: The Workbench feature has been added to the pylon Viewer for Linux ARM 64-bit. * vTools: The pylon vTools are available for Linux ARM 64-bit now. * Data Processing: The pylon Data Processing C++ API has been added to enable the use of vTools on Linux ARM 64-bit. SDK sample programs have been added to demonstrate the use of vTools. They can be found under \share\pylon\Samples\pylonDataProcessing\C++. The new Data Processing SDK sample programs require CMake version 3.12 or above. To update the CMake version, refer to https://apt.kitware.com/. A programmer's guide for the pylon Data Processing C++ API has been added. It can be accessed from the pylon Viewer's Help menu. * Setup: [5692] The CodeMeter Runtime v7.40 for Linux ARM 64-bit has been added. The CodeMeter Runtime must be installed in order to use vTools. You can find Debian and RPM packages under \share\pylon. The CodeMeter control center can be used to check available vTool licenses. CORRECTIONS =========== * GenTL: [234066] Fixed an issue with the pylon GigE and USB GenTL producers when updating the device list with open camera devices. * GenTL: [232981] The pylon GenTL consumer has been improved when working with DeviceLostEvent. * SDK: [233262] Corrected a potential alignment issue when using PylonDataContainer and PylonDataComponent. * SDK: [238324] Corrected an issue with white level values when saving 8-bit images in DNG file format. * USB: [229574] The setup-usb.sh script has been improved for a better operation on Linux Fedora operating systems. * pylon Viewer: [5656] The feature documentation for Event Grabber parameters now provides complete code snippets. RESTRICTIONS ============ * 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 Workbench provides the Statistics feature. The Statistics feature measures the execution times of vTools. Note that CPUs may run with different frequencies depending on the current load (e.g., due to or dynamic frequency scaling). Therefore, the times measured may vary depending on the configuration of your system and the overall CPU load. * Workbench: In case of display errors or missing symbols in the Workbench, please check and update your graphics card driver or install the OpenGL software emulation softpipe/llvmpipe. * CXP: Using secure boot (UEFI mode) with Linux requires a driver that is signed with a trusted certificate. Since the driver is provided as source code, there is no way to sign it with a trusted Basler certificate. To work with the driver, secure boot can be disabled. Alternatively, the driver can be self-signed as described in this Ubuntu blog entry: https://ubuntu.com/blog/how-to-sign-things-for-secure-boot * CXP: When camera parameters are changed during image acquisition, the change is not reflected in the interface card. * CXP: If images are lost on the interface card due to a buffer overflow, e.g., when the user application doesn't (re)queue buffers fast enough to deliver the images, this will be indicated by the next delivered buffer. This will be marked as INCOMPLETE, its fill size will be 0, and the custom error code BUFFER_INFO_BASLER_XAPI_ERROR_CODE is set to 42. Additionally, one lost frame will be added to the stream info. Note that exactly one lost frame will be added regardless of how many frames were lost due to the overflow. * CXP: The GenTL device ID changes when an applet is changed. Therefore, the device ID that was queried with one applet can be used with a different board and a different applet only if the applet has the same name as the original one with which the device ID was generated. * CXP: The GenTL BUFFER_INFO_FRAME_ID, which can be queried via DSGetBufferInfo, doesn't contain the source tag from the CXP image header. Instead, it contains a counter for all frames that have been delivered to the computer. * CXP: During an applet change, the cameras attached to an interface card are still displayed in the devices list even though they are not accessible anymore. An attempt to open a camera in this state leads to an error message. * CXP: When the DeviceUserID of a camera is changed, a restart of the GenTL Producer is required for the change to be reflected via the GenTL API. When using a GUI to interact with the camera via GenTL (i.e., the pylon Viewer), a restart of that application is required for the change to become visible. * CXP: Under rare circumstances, when the CXP link speed is changed frequently on one port, at some point a speed change has no effect anymore. To work around that, either reload the applet by loading a different applet and then loading the original one again or set the value of the environment variable SISO_FORCE_RELOAD_APPLET to 'yes'. * 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 the Silicon Software Runtime. * 3D: To use 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. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. * 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. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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. To work around that, set the Quality parameter to a lower value. * MP4: [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. * General: 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: 2022-06-07 VERSION: 7.0.0 (x86_64) ################################################################################ BINARY COMPATIBILITY ==================== Applications built with earlier versions of pylon are compatible with pylon 7.0.0. NEW FEATURES / CHANGES ====================== * pylon: The pylon major version has been increased to reflect the addition of the pylon vTools. These are tools that add professional image processing capabilities to the pylon Camera Software Suite. * Workbench: The Workbench feature has been added to the pylon Viewer. The Workbench offers a graphical editor for creating machine vision, medical, and other applications. The Workbench can be accessed from the Workbench menu, the Window menu, or the Workbench button in the pylon Viewer toolbar. * Workbench: The Recipe Management pane has been added to accompany the Workbench. The Recipe Management pane offers the Properties, Statistics, and Optimization tabs that allow you to configure, measure and optimize pylon vTools and recipes. * Workbench: The vTools pane has been added to accompany the Workbench. The vTools pane lists all available vTools. * Workbench: The vTool Documentation pane has been added to accompany the Workbench. It offers information about the purpose of individual vTools and a brief overview of how to use them. * Workbench: Recipe templates have been added to demonstrate the use of typical image processing tasks/applications. The templates can be found under share\pylon\Samples\pylonDataProcessing\RecipeTemplates. * Workbench: A new video introducing the pylon 7 Camera Software Suite has been added to the 'Welcome to pylon' dialog on the Learn More tab. * vTools: The following licensable vTools have been added: - Calibration - Measurements - Barcode Reader - Data Matrix Code Reader - QR Code Reader - Geometric Pattern Matching Pro - Absolute Thresholding - Auto Thresholding - Relative Thresholding - Color Classifier - Region Morphology - Region Selection - Region Feature Extraction * vTools: The following free vTools have been added: - Camera - Image Format Converter * vTools: The vTools Licensing tab has been added to the 'Welcome to pylon' dialog. The vTools Licensing tab provides an overview of your available licenses as well as information about the different license types (Demo, Evaluation, and Runtime license) and how to obtain them. * Data Processing: The pylon Data Processing C++ API has been added to enable the use of vTools. The Data Processing C++ API extends the existing C++ API for camera configuration and image acquistion. * Data Processing: SDK sample programs have been added to demonstrate the use of vTools. They can be found under \share\pylon\Samples\pylonDataProcessing\C++. * Data Processing: The new Data Processing SDK sample programs require CMake version 3.12 or above. * Data Processing: A Programmer's Guide for the pylon Data Processing C++ API has been added. It can be accessed from the pylon Viewer's Help menu. * pylon: [2101, 3306, 3853] The 'pylon End User License Agreement' (EULA) has been updated. * pylon: [2101, 3306, 3853] The 'pylon_Third-Party_Licenses' document has been updated. * pylon Viewer: [2923] The New Features tab in the 'Welcome to pylon' dialog has been updated. * Setup: [2920] The CodeMeter Runtime v7.40 has been added. The CodeMeter Runtime must be installed in order to use vTools. You can find Debian and RPM packages under \share\pylon. The CodeMeter control center can be used to check available vTool licenses. * Setup: [2921] The INSTALL file has been updated with new minimum and recommended system requirements for using the pylon Workbench and vTools. * BPD: [4729] Updated the offline Basler Product Documentation. * BPD: [2922] New minimum and recommended system requirements for using the pylon Workbench and the vTools have been added. DISCONTINUATION NOTICE ========================= * Linux armhf (ARM 32-bit) is no longer supported. CORRECTIONS =========== * pylon Viewer: [3118] The handling of different font sizes has been improved. * pylon Viewer: [4512] The scaling handling has been improved. * pylon Viewer: [4014] An issue with GigE cameras when losing GEV discovery packets has been solved. * pylon: All GUI tools, e.g., pylon Viewer, pylon IP Configurator, etc., have been built against Ubuntu 18.04 LTS. Use Ubuntu 18.04 LTS or above to be able to use the pylon GUI tools. RESTRICTIONS ============ * 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 Workbench provides the Statistics feature. The Statistics feature measures the execution times of vTools. Note that CPUs may run with different frequencies depending on the current load (e.g., due to or dynamic frequency scaling). Therefore, the times measured may vary depending on the configuration of your system and the overall CPU load. * CXP: Using secure boot (UEFI mode) with Linux requires a driver that is signed with a trusted certificate. Since the driver is provided as source code, there is no way to sign it with a trusted Basler certificate. To work with the driver, secure boot can be disabled. Alternatively, the driver can be self-signed as described in this [Ubuntu blog entry] https://ubuntu.com/blog/how-to-sign-things-for-secure-boot). * CXP: When camera parameters are changed during image acquisition, the change is not reflected in the interface card. * CXP: If images are lost on the interface card due to a buffer overflow, e.g., when the user application doesn't (re)queue buffers fast enough to deliver the images, this will be indicated by the next delivered buffer. This will be marked as INCOMPLETE, its fill size will be 0, and the custom error code BUFFER_INFO_BASLER_XAPI_ERROR_CODE is set to 42. Additionally, one lost frame will be added to the stream info. Note that exactly one lost frame will be added regardless of how many frames were lost due to the overflow. * CXP: The GenTL device ID changes when an applet is changed. Therefore, the device ID that was queried with one applet can be used with a different board and a different applet only if the applet has the same name as the original one with which the device ID was generated. * CXP: The GenTL BUFFER_INFO_FRAME_ID, which can be queried via DSGetBufferInfo, doesn't contain the source tag from the CXP image header. Instead, it contains a counter for all frames that have been delivered to the computer. * CXP: During an applet change, the cameras attached to an interface card are still displayed in the devices list even though they are not accessible anymore. An attempt to open a camera in this state leads to an error message. * CXP: When the DeviceUserID of a camera is changed, a restart of the GenTL Producer is required for the change to be reflected via the GenTL API. When using a GUI to interact with the camera via GenTL (i.e., the pylon Viewer), a restart of that application is required for the change to become visible. * CXP: Under rare circumstances, when the CXP link speed is changed frequently on one port, at some point a speed change has no effect anymore. To work around that, either reload the applet by loading a different applet and then loading the original one again, or set the value of the environment variable SISO_FORCE_RELOAD_APPLET to 'yes'. * 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 the Silicon Software Runtime. * 3D: To use Basler blaze 3D cameras requires the pylon Supplementary Package for blaze to be installed. The pylon Supplementary Package for blaze will be available for download on the Basler website at a later stage. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. * 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. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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: [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. * General: 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: 2021-11-09 VERSION: 6.3.0 (x86_64) ################################################################################ BINARY COMPATIBILITY ==================== Applications built with earlier versions of pylon are incompatible with pylon 6.3.0. NEW FEATURES / CHANGES ====================== * CXP: [199767] Added support for Basler boost dual-channel CoaXPress cameras with Sony IMX sensors. * CXP: [209477] Added support for Basler CXP-12 Interface Cards 2C and 4C. * CXP: [209477] Added support for Basler imaWorx CXP-12 Quad frame grabbers. * CXP: [183748] The CXP driver has been updated to version 5.0.0. * CXP: [183748] Added a new applet for the Basler CXP-12 Interface Card 1C with firmware version 4.0.4 S1.2. Use the GrabberFirmwareUpdater tool to update the firmware of an CXP-12 Interface Card 1C, if necessary. * CXP/GenTL: [212138, 211972, 214966] The CXP GenTL Producer, ProducerCXP.cti, has been updated to version 5.9.1. * CXP/GenTL: [220171] A new buffer overflow handling has been implemented. In the event of buffer overflow, affected images will be reported as failed. * CXP: [212992] The GrabberFirmwareUpdater tool has been added. It allows you to update the firmware of CXP-12 Interface Cards and frame grabbers. For more information, refer to the GrabberFirmwareUpdater_Readme located in the same folder, e.g., \Runtime\x64\pylonCXP\bin. * CXP: [212993] The gpioTool has been added. It allows you to configure the physical properties of the trigger signals received or sent by a Basler interface card or a frame grabber. For more information, refer to the gpioTool_Readme located in the same folder, e.g., \Runtime\x64\pylonCXP\bin. * CXP/GenTL: The firmware version of CXP-12 Interface Cards can now be queried via the GenTL Producer. To do so, use the InterfaceFirmwareVersion parameter. * CXP/pylon Viewer: The pylon Viewer doesn't require a restart after changing an applet anymore. The name of the applet currently loaded is displayed correctly now. * GigE Vision: The GEV socket driver has been updated. It supports better resend mechanisms comparable to the GEV performance driver now. * GigE Vision: [197963] Firewall traversal has been added to bypass the Windows firewall for GVSP packets. * GigE Vision: [197829] No GVCP packet resend commands will be sent by pylon when the GVCP Capability register is not set on the device. * USB: [211260] Added the DeviceVersion parameter to the DeviceInfo parameters for USB cameras. * SDK: [220227] New parameters for Basler boost dual-channel CoaXPress cameras, CXP-12 Interface Cards 1C/2C/4C, and imaWorx CXP-12 Quad frame grabbers have been added to the CBaslerUniversalInstantCamera class. * PylonC: [197658] The Chunk.c SDK sample has been adapted to better demonstrate the use of camera chunk data with ace 2 cameras. * pylon Viewer: [215258] In the Tools menu, the CXP Tools option has been added. It provides direct access to the GrabberFirmwareUpdater and the gpioTool tools if CXP has been installed. * pylon Viewer: [195378] The New Features tab in the Welcome to pylon dialog has been updated with information about Basler blaze 3D cameras. * pylon Viewer: [218627] The Show Tree View option has been added to the Features-All pane. When selected, the device features will be displayed in tree instead of flat view. * pylon Viewer: [207931] The pylon GUI tools, e.g., pylon Viewer, pylon IP Configurator, etc., have been built on Ubuntu 18.04 LTS. DISCONTINUATION NOTICE ========================= * Basler dart BCON for LVDS cameras are no longer supported. Use previous versions of pylon if support for dart BCON for LVDS is required. CORRECTIONS =========== * GigE Vision: [203028] Fixed a potential issue where a device removal may not have been detected when disabling the network adapter the camera is connected to. * pylon: [200514] Fixed an issue where an empty chunk caused an exception on USB cameras. * pylon: [211670] Installer rollbacks in case of minor problems during installation are now prevented. * GenTL: [205061] Fixed an issue in the ProducerGEV.cti where changes to the SocketBufferSize node had no effect. * GenTL: [212719] A correct value for BUFFER_INFO_DELIVERED_CHUNKPAYLOADSIZE (U3V/GigE) and _CHUNKLAYOUT (U3V only) is set now. * GenTL: [218622] The ProducerU3V.cti correctly returns NAMESPACE_PFNC_32BIT instead of UNKNOWN now. * GenTL: [220347] The setup-env.sh script now sets the GenICam GenTL path on a Debian Buster distribution correctly. * SDK: [201343] Fixed an issue where CGrabResultData::GetImageSize() would return wrong value for the YCbCr420_8_YY_CbCr_Semiplanar pixel format. * SDK: [201060] Fixed an issue in Callback.h that may have caused a compiler error when using a GCC 11 compiler. * SDK: [203519] Fixed an issue with CPixelTypeMapper when using the YUV422_8_UYVY pixel format. * PylonC: [212325] The C Programmer's Guide has been expanded to reflect the use of the PylonStreamGrabberStartStreamingIfMandatory() function, which is mandatory for image acquisition with CXP cameras. * pylon Viewer: [208844] The pylon Viewer will now return an error when an invalid parameter is set in the Features-All pane. * pylon Viewer: [209520] Fixed an issue where an assertion has been reported while using the Data32f pixel format in combination with the Histogram feature. * pylon Viewer: [201977, 192246] Improved multiple issues related to the product improvement program. RESTRICTIONS ============ * CXP: Using secure boot (UEFI mode) with Linux requires a driver that is signed with a trusted certificate. Since the driver is provided as source code, there is no way to sign it with a trusted Basler certificate. To work with the driver, secure boot can be disabled. Alternatively, the driver can be self-signed as described in this [Ubuntu blog entry] https://ubuntu.com/blog/how-to-sign-things-for-secure-boot). * CXP: When camera parameters are changed during image acquisition, the change is not reflected in the interface card. * CXP: If images are lost on the interface card due to a buffer overflow, e.g., when the user application doesn't (re)queue buffers fast enough to deliver the images, this will be indicated by the next delivered buffer. This will be marked as INCOMPLETE, its fill size will be 0, and the custom error code BUFFER_INFO_BASLER_XAPI_ERROR_CODE is set to 42. Additionally, one lost frame will be added to the stream info. Note that exactly one lost frame will be added regardless of how many frames were lost due to the overflow. * CXP: The GenTL device ID changes when an applet is changed. Therefore, the device ID that was queried with one applet can be used with a different board and a different applet only if the applet has the same name as the original one with which the device ID was generated. * CXP: The GenTL BUFFER_INFO_FRAME_ID, which can be queried via DSGetBufferInfo, doesn't contain the source tag from the CXP image header. Instead, it contains a counter for all frames that have been delivered to the computer. * CXP: During an applet change, the cameras attached to an interface card are still displayed in the devices list, even though they are not accessible anymore. An attempt to open a camera in this state leads to an error message. * CXP: When the DeviceUserID of a camera is changed, a restart of the GenTL Producer is required for the change to be reflected via the GenTL API. When using a GUI to interact with the camera via GenTL (i.e., the pylon Viewer), a restart of that application is required for the change to become visible. * CXP: Under rare circumstances, when the CXP link speed is changed frequently on one port, at some point a speed change has no effect anymore. To work around that, either reload the applet by loading a different applet and then loading the original one again, or set the value of the environment variable SISO_FORCE_RELOAD_APPLET to 'yes'. * 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 the Silicon Software Runtime. * 3D: To use Basler blaze 3D cameras requires the pylon Supplementary Package for blaze to be installed. The pylon Supplementary Package for blaze will be available for download on the Basler website at a later stage. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. * 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. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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: [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. * General: 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: 2021-03-09 VERSION: 6.2.0 (x86_64, armhf, aarch64) ################################################################################ BINARY COMPATIBILITY ==================== Applications built with earlier versions of pylon are incompatible with pylon 6.2.0. NEW FEATURES / CHANGES ====================== * CXP: [188628] Added support for Basler boost CoaXPress cameras with ON Semiconductor XGS sensors. * CXP: [188628] Added support for the Basler CXP-12 Interface Card 1C with firmware version 3.3. * CXP: [190008] The kernel-mode driver menable-dkms_4.5.1 has been updated to support Linux x86_64 kernel versions newer than 5.5.0. * 3D: [177711] Added support for the GenICam Generic Data Container (GenDC) version 1.1.0. This will allow the use of Basler blaze 3D cameras with the pylon SDK in future. * 3D/SDK: [180153] Added support for GenDC to the pylon C++ API. * GigE Vision: [170862] The effect of the Auto Packet Size feature has been improved when used on ace 2 cameras. * USB: [183637] The "setup-usb.sh" script now also works on Fedora, CentOS, and Red Hat distributions. * SDK: [189665] New parameters for Basler ace 2, dart, and boost cameras have been added to the CBaslerUniversalInstantCamera class. * SDK: [185786] Added a new sample to demonstrate the use of the SerialCommunication feature (UART) available on ace 2 cameras. * SDK: [133769] Added decompression support to pylonC to decompress compressed images from ace 2 Pro cameras. * SDK: [133769] Added new ImageDecompressor sample for pylonC. * SDK: [159212] Added DNG to the CImagePersistence class to support saving Bayer pictures in DNG file format. * SDK: [181930] Added CPylonDataContainer and CPylonDataComponent classes to access multi-component grab results. * SDK: [185772] Added GenDC PayloadType to PylonC. * SDK: [159107] Added GenApiRegister family of functions to read and write IRegister-type GenICam nodes in pylonC. * SDK: [189825] Added support for the Data32f pixel type, i.e., PFNC data 32-bit floating point, to the pylon C++ API. * SDK: [189825] Added support for the Data32f pixel type, i.e., PFNC data 32-bit floating point, to the pylon C API. * SDK: [189971] A pylon image can return a previously attached user buffer to a C++ interface now. * pylon Viewer: [164903] The pylon Viewer GUI tools have been updated to QT 5.12.8. * pylon Viewer: [187442] The About dialog in the pylon Viewer displays the pylon release version now. * pylon Viewer: [173865] The Vignetting Correction feature has been adapted to support MED ace cameras with a new binning selector parameter value. * pylon Viewer: [183612] The Vignetting Correction feature has been adapted to support ace 2 and boost cameras with a new binning selector parameter value. * pylon Viewer: [183913] The exposure time slider in the Features pane has been adapted to display the exposure time range correctly when using Ultra Short mode on ace 2 cameras. * pylon Viewer: [183912] The Bandwidth Manager reports missed frames as errors for USB cameras. * pylon Viewer: [187441, 158011] The Feature Documentation pane offers C++ source code snippets for related Selector features now. * pylon Viewer: [181775] The naming format for recording sequences of still images has been changed. * pylon Viewer: [190159] The timing precision when recording video files has been improved. * pylon Viewer: [184587] Some common tasks in the Features pane have been updated. * General: [191112] The pylon SDK Samples Manual has been updated. * General: [181771] The pylon End-User License Agreement has been updated. * General: [190547] The pylon End-User License Agreement for the pylon MPEG-4 Supplementary Package has been updated. * BPD: [181980] Added information about configuring the NIC and the firewall on Linux. The new information is included in Version 44. * BPD: [190192] Updated the offline Basler Product Documentation to version 45. DISCONTINUATION NOTICE ========================= * Linux x86 32 bit is no longer supported. Use previous versions of pylon if 32-bit Linux support is required. CORRECTIONS =========== * GenTL: [172316] Fixed an issue in the ProducerU3V.cti and ProducerGEV.cti producers, where EventGetData could return custom error code -10001 instead of GC_ERR_BUFFER_TOO_SMALL when the buffer passed was too small. * GenTL: [184792] The access mode of the InterfaceUpdateList has been changed to write-only. * GigE Vision: [158474] Unicasts and directed broadcasts, of ActionCommands and ScheduledActionCommands, are only sent if the request subnet matches the subnet of the IP address. This will reduce unexpected delays if a gateway or routing is required. * GigE Vision: [165200] Improved the discovery of cameras with different IP configurations. * USB: [167347] Error messages reported by the LibUsb are reported correctly now. * SDK: [187278] The trigger selector is reset to its original value after applying a configuration. * SDK: [190889] Fixed an issue where the image acquisition could stop when the program has run for a very long period. * SDK: [179416] Device accessibility information has been added to the C++ programmer's guide. * SDK: [181927] The C++ programmer's guide has been corrected in regard to creating specific cameras in pylon. * SDK: [186772] Include guards have been added to ImageDecompressor.h. * SDK: [175595] Corrected some header files to prevent warnings when using the gcc compiler. * pylon C: [156137, 175690] Fixed an issue caused when using the SimpleGrab sample in combination with a camera emulator. * pylon Viewer: [187482, 152733] The pylon Viewer works correctly with a remote X-server now. * pylon Viewer: [188833] The RPATH for running the pylon Viewer via X-server has been corrected. * pylon Viewer: [183914] The histogram calculation is only performed when the histogram pane is active now. * pylon Viewer: [187440, 176297] The Light Device Brightness slider in the Features pane has been adapted to correctly display the brightness range when using the Basler SLP Strobe Controller. * pylon Viewer: [182085] The position of GigE cameras in the Devices pane does not change anymore after enumeration. * pylon Viewer: [189875] The pylon Viewer can grab images after changing the IP address of the network adapter without having to close and reopen the pylon Viewer. The refresh button must be clicked before opening the camera if Auto-Scan is disabled. * pylon Viewer: [189905] Fixed an issue with the "Don't show this dialog again" option in the Bandwidth Manager. * pylon Viewer: [170965] The behavior of the Bandwidth Manager when used with GigE cameras on ARM-based boards has been improved. * Setup: [187517] A duplicate of the license folder has been removed. RESTRICTIONS ============ * 3D: To use Basler blaze 3D cameras requires the pylon Supplementary Package for blaze to be installed. The pylon Supplementary Package for blaze will be available for download on the Basler website at a later stage. * 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: The pylon C API doesn't provide convenient functions to use GenDC and the Basler blaze 3D camera 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. * 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. * GenTL: [133711] Limited GenTL support for producers with GenTL version 1.4 and below. * 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 the 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-06-18 VERSION: 6.1.3 (armhf, aarch64) ################################################################################ BINARY COMPATIBILITY ========================= Applications built with pylon 6.1.0 are compatible with pylon 6.1.3. NEW FEATURES / CHANGES ========================= * pylon Viewer: Added a command-line switch that allows you to force hardware or software rendering. This may be useful in case you notice problems with displaying the Welcome dialog, for example. CORRECTIONS ========================= * pylon Viewer: Fixed an issue that may have caused unexpected termination on some armhf and aarch64 processors. 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 for producers with GenTL version 1.4 and below. * 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-05-12 VERSION: 6.1.1 (x86_64) ################################################################################ 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 for producers with GenTL version 1.4 and below. * 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 for producers with GenTL version 1.4 and below. * 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 (x86, x86_64, armhf, aarch64) ################################################################################ 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 (x86, x86_64, armel, armhf) ################################################################################ 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 (x86, x86_64, armel, armhf) ################################################################################ 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.