개발자 가이드
Aspose.3D FOSS for TypeScript는 Node.js 개발자가 전체 TypeScript 타입 안전성을 유지하면서 3D 씬을 로드, 구성, 변환 및 내보낼 수 있게 해주는 오픈소스 MIT 라이선스 라이브러리입니다. 에셋 파이프라인, 포맷 변환 서비스, 기하학 검증 도구, 혹은 3D 콘텐츠 저작 스크립트를 구축하든, 이 라이브러리는 산업 표준 3D 개념을 반영한 씬 그래프 모델을 기반으로 한 깔끔하고 일관된 API를 제공합니다.
이 개발자 가이드는 빠른 시작 설치를 넘어 프로덕션 수준의 3D 처리 코드를 작성하는 데 필요한 모든 내용을 다룹니다.
이 섹션에서 찾을 수 있는 내용
기능 및 특성
그 기능 페이지는 Aspose.3D FOSS for TypeScript 작업을 위한 주요 참고 자료입니다. 다음을 다룹니다:
- 포맷 지원: OBJ(.mtl 재질 포함), glTF 2.0 / GLB 바이너리, STL(바이너리 및 ASCII), COLLADA(DAE), 3MF, 및 FBX, 각 포맷별 로드 및 저장 옵션 클래스를 포함하여
ObjLoadOptions및GltfSaveOptions. - 씬 그래프: 방법
Scene,Node,Entity,Transform, 및SceneObject전체 씬 계층 구조를 구성하며, 자식 노드 순회 패턴을 포함합니다. - 기하학 및 메쉬 API: 작업
Mesh,Geometry,VertexElementNormal,VertexElementUV,VertexElementVertexColor,MappingMode, 및ReferenceMode기하학 처리용. - 재질 시스템: 적용
LambertMaterial,PhongMaterial, 그리고PbrMaterial(PBR for glTF)를 씬 노드에 적용하고, .mtl 파일에서 로드된 재질 속성을 읽습니다. - 수학 유틸리티: 사용
Vector3,Vector4,Matrix4,Quaternion, 및BoundingBox변환, 경계 상자 쿼리 및 기하학 계산을 위해. - 애니메이션: 구성 및 읽기
AnimationClip,AnimationNode,AnimationChannel,KeyFrame,KeyframeSequence,Interpolation, 및Extrapolation데이터. - 스트림 및 버퍼 지원: 메모리 내에서 3D 씬 로드
Buffer객체를 통해scene.openFromBuffer()서버리스 및 스트리밍 사용 사례를 위해. - 전체 사용 예시: OBJ 로드, GLB 내보내기, STL 라운드트립 및 씬 그래프 탐색을 위한 엔드투엔드 TypeScript 스크립트.
- 팁, 일반적인 문제 및 FAQ: 프로덕션 사용 시 일반적인 함정을 피하기 위한 실용적인 가이드.
- API 레퍼런스 요약: 모든 핵심 클래스와 주요 메서드의 빠른 참고 목록.
핵심 개념
씬 그래프: Aspose.3D FOSS의 모든 3D 콘텐츠는 트리 형태로 표현됩니다 Node 객체들이 루트가 되는 scene.rootNode. 각 노드는 를 가질 수 있다 Entity (예를 들어 Mesh, Camera, 또는 Light) Transform 계층 구조에서 위치를 지정합니다.
포맷에 구애받지 않는 API: 지원되는 모든 포맷을 다음을 통해 엽니다 scene.open() 또는 scene.openFromBuffer() 그리고 지원되는 모든 포맷으로 다음을 통해 저장합니다 scene.save(). 동일한 씬 그래프 객체가 소스든 대상 포맷이든 관계없이 사용됩니다.
강력한 TypeScript 타입 지정: 라이브러리는 엄격한 컴파일러 설정(noImplicitAny, strictNullChecks).
단일 의존성: 유일한 런타임 의존성은 xmldom, npm에 의해 자동으로 설치됩니다. 컴파일할 네이티브 애드온도 없으며 시스템 패키지를 설치할 필요도 없습니다.
시작하기
아직 라이브러리를 설치하지 않으셨다면, 다음을 확인하십시오 시작하기 섹션 및 설치 읽기 전에 가이드.
사용 가능한 주제
- 기능 및 특성: 주요 기능 영역마다 코드 예제가 포함된 완전한 API 레퍼런스.
