빠른 시작

이 가이드는 @aspose/3d를 사용하여 TypeScript에 대한 3D 파일을 설치하고 로드 및 저장하는 가장 빠른 경로를 보여줍니다. 이 패키지는 MIT 라이선스를 갖춘 순수 JavaScript/TypeScript이며, 네이티브 바이너리나 플랫폼 전용 빌드 도구가 필요하지 않습니다.

전제 조건

요구 사항	세부 사항
Node.js	18 이상
OS	Windows, macOS, Linux, Docker
Package	`@aspose/3d` (소스에서 빌드)

Install

소스에서 패키지를 빌드합니다. 타입 정의는 패키지에 포함되어 있으므로 별도의 @types 패키지가 필요하지 않습니다:

git clone https://github.com/aspose-3d-foss/Aspose.3D-FOSS-for-TypeScript.git
cd Aspose.3D-FOSS-for-TypeScript
npm install
npm run build

3D 파일 로드

지원되는 모든 형식을 로드하려면 scene.open()에 경로를 전달해 호출하십시오. 라이브러리는 파일 확장자를 통해 형식을 감지합니다. scene.rootNode을 통해 씬 계층 구조에 접근하십시오:

import { Scene } from "@aspose/3d";

const scene = new Scene();
scene.open("model.obj");
console.log(`Root node: ${scene.rootNode.name}`);

씬 그래프 탐색

로드된 씬은 scene.rootNode을 루트로 하는 Node 객체들의 트리입니다. 각 노드와 그 자식들을 처리하려면 재귀적 탐색을 사용하십시오:

import { Scene, Node } from "@aspose/3d";

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = new Scene();
scene.open("model.glb");
walk(scene.rootNode);

다른 형식으로 저장

라이브러리는 파일 확장자를 통해 출력 형식을 감지합니다. 형식 간 변환을 위해 출력 경로와 함께 scene.save()를 호출하십시오:

import { Scene } from "@aspose/3d";

const scene = new Scene();
scene.open("model.obj");
scene.save("output.glb");
console.log("Converted to GLB.");

새 씬을 만들고 저장

인수가 없는 Scene를 생성하여 빈 씬을 시작하고, scene.rootNode에 자식 노드를 추가한 후, 파일을 쓰기 위해 scene.save()를 호출하십시오:

import { Scene, Node } from "@aspose/3d";

const scene = new Scene();
const box = scene.rootNode.createChildNode("box");
scene.save("new_scene.obj");

다음 단계

참조

Aspose.3D for TypeScript — Enterprise Documentation