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

Aspose.3D FOSS para Python

Carga, crea, transforma y exporta escenas 3D desde Python — gratuito y de código abierto.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Documentación GitHub

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

Aspose.3D FOSS para Python es una biblioteca con licencia MIT, pure-Python, para trabajar con formatos de archivo 3D. Instálala con un solo comando pip y comienza de inmediato a leer, construir y escribir escenas 3D sin instalar ningún runtime nativo, SDK externo o renderizador de terceros.

La biblioteca expone una API de grafo de escena limpia construida alrededor de Scene, Node, Mesh, Camera, Light y Transform, el mismo modelo conceptual utilizado por herramientas 3D profesionales. El soporte de formatos incluye OBJ (con carga de materiales .mtl), STL (binario y ASCII, verificado en ida y vuelta), glTF 2.0 / GLB (PBR materials), COLLADA (DAE), 3MF y FBX. Las opciones de carga y guardado por formato le permiten controlar coordinate flipping, scale, normal normalization y material loading sin escribir ningún código de análisis específico de formato.

Aspose.3D FOSS admite Python 3.7 a 3.12 y se ejecuta idénticamente en Windows, macOS y Linux CI runners, contenedores Docker y entornos sin servidor. Para funciones empresariales y soporte, consulte Aspose.3D for Python — Enterprise Product.

Compatibilidad con formatos 3D y API de grafo de escena

  • OBJ / MTL: Cargar archivos Wavefront OBJ con definiciones de material adjuntas.
  • STL: Leer y escribir STL tanto binario como ASCII con verificación completa de ida y vuelta.
  • glTF 2.0 / GLB: Carga de material PBR y salida binaria GLB a través de GltfSaveOptions.
  • COLLADA, 3MF, FBX: Soporte adicional de formato con clases de opciones por formato.
  • API de grafo de escena: Scene, Node, Mesh, Camera, Light, Transform.

Dónde se puede usar Aspose.3D FOSS

  • Asset validation pipelines: Verificar, reorientar y reexportar activos 3D en CI.
  • Herramientas de desarrollo de juegos: Procesa por lotes mallas OBJ/GLB sin un motor nativo.
  • Flujos de trabajo de impresión 3D: Leer, validar y volver a exportar archivos STL y 3MF.
  • Web backends: Sirva puntos finales de conversión 3D en Docker o funciones sin servidor.
  • Migración de contenido: Convierta entre familias de formatos a gran escala.

Opciones por formato y control de coordenadas

  • Orientación del sistema de coordenadas: Voltear ejes y ajustar la escala por formato sin código personalizado.
  • Normalización de normales: Normaliza automáticamente las normales de los vértices al cargar o guardar.
  • Control de carga de material: Habilite o deshabilite la carga de MTL/textura para un análisis más rápido.
  • Salida binaria vs. salida JSON: Elija GLB compacto o glTF legible por humanos mediante opciones.
  • Fidelidad de ida y vuelta: La estructura del grafo de escena se mantiene a través de los ciclos de carga y guardado (la fidelidad de preservación de nodos depende del formato y no se ha verificado de forma independiente para todos los formatos).

Experiencia del desarrollador

Aspose.3D FOSS para instalaciones de Python con un solo comando pip install aspose-3d-foss. La biblioteca es pura Python, sin extensiones nativas que compilar y sin paquetes del sistema que instalar.

La API de scene-graph refleja el modelo conceptual de las herramientas 3D profesionales, por lo que la curva de aprendizaje es corta para cualquiera familiarizado con el modelo de datos de Three.js o Blender. La biblioteca es MIT-licensed, open-source, y da la bienvenida a los informes de errores y contribuciones en GitHub.

Cargar una escena OBJ y exportar como glTF

Instale con pip, luego llame a Scene.open() con ObjLoadOptions para cargar el archivo OBJ junto con sus definiciones de material MTL. Una única llamada a scene.save() con una extensión .gltf escribe un archivo JSON glTF 2.0 — no se necesita registro de formato ni objeto convertidor.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

Convertir STL a GLB binario con inversión de coordenadas

Para producir un GLB binario compacto en lugar del glTF JSON predeterminado, pase una instancia de GltfSaveOptions con binary_mode = True. El mismo patrón se aplica a los ajustes del sistema de coordenadas — reemplace la clase de opciones por el formato al que está apuntando.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Preguntas frecuentes

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

Es una biblioteca gratuita, con licencia MIT, pure-Python, para cargar, manipular y guardar escenas 3D sin instalar ningún runtime nativo ni SDK externo.

¿Qué formatos 3D son compatibles?

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

¿Requiere alguna dependencia nativa?

No. Aspose.3D FOSS para Python es pure Python sin extensiones nativas. Funciona en Windows, macOS y Linux sin ningún paso de compilación.

¿Cómo lo instalo?

Ejecute pip install aspose-3d-foss. No se requieren paquetes del sistema adicionales ni extensiones nativas.

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

Sí. Las clases de opciones por formato le permiten invertir ejes, ajustar la escala y normalizar normales sin escribir código de análisis específico de cada formato.

¿Qué versiones de Python son compatibles?

Python 3.7 a 3.12 son compatibles. La biblioteca se ejecuta idénticamente en todos los principales sistemas operativos.

¿Está disponible el código fuente?

Sí. La biblioteca tiene licencia MIT y está alojada en GitHub. Se agradecen los informes de errores y las solicitudes de extracción.

  

Recursos de soporte y aprendizaje

 Español