panda3d
SDK 1.10.15
Panda3D هو محرك ألعاب، وإطار عمل لعرض ثلاثي الأبعاد وتطوير الألعاب لبرامج Python وC++. Panda3D مفتوح المصدر ومجاني لأي غرض، بما في ذلك المشاريع التجارية، وذلك بفضل ترخيصه الليبرالي. لمعرفة المزيد حول قدرات Panda3D، قم بزيارة المعرض وقائمة الميزات. لمعرفة كيفية استخدام Panda3D، تحقق من موارد الوثائق. إذا واجهتك مشكلة، اطلب المساعدة من مجتمعنا النشط.
تم ترخيص Panda3D بموجب ترخيص BSD المعدل. راجع ملف الترخيص لمزيد من التفاصيل.
يمكن تنزيل أحدث إصدار من Panda3D SDK من هذه الصفحة. إذا كنت معتادًا على تثبيت حزم بايثون، يمكنك استخدام الأمر التالي:
pip install panda3dأسهل طريقة لتثبيت أحدث إصدار من تطوير Panda3D في تثبيت Python موجود هي استخدام الأمر التالي:
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3dإذا فشل هذا الأمر، فيرجى التأكد من تحديث إصدار النقطة لديك.
إذا كنت تفضل تثبيت SDK الكامل بجميع الأدوات، فيمكن الحصول على أحدث إصدارات التطوير من هذه الصفحة.
ويتم تحديثها تلقائيًا باستخدام أحدث إصدار من GitHub من Panda.
يمكنك إنشاء Panda3D باستخدام برنامج التحويل البرمجي Microsoft Visual C++ 2017 أو 2019 أو 2022، والذي يمكن تنزيله مجانًا من موقع Visual Studio. ستحتاج أيضًا إلى تثبيت Windows SDK، وإذا كنت تنوي استهداف Windows Vista، فستحتاج أيضًا إلى Windows 8.1 SDK.
ستحتاج أيضًا إلى مكتبات تبعية الطرف الثالث المتاحة لاستخدام البرامج النصية للإنشاء. تتوفر هذه من خلال أحد عنواني URL هذين، اعتمادًا على ما إذا كنت تستخدم نظام 32 بت أو 64 بت، أو يمكنك النقر هنا للحصول على إرشادات حول إنشائها من المصدر.
بعد الحصول على هذه التبعيات، يمكنك إنشاء Panda3D من موجه الأوامر باستخدام الأمر التالي. قم بتغيير خيار --msvc-version بناءً على إصدار Visual C++ الخاص بك؛ 2022 هو 14.3، 2019 هو 14.2، 2017 هو 14.1، و2015 هو 14. قم بإزالة الخيار --windows-sdk=10 إذا كنت بحاجة إلى دعم Windows Vista، الذي يتطلب Windows 8.1 SDK.
makepanda m akepanda.bat --everything --installer --msvc-version=14.3 --windows-sdk=10 --no-eigen --threads=2عندما ينجح البناء، سيتم إنتاج ملف .exe يمكنك استخدامه لتثبيت Panda3D على نظامك.
ملاحظة: يمكنك اختيار إزالة --no-eigen والإنشاء بدعم Eigen لتحسين أداء وقت التشغيل. ومع ذلك، سيؤدي هذا إلى أن يستغرق البناء ساعات حتى يكتمل، نظرًا لأن Eigen عبارة عن مكتبة تعتمد على القوالب بشكل كبير، ولا يعمل مترجم MSVC بشكل جيد في ظل هذه الظروف.
يعد إنشاء Panda3D على Linux أمرًا سهلاً. كل ما تحتاجه هو استدعاء البرنامج النصي makepanda باستخدام إصدار Python الذي تريد إنشاء Panda3D عليه.
قم بتشغيل 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 بدلاً من ذلك، والذي سينسخ الملفات مباشرة إلى المواقع المناسبة على جهاز الكمبيوتر الخاص بك. قد يتعين عليك تشغيل أداة ldconfig لتحديث ذاكرة التخزين المؤقت لمكتبتك بعد تثبيت Panda3D.
بدلًا من ذلك، يمكنك إضافة خيار --wheel ، الذي سينتج ملف .whl يمكن تثبيته في تثبيت Python باستخدام pip .
على نظام التشغيل macOS، ستحتاج إلى تنزيل مجموعة من حزم الجهات الخارجية المجمعة مسبقًا لتجميع Panda3D، والتي يمكن الحصول عليها من هنا.
بعد وضع دليل الطرف الثالث داخل الدليل المصدر panda3d، يمكنك إنشاء Panda3D باستخدام أمر مثل ما يلي:
python makepanda/makepanda.py --everything --installerيمكنك استهداف حد أدنى محدد لإصدار macOS باستخدام علامة --osxtarget متبوعة برقم الإصدار، على سبيل المثال. 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 ) وقم بتشغيل البرنامج النصي makepanda باستخدام إصدار Python الذي اخترته:
python3.11 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2 في حالة نجاح ذلك، سيؤدي ذلك إلى إنتاج ملف .pkg في جذر الدليل المصدر والذي يمكنك تثبيته باستخدام pkg install .
على الرغم من أنه من الممكن إنشاء Panda3D على جهاز Android باستخدام shell termux، إلا أن المسار الموصى به هو ترجمة ملفات .whl بشكل متبادل باستخدام SDK وNDK، والتي يمكن استخدامها بعد ذلك بواسطة أمر build_apps لإنشاء تطبيق Python إلى ملف .apk. أو حزمة aab. ستحتاج إلى الحصول على أحدث حزم الجهات الخارجية، والتي يمكن الحصول عليها من صفحة العناصر الخاصة بآخر تشغيل ناجح هنا:
https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
وهذا لا يشمل بايثون في الوقت الحالي، والتي يمكن استخراجها من هذا الأرشيف بدلاً من ذلك.
توضح هذه الأوامر كيفية تجميع العجلات لواجهات ABI المدعومة لنظام Android:
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 أو قم بزيارة صفحة الرعاة على موقع الويب الخاص بنا. شكرا لكل من تبرع!
