Comment charger des modèles 3D en TypeScript

Le package @aspose/3d fournit aux applications TypeScript et Node.js une API simple pour ouvrir des fichiers de scène 3D. Scene est l’objet racine : appelez scene.open() avec un chemin de fichier et des options de chargement spécifiques au format, puis parcourez scene.rootNode pour accéder à la géométrie, aux matériaux et aux transformations.

Guide étape par étape

npm install @aspose/3d

##tsconfig.json: minimum required settings
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "strict": true
  }
}

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

import { GltfLoadOptions } from '@aspose/3d/formats/gltf';
import { FbxLoadOptions } from '@aspose/3d/formats/fbx';
import { StlLoadOptions } from '@aspose/3d/formats/stl';

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

const scene = new Scene();
const options = new ObjLoadOptions();
options.enableMaterials = true;

scene.open('model.obj', options);
console.log('Scene loaded successfully');

import * as fs from 'fs';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const buffer = fs.readFileSync('model.obj');
const scene = new Scene();
scene.openFromBuffer(buffer, new ObjLoadOptions());

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

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

function visitNode(node: any, depth: number = 0): void {
    const indent = '  '.repeat(depth);
    console.log(`${indent}Node: ${node.name}`);
    if (node.entity) {
        console.log(`${indent}  Entity type: ${node.entity.constructor.name}`);
    }
    for (const child of node.childNodes) {
        visitNode(child, depth + 1);
    }
}

visitNode(scene.rootNode);

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

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

for (const node of scene.rootNode.childNodes) {
    if (!node.entity) continue;
    const entity = node.entity;
    // Check if the entity is a Mesh by duck-typing controlPoints
    if ('controlPoints' in entity) {
        const mesh = entity as any;
        console.log(`Mesh "${node.name}": ${mesh.controlPoints.length} vertices`);
        // Print first three vertices
        for (let i = 0; i < Math.min(3, mesh.controlPoints.length); i++) {
            const v = mesh.controlPoints[i];
            console.log(`  v[${i}]: x=${v.x.toFixed(4)}, y=${v.y.toFixed(4)}, z=${v.z.toFixed(4)}`);
        }
    }
}

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

const options = new ObjLoadOptions();
options.enableMaterials = true;   // parse .mtl file if present

const scene = new Scene();
scene.open('model.obj', options);

// Inspect materials attached to nodes
for (const node of scene.rootNode.childNodes) {
    if (node.material) {
        console.log(`Material on "${node.name}": ${node.material.constructor.name}`);
    }
}

Problèmes courants et solutions

Erreur : Impossible de trouver le module ‘@aspose/3d/formats/obj’ Les sous‑chemins de format nécessitent les exportations de package Node.js 12.7+. Assurez‑vous d’utiliser Node.js 18 ou une version ultérieure. Si vous utilisez TypeScript, définissez "moduleResolution": "node16" ou "bundler" dans tsconfig.json.

scene.rootNode.childNodes est vide après open()
Certains fichiers OBJ utilisent des fins de ligne non standard ou n’ont pas de saut de ligne final. Vérifiez que le fichier est un OBJ valide en l’ouvrant dans un éditeur de texte. Confirmez également que vous avez passé ObjLoadOptions et non un LoadOptions générique : les options spécifiques au format sont requises pour un dispatch correct.

controlPoints array has zero length
Le tableau controlPoints a une longueur nulle.

Le maillage a peut‑être été chargé mais ne contient aucune géométrie (par exemple, un groupe vide dans le OBJ). Utilisez mesh.polygonCount pour vérifier avant d’itérer les sommets.

L’utilisation de la mémoire est élevée pour les gros fichiers
Le chargement depuis le tampon avec scene.openFromBuffer() ne réduit pas le pic de mémoire : le fichier complet doit être analysé. Pour les gros fichiers (> 100 Mo), assurez‑vous que votre processus Node.js dispose d’un tas suffisant : node --max-old-space-size=4096 yourScript.js.

Erreurs de type : ’entity’ est de type ‘unknown’ La propriété entity est typée de manière large. Convertissez en any ou en une classe spécifique (Mesh, Camera, etc.) selon ce que vous attendez dans votre scène.

Foire aux questions (FAQ)

Quels formats peuvent être chargés avec scene.open()? OBJ, glTF 2.0 (.gltf + .bin), GLB, STL, 3MF, FBX et COLLADA (.dae) sont tous pris en charge pour l’importation. Transmettez la classe *LoadOptions correspondante pour chaque format.

Puis-je charger un fichier sans spécifier d’options ?
Oui. scene.open('model.glb') fonctionne sans options pour les formats qui ne nécessitent pas de configuration spéciale. Le passage d’options est recommandé pour OBJ car la résolution des matériaux dépend de enableMaterials.

Le chargement s’exécute-t-il de manière asynchrone ?
Non. scene.open() et scene.openFromBuffer() sont synchrones. Enveloppez‑les dans un thread de travail ou setImmediate si vous devez garder la boucle d’événements réactive.

L’exportation OBJ est-elle prise en charge ?
Oui. L’exportation OBJ est prise en charge via scene.save('output.obj'). Le fichier matériel .mtl est écrit automatiquement à côté du fichier .obj.

Où le fichier .mtl est‑il attendu lors du chargement d’OBJ ?
Par défaut, l’analyseur recherche le fichier .mtl référencé à l’intérieur de l’OBJ (directive mtllib) relatif au répertoire du fichier OBJ. Assurez‑vous que les deux fichiers se trouvent dans le même dossier.

Voir aussi

• Comment exporter des scènes 3D au format glTF/GLB en TypeScript
• Référence API : Scene
• Référence API : ObjLoadOptions
• npm : @aspose/3d