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 SDKs externos que instalar y sin necesidad de un renderizador.

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 utilizado 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 se dirige a Node.js 18, 20 y 22+ con TypeScript 5.0+ y compila a CommonJS. La biblioteca se entrega con configuraciones estrictas del compilador TypeScript (noImplicitAny, strictNullChecks) para que su IDE proporcione autocompletado completo y seguridad en tiempo de compilación. Su única dependencia en tiempo de ejecución, xmldom, se instala automáticamente. Para la familia de productos empresariales, consulte Aspose.3D — Enterprise Product Family.

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

  • OBJ / MTL: Cargar archivos Wavefront OBJ con definiciones de material adjuntas.
  • glTF 2.0 / GLB: Carga de material PBR y salida binaria GLB a través de GltfSaveOptions.
  • STL: Leer y escribir tanto STL binario como ASCII con verificación completa de ida y vuelta.
  • COLLADA, 3MF, FBX: Soporte adicional de formato con clases de opciones por formato.
  • Tipos completos de TypeScript: Cada clase, método y opción está tipado fuertemente con noImplicitAny y strictNullChecks.

Dónde se puede usar Aspose.3D FOSS

  • Node.js asset pipelines: Importar archivos OBJ, validar y reorientar la geometría, y exportar como GLB en CI.
  • Herramientas de juego: Procesamiento por lotes de mallas 3D sin un motor o renderizador nativo.
  • Flujos de trabajo de impresión 3D: Leer, validar y volver 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: Convierta entre familias de formatos a gran escala desde un solo script.

Opciones por formato y control de coordenadas

  • Orientación del sistema de coordenadas: Voltear ejes y ajustar la escala por formato con clases de opciones.
  • Normal normalization: Normaliza automáticamente las normales de los vértices al cargar o guardar.
  • Binario vs. salida JSON: Seleccione GLB compacto o glTF legible a través de GltfSaveOptions.
  • Control de carga de materiales: Habilitar o deshabilitar la carga de MTL/textura 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 TypeScript se instala 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 proporciona autocompletado completo en el IDE para cada clase del grafo de escena y opción de formato. La biblioteca está dirigida a Node.js 18–22+ y TypeScript 5.0+, se ejecuta idénticamente en los runners de CI de Linux y en las estaciones de trabajo de los 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 scene.open() con ObjLoadOptions para cargar la malla junto con su archivo de material MTL. Tanto open() como save() son sincrónicos — no se necesita await ni encadenamiento de Promise. Llamar a scene.save() con una extensión .gltf escribe el JSON estándar glTF 2.0 — el formato se infiere automáticamente a partir 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Convertir STL a GLB binario

Para producir un GLB binario compacto en lugar del glTF JSON predeterminado, pase GltfSaveOptions con binaryMode = true. Tanto open() como save() son sincrónicos — no se necesita await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
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 para TypeScript es JavaScript/TypeScript puro. 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