Como carregar modelos 3D em TypeScript

O @aspose/3d o pacote fornece às aplicações TypeScript e Node.js uma API simples para abrir arquivos de cena 3D. Scene é o objeto raiz: chame scene.open() com um caminho de arquivo e opções de carregamento específicas de formato opcionais, então percorra scene.rootNode para acessar geometria, materiais e transformações.

Guia passo a passo

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.entity && node.entity.material) {
        console.log(`Material on "${node.name}": ${node.entity.material.constructor.name}`);
    }
}

Problemas comuns e correções

Erro: Não foi possível encontrar o módulo ‘@aspose/3d/formats/obj’ Os subcaminhos de formato exigem exportações de pacote do Node.js 12.7+. Certifique-se de que está usando o Node.js 18 ou posterior. Se estiver usando TypeScript, defina "moduleResolution": "node16" ou "bundler" em tsconfig.json.

scene.rootNode.childNodes está vazio após open() Alguns arquivos OBJ usam quebras de linha não padrão ou não têm uma nova linha final. Verifique se o arquivo é um OBJ válido abrindo-o em um editor de texto. Também confirme se você passou ObjLoadOptions e não um genérico LoadOptions: as opções específicas do formato são necessárias para o despacho correto.

o array controlPoints tem comprimento zero A malha pode ter sido carregada, mas não contém geometria (por exemplo, um grupo vazio no OBJ). Use mesh.polygonCount para verificar antes de iterar vértices.

O uso de memória é alto para arquivos grandes Carregar a partir do buffer com scene.openFromBuffer() não reduz a memória máxima: o arquivo inteiro deve ser analisado. Para arquivos grandes (> 100 MB), certifique-se de que seu processo Node.js tenha heap suficiente: node --max-old-space-size=4096 yourScript.js.

Erros de tipo: ’entity’ é do tipo ‘unknown’ O entity propriedade é tipada de forma ampla. Converta para any ou para uma classe específica (Mesh, Camera, etc.) dependendo do que você espera em sua cena.

Perguntas Frequentes (FAQ)

Quais formatos podem ser carregados com scene.open()? OBJ, glTF 2.0 (.gltf + .bin), GLB, STL, 3MF, FBX e COLLADA (.dae) são todos suportados para importação. Passe a *LoadOptions classe correspondente a cada formato.

Posso carregar um arquivo sem especificar opções? Sim. scene.open('model.glb') funciona sem opções para formatos que não exigem configuração especial. Passar opções é recomendado para OBJ porque a resolução do material depende de enableMaterials.

O carregamento ocorre de forma assíncrona? Não. scene.open() e scene.openFromBuffer() são síncronos. Envolva-os em uma thread de trabalho ou setImmediate se precisar manter o loop de eventos responsivo.

A exportação OBJ é suportada? Sim. A exportação OBJ é suportada via scene.save('output.obj'). O .mtl arquivo de material é escrito automaticamente ao lado do .obj arquivo.

Onde o arquivo .mtl é esperado ao carregar OBJ? Por padrão, o parser procura o .mtl arquivo referenciado dentro do OBJ (mtllib diretiva) relativo ao diretório do arquivo OBJ. Certifique-se de que ambos os arquivos estejam na mesma pasta.

Veja também

• Como Exportar Cenas 3D para glTF/GLB em TypeScript
• Referência da API: Scene
• Referência da API: ObjLoadOptions
• npm: @aspose/3d