Començar

Aspose.3D FOSS per a Python

Benvingut a Aspose.3D FOSS per a Python, una biblioteca gratuïta, amb llicència MIT, per a carregar, construir i exportar escenes 3D des de Python. Aquesta guia us portarà d’un entorn nou a una escena funcional en pocs minuts.

Requisits previs

Abans d’instal·lar, assegureu-vos que el vostre entorn compleixi aquests requisits:

Versió de Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython és l’intèrpret de referència; les sis versions es comproven en cada versió.

Gestor de paquets

  • pip (inclòs amb totes les instal·lacions modernes de Python)
  • No es requereixen altres eines de construcció, compiladors o paquets del sistema

Sistema operatiu

  • Windows, macOS i Linux són compatibles
  • La biblioteca és pura Python: no hi ha cap extensió nativa específica de plataforma per compilar

Instal·lació

Instal·leu des de PyPI amb pip:

pip install aspose-3d-foss

Vegeu la Guia d’instal·lació per a la configuració d’entorns virtuals, passos de verificació i un exemple de codi d’inici ràpid.

Aspose.3D FOSS per a Python

Un cop instal·lat, podeu immediatament:

  • Carrega OBJ (amb suport de material .mtl), STL, glTF 2.0, GLB, COLLADA i 3MF fitxers
  • Inspecciona jerarquies d’escena: recorre nodes, llegeix malles, accedeix a les normals de vèrtex i a les UV
  • Transforma escenes: aplica posicions, rotacions (via Quaternion), i escales utilitzant Transform
  • Aplica materials:treballa amb LambertMaterial i PhongMaterial en nodes d’escena
  • Exporta a qualsevol format compatible amb opcions de desament per format
  • Calcula geometria: consulta caixes delimitadores, acumula transformacions en l’espai mundial amb GlobalTransform
  • Llegeix animació: accés AnimationClip i KeyframeSequence dades dels fitxers glTF i COLLADA carregats

Inici ràpid

El codi següent carrega un fitxer d’escena, imprimeix els fills del node arrel i torna a desar l’escena en format 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")

Propers passos

 Català