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

Aspose.3D FOSS for Python

Cargar, crear, transformar y exportar 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 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 un API de grafo de escena limpio construido 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 (materiales PBR), COLLADA (DAE), 3MF y FBX. Las opciones de carga y guardado por formato le permiten controlar la inversión de coordenadas, escala, normalización de normales y carga de materiales sin escribir código de análisis específico de cada formato.

Aspose.3D FOSS soporta 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 características y soporte empresarial, consulte Aspose.3D for Python — Enterprise Product.

3D y el soporte de gráficos

  • 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 materiales PBR y salida binaria GLB a través de GltfSaveOptions.
  • COLLADA, 3MF, FBX: Soporte adicional de formatos con clases de opciones por formato.
  • Scene-graph API: Scene, Node, Mesh, Camera, Light, Transform.

Dónde Aspose.3D FOSS puede usarse

  • Puebles de validación de activos: Verificar, reorientar y reexportar activas 3D en CI.
  • Tooling de desarrollo del juego: Proceso de batch OBJ/GLB mesas sin un motor nativo.
  • Fluentes de trabajo de impresión 3D: Leer, validar y reexportar archivos STL y 3MF.
  • Backend: Servicio de puntos finales de conversión 3D en funciones Docker o sin servidor.
  • Migración de contenido: Convertir entre las familias de formato a escala.

Opciones Per-Format y Control de Coordinación

  • Orientación de sistema coordinado: Ases Flip y ajuste de escala por formato sin código personalizado.
  • Normalización: Normalizar automáticamente las normales vertex en carga o ahorro.
  • Control de carga del material: Activar o desactivar la carga MTL/texture para un parchete más rápido.
  • Binario vs. JSON: Elegir GLB compacto o glTF humano-leable a través de opciones.
  • Fidelidad de la ruta redonda: La estructura del gráfico de escena se mantiene a través de los ciclos de carga y ahorro (la fidelidade de conservación de nodo es formato-dependente y no verificado independientemente para todos los formatos).

Experiencia de desarrollador

Aspose.3D FOSS para Python se instala con un único comando pip install aspose-3d-foss. La biblioteca es pura Pythón, sin exteniones nativas para compilar y no hay paquetes de sistema para instalar.

La API de gráficos de escena refleja el modelo conceptual de herramientas 3D profesionales, por lo que la curva de aprendizaje es corta para cualquiera familiar con el modelado de datos de Three.js o Blender. La biblioteca está licenciada por MIT, abierta y acoge los informes de errores y las 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 glTF 2.0 JSON — 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 en GLB binario con Flipping Coordinate

Para producir un GLB binario compacto en lugar del JSON glTF por defecto, pasa una instancia GltfSaveOptions con binary_mode = True. El mismo patrón se aplica a ajustes de sistema de coordenadas - cambia la clase de opciones para el formato que está dirigido.

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 libre, licenciada por MIT pura Python para cargar, manipular y ahorrar escenas 3D sin instalar ningún tiempo de trabajo nativo o SDK externo.

¿Qué formatos 3D se apoyan?

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

¿Necesita alguna dependencia nativa?

No. Aspose.3D FOSS para Python es puro Pythón con extensiones nativas cero. se lleva a cabo en Windows, macOS y Linux sin ningún paso de compilación.

¿Cómo lo instalaré?

Run pip install aspose-3d-foss. No se requieren paquetes de sistema adicionales o exteniones nativas.

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

Las clases de opciones por formato le permiten flip axes, ajustar la escala y normalizar las normas sin escribir ningún código de parción específico para el formato.

¿Qué versiones de Python se apoyan?

Se soporta Python 3.7 a 3.12. la biblioteca funciona de manera idéntica en todos los sistemas operativos principales.

¿El código de fuente está disponible?

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

  

Recursos de soporte y aprendizaje

 Español