Notice: MediaWiki has been updated. Report any rough edges to marcan@marcan.st

Main Page: Difference between revisions

From OpenKinect
Jump to navigationJump to search
No edit summary
 
(43 intermediate revisions by 15 users not shown)
Line 1: Line 1:
__NOTOC__
[[Image:logo_openkinect_shaded.svg]]
'''Welcome to the OpenKinect project'''
'''Welcome to the OpenKinect project'''
{{Languages}}
== About ==


== About ==
'''OpenKinect''' is an open community of people interested in making use of the amazing Xbox Kinect hardware with our PCs and other devices. We are working on free, open source libraries that will enable the Kinect to be used with Windows, Linux, and Mac.


OpenKinect is an open community of people interested in making use of the amazing Xbox Kinect hardware with our PCs and other devices. We are working on free, open source libraries that will enable the Kinect to be used with Windows, Linux, and Mac.
The OpenKinect community consists of over 2000 members contributing their time and code to the Project. Our members have joined this Project with the mission of creating the best possible suite of applications for the Kinect. OpenKinect is a true "open source" community!


Some general information about how Kinect works can be found in [http://www.freepatentsonline.com/20100118123.pdf this document].
Our primary focus is currently the '''libfreenect''' software. Code contributed to OpenKinect where possible is made available under an Apache20 or optional GPL2 license.


Source code is available here: https://github.com/OpenKinect/libfreenect
* Source code is available here: https://github.com/OpenKinect/libfreenect


Get started right away by [[Getting Started|installing]] the software to your platform.
* Get started right away by [[Getting Started|installing]] the software to your platform.


== Communications ==
== Communications ==


If you want to participate or just watch the progress of the OpenKinect effort, subscribe to the [[http://groups.google.com/group/openkinect/ OpenKinect mailing list]]. In the application form, please tell us something about yourself and you'll be approved automatically. You could also subscribe to a low-traffic [[http://groups.google.com/group/openkinect-announce/ announcement-only mailing list]].
If you want to participate or just watch the progress of the OpenKinect effort, subscribe to the OpenKinect [http://groups.google.com/group/openkinect/ mailing list]. In the application form, please tell us something about yourself and you'll be approved automatically. You could also subscribe to the low-traffic announcement-only [http://groups.google.com/group/openkinect-announce/ mailing list].
 
You can follow us on Twitter http://twitter.com/openkinect
Please use the #tag #openkinect when tweeting your work
 
You can meet people in your area working on OpenKinect through Meetup Groups:
* [http://meetup.com/OpenKinect NYC]
* [http://qccolab.com QC-Colab Davenport, IA]
* [http://www.meetup.com/3DVision/ San Francisco]
 
You can also chat with people developing on OpenKinect software on IRC: [irc://irc.freenode.net/#OpenKinect #OpenKinect on irc.freenode.net].  


If you need an IRC client, check:
*You can follow us on ''Twitter'' [http://twitter.com/openkinect @openkinect]. Please use the #tag #openkinect when tweeting your work.


* Chatzilla (for firefox): https://addons.mozilla.org/en-US/firefox/addon/16/
*You can meet people in your area working on OpenKinect through [[Meetup_Groups|''Meetup Groups'']]:
* http://webchat.freenode.net/
** [http://meetup.com/OpenKinect NYC]
* http://quassel-irc.org/
** [http://qccolab.com QC-Colab Davenport, IA]
* http://www.mirc.com/
** [http://www.meetup.com/3DVision/ San Francisco]


Channel logs (Daily rotation) can be found at http://falcon4ever.pcsx2.net/kinect/logs/
*You can also chat with people developing on OpenKinect software on ''IRC'': [irc://irc.freenode.net/#OpenKinect #OpenKinect] on irc.freenode.net or using this web based [http://webchat.freenode.net/ chat].
*Channel logs (daily rotation) can be found [http://falcon4ever.pcsx2.net/kinect/logs/ here].


== Project information ==
== Project information ==


===== [[Roadmap|Project Roadmap]] =====
* '''[[Roadmap|Project Roadmap]]''' - The current roadmap for the project (libfreenect, analysis library, and applications)
*The current roadmap for the project (libfreenect, OpenKinect Processing library, and Openkinect apps)...
* '''[[People]]''' - Who is doing what: project leader, maintainers, contributors etc.
===== [[Policies|Project Policies]] =====
* '''[[History|Project History]]''' - The bounty, key dates and milestones
*The official name of the project, license, contribution policy, coordination between developers, and decision making...
* '''[[Policies|Project Policies]]''' -  The official name of the project, license, contribution policy, developers coordination and decision making
===== [[Contributing Code]] - How to contribute code =====
* '''[[Getting Started|Installation]]''' - How to download, build and install on Linux, OS X and Windows
*Official repositories, use of a fork and Openkinect source header, signing off, submissions and evaluation...
* '''[[Contributing Code]]''' - Official repositories, use of a fork and source header, signing off, submissions and evaluation etc.
===== [[Contributing]] - There many ways to contribute besides coding =====
* '''[[Code Integration]]''' - How to deal with how we use git: repository policy, git usage, workflow, starting development, integration process etc.
*Testing, administrative tasks, support related tasks, documentation, collaboration etc.
* '''[[Contributing]]''' - There are many ways to contribute: testing, administrative tasks, support related, documentation, collaboration etc.
===== [[Code Integration]] - How to deal with how we use git =====
* '''[[FAQ]]''' - Frequently asked questions
*Repository policy, git usage, workflows, how to start development and keep up to date, and the integration process...
* '''[[Documentation]]''' - Documenation
===== [[Getting Started|Installation]] - How to download, build and install OpenKinect =====
* '''[[Project_ideas|Project Ideas]]''' - Ideas and concepts to explore using OpenKinect
*Requirements and steps to install on Linux, OS X and Windows, user contributed guides...  
* '''[[Gallery|Gallery and websites]]''' - Videos and links to things people are doing with OpenKinect
===== [[People]] - Who is doing what =====
* '''[[Official_Logos|Official Logos]]''' - Official OpenKinect logos for use in your projects
*Project leader, maintainers, and who is doing what in the OpenKinect project...
===== [[Gallery]] - Videos and links to things people are doing with OpenKinect =====
*Demos and solutions using OpenKinect...
===== [[FAQ]] =====
*Frequently asked questions...
===== [[Logo_Proposals|Logo Proposals]] =====
*Following a vote, finalists have been chosen and the logo will be selected shortly!
===== [[Project_ideas|Project Ideas]] =====
*Ideas and concepts to explore using OpenKinect...


== API Documentation ==
== API Documentation ==


* [[High Level]] - High-level API documentation
* [[High Level]] - High-level API documentation
* [[Low Level]] - Low-level API documentation


== Wrappers ==
== Wrappers ==
Line 68: Line 56:
* [[C_Sync_Wrapper|C Synchronous]] - Provides functions to get data instead of callbacks
* [[C_Sync_Wrapper|C Synchronous]] - Provides functions to get data instead of callbacks
* [[Action_Script_3|Actionscript]]
* [[Action_Script_3|Actionscript]]
* [[C++_Wrapper|C++]]
* [[CSharp_Wrapper|C#]]
* [[CSharp_Wrapper|C#]]
* [[Java_Wrapper|Java]]
* [[Java_JNI_Wrapper|Java JNI]]
* [[Java_JNA_Wrapper|Java JNA]]
* [[Javascript_Wrapper|Javascript]]
* [[Javascript_Wrapper|Javascript]]
* [[Getting_Started_With_Common_Lisp|Common Lisp]] - Getting started with libfreenect on Common Lisp
* [[GLib_Wrapper|GFreenect (GLib)]] - Use Freenect from GLib. Also provides GObject Introspection which means automatic bindings for many other languages (Python, Javascript, Vala)


== Utilities ==
== Utilities ==
Line 79: Line 71:
== Knowledge base ==
== Knowledge base ==


* '''[[Protocol Documentation]]''' - Kinect USB procotol, structures and hardware control commands for the cameras, motor, LED and audio
* [http://www.freepatentsonline.com/20100118123.pdf Reference design] - US Patent Application "Depth mapping using projected patterns"
* [[Camera_DSP|NUI Camera DSP]] - Camera DSP, architecture, instruction set, firmware, and capabilities
* [[Camera_DSP|NUI Camera DSP]] - Camera DSP, architecture, instruction set, firmware, and capabilities
* [[lsusb output]] - Device identifier output
* [[lsusb output]] - Device identifier output
* [[USB Devices]] - Overview of the hardware devices
* [[USB Devices]] - Overview of the hardware devices
* [[Protocol Documentation]] - General information about the Kinect USB procotol
* [[USB Protocol Information]] - Other information about the Kinect USB protocol
* [[USB Protocol Information]] - Other information about the Kinect USB protocol
* [[Init Analysis]] - Messing with various init sequences
* [[Init Analysis]] - Messing with various init sequences
Line 92: Line 85:
== Links ==
== Links ==


''' Comment Threads '''
'''OpenNI'''
* http://ladyada.net/learn/diykinect/ - How the Kinect was hacked very detailed overview of what was involved
* http://openni.org - Open Natural Interaction, an industry-led, not-for-profit organization formed to certify and promote the compatibility and interoperability of Natural Interaction (NI) devices, applications and middleware
* http://www.adafruit.com/blog/2010/11/04/the-open-kinect-project-the-ok-prize-get-1000-bounty-for-kinect-for-xbox-360-open-source-drivers/ - Adafruit's competition. Comment thread contains list of some of the people working on this.
* http://github.com/openni - Open source framework for natural interaction devices
* http://hackaday.com/2010/11/04/kilobuck-open-kinect-project-prize/ - Hackaday's coverage of the bounty. Again, interesting comment thread.
* http://github.com/PrimeSense/Sensor - Open source driver for the PrimeSensor Development Kit


''' Tech '''
''' Tech '''
Line 103: Line 96:
* http://www.primesense.com/?p=535 - Primesense reference implementation (via adafruit thread)
* http://www.primesense.com/?p=535 - Primesense reference implementation (via adafruit thread)
* http://www.sensorland.com/HowPage090.html - How sensors work and the bayer filter
* http://www.sensorland.com/HowPage090.html - How sensors work and the bayer filter
* http://nvie.com/posts/a-successful-git-branching-model/ - Model for branching within Git
* http://www.numenta.com/htm-overview/education/HTM_CorticalLearningAlgorithms.pdf - Suggestions to implement pseudocode near the end
* http://www.numenta.com/htm-overview/education/HTM_CorticalLearningAlgorithms.pdf - Suggestions to implement pseudocode near the end
* http://www.dwheeler.com/essays/floss-license-slide.html Which licenses are compatible with which
* http://www.dwheeler.com/essays/floss-license-slide.html - Which licenses are compatible with which
* http://www.eetimes.com/design/signal-processing-dsp/4211071/Inside-Xbox-360-s-Kinect-controller - Another Hardware Teardown. Note this article incorrectly states that the PS1080 talks to the Marvell chip.
* http://www.eetimes.com/design/signal-processing-dsp/4211071/Inside-Xbox-360-s-Kinect-controller - Another Hardware Teardown. Note this article incorrectly states that the PS1080 talks to the Marvell chip.
 
* http://nvie.com/posts/a-successful-git-branching-model/ - Model for branching within Git
''' Kinect Themed sites '''
* http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches - Linux contribution procedure
* http://www.reddit.com/r/openkinect/ OpenKinect news and discussion community
* http://git.kernel.org/?p=git/git.git;a=blob_plain;f=Documentation/SubmittingPatches;hb=HEAD - Git project contribution procedure
* http://www.kinectHacks.net - Kinect hacking blog and forum
* http://www.freenect.com/ - Kinect hacking news
* http://www.modmykinect.com - The innovation begins.
* http://www.Bodensee-Deal.de/ - Kinect hacking news in German
 
''' Random '''
 
* Linux contribution procedure http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches
* Git project contribution procedure http://git.kernel.org/?p=git/git.git;a=blob_plain;f=Documentation/SubmittingPatches;hb=HEAD
 
''' Code Examples '''
* libfreenect and opencv 2.1 http://www.morethantechnical.com/2010/11/22/kinect-and-opencv-2-1/
 
 
''' News '''
 
* http://www.kinectxbox360.es/ Novedades, hacks y juegos de kinect en español.

Latest revision as of 11:38, 7 March 2012

Welcome to the OpenKinect project

Language: English  • español • suomi • français • italiano • português do Brasil • 中文(简体)

About

OpenKinect is an open community of people interested in making use of the amazing Xbox Kinect hardware with our PCs and other devices. We are working on free, open source libraries that will enable the Kinect to be used with Windows, Linux, and Mac.

The OpenKinect community consists of over 2000 members contributing their time and code to the Project. Our members have joined this Project with the mission of creating the best possible suite of applications for the Kinect. OpenKinect is a true "open source" community!

Our primary focus is currently the libfreenect software. Code contributed to OpenKinect where possible is made available under an Apache20 or optional GPL2 license.

  • Get started right away by installing the software to your platform.

Communications

If you want to participate or just watch the progress of the OpenKinect effort, subscribe to the OpenKinect mailing list. In the application form, please tell us something about yourself and you'll be approved automatically. You could also subscribe to the low-traffic announcement-only mailing list.

  • You can follow us on Twitter @openkinect. Please use the #tag #openkinect when tweeting your work.
  • You can also chat with people developing on OpenKinect software on IRC: #OpenKinect on irc.freenode.net or using this web based chat.
  • Channel logs (daily rotation) can be found here.

Project information

  • Project Roadmap - The current roadmap for the project (libfreenect, analysis library, and applications)
  • People - Who is doing what: project leader, maintainers, contributors etc.
  • Project History - The bounty, key dates and milestones
  • Project Policies - The official name of the project, license, contribution policy, developers coordination and decision making
  • Installation - How to download, build and install on Linux, OS X and Windows
  • Contributing Code - Official repositories, use of a fork and source header, signing off, submissions and evaluation etc.
  • Code Integration - How to deal with how we use git: repository policy, git usage, workflow, starting development, integration process etc.
  • Contributing - There are many ways to contribute: testing, administrative tasks, support related, documentation, collaboration etc.
  • FAQ - Frequently asked questions
  • Documentation - Documenation
  • Project Ideas - Ideas and concepts to explore using OpenKinect
  • Gallery and websites - Videos and links to things people are doing with OpenKinect
  • Official Logos - Official OpenKinect logos for use in your projects

API Documentation

Wrappers

Utilities

  • Record - Dumps Kinect data to PPM, PGM, and a bin dump for RGB, Depth, and Accel respectively.
  • Fakenect - libfreenect simulator/mock interface that lets you use the kinect demos without having a kinect (plays back data from Record)

Knowledge base

Links

OpenNI

  • http://openni.org - Open Natural Interaction, an industry-led, not-for-profit organization formed to certify and promote the compatibility and interoperability of Natural Interaction (NI) devices, applications and middleware
  • http://github.com/openni - Open source framework for natural interaction devices
  • http://github.com/PrimeSense/Sensor - Open source driver for the PrimeSensor Development Kit

Tech