thdtjsdn / airkinect Goto Github PK

AIRKinect Extension is a Native Extension for use with Adobe AIR 3.0. AIRKinect allows AIR developers to tap into the rich experience of the Microsoft Kinect and push interactivity to a new level.

Requirements:
=============

Adobe Flash Builder 4.6 IDE

Windows:
--------
1) Install Microsoft Kinect SDK Beta 2: http://kinectforwindows.org/
2) That's it

OSX Lion:
---------
1) Install Macports: http://www.macports.org
2) Execute the following command in Terminal: sudo port install libtool
3) Execute the following command in Terminal: sudo port install libusb-devel +universal
4) Download & install OpenNI OSX binary (unstable): http://www.openni.org/
5) Download & install Nite OSX binary (unstable): http://www.openni.org/
6) Download & install SensorKinect: https://github.com/avin2/SensorKinect

Optional:
=========
Flash Develop | Intellij
Support and setup can be found in forum


Getting Started - Flash Builder 4.6:
====================================

1) Download the latest AIRKinectExtension.ane and make sure the above requirements are installed. 

2) In Flash Builder, File > New > Flex Project

3) Give the project a name and choose application type as Adobe AIR. Make sure the selected SDK is 4.6 or higher. Click "Next"

4) No special server settings are required, click "Next"

5) Under the "Native Extensions" tab, click "Add ANE" and browse to the AIRKinectExtension.ane. Select and click "Finish".

6) Right click on the newly created project and select "Properties". Select "Flex Build Packaging" and tab "Native Extensions". The AIRKinectExtension should be present and check "Package" to make sure the ANE is included with your AIR Application. Click "Okay".

7) Watch the demos, read the docs, give feedback and enjoy!

Note from the authors:
====================================
Please send us demos to highlight projects using AIRKinect and provide feedback on use or create issues so we know what the community needs and is looking for. We want to empower the Flash developer to create amazing experiences and anything that will best promote this is our goal. 

AIRKinect-Extended Updates:

---- December 22, 2011: Version 1.0:
	1) AIRKinectManager for managing Skeleton Add/Remove/Update along with Camera Updates.
	2) 3D Regions
	3) Basic Velocity Based Gestures with Manager
	4) ManagedSkeletons with history
	5) PointCloudHelper for saving Point Clouds in standard formats.
	6) SkeletonSimulator for Recording and Playback of SkeletonXML
	7) UI
		1) UIManager to handle Cursor event dispatching
		2) MouseSiulator translates mouse into a cursor for testing or Web demos
		3) UI Components
			1) SelectableHandle (cursor snapping & timer based selection)
			2) Target (rollover behavior & timer based selection)
			3) HotSpot (Rollover based selection)
			4) SlideHandle (cursor snapping, slide progress & slide based selection)
			5) RepeatingSelectableHandle (cursor snapping & repeatable timer based selection )
			6) CrankHandle (cursor snapping & rotation based endless scroll)


AIRKinect Updates:
========
---- December 22, 2011: Version 1.6:

	1) Skeleton to RGB & Depth Space Translation (windows only)
	2) Per Pixel Depth information via ByteArray (point cloud)
	3) Renaming & Restructing of Classes
	4) Updated to AIR 3.1
	5) Kinect-less Support. Proper Handling when No Kinect is connected.
	
---- November 29, 2011: Version 1.5.

Version 1.5 adds support for the open source drivers on OSX. Most of the features work, except:
	1) Some of the skeleton points are interpolated.
	2) Get/Set of camera angle is not possible
	3) Not possible to reconnect after disconnection

---- November 22, 2011: Version 1 and initial checkin.

Version 1 of the AIRKinect Native Extension includes:
	1) Depth Video
	2) RGB Video
	3) Multiple Skeletons with 20 joint positions
	4) Depth point mapping
	5) RGB and Depth resolution customization
	6) Get/Set of camera angle
	7) Translation of joint points to virtual points
	8) Transform smoothing parameters for Kinect
	9) Kinect status with connect/disconnect

Notes:
With depth video at 320x340 and rgb video at 640x480, you should recieve updates at 30fps at stable for depth,rgb, and skeleton.
As the resolution increases the frames with decrease. Because the extension runs at 30fps, it is suggestable to increase the application fps to 30fps or above for best performance.