Guía del desarrollador

Aspose.3D FOSS para TypeScript es una biblioteca de código abierto, con licencia de MIT que permite a los desarrolladores de Node.js cargar, construir, transformar y exportar escenas 3D con la seguridad de tipo TypeScript completa. Ya sea que esté construyendo una pipeline de activos, un servicio de conversión de formatos, una herramienta de validación de geometría o un script de creación de contenido 3D, esta biblioteca proporciona una API limpia y consistente respaldada por un modelo de gráfico de escena que refleja los conceptos 3D estándar de la industria.

Esta Guía de Desarrolladores cubre todo lo que necesita para ir más allá de la instalación de inicio rápido y escribir código de procesamiento 3D de calidad de producción.

Lo que encontrarás en esta sección

Características y Funcionalidades

El Características la página es la referencia principal para trabajar con Aspose.3D FOSS para TypeScript. Cubre:

  • Compatibilidad de formatos: OBJ (con materiales .mtl), glTF 2.0 / GLB binario, STL (binario y ASCII), COLLADA (DAE), 3MF y FBX, con clases de opciones de carga y guardado por formato que incluyen ObjLoadOptions y GltfSaveOptions.
  • Grafo de escena: Cómo Scene, Node, Entity, Transform, y SceneObject compone una jerarquía completa de escena, incluidos los patrones de recorrido de nodos hijos.
  • Geometría y API de malla: Trabajando con Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, y ReferenceMode para el procesamiento de geometría.
  • Sistema de materiales: Aplicando LambertMaterial, PhongMaterial, y PbrMaterial (PBR para glTF) a nodos de escena, y leyendo propiedades de material cargadas desde archivos .mtl.
  • Utilidades matemáticas: Usando Vector3, Vector4, Matrix4, Quaternion, y BoundingBox para transformaciones, consultas de cajas delimitadoras y cálculos geométricos.
  • Animación: Construcción y lectura AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, y Extrapolation datos.
  • Soporte de flujo y búfer: Cargando escenas 3D desde la memoria Buffer objetos a través de scene.openFromBuffer() para casos de uso sin servidor y de transmisión.
  • Ejemplos completos de uso: Scripts TypeScript de extremo a extremo para cargar OBJ, exportar GLB, hacer round‑trip de STL y recorrer grafos de escena.
  • Consejos, problemas comunes y preguntas frecuentes: Guía práctica para evitar errores habituales en el uso en producción.
  • Resumen de referencia de API: Listado de referencia rápida de todas las clases clave y sus métodos principales.

Conceptos clave

Grafo de escena: Todo el contenido 3D en Aspose.3D FOSS se representa como un árbol de Node objetos con raíz en scene.rootNode. Cada nodo puede contener un Entity (como un Mesh, Camera, o Light) y un Transform que lo posiciona en la jerarquía.

API independiente del formato: Abres cualquier formato compatible a través de scene.open() o scene.openFromBuffer() y guardas en cualquier formato compatible a través de scene.save(). Los mismos objetos del grafo de escena se usan sin importar el formato de origen o destino.

Tipado fuerte de TypeScript: La biblioteca se entrega con configuraciones estrictas del compilador (noImplicitAny, strictNullChecks) y definiciones de tipos completas. Cada clase, método y propiedad de opción está totalmente tipada, lo que le brinda autocompletado en el IDE y seguridad en tiempo de compilación a lo largo de su código de procesamiento 3D.

Dependencia única: La única dependencia en tiempo de ejecución es xmldom, que se instala automáticamente mediante npm. No hay complementos nativos que compilar y no hay paquetes del sistema que instalar.

Comenzando

Si aún no ha instalado la biblioteca, consulte la Comenzando sección y el Instalación guía antes de seguir leyendo.

Temas disponibles

 Español