Panda3D는 Python 및 C++ 프로그램용 3D 렌더링 및 게임 개발을 위한 프레임워크인 게임 엔진입니다. Panda3D는 자유 라이센스 덕분에 오픈 소스이며 상업적 벤처를 포함한 모든 목적에 대해 무료입니다. Panda3D의 기능에 대해 자세히 알아보려면 갤러리와 기능 목록을 방문하세요. Panda3D 사용 방법을 알아보려면 설명서 리소스를 확인하세요. 막히면 활동적인 커뮤니티에 도움을 요청하세요.
Panda3D는 수정된 BSD 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
최신 Panda3D SDK는 이 페이지에서 다운로드할 수 있습니다. Python 패키지 설치에 익숙하다면 다음 명령을 사용할 수 있습니다.
pip install panda3d
Panda3D의 최신 개발 빌드를 기존 Python 설치에 설치하는 가장 쉬운 방법은 다음 명령을 사용하는 것입니다.
pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
이 명령이 실패하면 pip 버전이 최신인지 확인하세요.
모든 도구가 포함된 전체 SDK를 설치하려는 경우 이 페이지에서 최신 개발 빌드를 얻을 수 있습니다.
이는 최신 GitHub 버전의 Panda를 통해 자동으로 최신 상태로 유지됩니다.
Visual Studio 사이트에서 무료로 다운로드할 수 있는 Microsoft Visual C++ 2017, 2019 또는 2022 컴파일러를 사용하여 Panda3D를 빌드할 수 있습니다. Windows SDK도 설치해야 하며, Windows Vista를 대상으로 하려면 Windows 8.1 SDK도 필요합니다.
또한 빌드 스크립트에서 사용할 수 있는 타사 종속성 라이브러리도 필요합니다. 이는 32비트 시스템인지 64비트 시스템인지에 따라 두 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 소스 디렉터리 내에 thirdparty 디렉터리를 배치한 후 다음과 같은 명령을 사용하여 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 install
사용하여 설치할 수 있는 소스 디렉터리의 루트에 .pkg 파일이 생성됩니다.
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에서는 또한 built/lib
디렉토리의 LD_LIBRARY_PATH
변수를 가리켜야 합니다.
편의상 --tests
옵션을 makepanda에 전달할 수도 있습니다.
Panda3D를 사용할 때 버그가 발생하면 버그 추적기에 보고해 주세요. 이것은 다음에서 호스팅됩니다:
https://github.com/panda3d/panda3d/issues
먼저 검색 기능을 사용하여 버그가 이미 보고되었는지 확인하세요. 버그 보고서를 작성할 때 Panda3D 버전, 운영 체제, 아키텍처, 개발자가 필요한 코드 및 모델 등 개발자가 문제를 추적하는 데 도움이 되는 정보를 최대한 많이 포함했는지 확인하세요. 문제를 재현해 보세요.
버그가 발생했는지 확실하지 않은 경우 먼저 포럼이나 IRC 채널에 문의해 보세요.
프로젝트를 재정적으로 지원하고 싶다면 OpenCollective 캠페인을 방문하세요. 귀하의 기여는 Panda3D 개발을 가속화하는 데 도움이 됩니다.
후원자 목록을 보려면 BACKERS.md 파일을 참조하거나 당사 웹사이트의 후원자 페이지를 방문하세요. 기부해주신 모든 분들께 감사드립니다!