libfreenect est un pilote d'espace utilisateur pour Microsoft Kinect. Il fonctionne sous Linux, OSX et Windows et prend en charge Remarque : Si vous avez le...

Dépôt créer le : 12/11/2010

Release du : 26/02/2026 libfreenect v0.6.4 Dwelling

Forks: 1166 Watcher: 0 3767

Github: https://github.com/OpenKinect/libfreenect

Ajouter à une sélection :

Connectez-vous pour gérer vos sélections.

libfrenect

libfreenect est un pilote d'espace utilisateur pour Microsoft Kinect. Il fonctionne sous Linux, OSX et Windows et prend en charge

Images RGB et Profondeur
Moteurs
Accéléromètre
LED
Audio

Remarque: Si vous avez le nouveau Kinect v2 (XBox One), utilisezOpenKinect/libfreenect2à la place.

Instructions de construction

Pour construire libfreenect, vous aurez besoin

libusb>= 1.0.18 (besoin de Windows >= 1.0.22)
CMake>= 3,12.4
python>= 2,7 ou >= 3,3 (seulement si BÂTIMENT PYTHON=ON ou BÂTIMENT PYTHON2=ON ou BÂTIMENT PYTHON3=ON ou BÂTIMENT REDIST PACKAGE=OFF)

Pour les exemples, vous aurez besoin

OpenGL (inclus avec OSX)
glut (inclus avec OSX)
pthreads-win32(Windows)

Récupération et construction

git clone https://github.com/OpenKinect/libfreenect
cd libfreenect
mkdir build
cd build
cmake -L .. # -L lists all the project options
make

# if you don't have `make` or don't want color output
# cmake --build .

Utilisez CMake options pour contrôler ce qui est construit. Par exemple, pour construire l'emballage Python (par défaut vers le système Python):

cmake .. -DBUILD_PYTHON=ON
make

Ou l'emballage Python 3 :

cmake .. -DBUILD_PYTHON3=ON
make

Vous pouvez spécifier une compilation avec des symboles de débogage:

cmake .. -DCMAKE_BUILD_TYPE=debug
# or with optimizations
# cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo

Vous pouvez construire des paquets .deb, .rpm et/ou .tgz aveccpack:

cmake .. -DBUILD_CPACK_DEB=ON -DBUILD_CPACK_RPM=ON -DBUILD_CPACK_TGZ=ON
cpack

Pour le support audio, vous devez télécharger le firmware sur l'appareil. Les nouveaux modèles Kinect peuvent nécessiter un micrologiciel audio pour le moteur et le support LED. La meilleure méthode est deinsert firmware at runtimejuste après avoir appeléfreenect_init().

Vous pouvez également télécharger automatiquement le firmware pour le modèle 1414 de Kinect en spécifiant :

cmake .. -DBUILD_REDIST_PACKAGE=OFF

Notez que le firmware peut ne pas être légal de redistribuer dans votre juridiction!

OSX

Si vous n'avez pas de gestionnaire de paquets, installezHomebrew. Pour une construction manuelle, voirthe wiki.

Bois de maison

brew install libfreenect
# or get the very latest:
# brew install --HEAD libfreenect

MacPorts

sudo port install git-core cmake libusb libtool

Continuer avecFetch & Build.

Linux

N'oubliez pas d'installer leudev rules. Pour une construction manuelle, voirthe wiki.

Ubuntu/Debian/Mint

La version emballée dans Ubuntu peut être très ancienne. Pour installer les nouvelles constructions emballées, voirthe wiki. Continuer avec cette section pour une construction manuelle.

sudo apt-get install git cmake build-essential libusb-1.0-0-dev

# only if you are building the examples:
sudo apt-get install freeglut3-dev libxmu-dev libxi-dev

Continuer avecFetch & Build.

Il y a aussi unedebian branchà des fins d'emballage.

Gentoo Linux

Il y adev-libs/libfreenectebuilds dans leoverboard repo.

Arche Linux

Il y a unelibfreenectPKGBUILD dans l'AUR. Par ailleurslibfreenect-gitPKGBUILD construit les plus récents.

Windows

Dès libusb 1.0.22,libusbK isochronous transferssont maintenant soutenues nativement. Il n'est plus nécessaire de compiler une version personnalisée de libusb.

UtilisationZadigpour installer le pilote libusbK pour chaque périphérique que vous souhaitez utiliser. SuivreFetch & Buildou utilisez les outils Github et CMake GUI. N'oubliez pas de fournir des chemins à CMake afin qu'il puisse trouver des dépendances. Par exemple:

cmake .. -DLIBUSB_1_INCLUDE_DIR="C:\path\to\libusb\include" -DLIBUSB_1_LIBRARY="C:\path\to\libusb\libusb.lib"

Enveloppes

Des interfaces vers différentes langues sont fournies danswrappers/. Les enveloppes ne sont pas garanties d'être stables API ou à jour.

C (en utilisant une API synchrone)
C++
C#
python
rubis
actionscript
Java (JNA)

Fakenect

En utilisant falsenect, vous pouvez enregistrer une session dans un répertoire et la lire plus tard.

mkdir session
fakenect-record ./session

Pour utiliser un flux enregistré falsenect, il suffit de fournir la lib falsenect comme bibliothèque préchargée avecLD_PRELOADet indique le répertoire des fichiers enregistrés avecFAKENECT_PATH.

Échantillon avec des enveloppes de python :

    LD_PRELOAD="/usr/local/lib/fakenect/libfakenect.so" FAKENECT_PATH="./session" python ./wrappers/python/demo_cv_sync.py

Échantillon avec bac en C :

    LD_PRELOAD="/usr/local/lib/fakenect/libfakenect.so" FAKENECT_PATH="./session" freenect-glview

Code Contributions

Par ordre d'importance:

Assurez-vous de signer commits:git commit -s
Utiliser unefeature branchdans votre propre fourche et maître cible avec des demandes de tirage
Indentation de l'onglet, pas d'espace blanc traînant

Mainteneurs

Développement et entretien continus par la communauté OpenKinect

http://www.openkinect.org

Code original et génie: Hector Martin (marcan)
Responsable de la collectivité : Josh Blake (JoshB)
Intégration: Kyle Machulis (qDot)

Licence

Le projet libfreenect est couvert par une double Apache v2/GPL v2 licence. Les critères d'octroi de licences sont énumérés ci-dessous, ainsi qu'à haut de chaque fichier source dans la repo.

This file is part of the OpenKinect Project. http://www.openkinect.org

Copyright (c) 2010 individual OpenKinect contributors. See the CONTRIB
file for details.

This code is licensed to you under the terms of the Apache License,
version 2.0, or, at your option, the terms of the GNU General Public
License, version 2.0. See the APACHE20 and GPL2 files for the text of
the licenses, or the following URLs:
http://www.apache.org/licenses/LICENSE-2.0
http://www.gnu.org/licenses/gpl-2.0.txt

If you redistribute this file in source form, modified or unmodified,
you may:

- Leave this header intact and distribute it under the same terms,
  accompanying it with the APACHE20 and GPL2 files, or
- Delete the Apache 2.0 clause and accompany it with the GPL2 file, or
- Delete the GPL v2 clause and accompany it with the APACHE20 file

In all cases you must keep the copyright notice intact and include a
copy of the CONTRIB file.

Binary distributions must follow the binary distribution requirements
of either License.

Informations supplémentaires

Des informations sur le projet OpenKinect sont disponibles à l'adresse http://www.openkinect.org

Pour les questions, le soutien et la discussion, consultez la liste de diffusion des groupes google à l'adresse http://groups.google.com/group/openkinect

Ou le canal IRC à #openkinect surFreenode

Nous sommes également sur twitter à l'adresse http://twitter.com/openkinect