Panda3D ist eine Spiele-Engine, ein Framework für 3D-Rendering und Spieleentwicklung für Python- und C++-Programme. Panda3D ist Open Source und dank seiner liberalen Lizenz für jeden Zweck, einschließlich kommerzieller Unternehmungen, kostenlos. Um mehr über die Fähigkeiten von Panda3D zu erfahren, besuchen Sie die Galerie und die Funktionsliste. Informationen zur Verwendung von Panda3D finden Sie in den Dokumentationsressourcen. Wenn Sie nicht weiterkommen, bitten Sie unsere aktive Community um Hilfe.
Panda3D ist unter der Modified BSD-Lizenz lizenziert. Weitere Einzelheiten finden Sie in der LICENSE-Datei.
Das neueste Panda3D SDK kann von dieser Seite heruntergeladen werden. Wenn Sie mit der Installation von Python-Paketen vertraut sind, können Sie den folgenden Befehl verwenden:
pip install panda3d
Der einfachste Weg, die neueste Entwicklungsversion von Panda3D in einer vorhandenen Python-Installation zu installieren, ist die Verwendung des folgenden Befehls:
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
Wenn dieser Befehl fehlschlägt, stellen Sie bitte sicher, dass Ihre Pip-Version aktuell ist.
Wenn Sie lieber das vollständige SDK mit allen Tools installieren möchten, können Sie die neuesten Entwicklungs-Builds auf dieser Seite abrufen.
Diese werden automatisch mit der neuesten GitHub-Version von Panda auf dem neuesten Stand gehalten.
Sie können Panda3D mit dem Compiler Microsoft Visual C++ 2017, 2019 oder 2022 erstellen, der kostenlos von der Visual Studio-Website heruntergeladen werden kann. Sie müssen außerdem das Windows SDK installieren. Wenn Sie Windows Vista als Ziel verwenden möchten, benötigen Sie außerdem das Windows 8.1 SDK.
Sie benötigen außerdem die Abhängigkeitsbibliotheken von Drittanbietern, die für die Verwendung durch die Build-Skripts verfügbar sind. Diese sind unter einer dieser beiden URLs verfügbar, je nachdem, ob Sie ein 32-Bit- oder 64-Bit-System verwenden, oder Sie können hier klicken, um Anweisungen zum Erstellen aus dem Quellcode zu erhalten.
Nachdem Sie diese Abhängigkeiten erworben haben, können Sie Panda3D über die Eingabeaufforderung mit dem folgenden Befehl erstellen. Ändern Sie die Option --msvc-version
basierend auf Ihrer Version von Visual C++; 2022 ist 14,3, 2019 ist 14,2, 2017 ist 14,1 und 2015 ist 14. Entfernen Sie die Option --windows-sdk=10
, wenn Sie Windows Vista unterstützen müssen, wofür das Windows 8.1 SDK erforderlich ist.
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2
Wenn der Build erfolgreich ist, wird eine EXE-Datei erstellt, mit der Sie Panda3D auf Ihrem System installieren können.
Hinweis: Sie können --no-eigen
entfernen und mit Eigen-Unterstützung erstellen, um die Laufzeitleistung zu verbessern. Dies führt jedoch dazu, dass der Build mehrere Stunden in Anspruch nehmen wird, da Eigen eine stark vorlagenbasierte Bibliothek ist und der MSVC-Compiler unter diesen Umständen keine gute Leistung erbringt.
Panda3D unter Linux zu erstellen ist einfach. Sie müssen lediglich das Makepanda-Skript mit der Python-Version aufrufen, auf der Panda3D erstellt werden soll.
Führen Sie makepanda.py mit der Option --help aus, um zu sehen, welche Optionen verfügbar sind. Normalerweise möchten Sie die Option --everything (die mit Unterstützung für alle Funktionen erstellt, für die sie die erforderlichen Abhängigkeiten erkennt) und die Option --installer (die eine installierbare .deb- oder .rpm-Datei erstellt, die Sie installieren können) angeben. abhängig von Ihrer Distribution).
Der folgende Befehl veranschaulicht, wie Panda3D mit einigen allgemeinen Optionen erstellt wird:
python3 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2 --no-opencv
Sie werden wahrscheinlich einige Warnungen sehen, die besagen, dass mehrere Abhängigkeitspakete nicht gefunden werden können. Sie sollten festlegen, welche Sie in Ihren Build einbeziehen möchten, und die entsprechenden Entwicklungspakete installieren. Sie können diese Handbuchseite besuchen, um einen Überblick über die verschiedenen Abhängigkeiten zu erhalten.
Wenn Sie Ubuntu verwenden, sollte dieser Befehl die am häufigsten verwendeten Pakete von Drittanbietern abdecken:
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
Sobald Panda3D erstellt wurde, können Sie entweder das erstellte .deb- oder .rpm-Paket installieren, je nachdem, welche Linux-Distribution Sie verwenden. Um das Paket beispielsweise unter Debian oder Ubuntu zu installieren, verwenden Sie Folgendes:
sudo dpkg -i panda3d * .deb
Wenn Sie keine Linux-Distribution verwenden, die .deb- oder .rpm-Pakete unterstützt, müssen Sie möglicherweise stattdessen das Skript installpanda.py verwenden, das die Dateien direkt an die entsprechenden Speicherorte auf Ihrem Computer kopiert. Möglicherweise müssen Sie das ldconfig
-Tool ausführen, um Ihren Bibliothekcache nach der Installation von Panda3D zu aktualisieren.
Alternativ können Sie die Option --wheel
hinzufügen, die eine .whl-Datei erstellt, die mit pip
in eine Python-Installation installiert werden kann.
Unter macOS müssen Sie zum Kompilieren von Panda3D eine Reihe vorkompilierter Drittanbieterpakete herunterladen, die Sie hier erwerben können.
Nachdem Sie das Thirdparty-Verzeichnis im Panda3d-Quellverzeichnis abgelegt haben, können Sie Panda3D mit einem Befehl wie dem folgenden erstellen:
python makepanda/makepanda.py --everything --installer
Sie können eine bestimmte macOS-Mindestversion als Ziel festlegen, indem Sie das Flag --osxtarget gefolgt von der Versionsnummer verwenden, z. B. 10.9 oder 10.14.
Wenn der Build erfolgreich war, hat makepanda im Quellverzeichnis eine .dmg-Datei generiert, die das Installationsprogramm enthält. Öffnen Sie es einfach und führen Sie die Paketdatei aus, um das SDK auf Ihrem System zu installieren.
Das Erstellen unter FreeBSD ist dem Erstellen unter Linux sehr ähnlich. Sie müssen die erforderlichen Pakete mit dem Systempaketmanager installieren. Um die empfohlenen Abhängigkeiten zu installieren, können Sie diesen Befehl verwenden:
pkg install pkgconf bison png jpeg-turbo tiff freetype2 harfbuzz eigen squish openal opusfile libvorbis libX11 mesa-libs ode bullet assimp openexr
Sie müssen außerdem auswählen, welche Version von Python Sie verwenden möchten. Installieren Sie das entsprechende Paket dafür (z. B. python37
oder python38
) und führen Sie das makepanda-Skript mit der von Ihnen gewählten Python-Version aus:
python3.11 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2
Bei Erfolg wird eine .pkg-Datei im Stammverzeichnis des Quellverzeichnisses erstellt, die Sie mit pkg install
installieren können.
Obwohl es möglich ist, Panda3D auf einem Android-Gerät mithilfe der Termux-Shell zu erstellen, besteht die empfohlene Route darin, .whl-Dateien mithilfe des SDK und NDK zu kompilieren, die dann vom Befehl build_apps
verwendet werden können, um eine Python-Anwendung in eine .apk zu erstellen oder .aab-Bundle. Sie benötigen die neuesten Drittanbieterpakete, die Sie hier auf der Artefaktseite des letzten erfolgreichen Laufs erhalten können:
https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
Dies beinhaltet derzeit nicht Python, das stattdessen aus diesem Archiv extrahiert werden kann.
Diese Befehle zeigen, wie Räder für die unterstützten Android-ABIs kompiliert werden:
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
Es ist nun möglich, die generierten Räder mit build_apps
zu verwenden, wie auf dieser Seite erklärt:
https://discourse.panda3d.org/t/deployment-for-android/28226
Installieren Sie PyTest und führen Sie den Befehl pytest
aus. Wenn Sie Panda3D nicht installiert haben, müssen Sie Ihre Umgebung konfigurieren, indem Sie die Variable PYTHONPATH
auf das built
Verzeichnis verweisen. Unter Linux müssen Sie außerdem die Variable LD_LIBRARY_PATH
auf das Verzeichnis built/lib
verweisen.
Der Einfachheit halber können Sie alternativ die Option --tests
an makepanda übergeben.
Wenn Sie bei der Verwendung von Panda3D auf Fehler stoßen, melden Sie diese bitte im Bug-Tracker. Dies wird gehostet bei:
https://github.com/panda3d/panda3d/issues
Nutzen Sie unbedingt zunächst die Suchfunktion, um zu prüfen, ob der Fehler bereits gemeldet wurde. Stellen Sie beim Ausfüllen eines Fehlerberichts sicher, dass Sie so viele Informationen wie möglich angeben, die den Entwicklern helfen, das Problem aufzuspüren, z. B. Ihre Version von Panda3D, Ihr Betriebssystem, Ihre Architektur sowie alle Codes und Modelle, die für die Entwickler erforderlich sind das Problem reproduzieren.
Wenn Sie nicht sicher sind, ob bei Ihnen ein Fehler aufgetreten ist, fragen Sie zunächst in den Foren oder im IRC-Kanal nach.
Wenn Sie das Projekt finanziell unterstützen möchten, besuchen Sie unsere Kampagne auf OpenCollective. Ihre Beiträge helfen uns, die Entwicklung von Panda3D zu beschleunigen.
Die Liste der Unterstützer finden Sie in der Datei BACKERS.md oder auf der Seite „Sponsoren“ auf unserer Website. Vielen Dank an alle, die gespendet haben!