Aspose.3D FOSS 용 Python
Python에서 3D 씬을 로드, 생성, 변환 및 내보내기 — 무료이며 오픈소스.
3D 파일 처리를 위한 오픈소스 Python 라이브러리
Aspose.3D FOSS for Python은 MIT 라이선스를 가진 순수-Python 라이브러리로, 3D 파일 형식을 다루기 위해 설계되었습니다. 단일 pip 명령으로 설치하고 네이티브 런타임, 외부 SDK, 서드파티 렌더러를 설치하지 않고도 즉시 3D 씬을 읽고, 구성하고, 작성할 수 있습니다.
라이브러리는 Scene, Node, Mesh, Camera, Light, Transform를 중심으로 구축된 깔끔한 씬-그래프 API를 제공하며, 이는 전문 3D 도구에서 사용되는 동일한 개념 모델입니다. 포맷 지원에는 OBJ(.mtl 재질 로딩 포함), STL(바이너리 및 ASCII, 라운드트립 검증됨), glTF 2.0 / GLB(PBR 재질), COLLADA(DAE), 3MF 및 FBX가 포함됩니다. 포맷별 로드 및 저장 옵션을 통해 좌표 플리핑, 스케일, 노멀 정규화 및 재질 로딩을 포맷 전용 파싱 코드를 작성하지 않고 제어할 수 있습니다.
Aspose.3D FOSS는 Python 3.7부터 3.12까지 지원하며 Windows, macOS 및 Linux CI 러너, Docker 컨테이너, 서버리스 환경에서 동일하게 실행됩니다. 엔터프라이즈 기능 및 지원은 Aspose.3D for Python — Enterprise Product을(를) 참조하십시오.
3D 포맷 지원 및 씬 그래프 API
- OBJ / MTL: Wavefront OBJ 파일을 로드하고 해당 재질 정의를 함께 불러옵니다.
- STL: 바이너리와 ASCII STL을 모두 읽고 쓰며 전체 라운드트립 검증을 수행합니다.
- glTF 2.0 / GLB: PBR 재질 로딩 및 바이너리 GLB 출력 via
GltfSaveOptions. - COLLADA, 3MF, FBX: 형식별 옵션 클래스를 통한 추가 형식 지원.
- Scene-graph API:
Scene,Node,Mesh,Camera,Light,Transform.
Where Aspose.3D FOSS가 사용될 수 있는 곳
- 자산 검증 파이프라인: CI에서 3D 자산을 확인하고, 방향을 재조정하고, 다시 내보냅니다.
- 게임 개발 도구: 네이티브 엔진 없이 OBJ/GLB 메쉬를 일괄 처리합니다.
- 3D 프린팅 워크플로우: STL 및 3MF 파일을 읽고, 검증하고, 다시 내보냅니다.
- Web backends: Docker 또는 서버리스 함수에서 3D 변환 엔드포인트를 제공하십시오.
- 콘텐츠 마이그레이션: 대규모로 형식 패밀리 간 변환.
포맷별 옵션 및 좌표 제어
- 좌표계 방향: 축을 뒤집고 형식별로 스케일을 조정하며 사용자 코드를 사용하지 않습니다.
- 법선 정규화: 자동으로 정점 법선을 로드하거나 저장할 때 정규화합니다.
- 재질 로딩 제어: 더 빠른 구문 분석을 위해 MTL/텍스처 로딩을 활성화하거나 비활성화합니다.
- 바이너리 vs. JSON 출력: 컴팩트한 GLB 또는 사람이 읽을 수 있는 glTF를 옵션으로 선택하십시오.
- Round-trip fidelity: 로드 및 저장 사이클 전반에 걸쳐 씬 그래프 구조가 유지됩니다 (노드 보존 충실도는 형식에 따라 다르며 모든 형식에 대해 독립적으로 검증된 것은 아닙니다).
개발자 경험
Aspose.3D FOSS for Python은(는) 단일 pip install aspose-3d-foss 명령으로 설치됩니다. 이 라이브러리는 순수 Python이며, 컴파일할 네이티브 확장이 없고 설치할 시스템 패키지도 없습니다.
씬 그래프 API는 전문 3D 도구의 개념 모델을 그대로 반영하므로 Three.js 또는 Blender의 데이터 모델에 익숙한 사람이라면 학습 곡선이 짧습니다. 이 라이브러리는 MIT 라이선스로 제공되는 오픈 소스이며, GitHub에서 버그 보고 및 기여를 환영합니다.
OBJ 씬을 로드하고 glTF로 내보내기
pip으로 설치한 후, Scene.open()를 ObjLoadOptions와 함께 호출하여 OBJ 파일과 해당 MTL 재질 정의를 로드합니다. scene.save()를 한 번 호출하고 .gltf 확장자를 사용하면 glTF 2.0 JSON 파일이 작성됩니다 — 형식 레지스트리나 변환기 객체가 필요하지 않습니다.
pip install aspose-3d-foss
from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")
좌표 뒤집기를 적용하여 STL을 바이너리 GLB로 변환
기본 JSON glTF 대신 컴팩트한 바이너리 GLB를 생성하려면 GltfSaveOptions 인스턴스를 binary_mode = True와 함께 전달하십시오. 동일한 패턴이 좌표계 조정에도 적용됩니다 — 대상 형식에 맞게 옵션 클래스를 교체하십시오.
from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)
자주 묻는 질문
Aspose.3D FOSS for Python이(가) 무엇인가요?
이는 무료이며 MIT 라이선스를 가진 순수-Python 라이브러리로, 네이티브 런타임이나 외부 SDK를 설치하지 않고 3D 씬을 로드하고, 조작하며, 저장할 수 있습니다.
지원되는 3D 포맷은 무엇인가요?
OBJ(.mtl 포함), STL(바이너리 및 ASCII), glTF 2.0 및 GLB, COLLADA(DAE), 3MF, 그리고 FBX. 각 포맷마다 전용 로드/저장 옵션 클래스가 있습니다.
네이티브 종속성이 필요합니까?
아니요. Aspose.3D FOSS for Python는 순수 Python이며 네이티브 확장이 전혀 없습니다. Windows, macOS, Linux에서 컴파일 단계 없이 실행됩니다.
어떻게 설치하나요?
Run pip install aspose-3d-foss. 추가 시스템 패키지나 네이티브 확장은 필요하지 않습니다.
좌표계 방향을 제어할 수 있나요?
예. 포맷별 옵션 클래스는 축을 뒤집고, 스케일을 조정하며, 포맷별 파싱 코드를 작성하지 않고도 노멀을 정규화할 수 있게 해줍니다.
지원되는 Python 버전은 무엇인가요?
Python 3.7부터 3.12까지 지원됩니다. 이 라이브러리는 모든 주요 운영 체제에서 동일하게 실행됩니다.
소스 코드를 사용할 수 있나요?
예. 이 라이브러리는 MIT 라이선스를 가지고 있으며 GitHub에 호스팅됩니다. 버그 보고와 풀 리퀘스트를 환영합니다.
