Cómo comenzar con Aspose.3D FOSS para TypeScript

@aspose/3d para TypeScript es un paquete gratuito, licenciado por MIT para cargar, manipular y salvando archivos 3D en Node.js — no se requieren las binarias nativas, instalables desde el npm.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde npm (Node.js 18 o más tarde requerido):

npm install @aspose/3d@24.12.0

Verifique la instalación cargada correctamente:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

Paso 2: Importar las clases necesarias

Importa las clases que necesitas del paquete:

import { Scene, Node } from "@aspose/3d";

Paso 3: Cargar un archivo 3D

Uso scene.open() para cargar cualquier formato apoyado. la biblioteca detecta el formato Automaticamente desde la extensión de archivo:

import { Scene } from "@aspose/3d";

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

Uso de la técnica de fábrica estática:

const scene = Scene.fromFile("model.glb");

Paso 4: Caminar por el gráfico de escena

Una escena cargada es un árbol de Node Objetos enracinados en scene.rootNode:

import { Scene, Node } from "@aspose/3d";

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);

Paso 5: Salva en un formato diferente

Uso scene.save() para exportar a cualquier formato de salida compatible. la biblioteca detecta el Formato de salida del archivo extendido:

import { Scene } from "@aspose/3d";

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Problemas y soluciones comunes

Error: ENOENT Cuando llamar scene.open() El camino que pasaste no existe.Utilizar un camino absoluto o path.resolve() Para asegurar El camino de archivo es correcto.

Error de formato desconocido Asegúrese que la extensión de archivo se ajusta al formato real.La biblioteca detecta el formato por Extension para open() y fromFile().Pasar un parámetro de formato explícito para sobreride.

Escena vacía después de la carga Algunos formatos binarios pueden requerir opciones de carga específicas.Tenta utilizar la sobrecarga explícita con opciones específicas de formato si la carga predeterminada produce una escena vacía.

Errores de importación de TipoScript Las definiciones de tipo están vinculadas con el paquete. "moduleResolution": "bundler" o "node16" Está establecido en tu tsconfig.json.

Preguntas frecuentes

¿Sinoplanet / 3d requiere de cualquier binario nativo?

No. El paquete es puro JavaScript/TypeScript con ninguna dependencia nativa. se lleva a cabo en cualquier plataforma que apoye Node.js 18 o más tarde.

¿Qué versiones de Node.js se apoyan?

Node.js 18 o más tarde. El paquete se ejecuta en Windows, macOS y Linux.

¿La biblioteca es libre para uso comercial?

Se publica bajo la Licencia MIT. Puede utilizar, modificar y redistribuirlo para cualquier propósito, incluidas las aplicaciones comerciales.

¿Qué formatos 3D puedo leer y escribir?

El paquete soporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA y PLY para la lectura de ambos. y escribe.Utilizar la extensión basada en scene.save() para exportar a cualquier formato apoyado.

¿Puedo crear una escena 3D de la escuridad?

Construcción A Scene sin argumentos, añade nodos infantiles a los scene.rootNode,y, Salvo en el formato deseado.