개발자 가이드

Aspose.3D FOSS for Python은 오픈 소스이며 MIT 라이선스를 가진 라이브러리로, Python 개발자가 외부 런타임 종속성 없이 3D 씬을 로드, 구성, 변환 및 내보낼 수 있게 합니다. 자산 파이프라인, 검증 도구, 기하학 처리 스크립트, 혹은 포맷 변환 서비스를 구축하든, 이 라이브러리는 산업 표준 3D 개념을 반영하는 씬 그래프 모델을 기반으로 하는 깔끔하고 일관된 API를 제공합니다.

이 개발자 가이드는 빠른 시작 설치를 넘어 프로덕션 수준의 3D 처리 코드를 작성하는 데 필요한 모든 내용을 다룹니다.

이 섹션에서 찾을 수 있는 내용

기능 및 특성

그 기능 페이지는 Aspose.3D FOSS for Python 작업을 위한 주요 참고 자료입니다. 다음을 다룹니다:

  • 포맷 지원: OBJ(.mtl 재질 포함), STL(바이너리 및 ASCII), glTF 2.0 / GLB, COLLADA(DAE), 3MF, 그리고 진행 중인 FBX 토크나이저, 각 포맷별 로드 및 저장 옵션 클래스와 함께.
  • 씬 그래프: 방법 Scene, Node, Entity, Transform, 그리고 GlobalTransform 전체 씬 계층 구조로 구성하고, 자식 노드 순회 패턴을 포함합니다.
  • Mesh API: 작업 중 control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, 및 VertexElementSmoothingGroup 기하학 처리용.
  • 재질 시스템: 적용 LambertMaterial 및 PhongMaterial 씬 노드에, 그리고 .mtl 파일에서 로드된 재질 속성을 읽는 것.
  • 수학 유틸리티: 사용 Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, 그리고 BoundingBox 변환, 경계 상자 쿼리 및 기하학적 계산을 위해.
  • 애니메이션: 구성 및 읽기 AnimationClip, AnimationNode, KeyFrame, 그리고 KeyframeSequence 데이터.
  • 로드 및 저장 옵션: 형식별 옵션 클래스와 같은 ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • 전체 사용 예시: 엔드투엔드 Python 스크립트로 OBJ를 로드하고, STL을 내보내며, glTF를 라운드트립하고, 씬 그래프를 탐색합니다.
  • 팁, 일반적인 문제 및 FAQ: 프로덕션 사용 시 흔히 발생하는 함정을 피하기 위한 실용적인 가이드.
  • API 레퍼런스 요약: 모든 핵심 클래스의 빠른 참고 목록.

핵심 개념

씬 그래프: Aspose.3D FOSS의 모든 3D 콘텐츠는 트리 구조로 표현됩니다. Node 루트가 되는 객체 scene.root_node. 각 노드는 …를 가질 수 있다 Entity (예를 들어 Mesh, Camera, 또는 Light) 그리고 a Transform 계층 구조에 위치시키는.

포맷에 구애받지 않는 API: 지원되는 모든 포맷을 통해 엽니다 Scene.open() 또는 Scene.from_file() 그리고 지원되는 모든 포맷을 통해 저장합니다 Scene.save(). 동일한 씬 그래프 객체는 소스이든 대상 포맷이든 관계없이 사용됩니다.

의존성 없음: 이 라이브러리는 순수 Python입니다. 컴파일할 네이티브 확장이 없으며, 설치할 시스템 패키지도 없고, 관리할 서드파티 라이브러리도 없습니다.

시작하기

아직 라이브러리를 설치하지 않으셨다면, 시작하기 섹션과 설치 가이드를 먼저 확인한 후에 계속 읽으세요.

사용 가능한 주제

  • 기능 및 특성: 주요 기능 영역마다 코드 예제가 포함된 완전한 API 레퍼런스.
 한국어