Third-party platform (VisionPro)

Downloading and installing VisionPro

Please download VisionPro from Cognex official website (https://www.cognex.cn/zh-cn/products/machine-vision/vision-software/visionpro-software).

Note

Percipio has tested VisionPro 9.0 and confirmed that it can open the Percipio camera normally. It is recommended to use this tested version of VisionPro.

Downloading VisionPro SDK

Please download the Percipio VisionPro SDK from Percipio official website download center (https://www.percipio.xyz/downloadcenter/).

The directory structure of VisionPro SDK is shown in the following figure:

VisionPro SDK directory

Configuring environment

1. Right-click on the VisionPro shortcut icon and select “Open file location” from the shortcut menu to access the installation directory of VisionPro.

2. Copy PercipioCamera.dll, PercipioCameraExtern.dll, tycam.dll and opencv_world460.dll to bin folder in the VisionPro installation directory.

3. Copy PercipioCameraToolBlock.vtt to bin/Templates/Tools folder in the VisionPro installation directory.

Running

This section mainly introduces how to run the Percipio camera in VisionPro. The steps are as follows:

1. Double-click to run the VisionPro software.

2. Double-click on “Image Source” to enter VisionPro(R) QuickBuild Job Editor - CogJob1 page.

   

3. Click on the “Show VisionPro Tools” icon to bring up the VisionPro Tools page.

   

4. Double-click on “PercipioCameraToolBlock” and add it to the ToolGroup.

   

5. Double-click on “PercipioCameraToolBlock”, select the “Input/Output” tab in the PercipioCameraToolBlock page, and set the input parameters.

   

   • CameraId: Set camera serial number.

   • Z: Set the distance between the camera and the projection plane in the Z direction, in millimeters. Perform an orthogonal projection of the depth map onto this projection plane. With the camera field of view at this distance and the depth map resolution, the size of a single pixel (in millimeters) can be calculated for subsequent calculations.

   • ScaleUnit: Set the ScaleUnit feature of the camera to output depth values with different precisions.

   • RegistrationMode: Set the RGBD registration switch. 0: no registration; 1: rgb2depth; 2: depth2rgb.

6. Click on the “Run” icon. You can view the images captured by the camera in the output terminal.

   

   Afterwards, add other tools according to actual needs, and connect the output port of PercipioCameraToolBlock to the input port of other tools.

7. Optional: If you have secondary development needs for PercipioCameraToolBlock, you can click on the “Create/Edit Script” icon and edit the script.