Panda3D

Panda3D是一个游戏引擎，是为Python和C++程序提供3D渲染和游戏开发的框架。得益于其宽松的许可证，Panda3D是开源的，可以免费用于任何目的，包括商业项目。要了解Panda3D的功能，请访问画廊和功能列表。要学习如何使用Panda3D，请查看文档资源。如果遇到困难，可以向我们活跃的社区寻求帮助。

Panda3D采用修改后的BSD许可证。更多详情请参阅LICENSE文件。

安装Panda3D

最新的Panda3D SDK可以从此页面下载。如果你熟悉安装Python包，可以使用以下命令：

pip install panda3d

将最新的Panda3D开发版本安装到现有Python环境中的最简单方法是使用以下命令：

pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d

如果此命令失败，请确保你的pip版本是最新的。

如果你更喜欢安装包含所有工具的完整SDK，可以从此页面获取最新的开发版本。

这些版本会自动与GitHub上的最新Panda版本保持同步。

构建Panda3D

Windows

你可以使用Microsoft Visual C++ 2015、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是14。如果你需要支持Windows Vista，请移除--windows-sdk=10选项，因为Vista需要Windows 8.1 SDK。

makepanda\makepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2

构建成功后，它将生成一个.exe文件，你可以用它在系统上安装Panda3D。

**注意：**你可以选择移除--no-eigen并构建带有Eigen支持的版本，以提高运行时性能。但是，这将导致构建过程需要数小时才能完成，因为Eigen是一个大量使用模板的库，而MSVC编译器在这种情况下性能不佳。

Linux

在Linux上构建Panda3D很简单。你只需要使用你想要Panda3D构建针对的Python版本来调用makepanda脚本。

运行makepanda.py时加上--help选项，可以查看有哪些可用选项。通常，你会想要指定--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

在macOS上，你需要下载一组预编译的第三方包来编译Panda3D，可以从这里获取。

将thirdparty目录放置在panda3d源目录内后，你可以使用类似以下的命令构建Panda3D：

python makepanda/makepanda.py --everything --installer

你可以使用--osxtarget标志后跟版本号（例如10.9或10.14）来针对特定的最低macOS版本。

如果构建成功，makepanda将在源目录中生成一个包含安装程序的.dmg文件。只需打开它并运行包文件，即可将SDK安装到你的系统上。

FreeBSD

在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.7 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2

如果成功，这将在源目录的根目录下生成一个.pkg文件，你可以使用pkg install安装它。

Android

虽然可以使用termuxshell在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