Merged PR 26375: Prepare for pypylon 4.0.0rc1

.github/workflows/main.yml

@@ -175,7 +175,7 @@ jobs:
         run: |
           cd pylon-installer
           ren Basler-pylon-*.exe Basler-pylon.exe
-          $process = Start-Process Basler-pylon.exe -Wait -ArgumentList '/quiet /install=GigE_Runtime;USB_Runtime;Camera_Link_Runtime;CoaXPress_Runtime;GenTL_Consumer_Support;CamEmu_Support;SDKs;DataProcessing_SDK' -PassThru
+          $process = Start-Process Basler-pylon.exe -Wait -ArgumentList '/quiet /install=GigE_Runtime;USB_Runtime;Camera_Link_Runtime;GenTL_Consumer_Support;CamEmu_Support;SDKs;DataProcessing_SDK;DataProcessing_vTools' -PassThru
           Write-Host "Process finished with return code:" $process.ExitCode
 
       - name: Build wheels

README.md

@@ -113,10 +113,12 @@ Please note that the pylon Camera Software Suite may support different operating
 For latest information on pylon refer to: https://www.baslerweb.com/en/software/pylon/
 In addition, check the release notes of your pylon installation. 
 For instance: 
-* pylon 7.4.0 supports Windows 10/11 64 bit, Linux x86_64 and Linux aarch64 with glibc version >= 2.31 or newer.
+* pylon 7.5.0 supports Windows 10/11 64 bit, Linux x86_64 and Linux aarch64 with glibc version >= 2.31 or newer.
 * pylon vTools are supported on pylon 7.0.0 and newer.
 * pylon vTools are supported on pypylon 3.0 and newer only on Windows 10/11 64 bit, Linux x86_64 and Linux aarch64. 
 * For pylon vTools that require a license refer to: https://www.baslerweb.com/en/software/pylon-vtools/
+* CXP-12: To use CXP with pypylon >= 4.0.0 you need to install the CXP GenTL producer and drivers using the pylon Camera Software Suite setup.
+
 
 ## Binary Installation
 The easiest way to get pypylon is to install a prebuild wheel.
@@ -127,21 +129,17 @@ To install pypylon open your favourite terminal and run:
 
 The following versions are available on pypi:
 
- |                  | 3.6 | 3.7 | 3.8 | 3.9 | 3.10 | 3.11 |
- |------------------|-----|-----|-----|-----|------|------|
- | Windows 64bit    | x   | x   | x   | x   |  x   |  x   |
- | Linux x86_64***  | x   | x   | x   | x   |  x   |  x   |
- | Linux armv7l*    | x   | x   | x   | x   |  x   |  x   |
- | Linux aarch64*** | x   | x   | x   | x   |  x   |  x   |
- | macOS x86_64**   | x   | x   | x   | x   |  x   |  x   |
- | macOS arm64**    |     |     | x   | x   |  x   |  x   |
+ |                | 3.9 | 3.10 | 3.11 | 3.12 |
+ |----------------|-----|------|------|------|
+ | Windows 64bit  | x   | x    |  x   |  x   |
+ | Linux x86_64*  | x   | x    |  x   |  x   |
+ | Linux aarch64* | x   | x    |  x   |  x   |
+ | macOS x86_64** | x   | x    |  x   |  x   |
+ | macOS arm64**  | x   | x    |  x   |  x   |
 
 
 > Additional Notes on binary packages:
-> * (*) The linux 32bit binaries are manylinux_2_28 conformant.
-    This is roughly equivalent to a minimum glibc version >= 2.28.
-    :warning: You need at least pip 20.3 to install them.
-> * (***) The linux 64bit binaries are manylinux_2_31 conformant.
+> * (*) The linux 64bit binaries are manylinux_2_31 conformant.
     This is roughly equivalent to a minimum glibc version >= 2.31. 
     :warning: You need at least pip 20.3 to install them.
 > * (**) macOS binaries are built for macOS >= 11.0 (Big-Sur)

changelog.txt

@@ -1,3 +1,26 @@
+Version 4.0.0rc1
+    - Date 2024-07-02
+    - Updated to pylon 7.5 on linux and windows.
+    - pylon 6.2 is the lowest supported version when building pypylon.
+    - Dropped support for python 3.6, 3.7 and 3.8
+    - Added CI builds for python 3.12
+    - Dropped linux armv7l (32bit) support as it is no longer supported by pylon.
+    - Added PylonDataContainer and PylonDataComponent support for
+      3D cameras. You can use Basler 3D cameras with pypylon now.
+    - Extended PylonImage support for GetArray and GetMemoryWindow.
+    - Added pylondataprocessing.GetVersion().
+      It reports the version of the pylon Data Processing C++ SDK.
+    - The Builders recipe AddInput and AddOutput methods have changed.
+      see buildersrecipe_test.py on how to handle that.
+    - Updated data processing module documentation.
+    - Fixed an issue when using all GetMemoryWindow() methods when
+      running under python 3.12
+    - Fixed an issue when using GetArrayZeroCopy().
+    - Fixed an issue when running the unit tests with python 3.12.
+    - Fixed an issue with strings constaining regular expressions in setup.py
+    - Fixed an issue when running with numpy 2.0 in the unit tests.
+    - Extended the unit tests.
+
 Version 3.0.1
     - Date 2023-12-15
     - add issue templates and links to Basler docs and pypylon samples

samples/ifacenodemap_pocxp.py

@@ -2,8 +2,14 @@
 # Here we are going to use the interface node map of a Basler CXP interface
 # card to toggle 'Power Over CoaXPress' (PoCXP) between 'Auto' and 'Off'.
 
+from os import environ
 from pypylon import pylon
 
+# First check if GENICAM_GENTL64_PATH environment variable is set.
+# This is set automatically by the Basler setup when installing pylon CXP
+if environ.get('GENICAM_GENTL64_PATH') is None:
+    raise RuntimeError("GENICAM_GENTL64_PATH not set! Please install the CXP GenTL producer and drivers using the pylon Camera Software Suite setup.")
+
 # We need access to the interface node map. This can only be obtained from
 # a transport layer. Therefore we have to create the TL first.
 tl = pylon.TlFactory.GetInstance().CreateTl('BaslerGTC/Basler/CXP')