panda3d
SDK 1.10.15
Panda3D คือเอ็นจิ้นเกม ซึ่งเป็นเฟรมเวิร์กสำหรับการเรนเดอร์ 3D และการพัฒนาเกมสำหรับโปรแกรม Python และ C++ Panda3D เป็นโอเพ่นซอร์สและฟรีสำหรับวัตถุประสงค์ใดๆ รวมถึงการร่วมค้าเชิงพาณิชย์ด้วยใบอนุญาตเสรี หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับความสามารถของ Panda3D โปรดไปที่แกลเลอรีและรายการคุณสมบัติ หากต้องการเรียนรู้วิธีใช้ Panda3D โปรดตรวจสอบแหล่งข้อมูลเอกสารประกอบ หากคุณติดขัด ขอความช่วยเหลือจากชุมชนที่กระตือรือร้นของเรา
Panda3D ได้รับอนุญาตภายใต้ใบอนุญาต BSD ดัดแปลง ดูไฟล์ใบอนุญาตสำหรับรายละเอียดเพิ่มเติม
สามารถดาวน์โหลด Panda3D SDK ล่าสุดได้จากหน้านี้ หากคุณคุ้นเคยกับการติดตั้งแพ็คเกจ Python คุณสามารถใช้คำสั่งต่อไปนี้:
pip install panda3dวิธีที่ง่ายที่สุดในการติดตั้ง Build การพัฒนาล่าสุดของ Panda3D ลงในการติดตั้ง Python ที่มีอยู่คือการใช้คำสั่งต่อไปนี้:
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3dหากคำสั่งนี้ล้มเหลว โปรดตรวจสอบให้แน่ใจว่าเวอร์ชันของ pip เป็นเวอร์ชันล่าสุด
หากคุณต้องการติดตั้ง SDK แบบเต็มด้วยเครื่องมือทั้งหมด สามารถรับบิลด์การพัฒนาล่าสุดได้จากหน้านี้
สิ่งเหล่านี้จะได้รับการอัปเดตโดยอัตโนมัติด้วย Panda เวอร์ชัน GitHub ล่าสุด
คุณสามารถสร้าง 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 โดยใช้เชลล์ termux ได้ แต่เส้นทางที่แนะนำคือข้ามคอมไพล์ไฟล์ .whl โดยใช้ SDK และ NDK ซึ่งจากนั้นจะสามารถใช้โดยคำสั่ง 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 คุณจะต้องกำหนดค่าสภาพแวดล้อมของคุณโดยชี้ตัวแปร PYTHONPATH ไปที่ไดเร็กทอรี built บน Linux คุณจะต้องชี้ตัวแปร LD_LIBRARY_PATH ไปที่ไดเร็กทอรี built/lib
เพื่อความสะดวก คุณสามารถส่งตัวเลือก --tests ไปยัง makepanda ได้
หากคุณพบข้อบกพร่องใดๆ เมื่อใช้ Panda3D โปรดรายงานข้อบกพร่องเหล่านั้นในตัวติดตามข้อบกพร่อง งานนี้จัดขึ้นที่:
https://github.com/panda3d/panda3d/issues
ตรวจสอบให้แน่ใจว่าได้ใช้ฟังก์ชันการค้นหาก่อนเพื่อดูว่ามีการรายงานจุดบกพร่องหรือไม่ เมื่อกรอกรายงานข้อบกพร่อง ตรวจสอบให้แน่ใจว่าคุณได้ใส่ข้อมูลให้มากที่สุดเท่าที่จะเป็นไปได้เพื่อช่วยนักพัฒนาในการติดตามปัญหา เช่น เวอร์ชันของ Panda3D ระบบปฏิบัติการ สถาปัตยกรรม และโค้ดและโมเดลใด ๆ ที่จำเป็นสำหรับนักพัฒนา ทำให้เกิดปัญหาอีกครั้ง
หากคุณไม่แน่ใจว่าคุณพบข้อบกพร่องหรือไม่ โปรดสอบถามเกี่ยวกับข้อผิดพลาดดังกล่าวในฟอรัมหรือช่อง IRC ก่อน
หากคุณต้องการสนับสนุนโครงการทางการเงิน โปรดเยี่ยมชมแคมเปญของเราที่ OpenCollective การมีส่วนร่วมของคุณช่วยเราเร่งการพัฒนา Panda3D
สำหรับรายชื่อผู้สนับสนุน โปรดดูไฟล์ BACKERS.md หรือไปที่หน้าผู้สนับสนุนบนเว็บไซต์ของเรา ขอบคุณทุกคนที่บริจาค!
