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

Aspose.3D FOSS for TypeScript

Carga, construye, transforma y exporta escenas 3D desde Node.js — totalmente tipado, de código abierto y listo para producción con una sola npm install.

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

Documentación GitHub

Librería de TipoScript de código abierto para procesamiento de archivos 3D

Aspose.3D FOSS for 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 renderizador.

La biblioteca expone un API de grafo de escena totalmente tipado construido 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 te 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 apunta 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 tu 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, consulta Aspose.3D — Enterprise Product Family.

3D y Tipo de Escena-Grafía API

  • OBJ / MTL: Carga los archivos OBJ de Wavefront con las definiciones de material que acompañan.
  • glTF 2.0 / GLB: Carga de material PBR y salida binaria de GLS a través de GltfSaveOptions.
  • STL: Leer y escribir tanto binario como ASCII STL con verificación de ronda completa.
  • COLLADA, 3MF, FBX: Suporte adicional de formato con clases de opciones por formato.
  • Tipos de Tipo completo: Cada clase, método y opción se escribe con fuerza con noImplicitAny y strictNullChecks.

Dónde Aspose.3D FOSS Puede Usarse

  • **Node.js: Importa los archivos OBJ, valida y reoriente la geometría, e exporta como GLB en CI.
  • Tooling de juego: Proceso de batch 3D mesas sin un motor nativo o render.
  • Fluentes de trabajo de impresión 3D: Leer, validar y reexportar archivos STL y 3MF.
  • Backends sin servidor: Ejecutar los puntos finales de conversión 3D en Lambda o Funciones de la nube.
  • Migración de contenido: Convertir entre las familias de formatos a escala desde un único script.

Opciones Per-Format y Control de Coordinación

  • Orientación de sistema coordinado: Ases Flip y ajuste la escala por formato con clases opcionales.
  • Normalización: Normalizar automáticamente las normales vertex en carga o ahorro.
  • Binario vs. JSON: Seleccione GLB compacto o glTF leible a través de GltfSaveOptions.
  • Control de carga del material: Activar o desactivar la carga MTL/texture para un parchete más rápido.
  • Fidelidad de la ruta redonda: Los nodos de gráfico desconocidos se conservan verbatim en re-salvo.

Experiencia de desarrollador

Aspose.3D FOSS para TypeScript se instala con un único comando npm install @aspose/3d. No hay ads nativos para compilar. La biblioteca es pura TypeScripts/JavaScript con una dependencia automática (xmldom).

La API firmemente tipada proporciona un autocomplete completo de IDE para cada clase y opción de formato de escenario. la biblioteca mira a Node.js 18-22+ y TypeScript 5.0+, se lleva a cabo idénticamente en los runners CI Linux y las estaciones de trabajo del desarrollador, y está licenciado por MIT con un rastreador de problemas abiertos 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 JSON glTF 2.0 estándar — 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 en GLB binario

Para producir un GLB binario compacto en lugar del JSON glTF por defecto, pasa GltfSaveOptions con binaryMode = true. Tanto open() y save() son sincronos — 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, licenciada por MIT TypeScript/Node.js para cargar, manipular y ahorrar escenas 3D sin instalar ningún addon nativo o SDK externo.

¿Qué formatos 3D se apoyan?

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

¿Necesita los ads nativos de Node.js?

No. Aspose.3D FOSS para TypeScript es puro JavaScript/TypeScript. no requiere paso de compilación y tiene una dependencia de tiempo de trabajo único (xmldom) instalado automáticamente por npm.

¿Cómo lo instalaré?

Run npm install @aspose/3d. No se requieren paquetes de sistema adicionales o ads nativos.

¿Qué versiones de Node.js y TypeScript están apoyadas?

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

¿Tiene una definición de tipo TypeScript?

Todos los tipos de clases, métodos, enumeras y opciones están totalmente impresos con noImplicitAny y strictNullChecks activados.

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

Por formato clases de opciones como ObjLoadOptions y GltfSaveOptions permiten que se flip a los ángulos, ajuste la escala y normalize las normas sin codificar personalizado.

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

La biblioteca está licenciada por MIT y se alojará en GitHub. los informes de bugs y las solicitudes de pilación son bienvenidos.

  

Recursos de soporte y aprendizaje

 Español