- examples/basic_2D.py shows examples of displaying body, body index, color, align color, depth and IR images in 2D using OpenCV
- examples/basic_3D.py shows examples of displaying coloured point cloud, joint and joint orientation in 3D using Open3D
Other than the prerequisites stated below, we will also need opencv-python and open3d-python for the 2D and 3D display as we are not using PyGame for the display
To create a Python virtual environment with the packages required:
conda env create -f environment.yml
Note: First time install of PyKinectV2 via pip may encounter AssertionError: 80 File "C:\Users...\Anaconda2\lib\site-packages\pykinect2\PyKinectV2.py", line 2216, in assert sizeof(tagSTATSTG) == 72, sizeof(tagSTATSTG) Just go to the pykinect2 installation in the site-packages folder on your computer and replace the PyKinectV2.py file with the one from this github repository.
Enables writing Kinect applications, games, and experiences using Python. Inspired by the original PyKinect project on CodePlex.
Only color, depth, body and body index frames are supported in this version. PyKinectBodyGame is a sample game. It demonstrates how to use Kinect color and body frames.
The easiest way to get most of the pre-requisites is to use Anaconda which includes NumPy. You'll then need to pip install comtypes. The PyKinectBodyGame sample requires PyGame which needs to be manually installed.
- Download Anaconda get the 32-bit version. This includes NumPy.
- pip install comtypes
- Install the Kinect for Windows SDK v2
Full List of Dependencies
- Python 2.7.x or 3.4 and higher
- NumPy
- comtypes
- Kinect for Windows SDK v2
- Kinect v2 sensor and adapter Note: you can use a Kinect for Xbox One as long as you also have the Kinect Adapter for Windows
- PyGame - for running PyKinectBodyGame sample
The package can be installed through pip using the usual means:
pip install pykinect2
If you are using a virtual environment, be sure to activate it first.
For more information, please see https://pip.pypa.io/en/latest/user_guide.html#installing-packages
To install the package manually, clone this repository to a local folder and include it in the appropriate python environment. If installing in a virtual environment, be sure to install all required dependencies (above).
For example:
cd c:\projects\myproject\env\
/Scripts/activate.bat
easy_install -a c:\projects\downloads\PyKinect2
After installation is complete, you can launch the interactive python shell and import pykinect2
to ensure everything has been installed properly.
Core helper classes for working with the Kinect sensor are located in PyKinectRuntime.py. For usage examples, please see /examples/PyKinectBodyGame.py.