Comenzando

Aspose.3D FOSS para Python

Bienvenido a Aspose.3D FOSS para Python, una biblioteca gratuita, con licencia MIT, para cargar, construir y exportar escenas 3D desde Python. Esta guía te llevará desde un entorno nuevo hasta una escena funcional en unos minutos.

Requisitos previos

Antes de instalar, asegúrese de que su entorno cumpla con estos requisitos:

Versión de Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython es el intérprete de referencia; las seis versiones se prueban en cada lanzamiento

Gestor de paquetes

  • pip (incluido con todas las instalaciones modernas de Python)
  • No se requieren otras herramientas de compilación, compiladores o paquetes del sistema

Sistema operativo

  • Windows, macOS y Linux son compatibles
  • La biblioteca es pura Python: no hay extensiones nativas específicas de plataforma que compilar

Instalación

Instale desde PyPI usando pip:

pip install aspose-3d-foss

Vea la Guía de instalación para la configuración del entorno virtual, pasos de verificación y un ejemplo de código de inicio rápido.

Aspose.3D FOSS para Python

Una vez instalado, puede inmediatamente:

  • Cargar archivos OBJ (con soporte de material .mtl), STL, glTF 2.0, GLB, COLLADA y 3MF
  • Inspeccionar jerarquías de escena: recorrer nodos, leer mallas, acceder a normales de vértices y UVs
  • Transformar escenas: aplicar posiciones, rotaciones (a través de Quaternion), y escalas usando Transform
  • Aplicar materiales:trabajar con LambertMaterial y PhongMaterial en nodos de escena
  • Exportar a cualquier formato compatible con opciones de guardado por formato
  • Calcular geometría: consultar cajas delimitadoras, acumular transformaciones en espacio mundial con GlobalTransform
  • Leer animación: acceso AnimationClip y KeyframeSequence datos de archivos glTF y COLLADA cargados

Inicio rápido

El siguiente código carga un archivo de escena, imprime los hijos del nodo raíz y vuelve a guardar la escena en formato GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Próximos pasos

 Español