Hoe te beginnen met Aspose.3D FOSS voor TypeScript

@aspose/3d TypeScript is een gratis, MIT-licentie pakket voor het laden, manipuleren en 3D-bestanden opslaan in Node.js - geen native binaries vereist, kan worden geïnstalleerd vanaf npm.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

Installeer vanaf npm (Node.js 18 of hoger vereist):

npm install @aspose/3d@24.12.0

Controleer of de installatie correct is geladen:

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

Stap 2: Importeren van vereiste klassen

Importeer de klassen die je nodig hebt:

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

Hoe laad ik een 3D-bestand?

Gebruiken scene.open() om een ondersteund formaat te laden. De bibliotheek detecteert het automatisch uit de bestandsextensie:

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

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

Of gebruik de statische fabrieksmethode:

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

Hoe doorloop ik de scene graph?

Een verlaagd toneel is een boom van Node Objecten die zijn ingebouwd in 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);

Stap 3: Sla op naar het doelformaat

Gebruiken scene.save() Exporteren naar een ondersteund outputformaat. De bibliotheek detecteert de Uitvoerformaat van de bestandsextensie:

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

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

Veelvoorkomende problemen en oplossingen

Error: ENOENT Wanneer bellen scene.open() De weg die je hebt afgelegd bestaat niet. Gebruik een absolute pad of path.resolve() Om te garanderen De file path is correct.

Onbekende formaten fout Zorg ervoor dat de bestandsextensie overeenkomt met het werkelijke formaat. De bibliotheek detecteert de indeling door Uitbreiding voor open() en fromFile().Een expliciete formateparameter doorgeven om over te ronden.

Leeg scherm na het laden Sommige binaire formaten kunnen specifieke belastingopties vereisen. probeer de expliciete overbelasting te gebruiken met opties voor een bepaald formaat als de standaardlading een lege scène genereert.

TypeScript import fouten De definities van het type worden bijgevoegd met het pakket.Zorg ervoor dat de "moduleResolution": "bundler" of "node16" is ingesteld in uw tsconfig.json.

Veelgestelde vragen

Heeft @aspose/3d native binaries nodig?

Het pakket is puur JavaScript/TypeScript zonder native afhankelijkheden. het werkt op elk platform dat Node.js 18 of hoger ondersteunt.

Welke Node.js versies worden ondersteund?

Node.js 18 or later. The package runs on Windows, macOS, and Linux.

Is de bibliotheek gratis voor commercieel gebruik?

Ja. Het is vrijgegeven onder de MIT-licentie. U kunt het gebruiken, wijzigen en herdistribueren voor elk doel, inclusief commerciële toepassingen.

Welke 3D-formaten kan ik lezen en schrijven?

Het pakket ondersteunt OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA en PLY voor beide lezingen en schrijven. gebruik de extensie-gebaseerde scene.save() Exporteren naar elk ondersteund formaat.

Kan ik een 3D-scène vanaf nul maken?

Ja, bouwen a Scene zonder argumenten, voeg kinderknopen toe aan de scene.rootNode,en opslaan naar het gewenste formaat.