Comment charger des modèles 3D en TypeScript

Le @aspose/3d Le package offre 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 facultatives, 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 générique LoadOptions: les options spécifiques au format sont requises pour un dispatch correct.

Le tableau controlPoints a une longueur nulle Le maillage a peut‑être été chargé mais ne contient aucune géométrie (par ex., un groupe vide dans l’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 Chargement depuis le tampon avec scene.openFromBuffer() ne réduit pas la mémoire maximale : 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’ Le entity propriété 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. Passez le *LoadOptions classe correspondant à 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 une 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 .mtl le fichier material est écrit automatiquement à côté du .obj fichier.

Où le fichier .mtl est‑il attendu lors du chargement d’un OBJ ? Par défaut, l’analyseur recherche le .mtl fichier référencé à l’intérieur de l’OBJ (mtllib directive) 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 vers glTF/GLB en TypeScript
• Référence API : Scene
• Référence API : ObjLoadOptions
• npm : @aspose/3d