VisionPro 9.23 contains new or changed features since the previous release of VisionPro 9.22 SR1.
This topic contains the following sections.
- New Features In This Release
- 3D Operations Requirements
- Minimum Computer Requirements
- Supported Operating Systems
- Supported Visual Studio Development Environments
- Acquisition Platforms
- Support for Cognex Designer and VisionPro Deep Learning
- Security Key Firmware
- Find Additional VisionPro Documentation Online
- Needed Instruction Sets
This release supports the following new features:
This release includes complete support for the 3D-L38 including hardware and software documentation.
This release makes the following changes regarding support for the 3D-L68:
Adds the following new custom properties as described in the topic 3D-L68 Sensor Acquisition:
- HighDynamicRangeMergeMode
- LaserMode
- BinningHorizontal
- BinningVertical
- AdvancedReflectionFilterMode
- Renames the custom property MaximumEncoderStepFrequency to MaximumEncoderLineFrequency
- Replaces the Configure_L68_IP utility with L68_Configuration_Tool utility
Includes the 3D-L68 firmware version 6.1.2.16
See the topic 3D-L68 Series Firmware Upgrades for details on updating the 3D-L68 firmware.
As of this release, all range images produced by the 3D-L68, the 3D-A5000, or any other 3D vision sensor that uses the Cognex Acquisition Integration Kit (AIK) module supports a SelectedSpaceName of "Sensor2D" instead of "@" (root space). This change ensures that range images produced by the AIK module use the same two-dimensional coordinate space as the range images produced by other Cognex 3D vision sensors, such as the DS-1000 or the 3D-L4000.
This release supports Cognex VisionPro Deep Learning 4.0.0 for use with the DLRuntime tool, which allows your vision application access to all the images, vision tools and results supported by VisionPro Deep Learning (VPDL) software.
Be aware of the changes to the DLRunime tool support in this release:
- The CogDLRuntime classes are now based on Cognex VisionPro Deep Learning 4.0 and the Cognex VisionPro Deep Learning 4.0 Resources.
Some .vrws files might no longer be loadable with VPDL 4.0 and this VisionPro release. Specifically, any .vrws file that contained either a Red High Detail or a Green High Detail ViDi tool will no longer load successfully.
That means that if you had persisted a CogDLRuntime operator in the Open state and the FileName for that operator referenced a .vrws file containing one of these tools, the operator will no longer depersist successfully but will instead have a State of Partial.
This release redefines the CogDLRuntimeToolTypeConstants enumeration:
- 0: Unknown
- 1: Blue
- 2: BlueRead
- 3: RedLegacy
- 4: GreenLegacy
- 5: GreenStandard
- 6: RedStandard
- 7: AnomalyDetection
This release removes the following API:
- The CogDLRuntimeRedModeConstants enumeration
- The CogDLRuntimeViewRed class properties Mode and Threshold
- The CogDLRuntimeViewGreenLabeled class property SimilarityReference
This release adds the following API:
- The CogDLRuntimeViewRed class properties FilteredScoreMaps and RegionThreshold
- The CogDLRuntimeRegionThresholds class
- The CogDLRuntimeViewRedLabeled class property HasLabeledRegion
- The CogDLRuntimeViewGreen class property OutlierScore
- This release updates the DLRuntime Edit Control
Note: Be aware the VisionPro installer does not install the DLRuntime Tool by default. You must explicitly install the DLRuntime Tool when you install this VisionPro release.
See the topic Integrating a VPDL Runtime Workspace for details on installing and using a DLRuntime Tool.
This release includes the following camera device driver upgrades:
- Upgrade of Pleora from 3.1.16 to 6.5.0 (eBus from 4.1.16 to 7.5.0)
- Upgrade of Basler pylon runtime from 7.4.0 to 7.5.0
In addition, this release makes the following changes to the VisionPro installer regarding device drivers:
- Renames Trevista Hardware Driver to Basler Framgebrabber Runtime
- Reorders the list of GigE Interface drivers
Be aware this release makes no changes to the functionality of any device drivers.
The property LatencyLevel reads or sets the latency level of the GigE Vision performance driver, with a range of 0 (lowest latency) to 3 (lowest CPU). Smaller values reduce acquisition latency and may improve reliability at the expense of higher CPU usage.
The property uses a default value of 3 but Cognex makes the following recommendations going forward:
- Set a value of 2 for 1GigE cameras to improve acquisition robustness.
- Set a value of 0 for 5GigE and 10GigE cameras.
This release drops support for the DSMax. Contact your Cognex sales representative for more information.
This release removes the remaining legacy MS VC++ Redistributables dependencies (2010 and 2013).
Your processor must support the AVX2 instruction set for any Cognex 3D operations.
VisionPro supports the CPUCanExecute3D method to return True if the processor in your computer is capable of executing Cognex 3D operations. Otherwise the method returns False. Use the CPUCanExecute3D method to verify any computer you use to create or deploy your application can perform 3D operations.
Contact your Cognex sales representative for recommendations on the best computer to use for your specific vision application. Cognex can make the following general recommendations for minimum PC requirements:
- IBM or compatible Pentium computer with MMX/SSE2 instruction set
- One open PCI slot if you are using a PCI-bus Cognex frame grabber or a GigE camera adapter
- One open PCI Express slot if you are using a PCI Express-bus frame grabber, Cognex Communication Card or GigE Vision network adapter
- One open USB port for the Cognex Security Key
- One USB3 port if you are using GenTL acquisition
- 4 GB memory, 2 GB free disk space prior to installation
- 1024 x 768 display with a display setting of 96 DPI
- PCI, PCI Express (recommended), or AGP video adapter
VisionPro supports development and deployment on single or multiprocessor machines using native languages (English, Japanese, German, Korean, and Simplified Chinese) on a variety of Windows 64-bit operating systems.
VisionPro supports 2D vision tools and features on Windows 10 Pro, Windows 10 IoT Enterprise, and Windows 11 Pro.
VisionPro supports various 3D sensors and 3D vision tools based on your 64-bit operating system:
| 3D Hardware/Feature | Required 64-Bit OS |
| VisionPro with the 3D-L38, 3D-L68, 3D-L4000, DS1000 and DS900 series sensors | Windows 10 Pro, Windows 10 IoT Enterprise, Windows 11 Pro |
| VisionPro with the DSMax series sensors | Windows 10 Pro, Windows 11 Pro |
| 3D-A5000 sensor with A5000 Viewer and 3D HandEye Field Calibrator | Windows 10 Pro, Windows 11 Pro |
| CAD Import Tool | Windows 10 Pro, Windows 11 Pro |
| Cognex 3DExpress | Windows 10 Pro, Windows 11 Pro |
VisionPro 9.23 supports application development and deployment using any version of Visual Studio that enables the targeting of projects to .NET Framework 4.8.
Note: Be aware that only versions of Visual Studio prior to and including VS2017 support adding VisionPro UI tool controls to Visual Studio Winform Designer.
See the VisionPro Camera Support website for a complete list of cameras VisionPro supports. Be aware that not all acquisition platforms are supported on all operating systems.
- GigE Vision and related performance drivers
- 3D-L38 series 3D Sensors
- 3D-L68 series 3D Sensors
- 3D-A5000 3D Sensor
- DS1000 series 3D Sensors
- 3D-L4000 series 3D Sensors (3D-L4050, 3D-L4100, 3D-L4300, 3D-L4033)
- DS900 series 3D Sensors
- DSMax series 3D Sensors
- CFG-8700 series
- USB 3.0 cameras by means of a GenTL consumer
Refer to the following for information on using Cognex Designer and VisionPro Deep Learning with VisionPro 9.23:
Designer | VisionPro 9.23 supports Designer 4.4.3 - 4.5 VisionPro Deep Learning users must update to Designer 4.5 |
VisionPro Deep Learning | Using VisionPro 9.23 and VisionPro Deep Learning on the same system requires you install both:
|
VisionPro uses a USB security key attached to your computer to ensure the software is properly authorized for use. This release supports firmware version 4.12 for VisionPro security keys. See the topic Security Key Updates for how to check the firmware version on your security key.
If you are using a security key with a previous version of firmware, contact Cognex Support for assistance in upgrading to the latest version. Keep your security key firmware up to date to take advantage of the latest features and improvements to Cognex software security.
The VisionPro Support website contains additional VisionPro documentation not included with your VisionPro installation.
The following table lists the specific instruction set your processor must support for various vision tools:
| Tool | Instruction Set | Notes |
| PMAlign | SSE4.1 | Instruction set needed for 16-bit image analysis only |
| PMRedLine | SSE4.1 | |
| Any 3D operations ViDiEL tools | AVX2 | Any AVX instruction sets prior to AVX2 are not sufficient for 3D operations. |