Aspose.3D FOSS
Python
시작하기
설치

설치

Aspose.3D FOSS for Python 설치

Aspose.3D FOSS for Python은 PyPI에서 순수-Python 패키지로 배포됩니다. 컴파일할 네이티브 확장이 없으며, 설치할 시스템 라이브러리도 없고, Microsoft Office나 기타 서드파티 런타임도 필요하지 않습니다.

전제 조건

요구사항세부사항
Python 버전3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
패키지 관리자pip (CPython에 포함)
운영 체제Windows, macOS, Linux (CPython이 실행되는 모든 플랫폼)
컴파일러 / 빌드 도구필요 없음
시스템 패키지필요 없음

1. Install via pip (Recommended)

가장 간단한 Aspose.3D FOSS 설치 방법은 PyPI에서 직접 설치하는 것입니다:

pip install aspose-3d-foss

pip이 패키지를 다운로드하고 설치하며, 환경에 기록합니다. 설치 후 추가 설정이 필요하지 않습니다.

재현 가능한 빌드를 위해 고정된 버전을 설치하려면:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

가상 환경을 사용하면 라이브러리가 다른 Python 프로젝트와 격리되어 버전 충돌을 방지할 수 있습니다.

가상 환경을 생성하고 활성화합니다:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

활성화된 환경 안에 라이브러리를 설치합니다:

pip install aspose-3d-foss

재현성을 위해 의존성을 기록합니다:

pip freeze > requirements.txt

다른 머신에서 환경을 재구성하려면:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

설치 후, 라이브러리가 올바르게 임포트되는지 확인합니다:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

예상 출력:

Aspose.3D FOSS installed successfully
Root node name:

참고: 루트 노드에 기본 이름이 없습니다 — scene.root_node.name 빈 문자열을 반환합니다.

pip으로 설치된 버전을 확인할 수도 있습니다:

pip show aspose-3d-foss

이 명령은 버전, 저자 및 라이선스(MIT)를 출력합니다.

빠른 시작: 씬을 로드하고 검사하기

다음 스크립트는 3D 파일을 로드하고, 각 메시 노드에 대한 정보를 출력하며, 씬을 GLB 형식으로 다시 내보냅니다:

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False

scene = Scene()
scene.open("model.obj", options)

##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")

for node in scene.root_node.child_nodes:
    if node.entity is None:
        continue
    mesh = node.entity
    print(f"  Node: {node.name}")
    print(f"    Vertices: {len(mesh.control_points)}")
    print(f"    Polygons: {len(mesh.polygons)}")
    if node.material:
        print(f"    Material: {type(node.material).__name__}")

##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")

아직 OBJ 파일이 없으시다면, 라이브러리를 사용해 처음부터 씬을 생성할 수도 있습니다:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

플랫폼 참고사항

Windows, macOS, Linux: 라이브러리는 모든 플랫폼에서 동일합니다. 플랫폼별 코드 경로나 바이너리 확장이 없습니다.

Docker / 서버리스: 시스템 패키지 의존성이 없기 때문에, 이 라이브러리는 슬림 Docker 이미지(예: python:3.12-slim) 추가적인 apt 또는 yum 패키지를 설치하지 않고도 작동합니다.

CI/CD: 추가 pip install aspose-3d-foss CI 파이프라인의 의존성 단계에. 추가 설정이 필요하지 않습니다.

Conda: 프로젝트가 Conda를 사용한다면, Conda 환경 내에서 PyPI에서 라이브러리를 설치하세요:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

추가 자료

 한국어