Notice: MediaWiki has been updated. Report any rough edges to marcan@marcan.st
Main Page: Difference between revisions
(Removed chat clients that added clutter, webchat reference suffices; reduced hyperlinks footprint, we see the links in browser status anyway; focus on the mailing list, bullets for others means.) |
No edit summary |
||
(35 intermediate revisions by 12 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 == | |||
'''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 | 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. | |||
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/ | 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 @openkinect].Please use the #tag #openkinect when tweeting your work. | *You can follow us on ''Twitter'' [http://twitter.com/openkinect @openkinect]. Please use the #tag #openkinect when tweeting your work. | ||
*You can meet people in your area working on OpenKinect through ''Meetup Groups'': | *You can meet people in your area working on OpenKinect through [[Meetup_Groups|''Meetup Groups'']]: | ||
** [http://meetup.com/OpenKinect NYC] | ** [http://meetup.com/OpenKinect NYC] | ||
** [http://qccolab.com QC-Colab Davenport, IA] | ** [http://qccolab.com QC-Colab Davenport, IA] | ||
** [http://www.meetup.com/3DVision/ San Francisco] | ** [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 or using this web based [http://webchat.freenode.net/ chat]. Channel logs (daily rotation) can be found [http://falcon4ever.pcsx2.net/kinect/logs/ here]. | *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]]''' - The current roadmap for the project (libfreenect, analysis library, and applications) | |||
* '''[[People]]''' - Who is doing what: project leader, maintainers, contributors etc. | |||
* '''[[History|Project History]]''' - The bounty, key dates and milestones | |||
* '''[[Policies|Project Policies]]''' - The official name of the project, license, contribution policy, developers coordination and decision making | |||
* '''[[Getting Started|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|Project Ideas]]''' - Ideas and concepts to explore using OpenKinect | |||
* '''[[Gallery|Gallery and websites]]''' - Videos and links to things people are doing with OpenKinect | |||
* '''[[Official_Logos|Official Logos]]''' - Official OpenKinect logos for use in your projects | |||
*Project | |||
* | |||
== 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 60: | 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_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 | * [[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 72: | 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 | ||
* [[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 86: | Line 86: | ||
'''OpenNI''' | '''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://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/openni - Open source framework for natural interaction devices | ||
* http://github.com/PrimeSense/Sensor - Open source driver for the PrimeSensor Development Kit | * http://github.com/PrimeSense/Sensor - Open source driver for the PrimeSensor Development Kit | ||
''' Tech ''' | ''' Tech ''' | ||
Line 101: | 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://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 | |||
* http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches - Linux contribution procedure | |||
* http:// | * http://git.kernel.org/?p=git/git.git;a=blob_plain;f=Documentation/SubmittingPatches;hb=HEAD - Git project contribution procedure | ||
* | |||
* | |||
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.
- Source code is available here: https://github.com/OpenKinect/libfreenect
- 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 meet people in your area working on OpenKinect through Meetup Groups:
- 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
- High Level - High-level API documentation
- Low Level - Low-level API documentation
Wrappers
- Python
- C Synchronous - Provides functions to get data instead of callbacks
- Actionscript
- C++
- C#
- Java JNI
- Java JNA
- Javascript
- Common Lisp - Getting started with libfreenect on Common Lisp
- GFreenect (GLib) - Use Freenect from GLib. Also provides GObject Introspection which means automatic bindings for many other languages (Python, Javascript, Vala)
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
- Protocol Documentation - Kinect USB procotol, structures and hardware control commands for the cameras, motor, LED and audio
- Reference design - US Patent Application "Depth mapping using projected patterns"
- NUI Camera DSP - Camera DSP, architecture, instruction set, firmware, and capabilities
- lsusb output - Device identifier output
- USB Devices - Overview of the hardware devices
- USB Protocol Information - Other information about the Kinect USB protocol
- Init Analysis - Messing with various init sequences
- Imaging Information - Information about the imaging data returned by the Kinect
- Research Material - Research material for software layer implementation
- Hardware_info - Hardware information
- Calibration - Gathering information for including calibration facilities
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
- http://www.ifixit.com/Teardown/Microsoft-Kinect-Teardown/4066/ - Hardware teardown. Chip info is here. (via adafruit)
- http://kinecthacks.net/kinect-pinout/ - Pinout info of the Kinect Sensor
- 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.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.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
- http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/SubmittingPatches - Linux contribution procedure
- http://git.kernel.org/?p=git/git.git;a=blob_plain;f=Documentation/SubmittingPatches;hb=HEAD - Git project contribution procedure