Panda3D est un moteur de jeu, un framework de rendu 3D et de développement de jeux pour les programmes Python et C++. Panda3D est open source et gratuit pour tout usage, y compris les entreprises commerciales, grâce à sa licence libérale. Pour en savoir plus sur les capacités de Panda3D, visitez la galerie et la liste des fonctionnalités. Pour savoir comment utiliser Panda3D, consultez les ressources de documentation. Si vous êtes bloqué, demandez de l'aide à notre communauté active.
Panda3D est sous licence BSD modifiée. Voir le fichier LICENSE pour plus de détails.
Le dernier SDK Panda3D peut être téléchargé à partir de cette page. Si vous êtes habitué à installer des packages Python, vous pouvez utiliser la commande suivante :
pip install panda3d
Le moyen le plus simple d'installer la dernière version de développement de Panda3D dans une installation Python existante consiste à utiliser la commande suivante :
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
Si cette commande échoue, assurez-vous que votre version de pip est à jour.
Si vous préférez installer le SDK complet avec tous les outils, les dernières versions de développement peuvent être obtenues à partir de cette page.
Ceux-ci sont automatiquement mis à jour avec la dernière version GitHub de Panda.
Vous pouvez créer Panda3D avec le compilateur Microsoft Visual C++ 2017, 2019 ou 2022, téléchargeable gratuitement depuis le site Visual Studio. Vous devrez également installer le SDK Windows, et si vous avez l'intention de cibler Windows Vista, vous aurez également besoin du SDK Windows 8.1.
Vous aurez également besoin des bibliothèques de dépendances tierces disponibles pour les scripts de build à utiliser. Ceux-ci sont disponibles à partir de l'une de ces deux URL, selon que vous utilisez un système 32 bits ou 64 bits, ou vous pouvez cliquer ici pour obtenir des instructions sur la façon de les créer à partir des sources.
Après avoir acquis ces dépendances, vous pouvez créer Panda3D à partir de l'invite de commande à l'aide de la commande suivante. Modifiez l'option --msvc-version
en fonction de votre version de Visual C++ ; 2022 correspond à 14,3, 2019 correspond à 14,2, 2017 correspond à 14,1 et 2015 correspond à 14. Supprimez l'option --windows-sdk=10
si vous devez prendre en charge Windows Vista, qui nécessite le SDK Windows 8.1.
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2
Une fois la construction réussie, elle produira un fichier .exe que vous pourrez utiliser pour installer Panda3D sur votre système.
Remarque : vous pouvez choisir de supprimer --no-eigen
et de créer avec le support Eigen afin d'améliorer les performances d'exécution. Cependant, cela entraînera des heures de construction, car Eigen est une bibliothèque fortement basée sur des modèles et le compilateur MSVC ne fonctionne pas bien dans ces circonstances.
Construire Panda3D sur Linux est simple. Tout ce dont vous avez besoin est d'appeler le script makepanda en utilisant la version de Python avec laquelle vous souhaitez que Panda3D soit construit.
Exécutez makepanda.py avec l'option --help pour voir quelles options sont disponibles. Habituellement, vous souhaiterez spécifier l'option --everything (qui prend en charge toutes les fonctionnalités pour lesquelles elle détecte les dépendances préalables) et l'option --installer (qui produit un fichier .deb ou .rpm installable que vous pouvez installer, selon votre distribution).
La commande suivante illustre comment créer Panda3D avec quelques options courantes :
python3 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2 --no-opencv
Vous verrez probablement des avertissements indiquant qu'il est impossible de trouver plusieurs packages de dépendances. Vous devez déterminer ceux que vous souhaitez inclure dans votre build et installer les packages de développement respectifs. Vous pouvez visiter cette page de manuel pour un aperçu des différentes dépendances.
Si vous utilisez Ubuntu, cette commande devrait couvrir les packages tiers les plus fréquemment utilisés :
sudo apt-get install build-essential pkg-config fakeroot python3-dev libpng-dev libjpeg-dev libtiff-dev zlib1g-dev libssl-dev libx11-dev libgl1-mesa-dev libxrandr-dev libxxf86dga-dev libxcursor-dev bison flex libfreetype6-dev libvorbis-dev libeigen3-dev libopenal-dev libode-dev libbullet-dev nvidia-cg-toolkit libgtk-3-dev libassimp-dev libopenexr-dev
Une fois Panda3D construit, vous pouvez installer le package .deb ou .rpm produit, selon la distribution Linux que vous utilisez. Par exemple, pour installer le package sur Debian ou Ubuntu, utilisez ceci :
sudo dpkg -i panda3d * .deb
Si vous n'utilisez pas une distribution Linux prenant en charge les packages .deb ou .rpm, vous devrez peut-être utiliser le script installpanda.py à la place, qui copiera directement les fichiers dans les emplacements appropriés sur votre ordinateur. Vous devrez peut-être exécuter l'outil ldconfig
afin de mettre à jour le cache de votre bibliothèque après l'installation de Panda3D.
Alternativement, vous pouvez ajouter l'option --wheel
, qui produira un fichier .whl pouvant être installé dans une installation Python à l'aide de pip
.
Sur macOS, vous devrez télécharger un ensemble de packages tiers précompilés afin de compiler Panda3D, qui peuvent être acquis à partir d'ici.
Après avoir placé le répertoire tiers dans le répertoire source de panda3d, vous pouvez construire Panda3D à l'aide d'une commande comme la suivante :
python makepanda/makepanda.py --everything --installer
Vous pouvez cibler une version minimale spécifique de macOS en utilisant l'indicateur --osxtarget suivi du numéro de version, par exemple. 10.9 ou 10.14.
Si la construction a réussi, makepanda aura généré un fichier .dmg dans le répertoire source contenant le programme d'installation. Ouvrez-le simplement et exécutez le fichier du package afin d'installer le SDK sur votre système.
Construire sur FreeBSD est très similaire à construire sur Linux. Vous devrez installer les packages requis à l'aide du gestionnaire de packages système. Pour installer l'ensemble de dépendances recommandé, vous pouvez utiliser cette commande :
pkg install pkgconf bison png jpeg-turbo tiff freetype2 harfbuzz eigen squish openal opusfile libvorbis libX11 mesa-libs ode bullet assimp openexr
Vous devrez également choisir la version de Python que vous souhaitez utiliser. Installez le package approprié (tel que python37
ou python38
) et exécutez le script makepanda avec la version Python de votre choix :
python3.11 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2
En cas de succès, cela produira un fichier .pkg à la racine du répertoire source que vous pourrez installer à l'aide de pkg install
.
Bien qu'il soit possible de créer Panda3D sur un appareil Android à l'aide du shell termux, la méthode recommandée consiste à compiler de manière croisée les fichiers .whl à l'aide du SDK et du NDK, qui peuvent ensuite être utilisés par la commande build_apps
pour créer une application Python dans un .apk. ou un paquet .aab. Vous devrez obtenir les derniers packages tiers, qui peuvent être obtenus à partir de la page des artefacts de la dernière exécution réussie ici :
https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
Cela n'inclut pas Python pour le moment, qui peut être extrait de cette archive.
Ces commandes montrent comment compiler des roues pour les ABI Android pris en charge :
export ANDROID_SDK_ROOT=/home/rdb/local/android
python3.8 makepanda/makepanda.py --everything --outputdir built-droid-arm64 --arch arm64 --target android-21 --threads 6 --wheel
python3.8 makepanda/makepanda.py --everything --outputdir built-droid-armv7a --arch armv7a --target android-19 --threads 6 --wheel
python3.8 makepanda/makepanda.py --everything --outputdir built-droid-x86_64 --arch x86_64 --target android-21 --threads 6 --wheel
python3.8 makepanda/makepanda.py --everything --outputdir built-droid-x86 --arch x86 --target android-19 --threads 6 --wheel
Il est désormais possible d'utiliser les roues générées avec build_apps
, comme expliqué sur cette page :
https://discourse.panda3d.org/t/deployment-for-android/28226
Installez PyTest et exécutez la commande pytest
. Si vous n'avez pas installé Panda3D, vous devrez configurer votre environnement en pointant la variable PYTHONPATH
sur le répertoire built
. Sous Linux, vous devrez également pointer la variable LD_LIBRARY_PATH
vers le répertoire built/lib
.
Pour plus de commodité, vous pouvez également transmettre l'option --tests
à makepanda.
Si vous rencontrez des bugs lors de l'utilisation de Panda3D, veuillez les signaler dans le suivi des bugs. Celui-ci est hébergé chez :
https://github.com/panda3d/panda3d/issues
Assurez-vous d'utiliser d'abord la fonction de recherche pour voir si le bug a déjà été signalé. Lorsque vous remplissez un rapport de bogue, assurez-vous d'inclure autant d'informations que possible pour aider les développeurs à localiser le problème, telles que votre version de Panda3D, votre système d'exploitation, votre architecture, ainsi que tout code et modèle nécessaires aux développeurs. reproduire le problème.
Si vous n'êtes pas sûr d'avoir rencontré un bug, n'hésitez pas à le poser d'abord sur les forums ou sur le canal IRC.
Si vous souhaitez soutenir financièrement le projet, visitez notre campagne sur OpenCollective. Vos contributions nous aident à accélérer le développement de Panda3D.
Pour la liste des contributeurs, consultez le fichier BACKERS.md ou visitez la page Sponsors de notre site Web. Merci à tous ceux qui ont fait un don !