Wie man einen 3D‑Szenengraph in TypeScript durchläuft

Der Szenengraph in Aspose.3D FOSS für TypeScript ist ein Baum von Node Objekten, die bei scene.rootNode. Traversierung ist rekursiv: Jeder Knoten stellt ein childNodes iterierbares Objekt und ein optionales entity Property. Dieser Leitfaden zeigt, wie man den gesamten Baum durchläuft, Entitätstypen identifiziert und Mesh-Statistiken sammelt.

Voraussetzungen

• Node.js 18 oder neuer
• TypeScript 5.0 oder neuer
• @aspose/3d installiert

Schritt-für-Schritt-Anleitung

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>

Tipps und bewährte Vorgehensweisen

• Immer Null prüfen node.entity bevor Sie entitätsspezifische Eigenschaften zugreifen. Viele Knoten sind reine Gruppenknoten, die keine Entität tragen.
• Verwenden Sie instanceof über constructor.name für Typprüfungen in Logikpfaden. instanceof ist refaktor-sicher; Zeichenkettenvergleich auf constructor.name bricht bei Minifizierung.
• Durchlaufen über for...of über childNodes: das Iterable verarbeitet alle Array-Größen sicher. Vermeiden Sie numerische Indizierung für zukünftige Kompatibilität.
• Vermeiden Sie das Mutieren des Baums während der Traversierung: Fügen Sie innerhalb des rekursiven Aufrufs keine Knoten hinzu oder entfernen Sie sie. Sammeln Sie zuerst die Ergebnisse, dann ändern Sie sie.
• Übergeben Sie ein Ergebnis-Array als Parameter: Dies verhindert die Allokation eines neuen Arrays bei jedem rekursiven Aufruf und erleichtert das Zusammenführen von Teilbaum-Ergebnissen.

Häufige Probleme

Häufig gestellte Fragen

Hat scene.rootNode trägt es selbst eine Entität? Nein. Der Wurzelknoten ist ein Container, der von der Bibliothek automatisch erstellt wird. Er hat keine Entität. Ihre Geometrie und andere Szenenobjekte befinden sich auf Kindknoten eine oder mehrere Ebenen darunter. rootNode.

Was ist der Unterschied zwischen node.entity und node.entities? node.entity enthält die einzelne primäre Entität (der übliche Fall). Einige ältere FBX- und COLLADA-Dateien können Knoten mit mehreren angehängten Entitäten erzeugen; in diesem Fall node.entities (Plural) liefert die vollständige Liste.

Kann ich in Breitensuche statt in Tiefensuche traversieren? Ja. Verwenden Sie eine Warteschlange anstelle eines rekursiven Aufrufs: push scene.rootNode in ein Array, dann shift und verarbeite Knoten, während du jedes Knoten’s childNodes in das Ende der Warteschlange.

Ist scene.open() synchron? Ja. scene.open() und scene.openFromBuffer() blockieren beide den aufrufenden Thread, bis die Datei vollständig geparst ist. Packen Sie sie in einen Worker‑Thread, wenn Sie die Ereignisschleife reaktionsfähig halten müssen.

Wie erhalte ich Welt‑Raum‑Positionen von einem Knoten? Lesen node.globalTransform; es gibt ein schreibgeschütztes GlobalTransform mit der Welt‑Raum‑Matrix, zusammengesetzt aus allen übergeordneten Transformationen. Für explizite Matrixberechnungen rufen Sie node.evaluateGlobalTransform(false).

Welche Entitätstypen sind neben Mesh? Camera, Light, und benutzerdefinierte Skelett-/Knochen-Entitäten. Prüfen node.entity.constructor.name oder verwenden instanceof mit der spezifischen Klasse importiert aus @aspose/3d.

Siehe auch

• Wie man 3D‑Modelle in TypeScript lädt
• Wie man programmgesteuert ein 3D‑Mesh in TypeScript erstellt
• Entwicklerhandbuch: Szenengraph
• npm: @aspose/3d