Panda3D adalah mesin permainan, kerangka kerja untuk rendering 3D dan pengembangan game untuk program Python dan C++. Panda3D bersifat open-source dan gratis untuk tujuan apa pun, termasuk usaha komersial, berkat lisensi liberalnya. Untuk mempelajari lebih lanjut tentang kemampuan Panda3D, kunjungi galeri dan daftar fitur. Untuk mempelajari cara menggunakan Panda3D, periksa sumber dokumentasi. Jika Anda mengalami kebuntuan, mintalah bantuan dari komunitas aktif kami.
Panda3D dilisensikan di bawah Lisensi BSD yang Dimodifikasi. Lihat file LISENSI untuk lebih jelasnya.
SDK Panda3D terbaru dapat diunduh dari halaman ini. Jika Anda terbiasa menginstal paket Python, Anda dapat menggunakan perintah berikut:
pip install panda3d
Cara termudah untuk menginstal versi pengembangan terbaru Panda3D ke dalam instalasi Python yang sudah ada adalah menggunakan perintah berikut:
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
Jika perintah ini gagal, pastikan versi pip Anda mutakhir.
Jika Anda lebih suka menginstal SDK lengkap dengan semua alat, versi pengembangan terbaru dapat diperoleh dari halaman ini.
Ini secara otomatis selalu diperbarui dengan Panda versi GitHub terbaru.
Anda dapat membangun Panda3D dengan compiler Microsoft Visual C++ 2017, 2019 atau 2022, yang dapat diunduh secara gratis dari situs Visual Studio. Anda juga perlu menginstal Windows SDK, dan jika Anda ingin menargetkan Windows Vista, Anda juga memerlukan Windows 8.1 SDK.
Anda juga memerlukan pustaka ketergantungan pihak ketiga yang tersedia agar skrip build dapat digunakan. Ini tersedia dari salah satu dari dua URL ini, tergantung pada apakah Anda menggunakan sistem 32-bit atau 64-bit, atau Anda dapat mengklik di sini untuk petunjuk cara membuatnya dari sumber.
Setelah memperoleh dependensi ini, Anda dapat membangun Panda3D dari command prompt menggunakan perintah berikut. Ubah opsi --msvc-version
berdasarkan versi Visual C++ Anda; 2022 adalah 14.3, 2019 adalah 14.2, 2017 adalah 14.1, dan 2015 adalah 14. Hapus opsi --windows-sdk=10
jika Anda perlu mendukung Windows Vista, yang memerlukan SDK Windows 8.1.
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2
Ketika build berhasil, file .exe akan dihasilkan yang dapat Anda gunakan untuk menginstal Panda3D di sistem Anda.
Catatan: Anda dapat memilih untuk menghapus --no-eigen
dan membangun dengan dukungan Eigen untuk meningkatkan kinerja runtime. Namun, hal ini akan menyebabkan pembangunan memakan waktu berjam-jam untuk diselesaikan, karena Eigen adalah perpustakaan yang sangat berbasis templat, dan kompiler MSVC tidak bekerja dengan baik dalam kondisi seperti itu.
Membangun Panda3D di Linux itu mudah. Yang Anda butuhkan hanyalah menjalankan skrip makepanda menggunakan versi Python yang Anda inginkan untuk membuat Panda3D.
Jalankan makepanda.py dengan opsi --help untuk melihat opsi mana yang tersedia. Biasanya, Anda ingin menentukan opsi --everything (yang dibangun dengan dukungan untuk semua fitur yang dependensi prasyaratnya terdeteksi) dan opsi --installer (yang menghasilkan file .deb atau .rpm yang dapat diinstal untuk Anda instal, tergantung pada distribusi Anda).
Perintah berikut mengilustrasikan cara membuat Panda3D dengan beberapa opsi umum:
python3 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2 --no-opencv
Anda mungkin akan melihat beberapa peringatan yang mengatakan bahwa ia tidak dapat menemukan beberapa paket ketergantungan. Anda harus menentukan mana yang ingin Anda sertakan dalam build Anda dan menginstal paket pengembangan masing-masing. Anda dapat mengunjungi halaman manual ini untuk ikhtisar berbagai dependensi.
Jika Anda menggunakan Ubuntu, perintah ini harus mencakup paket pihak ketiga yang paling sering digunakan:
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
Setelah Panda3D dibuat, Anda dapat menginstal paket .deb atau .rpm yang dihasilkan, bergantung pada distribusi Linux yang Anda gunakan. Misalnya, untuk menginstal paket di Debian atau Ubuntu, gunakan ini:
sudo dpkg -i panda3d * .deb
Jika Anda tidak menggunakan distribusi Linux yang mendukung paket .deb atau .rpm, Anda mungkin harus menggunakan skrip installpanda.py, yang akan langsung menyalin file ke lokasi yang sesuai di komputer Anda. Anda mungkin harus menjalankan alat ldconfig
untuk memperbarui cache perpustakaan Anda setelah menginstal Panda3D.
Alternatifnya, Anda dapat menambahkan opsi --wheel
, yang akan menghasilkan file .whl yang dapat diinstal ke dalam instalasi Python menggunakan pip
.
Di macOS, Anda perlu mengunduh sekumpulan paket pihak ketiga yang telah dikompilasi sebelumnya untuk mengkompilasi Panda3D, yang dapat diperoleh dari sini.
Setelah menempatkan direktori pihak ketiga di dalam direktori sumber panda3d, Anda dapat membuat Panda3D menggunakan perintah seperti berikut:
python makepanda/makepanda.py --everything --installer
Anda dapat menargetkan versi macOS minimum tertentu menggunakan tanda --osxtarget diikuti dengan nomor rilis, misalnya. 10.9 atau 10.14.
Jika pembangunan berhasil, makepanda akan menghasilkan file .dmg di direktori sumber yang berisi penginstal. Cukup buka dan jalankan file paket untuk menginstal SDK ke sistem Anda.
Membangun di FreeBSD sangat mirip dengan membangun di Linux. Anda perlu menginstal paket yang diperlukan menggunakan manajer paket sistem. Untuk menginstal kumpulan dependensi yang disarankan, Anda dapat menggunakan perintah ini:
pkg install pkgconf bison png jpeg-turbo tiff freetype2 harfbuzz eigen squish openal opusfile libvorbis libX11 mesa-libs ode bullet assimp openexr
Anda juga harus memilih versi Python mana yang ingin Anda gunakan. Instal paket yang sesuai untuknya (seperti python37
atau python38
) dan jalankan skrip makepanda dengan versi Python pilihan Anda:
python3.11 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2
Jika berhasil, ini akan menghasilkan file .pkg di root direktori sumber yang dapat Anda instal menggunakan pkg install
.
Meskipun dimungkinkan untuk membangun Panda3D pada perangkat Android menggunakan shell termux, rute yang disarankan adalah mengkompilasi silang file .whl menggunakan SDK dan NDK, yang kemudian dapat digunakan oleh perintah build_apps
untuk membangun aplikasi Python menjadi .apk atau bundel .aab. Anda perlu mendapatkan paket pihak ketiga terbaru, yang dapat diperoleh dari halaman artefak yang terakhir kali berhasil dijalankan di sini:
https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
Ini tidak termasuk Python saat ini, yang dapat diekstraksi dari arsip ini.
Perintah berikut menunjukkan cara mengkompilasi wheel untuk ABI Android yang didukung:
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
Sekarang dimungkinkan untuk menggunakan roda yang dihasilkan dengan build_apps
, seperti yang dijelaskan di halaman ini:
https://discourse.panda3d.org/t/deployment-for-android/28226
Instal PyTest dan jalankan perintah pytest
. Jika Anda belum menginstal Panda3D, Anda perlu mengkonfigurasi lingkungan Anda dengan mengarahkan variabel PYTHONPATH
ke direktori built
. Di Linux, Anda juga perlu mengarahkan variabel LD_LIBRARY_PATH
ke direktori built/lib
.
Untuk memudahkan, Anda dapat meneruskan opsi --tests
ke makepanda.
Jika Anda menemukan bug saat menggunakan Panda3D, harap laporkan di pelacak bug. Ini diselenggarakan di:
https://github.com/panda3d/panda3d/issues
Pastikan untuk menggunakan fungsi pencarian terlebih dahulu untuk melihat apakah bug telah dilaporkan. Saat mengisi laporan bug, pastikan Anda menyertakan informasi sebanyak mungkin untuk membantu pengembang melacak masalahnya, seperti versi Panda3D Anda, sistem operasi, arsitektur, dan kode serta model apa pun yang diperlukan pengembang untuk melakukannya. mereproduksi masalah tersebut.
Jika Anda tidak yakin apakah Anda menemukan bug, silakan menanyakannya di forum atau saluran IRC terlebih dahulu.
Jika Anda ingin mendukung proyek ini secara finansial, kunjungi kampanye kami di OpenCollective. Kontribusi Anda membantu kami mempercepat pengembangan Panda3D.
Untuk daftar pendukung, lihat file BACKERS.md atau kunjungi halaman Sponsor di situs web kami. Terima kasih kepada semua orang yang telah berdonasi!