Depthmapper is a collection of utilities for using a Kinect's distance sensor. It contains utilites for collecting the data from the hardware and displaying this data in a 3D environment.

This project is available from GitHub.

• Python
• PyOgre (required for displayer)
• Kinect for Windows SDK (required for collector)
• PyKinect (required for collector)

Note: PyKinect and the Kinect for Windows SDK are only available on Windows. Depthmapper was written in a Windows environment, so issues may arise when running on other platforms.

1. Install PyOgre and PyKinect
2. Edit bin/plugins.cfg and change the paths to suit your machine
3. Run collector.py to collect data from the Kinect
4. Run displayer.py to display the data in a 3D interface

The collector is responsible for collecting the data from the Kinect and saving it into a format recognisable by the displayer.

python collector.py [<filename>]

• <filename>: an optional filename to save the data to. Defaults to snap.data

The displayer is responsible for displaying collected data in a 3D interface.

python displayer.py [<filename>]

• <filename>: an optional filename to save the data to. Defaults to snap.data

While using the displayer, navigation is controlled through the keyboard and mouse.

• w: move forward
• a: move left
• s: move backward
• d: move right
• Page Up: move vertically upwards
• Page Down: move vertically downwards
• Print Screen: save a screenshot
• f: toggle information dialog
• p: toggle positional information
• r: toggle view mode (full, wireframe, or point mode)

Contains public domain code and media from the PyOgre project.

Depthmapper is licensed under the ISC license. See LICENSE.md for more information.