Panda3D は、ゲーム エンジンであり、Python および C++ プログラム用の 3D レンダリングおよびゲーム開発用のフレームワークです。 Panda3D はオープンソースであり、自由ライセンスのおかげで、商業ベンチャーを含むあらゆる目的に無料で使用できます。 Panda3D の機能の詳細については、ギャラリーと機能リストをご覧ください。 Panda3D の使用方法については、ドキュメント リソースを確認してください。行き詰まった場合は、アクティブなコミュニティに助けを求めてください。
Panda3D は、Modified BSD License に基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。
最新の Panda3D SDK はこのページからダウンロードできます。 Python パッケージのインストールに慣れている場合は、次のコマンドを使用できます。
pip install panda3d
Panda3D の最新の開発ビルドを既存の Python インストールにインストールする最も簡単な方法は、次のコマンドを使用することです。
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
このコマンドが失敗した場合は、pip のバージョンが最新であることを確認してください。
すべてのツールを含む完全な SDK をインストールしたい場合は、このページから最新の開発ビルドを入手できます。
これらは、Panda の最新の GitHub バージョンで自動的に最新に保たれます。
Panda3D は、Visual Studio サイトから無料でダウンロードできる Microsoft Visual C++ 2017、2019、または 2022 コンパイラーを使用して構築できます。 Windows SDK もインストールする必要があります。また、Windows Vista を対象とする場合は、Windows 8.1 SDK も必要になります。
ビルド スクリプトで使用できるサードパーティの依存関係ライブラリも必要になります。これらは、32 ビット システムと 64 ビット システムのどちらを使用しているかに応じて、これら 2 つの URL のいずれかから入手できます。また、ソースからビルドする手順については、ここをクリックしてください。
これらの依存関係を取得したら、次のコマンドを使用してコマンド プロンプトから Panda3D をビルドできます。 Visual C++ のバージョンに基づいて--msvc-version
オプションを変更します。 2022 は 14.3、2019 は 14.2、2017 は 14.1、2015 は 14 です。Windows 8.1 SDK を必要とする Windows Vista をサポートする必要がある場合は、 --windows-sdk=10
オプションを削除します。
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2
ビルドが成功すると、システムに Panda3D をインストールするために使用できる .exe ファイルが生成されます。
注:実行時のパフォーマンスを向上させるために、 --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 がビルドされたら、使用している Linux ディストリビューションに応じて、生成された .deb または .rpm パッケージをインストールできます。たとえば、Debian または Ubuntu にパッケージをインストールするには、これを使用します。
sudo dpkg -i panda3d * .deb
.deb または .rpm パッケージをサポートする Linux ディストリビューションを使用していない場合は、代わりに installpanda.py スクリプトを使用する必要がある場合があります。これにより、ファイルがコンピュータ上の適切な場所に直接コピーされます。 Panda3D のインストール後にライブラリ キャッシュを更新するには、 ldconfig
ツールを実行する必要がある場合があります。
あるいは、 --wheel
オプションを追加すると、 pip
使用して Python インストールにインストールできる .whl ファイルが生成されます。
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 シェルを使用して 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 は含まれていませんが、代わりにこのアーカイブから抽出できます。
これらのコマンドは、サポートされている Android ABI 用にホイールをコンパイルする方法を示しています。
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 をインストールしていない場合は、 built
ディレクトリにPYTHONPATH
変数を指定して環境を構成する必要があります。 Linux では、 LD_LIBRARY_PATH
変数がbuilt/lib
ディレクトリを指すようにする必要もあります。
便宜上、 --tests
オプションを makepanda に渡すこともできます。
Panda3D の使用中にバグが発生した場合は、バグ トラッカーで報告してください。これは次の場所でホストされています。
https://github.com/panda3d/panda3d/issues
まず検索機能を使用して、バグがすでに報告されているかどうかを確認してください。バグ レポートに記入するときは、Panda3D のバージョン、オペレーティング システム、アーキテクチャ、開発者が問題を解決するために必要なコードやモデルなど、開発者が問題を追跡できるようにできる限り多くの情報を含めるようにしてください。問題を再現します。
バグに遭遇したかどうかわからない場合は、まずフォーラムまたは IRC チャネルでお気軽に質問してください。
プロジェクトを財政的に支援したい場合は、OpenCollective のキャンペーンにアクセスしてください。あなたの貢献は、Panda3D の開発を加速するのに役立ちます。
バッカーのリストについては、BACKERS.md ファイルを参照するか、Web サイトのスポンサー ページにアクセスしてください。寄付してくださった皆様、ありがとうございました!