Jak przejść przez 3D Scene Graph w TypeScript

Grafika sceny w Aspose.3D FOSS dla TypeScript jest drzewem Node Obiekty z korzeniami w scene.rootNode.Przejazd jest recursywny: każdy węzły narażają na childNodes Niezależnie od tego, czy jest to opcjonalne entity Ten przewodnik pokazuje, jak chodzić przez cały drzewo, identyfikować typy podmiotów i zbierać statystyki z łupieżu.

Warunki

• Node.js 18 lub później
• TypScript 5.0 lub później
• @aspose/3d Instalacja

Przewodnik krok po kroku

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>

Porady i najlepsze praktyki

• Zawsze zero-check node.entity Przed dostępem do właściwości specyficznych dla podmiotu. Wiele węzłów to czyste grupy wązły, które nie przynoszą żadnej jednostki.
• Używanie instanceof nad constructor.name W przypadku kontrol typu w ścieżkach logicznych. instanceof jest bezpieczny; porównanie strun na constructor.name Zamieszka się z miniatyrą.
• Przejście przez for...of nad childNodes: nieprzyjemne obsługuje wszystkie rozmiary array bezpiecznie. unikać indeksowania numerycznego dla kompatybilności z przodu.
• Unikaj wymiany drzewa podczas przepływu:Nie dodaj ani nie usuwaj węzłów wewnątrz połączenia recursywnego. najpierw zbierz wyniki, a następnie modyfikuj.
• Przeprowadź aretę wyników jako parametr:To unika przypisywania nowego rzędu na każdym powtarzającym się wezwaniu i ułatwia połączenie wyników poddrzew.

wspólne kwestie

Często zadawane pytania

Czyli scene.rootNode Czy sam posiada podmiot? No. Krok jest kontenerem stworzonym automatycznie przez bibliotekę. nie ma podmiotu. geometry i inne obiekty sceny żyją na dziecięcych węzłów jeden lub więcej poziomów poniżej rootNode.

Jaka jest różnica między node.entity i node.entities? node.entity niektóre starsze pliki FBX i COLLADA mogą wytwarzać węzły z wieloma podłączonymi podmiotami; w tym przypadku node.entities (Plural) zawiera pełną listę.

Czy mogę przejść w szerokości pierwszej kolejności zamiast głębi pierwszej? Użyj cegły zamiast powtarzającego się połączenia: push scene.rootNode w kolejce, a następnie przełącz i przetwarzaj przyciski podczas naciśnięcia każdego przycisków childNodes Wchodzimy do tail.

Jest scene.open() Synchronizacja ? Tak i tak. scene.open() i scene.openFromBuffer() Obie blokują pasek wezwania, aż plik zostanie w pełni rozdrobniony. Włóż je do paska pracownika, jeśli potrzebujesz, aby przewód zdarzeń był reakcyjny.

Jak mogę uzyskać pozycje światowego przestrzeni z nodu? Czytaj node.globalTransform;Wróci do czytania tylko GlobalTransform z świat-space matrycy, składającej się ze wszystkich przodków transformacji. dla wyjaśnionej matrix matematyki, wezwanie node.evaluateGlobalTransform(false).

Jakie rodzaje podmiotów są możliwe oprócz Mesh? Camera, Light, i dostosowane podmioty skeletonowe / kości. sprawdź node.entity.constructor.name lub używać instanceof z klasą przywożoną od @aspose/3d.

Zobacz również

• Jak pobrać modele 3D w typografie
• Jak stworzyć 3D Mesh w programie TypeScript
• Przewodnik dla twórców: Scene Graph
• NPM: @aspose / 3d