TypeScript을 위한 Aspose.3D FOSS를 시작하는 방법
@aspose/3d TypeScript는 로딩, 조작 및 Node.js에서 3D 파일을 저장할 필요가 없습니다 - npm에서 설치할 수있는 원주민 바이너리 요구 사항이 없습니다.
단계별 가이드
단계 1 : 패키지를 설치합니다.
npm에서 설치 (Node.js 18 또는 이후에 필요한):
npm install @aspose/3d@24.12.0설치가 제대로 충전된지 확인하십시오 :
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");단계 2 : 수입 필요한 클래스
패키지에서 필요한 수업을 가져오십시오 :
import { Scene, Node } from "@aspose/3d";3단계 : 3D 파일을 다운로드합니다.
사용하기 scene.open() 지원되는 형식을 충전하려면 도서관이 형식을 감지합니다. 파일 확장에서 자동으로:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);또는 정적 공장 방법을 사용하십시오 :
const scene = Scene.fromFile("model.glb");단계 4 : 장면 그래프를 통과하십시오.
짐이 있는 장면은 나무의 Node 뿌리 잡힌 물체들에 대하여 scene.rootNode:
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 = Scene.fromFile("model.obj");
walk(scene.rootNode);5단계: 다른 형식으로 저장하기
사용하기 scene.save() 모든 지원되는 출력 형식으로 수출하려면 도서관이 파일 확장에서 출력 형식 :
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");일반적인 문제와 해결책
Error: ENOENT 전화할 때 scene.open() 당신이 통과한 길은 존재하지 않습니다. 절대적인 길을 사용하거나 path.resolve() 보장하기 위해서 파일 경로는 올바른 것입니다.
알려지지 않은 형식 오류 파일 확장 프로그램이 실제 형식과 일치하는지 확인합니다. 도서관은 형식을 감지합니다 확장에 대하여 open() 그리고 fromFile().명확한 형식의 파라미터를 옮기면 위로가 됩니다.
빈 장면을 충전 후에 일부 바이너리 형식은 특정 로드 옵션을 필요로 할 수 있습니다. 명시적인 과도한 로드를 사용하십시오. 기본 로드가 빈 장면을 생성하는 경우 형식 특정 옵션.
TypeScript 오류 수입 종류 정의는 패키지와 연결되어 있습니다. "moduleResolution": "bundler" 또는 "node16" 당신의 안에 앉아있다 tsconfig.json.
자주 묻는 질문들
@aspose/3d는 원주민 바이너리를 필요로합니까?
No. 패키지는 순수한 JavaScript/TypeScript이며, 원주민 의존성이 없습니다.Node.js 18 이상을 지원하는 모든 플랫폼에서 실행됩니다.
어떤 Node.js 버전이 지원되는가?
Node.js 18 또는 이후 패키지는 Windows, macOS 및 Linux에서 실행됩니다.
도서관은 상업용으로 무료로 이용할 수 있나요?
예. MIT 라이센스에 따라 발행됩니다.당신은 그것을 사용할 수 있습니다, 수정하고 재배포 어떤 목적, 상업용 응용 프로그램을 포함하여.
어떤 3D 형식으로 읽고 쓰는가?
패키지는 OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA 및 PLY를 모두 읽을 수 있도록 지원합니다. 첨부 파일을 사용하여 확장된 scene.save() 지원되는 모든 형식으로 수출할 수 있습니다.
3D 스크래치에서 시나리오를 만들 수 있습니까?
A : 건설을 하다 Scene 아무런 논쟁도 없어서, 아이 노드를 추가하십시오. scene.rootNode,그리고, 그리고 원하는 형식으로 저장합니다.