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.
- Install PyOgre and PyKinect
- Edit
bin/plugins.cfg
and change the paths to suit your machine - Run
collector.py
to collect data from the Kinect - 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 tosnap.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 tosnap.data
While using the displayer, navigation is controlled through the keyboard and mouse.
w
: move forwarda
: move lefts
: move backwardd
: move rightPage Up
: move vertically upwardsPage Down
: move vertically downwardsPrint Screen
: save a screenshotf
: toggle information dialogp
: toggle positional informationr
: 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.