Guía del desarrollador

Aspose.3D FOSS para Python es una biblioteca de código abierto, con licencia MIT, que permite a los desarrolladores de Python cargar, construir, transformar y exportar escenas 3D sin dependencias externas en tiempo de ejecución. Ya sea que estés construyendo una canalización de activos, una herramienta de validación, un script de procesamiento geométrico o un servicio de conversión de formatos, esta biblioteca proporciona una API limpia y coherente respaldada por un modelo de scene-graph que refleja los conceptos 3D estándar de la industria.

Esta Guía del desarrollador cubre todo lo que necesitas para ir más allá de la instalación rápida y escribir código de procesamiento 3D de calidad de producción.

Qué 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 Python. Cubre:

  • Soporte de formatos: OBJ (con materiales .mtl), STL (binario y ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, y el tokenizador FBX en desarrollo, con clases de opción de carga y guardado por formato.
  • Grafo de escena: Cómo Scene, Node, Entity, Transform, y GlobalTransform compón en una jerarquía completa de escena, incluidos los patrones de recorrido de nodos hijos.
  • Mesh API: Trabajando con control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, y VertexElementSmoothingGroup para el procesamiento de geometría.
  • Sistema de materiales: Aplicando LambertMaterial y PhongMaterial a los nodos de escena, y leyendo propiedades de material cargadas desde archivos .mtl.
  • Utilidades matemáticas: Usando Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, y BoundingBox para transformaciones, consultas de bounding-box y cálculos geométricos.
  • Animación: Construcción y lectura AnimationClip, AnimationNode, KeyFrame, y KeyframeSequence datos.
  • Opciones de carga y guardado: Clases de opciones por formato como ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Ejemplos completos de uso: Scripts de extremo a extremo Python para cargar OBJ, exportar STL, hacer round‑tripping de glTF y recorrer grafos de escena.
  • Consejos, problemas comunes y preguntas frecuentes: Guía práctica para evitar errores comunes en el uso en producción.
  • Resumen de referencia de API: Listado de referencia rápida de todas las clases clave.

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.root_node. Cada nodo puede llevar 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.from_file() y guardar en cualquier formato compatible a través de Scene.save(). Los mismos objetos del grafo de escena se utilizan sin importar el formato de origen o destino.

Cero dependencias: La biblioteca es pura Python. No hay ninguna extensión nativa que compilar, ningún paquete del sistema que instalar, y ninguna biblioteca de terceros que gestionar.

Comenzando

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

Temas disponibles

 Español