Aspose.3D FOSS for TypeScript
Node.js에서 3D 씬을 로드·구성·변환·내보내세요 — 단일 npm 설치만으로 완전 타입 지정, 오픈소스, 프로덕션 준비 완료.
3D 파일 처리용 오픈소스 타입스크립트 라이브러리
Aspose.3D FOSS for TypeScript는 Node.js 애플리케이션에서 3D 파일 형식을 다루기 위한 MIT 라이선스 라이브러리입니다. 단일 npm install @aspose/3d 명령으로 설치하고 즉시 TypeScript에서 3D 씬을 읽고, 구성하고, 작성할 수 있으며, 컴파일할 네이티브 애드온이 없고, 설치할 외부 SDK가 없으며, 렌더러도 필요하지 않습니다.
이 라이브러리는 Scene, Node, Entity, Mesh, Camera, Light, Transform을 중심으로 구축된 완전 타입이 지정된 씬 그래프 API를 노출합니다. 이는 전문 3D 도구에서 사용되는 동일한 개념 모델입니다. 지원 형식에는 OBJ (Wavefront, .mtl 재질 로딩 포함), glTF 2.0 및 GLB 바이너리 (PBR 재질), STL (바이너리 및 ASCII, 전체 라운드트립), COLLADA (DAE), 3MF 및 FBX가 포함됩니다. ObjLoadOptions 및 GltfSaveOptions와 같은 형식별 옵션 클래스는 좌표계 방향, 스케일, 노멀 정규화, 바이너리 vs. JSON 출력 및 재질 로딩에 대한 정밀한 제어를 제공합니다.
Aspose.3D FOSS는 TypeScript 5.0+와 함께 Node.js 18, 20, 22+를 대상으로 하며 CommonJS로 컴파일됩니다. 이 라이브러리는 엄격한 TypeScript 컴파일러 설정(noImplicitAny, strictNullChecks)과 함께 제공되어 IDE가 완전한 자동 완성과 컴파일 시 안전성을 제공하도록 합니다. 단일 런타임 종속성인 xmldom는 자동으로 설치됩니다. 엔터프라이즈 제품군에 대해서는 Aspose.3D — Enterprise Product Family을(를) 참조하십시오.
3D 형식 지원 및 타이핑된 장면 그래프 API
- OBJ/MTL: 물파전 OBJ 파일과 함께 자료 정의를 입력합니다.
- glTF 2.0 / GLB: PBR 재료 로딩 및
GltfSaveOptions를 통해 2차 GDB 출력. - STL: 전체 회전 검증으로 바이너리 및 ASCII STL을 읽고 쓰십시오.
- COLLADA, 3MF, FBX: 포맷별 옵션 클래스와 함께 추가적인 형식 지원.
- Full TypeScript 타입: 모든 클래스, 메소드 및 옵션은
noImplicitAny와strictNullChecks로 강하게 입력됩니다.
Aspose.3D FOSS 가 사용 될 수 있는 곳
- Node.js 자산 파이프라인: OBJ 파일을 가져와 기하학을 확인하고 재향성하여 CI에서 GLB로 수출합니다.
- 게임 도구: 네이티브 엔진이나 렌더러 없이 3D 매쉬를 배치 처리합니다.
- 3D 프린팅 워크플로우: STL 및 3MF 파일을 읽고, 검증하고 재출력합니다.
- ** 서버리스 백엔드:** 람다 또는 클라우드 함수에서 3D 변환 엔드포인트 실행.
- 콘텐츠 마이그레이션: 단일 스크립트에서 규모로 형식 가족 간 변환.
포맷 선택 및 조정 제어
- ** 좌표계 방향:** 축을 바꾸고 선택 클래스를 통해 각 형식별로 스케일을 조정합니다.
- 정상화: 로드 또는 저장 시 정상 윗부분을 자동으로 정규화하는.
- 비너리 대 JSON 출력:
GltfSaveOptions를 통해 컴팩트 GLB 또는 읽을 수 있는 glTF을 선택하세요. - 물질 로딩 제어: 보다 빠른 분석을 위해 MTL/조직 로드를 활성화 또는 비활성화하십시오.
- 회전 충실성: 알려지지 않은 장면-그래프 노드는 다시 저장할 때 그대로 보존됩니다.
개발자 경험
Aspose.3D는 단일 npm install @aspose/3d 명령으로 TypeScript 설치를 위한 FOSS입니다. 컴파일할 네이티브 애드온이 없습니다. 이 라이브러리는 순수 TypeScript/JavaScript이며 자동으로 설치되는 의존성 하나(xmldom)가 있습니다.
강력하게 타입이 지정된 API는 모든 scene-graph 클래스와 포맷 옵션에 대한 완전한 IDE 자동 완성을 제공합니다. 이 라이브러리는 Node.js 18–22+와 TypeScript 5.0+를 대상으로 하며, Linux CI 러너와 개발자 워크스테이션에서 동일하게 실행되고, MIT 라이선스를 갖고 GitHub에 공개 이슈 트래커가 있습니다.
OBJ 장면을 로드하고 glTF로 수출
npm으로 설치한 후, scene.open()와 ObjLoadOptions을 사용하여 메쉬와 해당 MTL 재질 파일을 함께 로드합니다. open()와 save()는 모두 동기식이며 — await이나 Promise 체이닝이 필요하지 않습니다. scene.save()를 .gltf 확장자를 사용해 호출하면 표준 glTF 2.0 JSON을 작성합니다 — 형식은 파일 확장자에서 자동으로 추론됩니다.
npm install @aspose/3d
import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");
STL를 이진 GLB로 변환합니다.
기본 JSON glTF 대신 컴팩트한 바이너리 GLB를 생성하려면 GltfSaveOptions에 binaryMode = true를 전달하십시오. open()와 save()는 모두 동기식이며 — await가 필요하지 않습니다.
import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);
자주 묻는 질문
TypeScript의 Aspose.3D FOSS는 무엇입니까?
그것은 무료, MIT-허가를 받은 TypeScript/Node.js 라이브러리이며 3D 장면을 로딩하고 조작하며 저장하는 데는 네이티브 애드온이나 외부 SDK를 설치하지 않고 사용된다.
어떤 3D 형식이 지원되나요?
OBJ (mtl), glTF 2.0 및 GLB, STL (바이너리 및 ASCII), COLLADA (DAE), 3MF, FBX. 각 형식은 전용 타이핑 옵션 클래스를 가지고 있습니다.
네이티브 Node.js 애드온을 필요로 하는가?
네. Aspose.3D FOSS for TypeScript은 순수한 자바스크립트/타이프 스크립트로 컴파일 단계가 필요하지 않으며 npm에 의해 자동으로 설치된 단일 런 타임 의존성 (xmldom) 을 가지고 있습니다.
어떻게 설치해야 할까요?
npm install @aspose/3d를 실행하십시오. 추가 시스템 패키지 또는 네이티브 애드온은 필요하지 않습니다.
Node.js 및 TypeScript 버전이 지원되는 경우?
Node.js 18, 20, 22+. 타입스크립트 5.0+ 이 라이브러리는 CommonJS로 컴파일되며 엄격한 타이프 스크립트의 설정으로 작동합니다.
TypeScript 타입 정의를 가지고 있나요?
네. 모든 클래스, 메서드, 엔럼 및 옵션 타입은 noImplicitAny와 strictNullChecks가 활성화되어 완전히 입력됩니다.
좌표계 방향성을 제어할 수 있나요?
네. ObjLoadOptions 및 GltfSaveOptions 같은 포맷별 옵션 클래스는 축을 뒤집고, 규모를 조정하고 사용자 정의 파싱 코드가 없이 정상화할 수 있습니다.
소스 코드를 어디서 찾을 수 있을까요?
라이브러리는 MIT에서 사용 허가받았고 GitHub에 호스팅되어 있습니다. 버그 보고와 롤 요청은 환영합니다.
