1. Productos
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS para TypeScript

Cargue, construya, transforme y exporte escenas 3D desde Node.js — totalmente tipado, de código abierto y listo para producción con una única instalación npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Documentación GitHub

Biblioteca de TypeScript de código abierto para el procesamiento de archivos 3D

Aspose.3D FOSS para TypeScript es una biblioteca con licencia MIT para trabajar con formatos de archivo 3D en aplicaciones Node.js. Instálala con un único comando npm install @aspose/3d y comienza a leer, construir y escribir escenas 3D en TypeScript de inmediato, sin complementos nativos que compilar, sin SDK externos que instalar y sin necesidad de un motor de renderizado.

La biblioteca expone una API de grafo de escena totalmente tipada construida alrededor de Scene, Node, Entity, Mesh, Camera, Light y Transform, el mismo modelo conceptual usado por herramientas 3D profesionales. El soporte de formatos incluye OBJ (Wavefront, con carga de materiales .mtl), glTF 2.0 y GLB binario (materiales PBR), STL (binario y ASCII, ciclo completo), COLLADA (DAE), 3MF y FBX. Clases de opciones por formato como ObjLoadOptions y GltfSaveOptions le brindan un control preciso sobre la orientación del sistema de coordenadas, escala, normalización de normales, salida binaria vs. JSON y carga de materiales.

Aspose.3D FOSS está dirigido a Node.js 18, 20 y 22+ con TypeScript 5.0+ y se compila a CommonJS. La biblioteca se entrega con configuraciones estrictas del compilador TypeScript (noImplicitAny, strictNullChecks) para que su IDE ofrezca autocompletado completo y seguridad en tiempo de compilación. Su única dependencia en tiempo de ejecución, xmldom, se instala automáticamente.

Compatibilidad con formatos 3D y API de grafo de escena tipada

  • OBJ / MTL: Carga archivos Wavefront OBJ con sus definiciones de material adjuntas.
  • glTF 2.0 / GLB: Carga de materiales PBR y salida binaria GLB mediante GltfSaveOptions.
  • STL: Lee y escribe STL tanto binario como ASCII con verificación de ciclo completo.
  • COLLADA, 3MF, FBX: Soporte adicional de formatos con clases de opciones por formato.
  • Tipos completos de TypeScript: Cada clase, método y opción está fuertemente tipado con noImplicitAny y strictNullChecks.

Dónde se puede usar Aspose.3D FOSS

  • Pipelines de activos en Node.js: Importa archivos OBJ, valida y reorienta la geometría, y exporta como GLB en CI.
  • Herramientas de juego: Procesa por lotes mallas 3D sin un motor o renderizador nativo.
  • Flujos de trabajo de impresión 3D: Lee, valida y vuelve a exportar archivos STL y 3MF.
  • Backends sin servidor: Ejecuta puntos finales de conversión 3D en Lambda o Cloud Functions.
  • Migración de contenido: Convierte entre familias de formatos a gran escala desde un solo script.

Opciones por formato y control de coordenadas

  • Orientación del sistema de coordenadas: Invierte ejes y ajusta la escala según el formato con clases de opciones.
  • Normalización de normales: Normaliza automáticamente las normales de vértices al cargar o guardar.
  • Salida binaria vs. JSON: Selecciona GLB compacto o glTF legible mediante GltfSaveOptions.
  • Control de carga de materiales: Habilita o deshabilita la carga de MTL/texturas para un análisis más rápido.
  • Fidelidad de ida y vuelta: Los nodos desconocidos del grafo de escena se conservan literalmente al volver a guardar.

Experiencia del desarrollador

Aspose.3D FOSS para instalaciones de TypeScript con un solo comando npm install @aspose/3d. No hay complementos nativos que compilar. La biblioteca es puro TypeScript/JavaScript con una dependencia auto‑instalada (xmldom).

La API fuertemente tipada ofrece autocompletado completo en el IDE para cada clase del grafo de escena y cada opción de formato. La biblioteca está dirigida a Node.js 18–22+ y TypeScript 5.0+, se ejecuta idénticamente en runners de CI Linux y estaciones de trabajo de desarrolladores, y tiene licencia MIT con un rastreador de incidencias abierto en GitHub.

Cargar una escena OBJ y exportar como glTF

Instala con npm, luego usa el método síncrono scene.open() con ObjLoadOptions para cargar la malla junto con su archivo de material MTL. Llamar a scene.save() con una extensión .gltf escribe JSON estándar glTF 2.0; el formato se infiere automáticamente de la extensión del archivo.

npm install @aspose/3d

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

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

// Exportar como glTF 2.0 JSON
scene.save("model.gltf");

Convertir STL a GLB binario

Para producir un GLB binario compacto en lugar del JSON glTF predeterminado, pase GltfSaveOptions con binaryMode = true.

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

const scene = new Scene();
scene.open("mesh.stl");

// Guardar como GLB binario compacto
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Preguntas frecuentes

¿Qué es Aspose.3D FOSS para TypeScript?

Es una biblioteca gratuita, con licencia MIT, de TypeScript/Node.js para cargar, manipular y guardar escenas 3D sin instalar ningún complemento nativo ni SDK externo.

¿Qué formatos 3D son compatibles?

OBJ (con .mtl), glTF 2.0 y GLB, STL (binario y ASCII), COLLADA (DAE), 3MF y FBX. Cada formato tiene una clase de opciones tipada dedicada.

¿Requiere complementos nativos de Node.js?

No. Aspose.3D FOSS for TypeScript es puro JavaScript/TypeScript. No requiere paso de compilación y tiene una única dependencia en tiempo de ejecución (xmldom) instalada automáticamente por npm.

¿Cómo lo instalo?

Ejecute npm install @aspose/3d. No se requieren paquetes del sistema adicionales ni complementos nativos.

¿Qué versiones de Node.js y TypeScript son compatibles?

Node.js 18, 20 y 22+. TypeScript 5.0+. La biblioteca se compila a CommonJS y funciona con configuraciones estrictas de TypeScript.

¿Incluye definiciones de tipos de TypeScript?

Sí. Todas las clases, métodos, enumeraciones y tipos de opciones están completamente tipados con noImplicitAny y strictNullChecks habilitados.

¿Puedo controlar la orientación del sistema de coordenadas?

Sí. Las clases de opciones por formato, como ObjLoadOptions y GltfSaveOptions, le permiten invertir ejes, ajustar la escala y normalizar normales sin código de análisis personalizado.

¿Dónde puedo encontrar el código fuente?

La biblioteca tiene licencia MIT y está alojada en GitHub. Se agradecen los informes de errores y las pull requests.

  

Recursos de soporte y aprendizaje

 Español