Cách Duyệt Đồ Thị Cảnh 3D trong TypeScript

Đồ thị cảnh trong Aspose.3D FOSS cho TypeScript là một cây của Node các đối tượng có gốc tại scene.rootNode. Việc duyệt là đệ quy: mỗi nút cung cấp một childNodes iterable và một tùy chọn entity property. Hướng dẫn này chỉ ra cách duyệt toàn bộ cây, xác định các loại thực thể, và thu thập thống kê mesh.

Yêu cầu trước

• Node.js 18 trở lên
• TypeScript 5.0 trở lên
• @aspose/3d đã cài đặt

Hướng Dẫn Từng Bước

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>

Mẹo và Thực hành Tốt nhất

• Luôn kiểm tra null node.entity trước khi truy cập các thuộc tính đặc thù của thực thể. Nhiều nút là các nút nhóm thuần túy không mang thực thể nào.
• Sử dụng instanceof trên constructor.name để kiểm tra kiểu trong các luồng logic. instanceof là an toàn khi tái cấu trúc; so sánh chuỗi trên constructor.name bị lỗi khi minification.
• Duyệt qua for...of trên childNodes: iterable xử lý mọi kích thước mảng một cách an toàn. Tránh sử dụng chỉ mục số để đảm bảo khả năng tương thích trong tương lai.
• Tránh thay đổi cây trong quá trình duyệt: không thêm hoặc xóa nút trong lời gọi đệ quy. Thu thập kết quả trước, sau đó mới sửa đổi.
• Truyền một mảng kết quả làm tham số: điều này tránh việc cấp phát mảng mới trong mỗi lời gọi đệ quy và giúp dễ dàng hợp nhất kết quả của các nhánh con.

Các vấn đề thường gặp

Câu hỏi thường gặp

Có scene.rootNode bản thân nó có mang một thực thể không? Không. Nút gốc là một container được thư viện tạo tự động. Nó không có thực thể. Hình học và các đối tượng cảnh khác của bạn tồn tại trên các nút con, cách đây một hoặc nhiều cấp độ. rootNode.

Sự khác nhau giữa node.entity và node.entities? node.entity giữ thực thể chính duy nhất (trường hợp phổ biến). Một số tệp FBX và COLLADA cũ hơn có thể tạo ra các nút với nhiều thực thể đính kèm; trong trường hợp đó node.entities (số nhiều) cung cấp danh sách đầy đủ.

Tôi có thể duyệt theo thứ tự rộng (breadth-first) thay vì sâu (depth-first) không? Có. Sử dụng một hàng đợi thay vì gọi đệ quy: đẩy scene.rootNode vào một mảng, sau đó shift và xử lý các nút trong khi đẩy mỗi nút childNodes vào cuối hàng đợi.

Có phải scene.open() đồng bộ không? Có. scene.open() và scene.openFromBuffer() cả hai đều chặn luồng gọi cho đến khi tệp được phân tích hoàn toàn. Đặt chúng trong một luồng worker nếu bạn cần giữ vòng lặp sự kiện phản hồi.

Làm sao tôi lấy vị trí không gian thế giới từ một nút? Đọc node.globalTransform; nó trả về một đối tượng chỉ đọc GlobalTransform với ma trận không gian thế giới, được tạo thành từ tất cả các biến đổi của tổ tiên. Đối với phép tính ma trận rõ ràng, gọi node.evaluateGlobalTransform(false).

Các loại thực thể nào có thể có ngoài Mesh? Camera, Light, và các thực thể khung xương/xương tùy chỉnh. Kiểm tra node.entity.constructor.name hoặc sử dụng instanceof với lớp cụ thể được nhập từ @aspose/3d.

Xem thêm

• How to Load 3D Models in TypeScript
• Cách xây dựng Mesh 3D một cách lập trình trong TypeScript
• Hướng dẫn nhà phát triển: Đồ thị cảnh
• npm: @aspose/3d