Începeți

Aspose.3D FOSS pentru Python

Bine ați venit la Aspose.3D FOSS pentru Python, o bibliotecă gratuită, licențiată sub MIT, pentru încărcarea, construirea și exportarea scenelor 3D din Python. Acest ghid vă va duce de la un mediu proaspăt la o scenă funcțională în câteva minute.

Prerechizite

Înainte de instalare, asigurați-vă că mediul dvs. îndeplinește aceste cerințe:

Versiune Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython este interpretul de referință; toate cele șase versiuni sunt testate la fiecare lansare

Manager de pachete

  • pip (incluse în toate instalările moderne de Python)
  • Nu sunt necesare alte instrumente de construire, compilatoare sau pachete de sistem

Sistem de operare

  • Windows, macOS și Linux sunt toate suportate
  • Biblioteca este pur Python: nu există extensii native specifice platformei de compilat

Instalare

Instalați de pe PyPI utilizând pip:

pip install aspose-3d-foss

Consultați Ghidul de instalare pentru configurarea mediului virtual, pașii de verificare și un exemplu de cod rapid.

Aspose.3D FOSS pentru Python

După instalare puteți imediat:

  • Încărcați fișiere OBJ (cu suport pentru materiale .mtl), STL, glTF 2.0, GLB, COLLADA și 3MF
  • Inspectați ierarhiile scenei: parcurge nodurile, citește mesh-urile, accesează normalele vârfurilor și UV-urile
  • Transformare scene: aplică poziții, rotații (prin Quaternion), și scale utilizând Transform
  • Aplică materialele: lucrează cu LambertMaterial și PhongMaterial pe nodurile scenei
  • Exportă în orice format suportat cu opțiuni de salvare specifice fiecărui format
  • Calculează geometria:interoghează bounding boxes, acumulează transformările în spațiul lumii cu GlobalTransform
  • Citește animația: acces AnimationClip și KeyframeSequence date din fișierele glTF și COLLADA încărcate

Începe rapid

Codul de mai jos încarcă un fișier de scenă, afișează copiii nodului rădăcină și salvează din nou scena în 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")

Pași următori

 Română