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

Aspose.3D FOSS for 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 usado 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 te 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 hasta 3.12 y se ejecuta idénticamente en Windows, macOS y Linux CI runners, contenedores Docker y entornos serverless. No hay ninguna extensión nativa que compilar ni paquete del sistema que instalar.

Compatibilidad con formatos 3D y API de grafo de escena

  • OBJ / MTL: Carga archivos Wavefront OBJ con sus definiciones de material adjuntas.
  • STL: Lee y escribe 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 mediante GltfSaveOptions.
  • COLLADA, 3MF, FBX: Soporte adicional de formatos 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

  • Canales de validación de activos: Verifica, reorienta y vuelve a exportar 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: Lee, valida y vuelve a exportar archivos STL y 3MF.
  • Web backends: Sirve puntos finales de conversión 3D en Docker o funciones sin servidor.
  • Migración de contenido: Convierte entre familias de formatos a gran escala.

Opciones por formato y control de coordenadas

  • Orientación del sistema de coordenadas: Invierte ejes y ajusta la escala por formato sin código personalizado.
  • Normalización de normales: Normaliza automáticamente las normales de vértices al cargar o guardar.
  • Control de carga de materiales: Habilita o deshabilita la carga de MTL/texturas para un análisis más rápido.
  • Salida binaria vs. JSON: Elige GLB compacto o glTF legible por humanos mediante opciones.
  • Fidelidad de ida y vuelta: La estructura del grafo de escena se mantiene a lo largo de los ciclos de carga y guardado (la fidelidad de preservación de nodos depende del formato y no está verificada 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 del grafo de escena refleja el modelo conceptual de las herramientas 3D profesionales, por lo que la curva de aprendizaje es corta para quien esté familiarizado con el modelo de datos de Three.js o Blender. La biblioteca tiene licencia MIT, es de código abierto y acepta informes de errores y contribuciones en GitHub.

Cargar una escena OBJ y exportar como glTF

Instala con pip, luego llama a Scene.open() con ObjLoadOptions para cargar el archivo OBJ junto con sus definiciones de material MTL. Una única llamada scene.save() con extensión .gltf escribe un archivo JSON glTF 2.0, sin necesidad de un registro de formatos ni de un objeto convertidor.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

# Cargar un archivo OBJ (con materiales .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Exportar como 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")

# Guardar como GLB binario
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Preguntas frecuentes

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

Es una biblioteca gratuita, bajo 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. Se ejecuta 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 aceptan informes de errores y pull requests.

  

Recursos de soporte y aprendizaje

 Español