Cómo hacer un gráfico de escenario 3D en TypeScript

El gráfico de escena en Aspose.3D FOSS para TypeScript es un árbol de Node Objetos enracinados en scene.rootNode.El paso es recursivo: cada nodo exponerá a una childNodes iterable y una opción entity Esta guía muestra cómo caminar por todo el árbol, identificar tipos de entidades y recoger estadísticas de mesh.

Prediciones

• Node.js 18 o más tarde
• Tipo de gráficos 5.0 o más tarde
• @aspose/3d Instalado

Guía paso a paso

npm install @aspose/3d

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

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

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

console.log(`Root node: "${scene.rootNode.name}"`);
console.log(`Top-level children: ${scene.rootNode.childNodes.length}`);

function traverse(node: any, depth = 0): void {
    const indent = '  '.repeat(depth);
    const entityType = node.entity ? node.entity.constructor.name : '-';
    console.log(`${indent}[${entityType}] ${node.name}`);
    for (const child of node.childNodes) {
        traverse(child, depth + 1);
    }
}

traverse(scene.rootNode);

[-] RootNode
  [Mesh] Cube

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

import { Mesh } from '@aspose/3d/entities';

function visitWithTypeCheck(node: any, depth = 0): void {
    const indent = '  '.repeat(depth);
    if (node.entity instanceof Mesh) {
        const mesh = node.entity as Mesh;
        console.log(`${indent}MESH "${node.name}": ${mesh.controlPoints.length} vertices`);
    } else if (node.entity) {
        console.log(`${indent}${node.entity.constructor.name} "${node.name}"`);
    } else {
        console.log(`${indent}GROUP "${node.name}"`);
    }
    for (const child of node.childNodes) {
        visitWithTypeCheck(child, depth + 1);
    }
}

visitWithTypeCheck(scene.rootNode);

import { Mesh } from '@aspose/3d/entities';

function collectMeshes(
    node: any,
    results: Array<{ name: string; mesh: Mesh }> = []
): Array<{ name: string; mesh: Mesh }> {
    if (node.entity instanceof Mesh) {
        results.push({ name: node.name, mesh: node.entity as Mesh });
    }
    for (const child of node.childNodes) {
        collectMeshes(child, results);
    }
    return results;
}

const meshNodes = collectMeshes(scene.rootNode);
console.log(`Found ${meshNodes.length} mesh node(s)`);

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

function collectMeshes(node: any, results: Array<{name: string, mesh: Mesh}> = []) {
    if (node.entity instanceof Mesh) {
        results.push({ name: node.name, mesh: node.entity as Mesh });
    }
    for (const child of node.childNodes) {
        collectMeshes(child, results);
    }
    return results;
}

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

const meshes = collectMeshes(scene.rootNode);
for (const { name, mesh } of meshes) {
    console.log(`${name}: ${mesh.controlPoints.length} vertices, ${mesh.polygonCount} polygons`);
}

Cube: 8 vertices, 6 polygons
Sphere: 482 vertices, 480 polygons

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Consejos y mejores prácticas

• Siempre no-check node.entity Muchos nodos son nodas de grupo puros que no llevan ninguna entidad.
• Uso instanceof Sobre constructor.name para los controles de tipo en caminos lógicos. instanceof es refactor-seguro; la comparación de las líneas en el constructor.name Se rompe con la minificación.
• Viaje a través for...of Sobre childNodes: el iterable maneja todos los tamaños de la línea de forma segura. Evite la indicación numérica para compatibilidad a frente.
• Evitar mutiendo el árbol durante la cruzada:No añade o elimine los núcleos dentro de la llamada recursiva.Recoger resultados primero, luego modificar.
• Pasar un resultado como parámetro:Esto evita la asignación de una nueva línea en cada llamada recursiva y hace que sea fácil combinar los resultados subterráneos.

Problemas comunes

Preguntas frecuentes

¿Qué hace scene.rootNode ¿Tiene una entidad? No. El nodo de raíz es un contenedor creado automáticamente por la biblioteca. no tiene ninguna entidad. su geometría y otros objetos de escena viven en los nodos infantiles uno o más niveles debajo rootNode.

¿Cuál es la diferencia entre node.entity y node.entities? node.entity Algunas ficheras de FBX y COLLADA mayores pueden producir nódulos con múltiples entidades adheridas; en ese caso, node.entities (plural) proporciona la lista completa.

¿Puedo cruzar en orden de ancho y no en primer lugar? Use una cueva en lugar de una llamada recursiva: pulse scene.rootNode en una array, luego cambiar y procesar los nodos mientras empujando cada nodo de la childNodes En el cuello de la caña.

Es scene.open() ¿Síntomas en sí? Sí sí. scene.open() y scene.openFromBuffer() ambos bloquean el hilo de llamada hasta que el archivo esté completamente parsado. envuelvelos en un hilo del trabajador si necesita mantener la barra de eventos respondiendo.

¿Cómo puedo obtener posiciones del espacio mundial desde un nodo? Leer node.globalTransform;que devolve una lectura única GlobalTransform con la matriz del espacio, compuesta de todas las transformaciones ancestrales. para matemáticas explícitas, llame node.evaluateGlobalTransform(false).

¿Qué tipos de entidades son posibles además de Mesh? Camera, Light, y las entidades esqueletas/bones personalizadas. ver node.entity.constructor.name o usar instanceof de la clase importada por los @aspose/3d.

Ver también

• Cómo descargar modelos 3D en TypeScript
• Cómo crear una Mesh 3D de manera programática en TypeScript
• Guía de desarrollador: Scene Graph
• NPM: @aspose / 3d