Aspose.3D FOSS - Aspose.3D TypeScript용 FOSS
Node.js에서 3D 씬을 로드하고, 구성하며, 변환하고, 내보냅니다 — 완전한 타입 지원, 오픈소스, 단일 npm 설치로 프로덕션 준비 완료.
3D 파일 처리를 위한 오픈소스 TypeScript 라이브러리
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는 Node.js 18, 20 및 22+와 TypeScript 5.0+를 대상으로 하며 CommonJS로 컴파일됩니다. 라이브러리는 엄격한 TypeScript 컴파일러 설정(noImplicitAny, strictNullChecks)과 함께 제공되어 IDE가 전체 자동 완성과 컴파일 시점 안전성을 제공합니다. 단일 런타임 종속성인 xmldom는 자동으로 설치됩니다. 엔터프라이즈 제품군에 대해서는 Aspose.3D — Enterprise Product Family를 참조하십시오.
3D 포맷 지원 및 타입이 지정된 씬 그래프 API
- OBJ / MTL: Wavefront OBJ 파일을 해당 재질 정의와 함께 로드합니다.
- glTF 2.0 / GLB: PBR 재질 로딩 및 바이너리 GLB 출력 via
GltfSaveOptions. - STL: 바이너리와 ASCII STL을 모두 읽고 쓰며 전체 라운드트립 검증을 수행합니다.
- COLLADA, 3MF, FBX: 형식별 옵션 클래스를 통한 추가 형식 지원.
- Full TypeScript types: 모든 클래스, 메서드 및 옵션은
noImplicitAny및strictNullChecks를 사용하여 강력하게 타입이 지정됩니다.
Aspose.3D FOSS 를 사용할 수 있는 곳
- Node.js asset pipelines: OBJ 파일을 가져오고, 기하학을 검증 및 재정렬하며, CI에서 GLB로 내보냅니다.
- 게임 툴링: 네이티브 엔진이나 렌더러 없이 3D 메쉬를 일괄 처리합니다.
- 3D 프린팅 워크플로우: 읽고, 검증하고, STL 및 3MF 파일을 다시 내보내기.
- Serverless backends: Lambda 또는 Cloud Functions에서 3D 변환 엔드포인트를 실행합니다.
- 콘텐츠 마이그레이션: 단일 스크립트에서 대규모로 포맷 패밀리 간 변환을 수행합니다.
포맷별 옵션 및 좌표 제어
- 좌표계 방향: 형식별로 축을 뒤집고 옵션 클래스와 함께 스케일을 조정합니다.
- 노멀 정규화: 로드하거나 저장할 때 정점 노멀을 자동으로 정규화합니다.
- Binary vs. JSON output: 컴팩트한 GLB 또는 읽을 수 있는 glTF를
GltfSaveOptions를 통해 선택하십시오. - 재질 로딩 제어: 더 빠른 구문 분석을 위해 MTL/텍스처 로딩을 활성화하거나 비활성화합니다.
- Round-trip fidelity: 알 수 없는 씬 그래프 노드는 재저장 시 그대로 보존됩니다.
개발자 경험
Aspose.3D FOSS for TypeScript는 단일 npm install @aspose/3d 명령으로 설치됩니다. 컴파일할 네이티브 애드온이 없습니다. 이 라이브러리는 순수 TypeScript/JavaScript이며 하나의 자동 설치 종속성(xmldom)이 있습니다.
강력하게 타입이 지정된 API는 모든 씬-그래프 클래스와 포맷 옵션에 대해 완전한 IDE 자동 완성을 제공합니다. 이 라이브러리는 Node.js 18–22+와 TypeScript 5.0+를 대상으로 하며, Linux CI 러너와 개발자 워크스테이션에서 동일하게 실행되고, MIT-licensed이며 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을 Binary 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);
자주 묻는 질문
Aspose.3D FOSS for TypeScript가 무엇인가요?
이 라이브러리는 무료이며 MIT 라이선스를 가진 TypeScript/Node.js 라이브러리로, 네이티브 애드온이나 외부 SDK를 설치하지 않고 3D 씬을 로드, 조작 및 저장할 수 있습니다.
지원되는 3D 포맷은 무엇인가요?
OBJ (with .mtl), glTF 2.0 and GLB, STL (binary and ASCII), COLLADA (DAE), 3MF, and FBX. 각 포맷마다 전용 타입 옵션 클래스가 있습니다.
네이티브 Node.js 애드온이 필요합니까?
아니오. Aspose.3D FOSS for TypeScript는 순수 JavaScript/TypeScript입니다. 컴파일 단계가 필요 없으며 npm에 의해 자동으로 설치되는 단일 런타임 의존성 (xmldom)을 가집니다.
어떻게 설치하나요?
npm install @aspose/3d를 실행하십시오. 추가 시스템 패키지나 네이티브 애드온이 필요하지 않습니다.
지원되는 Node.js 및 TypeScript 버전은 무엇인가요?
Node.js 18, 20, 및 22+. TypeScript 5.0+. 이 라이브러리는 CommonJS로 컴파일되며 엄격한 TypeScript 설정에서도 작동합니다.
TypeScript 타입 정의가 포함되어 있나요?
예. 모든 클래스, 메서드, 열거형 및 옵션 타입은 noImplicitAny와 strictNullChecks가 활성화된 상태에서 완전하게 타입이 지정됩니다.
좌표계 방향을 제어할 수 있나요?
예. ObjLoadOptions와 GltfSaveOptions와 같은 포맷별 옵션 클래스는 사용자 정의 파싱 코드 없이 축을 뒤집고, 스케일을 조정하며, 노멀을 정규화할 수 있게 해줍니다.
소스 코드는 어디에서 찾을 수 있나요?
이 라이브러리는 MIT 라이선스를 가지고 있으며 GitHub에 호스팅됩니다. 버그 보고 및 풀 리퀘스트를 환영합니다.
