API Overview — @aspose/3d for TypeScript

Package: @aspose/3d (v24.12.0) Langage : TypeScript / Node.js 18+ Licence : MIT

@aspose/3d est une bibliothèque sous licence MIT pour la lecture, la construction et l’exportation de scènes 3D dans Node.js. Elle est fournie avec des définitions de types TypeScript complètes, une seule dépendance d’exécution (xmldom), et prend en charge sept principaux formats de fichiers 3D. Toutes les entrées/sorties sont synchrones. Aucun module natif n’est requis.

Enumerations

npm install @aspose/3d

Enumerations tsconfig.json paramètres pour une résolution correcte des sous‑chemins :

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

La classe Shape fournit des méthodes internes pour travailler avec les espaces réservés :

Enumerations

Le conteneur racine d’une scène 3D. Tout le contenu ; nœuds, géométrie, matériaux et animations ; est stocké dans un arbre dont la racine est scene.rootNode.Utilisez open() / openFromBuffer() pour charger un fichier et save() / saveToBuffer() à exporter.

Enumerations

Un nœud d’arbre nommé dans le graphe de scène. Les nœuds portent un optionnel Entity (mesh, camera, light) et un Transform qui positionne le nœud par rapport à son parent.

Enumerations

Maillage polygonal ; le type de géométrie principal. Étend Geometry.

Enumerations

Transformation locale appliquée à un nœud.

Classes de matériaux

Classes mathématiques

Classes d’animation

Enumerations

Modules de format

Les classes d’options spécifiques à chaque format sont exportées depuis des modules de sous‑chemin. Importez‑les séparément :

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';
import { StlLoadOptions, StlSaveOptions } from '@aspose/3d/formats/stl';
import { FbxLoadOptions, FbxSaveOptions } from '@aspose/3d/formats/fbx';
import { ColladaLoadOptions } from '@aspose/3d/formats/collada';
import { ThreeMfSaveOptions } from '@aspose/3d/formats/3mf';

Module OBJ (@aspose/3d/formats/obj)

Module glTF/GLB (@aspose/3d/formats/gltf)

Module STL (@aspose/3d/formats/stl)

Module FBX (@aspose/3d/formats/fbx)

Formats pris en charge

Exemple de référence rapide

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

// Load OBJ with materials
const scene = new Scene();
const loadOpts = new ObjLoadOptions();
loadOpts.enableMaterials = true;
scene.open('input.obj', loadOpts);

// Inspect root nodes
for (const node of scene.rootNode.childNodes) {
    console.log(`Node: ${node.name}, entity: ${node.entity?.constructor.name}`);
}

// Export as GLB (binary glTF)
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;
scene.save('output.glb', saveOpts);

Voir aussi

• Classe Scene
• Classe Node
• Classe Mesh
• Fonctionnalités et caractéristiques
• Support de format