Comment démarrer avec Aspose.3D FOSS pour TypeScript

@aspose/3d TypeScript est un package gratuit, certifié par MIT pour le chargement, la manipulation et Économiser des fichiers 3D dans Node.js — aucun binaire natif requis, installable à partir de npm.

Guide étape par étape

npm install @aspose/3d@24.12.0

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

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

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");

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);

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

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

Problèmes courants et solutions

Error: ENOENT Quand on appelle scene.open() Le chemin que vous avez traversé n’existe pas. Utilisez un chemin absolu ou path.resolve() Pour assurer Le chemin de fichier est correct.

Erreur de format inconnu Assurez-vous que l’extension de fichier correspond au format réel.La bibliothèque détecte le format par Extension pour open() et fromFile().Passez un paramètre de format explicite pour surrider.

Scène vide après le chargement Certains formats binaires peuvent nécessiter des options de charge spécifiques. essayez d’utiliser la surcharge explicite avec des options spécifiques au format si la charge par défaut produit une scène vide.

TypeScript Erreur d’importation Les définitions de type sont liées au package. assurez-vous "moduleResolution": "bundler" ou "node16" Il est mis dans votre tsconfig.json.

Questions fréquentes

@aspose/3d nécessite-t-il des binariers indigènes ?

Non. Le package est pure JavaScript/TypeScript sans dépendances natives. Il fonctionne sur toute plate-forme qui soutient Node.js 18 ou plus tard.

Quelles versions de Node.js sont-elles soutenues ?

Node.js 18 ou plus tard. Le package fonctionne sur Windows, macOS et Linux.

La bibliothèque est-elle gratuite pour une utilisation commerciale ?

Oui. Il est libéré sous la licence MIT. Vous pouvez l’utiliser, modifier et redistribuer à tout but, y compris les applications commerciales.

Quels sont les formats 3D que je peux lire et écrire ?

Le package prend en charge OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA et PLY pour la lecture. et écrire. Utilisez l’extension-basée scene.save() pour les exportations dans tout format supporté.

Puis-je créer une scène 3D à partir de la crème ?

Construire A Scene sans arguments, ajoutez les nodes de l’enfant à scene.rootNode,et Enregistrer dans le format souhaité.

Voir aussi

• FAQ — Aspose.3D FOSS pour TypeScript
• Comment charger des modèles 3D en TypeScript
• Comment convertir des modèles 3D en TypeScript
• Démarrer les docs
• Le référencement API