Examples

The Ensenso SDK ships with some example programs that demonstrate simple usage of the NxLib API. On Windows, you can open the example folder with the “EnsensoSDK/Examples” start menu entry. On Linux the examples are installed in $ENSENSO_INSTALL/development/examples.

The C and C++ examples are provided as Visual Studio 2015 solutions and as Makefiles for building them on Linux. Note that you need to compile the examples yourselves. If you don’t have write permissions in the SDK installation folder you might have to copy the example source code somewhere else first.

C

nxSimple

Shows how to grab and process an image using basic C API calls.

nxListCams

Lists all connected cameras.

nxListCamsLibDynamic

Loads NxLib on runtime and lists all connected cameras

nxLoadParams

Loads camera parameters from a JSON file.

nxReadArray

Displays all numbers of an Array/Matrix-Node.

C++

nxSimple

Shows how to grab and process an image using the C++ object oriented API.

nxSimpleParalel

Shows how to grab images in one thread and process them in another using the C++ object oriented API.

nxDisparityMapViewer

Shows how to capture images and compute and display a disparity map in a simple WinAPI/XLib application.

nxImageBuffer

Shows how to enable continous triggering and automatically fill an image buffer and retrieve images from this buffer.

nxListCams

Lists all connected cameras.

nxListCamsLibDynamic

Loads NxLib on runtime and lists all connected cameras

nxPartFinder

Shows how to generate a model, store/load it to/from the filesystem and search for parts in the depth data of the selected camera.

nxRenderPointMap

Renders a telecentric point map with data from multiple cameras.

nxRenderPointMapTexture

Renders a perspective point map using a computed rectified texture.

nxSaveImages

Saves raw and rectified images as png files.

nxSetBinaryData

Shows how to read and write Binary node data.

nxGetLog

Load logs from a NxLibRemote and write them to a file, readable by NxProfiler

C#

nxSimple

Shows how to grab and process an image using the C++ object oriented API.

nxDisparityMapViewer

Shows how to capture images and compute and display a disparity map in a small application using Windows Forms.

nxCalibrateHandEye

A small console application to demonstrate how to use cmdCalibrateHandEye to perform camera-to-robot calibration for different setups.

MVTec Halcon

SimpleLive

Shows how to grab XYZ-data from a camera and displays the separate channels in HDevelop.

SimpleLive-RenderView

Grabs 3D data continously and displays the rendered 3D surfaces as color image.

SurfaceMatching-Single

Uses a single Ensenso camera to learn an object surface from the first 3D image and then searches for the taught object in all following images.

WorkspaceCalibration

Performs a workspace calibration.

Python

A list of python examples can be found here.