Ako začať s Aspose.3D FOSS pre TypeScript

@aspose/3d pre TypeScript je bezplatný, MIT licenčný balík na nabíjanie, manipuláciu a 3D súbory v Node.js – žiadne domáce binárne požadované, inštalovateľné od npm.

Postupný návod

Krok 1: Nainštalujte balík

Inštalácia od npm (Node.js 18 alebo novšie je potrebná):

npm install @aspose/3d@24.12.0

Skontrolujte správne nabitý inštalátor:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

Krok 2: Import požadovaných tried

Importujte triedy, ktoré potrebujete:

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

Krok 3: Nahrať 3D súbor

Používanie scene.open() na stiahnutie akéhokoľvek podporovaného formátu. knižnica detekuje formát automaticky z rozšírenia súboru:

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

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

Alebo použite statickú továreň:

const scene = Scene.fromFile("model.glb");

Krok 4: Prejsť cez scénový graf

Nádherná scéna je stromček Node Objekty zakorenené v 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);

Krok 3: Uložte do cieľového formátu

Používanie scene.save() na export do akéhokoľvek podporovaného formátu výstupu. knižnica detekuje formát výstupu z rozšírenia súborov:

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

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Bežné problémy a riešenia

Error: ENOENT Keď volá scene.open() Cesta, ktorú prešiel neexistuje. Použite absolútnu cestu alebo path.resolve() aby sa zabezpečilo Pôvodný súbor je správny.

Neznámy formát chyb Uistite sa, že rozšírenie súboru zodpovedá skutočnému formátu. knižnica detekuje formát podľa rozšírenie pre open() a fromFile().Prepustiť explicitný parameter formátu pre override.

Prázdna scéna po nahrávaní Niektoré binárne formáty môžu vyžadovať špecifické možnosti zaťaženia. skúste použiť explicitný preťaženie s formátovo špecifickými možnosťami, ak predvolený zaťaženie produkuje prázdnu scénu.

TypScript import chyby Typ definície sú spojené s balíkom. zabezpečiť "moduleResolution": "bundler" alebo "node16" je nastavený vo vašej tsconfig.json.

Často kladené otázky

@aspose/3d vyžaduje nejaké domáce binárne?

No. balík je čistý JavaScript/TypeScript s žiadnou domorodou závislosťou. beží na akejkoľvek platforme podporujúcej Node.js 18 alebo neskôr.

Ktoré verzie Node.js sú podporované?

Node.js 18 alebo neskôr. balík sa používa na Windows, macOS a Linux.

Je knižnica voľná na komerčné použitie?

Je vydaný podľa licencie MIT. Môžete ho používať, modifikovať a distribuovať na akýkoľvek účel vrátane komerčných aplikácií.

Aké 3D formáty môžem čítať a písať?

Balík podporuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA a PLY pre čítanie oboch strán. a písanie. používať rozšírenie-based scene.save() exportovať do akéhokoľvek podporovaného formátu.

Môžem vytvoriť 3D scénu z škrabanca?

konštrukcia a Scene bez argumentov, pridajte detské uzly k scene.rootNode,a , a Uložiť do požadovaného formátu.