Panda3D 是一個遊戲引擎,是一個用於 Python 和 C++ 程式的 3D 渲染和遊戲開發的框架。由於其寬鬆的許可證,Panda3D 是開源的,並且可以免費用於任何目的,包括商業企業。要了解有關 Panda3D 功能的更多信息,請訪問圖庫和功能列表。若要了解如何使用 Panda3D,請查看文件資源。如果您遇到困難,請向我們活躍的社區尋求協助。
Panda3D 根據修改版 BSD 授權取得許可。有關更多詳細信息,請參閱許可證文件。
可以從此頁面下載最新的Panda3D SDK。如果您熟悉安裝 Python 包,可以使用以下命令:
pip install panda3d
將 Panda3D 的最新開發版本安裝到現有 Python 安裝中的最簡單方法是使用以下命令:
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
如果此命令失敗,請確保您的 pip 版本是最新的。
如果您希望安裝包含所有工具的完整 SDK,可以從此頁面取得最新的開發版本。
這些會自動與最新的 GitHub 版本的 Panda 保持同步。
您可以使用 Microsoft Visual C++ 2017、2019 或 2022 編譯器建置 Panda3D,該編譯器可以從 Visual Studio 網站免費下載。您還需要安裝 Windows SDK,如果您打算針對 Windows Vista,則還需要 Windows 8.1 SDK。
您還需要可供建置腳本使用的第三方依賴函式庫。這些可以從這兩個 URL 之一獲得,具體取決於您使用的是 32 位元還是 64 位元系統,或者您可以按一下此處以取得有關從原始程式碼建立它們的說明。
取得這些依賴項後,您可以使用下列命令從命令提示字元建置 Panda3D。根據您的 Visual C++ 版本更改--msvc-version
選項; 2022 年是 14.3、2019 年是 14.2、2017 年是 14.1、2015 年是--windows-sdk=10
。
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2
建置成功後,它將產生一個 .exe 文件,您可以使用該文件在系統上安裝 Panda3D。
注意:您可以選擇刪除--no-eigen
並使用 Eigen 支援進行構建,以提高運行時效能。然而,這將導致建置需要幾個小時才能完成,因為 Eigen 是一個嚴重基於模板的函式庫,而 MSVC 編譯器在這些情況下表現不佳。
在 Linux 上建置 Panda3D 很容易。您所需要做的就是使用您希望建立 Panda3D 的 Python 版本來呼叫 makepanda 腳本。
使用 --help 選項執行 makepanda.py 以查看哪些選項可用。通常,您需要指定 --everything 選項(建置時支援偵測先決條件依賴項的所有功能)和 --installer 選項(產生可安裝的 .deb 或 .rpm 檔案供您安裝,取決於您的發行版)。
以下命令說明如何使用一些常見選項來建立 Panda3D:
python3 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2 --no-opencv
您可能會看到一些警告,指出無法找到多個依賴套件。您應該確定要在建置中包含哪些套件並安裝相應的開發包。您可以造訪此手冊頁以取得各種依賴項的概述。
如果您使用的是 Ubuntu,此命令應該涵蓋最常用的第三方軟體包:
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
建置 Panda3D 後,您可以安裝產生的 .deb 或 .rpm 軟體包,具體取決於您使用的 Linux 發行版。例如,要在 Debian 或 Ubuntu 上安裝該軟體包,請使用以下命令:
sudo dpkg -i panda3d * .deb
如果您使用的 Linux 發行版不支援 .deb 或 .rpm 軟體包,則可能必須使用 installpanda.py 腳本,該腳本會將檔案直接複製到電腦上的適當位置。安裝 Panda3D 後,您可能必須執行ldconfig
工具才能更新庫快取。
或者,您可以新增--wheel
選項,這將產生一個 .whl 文件,可以使用pip
將其安裝到 Python 安裝中。
在 macOS 上,您需要下載一組預先編譯的第三方套件才能編譯 Panda3D,可以從此處取得。
將第三方目錄放入 panda3d 來源目錄後,您可以使用以下指令建置 Panda3D:
python makepanda/makepanda.py --everything --installer
您可以使用 --osxtarget 標誌後面跟著版本號碼來定位特定的最低 macOS 版本,例如。 10.9 或 10.14。
如果建置成功,makepanda 將在包含安裝程式的來源目錄中產生一個 .dmg 檔案。只需打開它並運行套件檔案即可將 SDK 安裝到您的系統上。
在 FreeBSD 上建置與在 Linux 上建置非常相似。您將需要使用系統套件管理器安裝必需的套件。若要安裝建議的依賴項集,可以使用下列命令:
pkg install pkgconf bison png jpeg-turbo tiff freetype2 harfbuzz eigen squish openal opusfile libvorbis libX11 mesa-libs ode bullet assimp openexr
您還需要選擇要使用的 Python 版本。為其安裝適當的套件(例如python37
或python38
)並使用您選擇的 Python 版本運行 makepanda 腳本:
python3.11 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2
如果成功,這將在來源目錄的根目錄中產生一個 .pkg 文件,您可以使用pkg install
進行安裝。
雖然可以使用 termux shell 在 Android 裝置上建置 Panda3D,但建議的途徑是使用 SDK 和 NDK 交叉編譯 .whl 文件,然後build_apps
命令可以使用該文件將 Python 應用程式建置為 .apk或 .aab 捆綁包。您將需要取得最新的第三方軟體包,可以從此處上次成功運行的工件頁面取得:
https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
目前不包括 Python,可以從該檔案中提取 Python。
這些命令展示瞭如何為支援的 Android ABI 編譯wheel:
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
現在可以將產生的輪子與build_apps
一起使用,如本頁所述:
https://discourse.panda3d.org/t/deployment-for-android/28226
安裝 PyTest 並執行pytest
命令。如果您尚未安裝 Panda3D,則需要透過將PYTHONPATH
變數指向建置目錄來built
環境。在 Linux 上,您還需要將LD_LIBRARY_PATH
變數指向built/lib
目錄。
為了方便起見,您也可以將--tests
選項傳遞給 makepanda。
如果您在使用 Panda3D 時遇到任何錯誤,請在錯誤追蹤器中回報。這是託管在:
https://github.com/panda3d/panda3d/issues
確保首先使用搜尋功能查看該錯誤是否已被報告。填寫錯誤報告時,請確保包含盡可能多的信息以幫助開發人員追蹤問題,例如您的 Panda3D 版本、作業系統、架構以及開發人員所需的任何程式碼和模型。
如果您不確定是否遇到了錯誤,請先在論壇或 IRC 頻道中詢問。
如果您想在經濟上支持該項目,請造訪我們在 OpenCollective 上的活動。您的貢獻有助於我們加速 Panda3D 的發展。
有關支持者列表,請參閱 BACKERS.md 檔案或訪問我們網站上的贊助商頁面。感謝所有捐贈者!