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 컨테이너, 서버리스 환경에서 동일하게 실행됩니다. 컴파일할 네이티브 확장이나 설치할 시스템 패키지가 없습니다.

3D 포맷 지원 및 씬 그래프 API

OBJ / MTL: Wavefront OBJ 파일을 해당 재질 정의와 함께 로드합니다.
STL: 바이너리와 ASCII STL을 모두 읽고 쓰며 완전한 라운드트립 검증을 제공합니다.
glTF 2.0 / GLB: GltfSaveOptions를 통해 PBR 재질 로딩 및 바이너리 GLB 출력을 지원합니다.
COLLADA, 3MF, FBX: 포맷별 옵션 클래스를 통한 추가 포맷 지원.
Scene-graph API: Scene, Node, Mesh, Camera, Light, Transform.

어디에서 Aspose.3D FOSS 를 사용할 수 있나요

Asset validation pipelines: CI에서 3D 에셋을 검증하고, 방향을 재조정하며, 다시 내보냅니다.
Game development tooling: 네이티브 엔진 없이 OBJ/GLB 메쉬를 일괄 처리합니다.
3D printing workflows: STL 및 3MF 파일을 읽고, 검증하고, 다시 내보냅니다.
Web backends: Docker 또는 서버리스 함수에서 3D 변환 엔드포인트를 제공합니다.
Content migration: 대규모로 포맷 패밀리 간 변환을 수행합니다.

포맷별 옵션 및 좌표 제어

Coordinate-system orientation: 형식에 따라 축을 뒤집고 스케일을 조정합니다(맞춤 코딩 없이).
Normal normalization: 로드하거나 저장할 때 정점 노멀을 자동으로 정규화합니다.
Material loading control: 더 빠른 파싱을 위해 MTL/텍스처 로드를 활성화하거나 비활성화합니다.
Binary vs. JSON output: 옵션을 통해 압축된 GLB 또는 사람이 읽기 쉬운 glTF를 선택합니다.
Round-trip fidelity: 로드와 저장 주기 동안 씬 그래프 구조가 유지됩니다(노드 보존 정확도는 형식에 따라 다르며 모든 형식에 대해 독립적으로 검증된 것은 아닙니다).

개발자 경험

Aspose.3D FOSS for Python은(는) 단일 pip install aspose-3d-foss 명령으로 설치됩니다. 이 라이브러리는 순수 Python이며, 컴파일할 네이티브 확장이나 설치할 시스템 패키지가 없습니다.

Scene-graph API는 전문 3D 도구의 개념 모델을 그대로 반영하므로 Three.js 또는 Blender의 데이터 모델에 익숙한 사람이라면 학습 곡선이 짧습니다. 이 라이브러리는 MIT 라이선스를 가진 오픈 소스이며, GitHub에서 버그 보고 및 기여를 환영합니다.

OBJ 씬을 로드하고 glTF 로 내보내기

pip으로 설치한 후 Scene.open()을 ObjLoadOptions와 함께 호출하여 OBJ 파일과 해당 MTL 재질 정의를 로드합니다. .gltf 확장자를 사용한 단일 scene.save() 호출만으로 형식 레지스트리나 변환기 객체 없이 glTF 2.0 JSON 파일이 작성됩니다.

pip install aspose-3d-foss

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

# OBJ 파일을 로드합니다 (.mtl 재질 포함)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# glTF 2.0으로 내보내기
scene.save("model.gltf")

STL을 좌표 뒤집기로 Binary 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)

자주 묻는 질문