Jak začít s Aspose.3D FOSS pro TypeScript

@aspose/3d pro TypeScript je bezplatný, MIT-licencovaný balíček pro nabíjení, manipulace a 3D soubory v Node.js – žádné native binary požadované, instalovatelné od npm.

Krok za krokem průvodce

Krok 1: Nainstalujte balíček

Instalace od npm (Node.js 18 nebo novější požaduje):

npm install @aspose/3d@24.12.0

Zkontrolujte správně nabitý instalace:

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

Krok 2: Import požadovaných tříd

Import tříd, které potřebujete z balíčku:

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

Je k dispozici kódování/dekódování vodoznaku?

Použití scene.open() - přenášet jakýkoli formát podporovaný. knihovna detekuje formáty automaticky z rozšíření souboru:

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

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

Použijte statickou tovární metodu:

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

Ne. `Geometry.GetDeformers()` ještě není implementována.

Nádherná scéna je stromem Node Objekty zakotvené 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 cílového formátu

Použití scene.save() do jakéhokoli formátu výstupu podporovaného. knihovna detekuje Formát výstupu z rozšíření souboru:

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

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

Časté problémy a opravy

Error: ENOENT Když voláme scene.open() Cesta, kterou procházíte neexistuje. použijte absolutní cestu nebo path.resolve() Aby bylo zajištěno Původní soubor je správný.

Neznámá chyba formátu Ujistěte se, že rozšíření souboru odpovídá skutečnému formátu. knihovna detekuje formát podle Rozšíření pro open() a fromFile().Přejděte do výslovného formátu parametru, aby se přehodnotil.

Prázdná scéna po nakládce Některé binární formáty mohou vyžadovat specifické možnosti zatížení. zkuste použít explicitní přetížení s formátově specifickými možnostmi, pokud předvolený záloha produkuje prázdnou scénu.

Typové chyby importů Typy definice jsou spojeny s balíkem. "moduleResolution": "bundler" nebo "node16" je nastaven v tvém tsconfig.json.

Často kladené otázky

@aspose/3d vyžaduje žádné domácí binární?

No. Pakoje jsou čisté JavaScript/TypeScript s žádnými závislostmi. běží na jakékoli platformě podporující Node.js 18 nebo později.

Které verze Node.js jsou podporovány?

Node.js 18 nebo později. balíček běží na Windows, macOS a Linuxu.

Je knihovna zdarma pro komerční použití?

Je vydán pod licencí MIT. Můžete jej používat, upravovat a distribuovat pro jakýkoli účel, včetně komerčních aplikací.

Jaké 3D formáty si mohu přečíst a psát?

Balíček podporuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA a PLY pro čtení obou a psát. použijte rozšíření založené na scene.save() exportovat do jakéhokoli podporovaného formátu.

Můžu vytvořit 3D scénu z skratku?

Ano, stavět a Scene bez argumentů, přidejte dětské uzly k scene.rootNode,a Využijte požadovaný formát.