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

Aspose.3D FOSS pentru Python

Încărcați, creați, transformați și exportați scene 3D din Python — gratuit și open-source.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Documentation GitHub

Bibliotecă Python open-source pentru procesarea fișierelor 3D

Aspose.3D FOSS pentru Python este o bibliotecă licențiată MIT, pure-Python, pentru lucrul cu formatele de fișiere 3D. Instalați-o cu o singură comandă pip și începeți imediat să citiți, să construiți și să scrieți scene 3D fără a instala niciun runtime nativ, SDK extern sau motor de redare terț.

Biblioteca expune o API curată de graf de scenă construită în jurul Scene, Node, Mesh, Camera, Light și Transform, același model conceptual utilizat de instrumentele 3D profesionale. Suportul pentru formate include OBJ (cu încărcare de materiale .mtl), STL (binare și ASCII, verificat în roundtrip), glTF 2.0 / GLB (materiale PBR), COLLADA (DAE), 3MF și FBX. Opțiunile de încărcare și salvare per-format vă permit să controlați inversarea coordonatelor, scala, normalizarea normalelor și încărcarea materialelor fără a scrie cod de parsare specific formatului.

Aspose.3D FOSS suportă Python 3.7 până la 3.12 și rulează identic pe Windows, macOS și Linux CI runners, containere Docker și medii serverless. Pentru funcționalități și suport enterprise, consultați Aspose.3D for Python — Enterprise Product.

Suport pentru formate 3D și API de graf de scenă

  • OBJ / MTL: Încarcă fișiere Wavefront OBJ cu definiții de material însoțitoare.
  • STL: Citește și scrie atât STL binar, cât și ASCII, cu verificare completă a roundtrip‑ului.
  • glTF 2.0 / GLB: Încărcarea materialelor PBR și ieșirea binară GLB prin GltfSaveOptions.
  • COLLADA, 3MF, FBX: Suport suplimentar pentru formate cu clase de opțiuni per-format.
  • API de graf de scenă: Scene, Node, Mesh, Camera, Light, Transform.

Unde Aspose.3D FOSS poate fi utilizat

  • Conducte de validare a activelor: Verificați, reorientați și reexportați active 3D în CI.
  • Instrumente pentru dezvoltarea jocurilor: Procesează în lot modele OBJ/GLB fără un motor nativ.
  • Fluxuri de lucru pentru imprimarea 3D: Citește, validează și reexportă fișiere STL și 3MF.
  • Web backends: Serviți puncte finale de conversie 3D în Docker sau funcții serverless.
  • Migrarea conținutului: Conversie între familii de formate la scară largă.

Opțiuni per-format și control al coordonatelor

  • Orientarea sistemului de coordonate: Inversează axele și ajustează scara pentru fiecare format fără cod personalizat.
  • Normalizarea normalelor: Normalizează automat normele vârfurilor la încărcare sau salvare.
  • Controlul încărcării materialelor: Activați sau dezactivați încărcarea MTL/texture pentru o analiză mai rapidă.
  • Binary vs. JSON output: Alegeți GLB compact sau glTF lizibil pentru oameni prin opțiuni.
  • Round-trip fidelity: Structura graficului de scenă este menținută pe parcursul ciclurilor de încărcare și salvare (fidelitatea de păstrare a nodurilor depinde de format și nu este verificată independent pentru toate formatele).

Experiența dezvoltatorului

Aspose.3D FOSS pentru Python se instalează cu o singură comandă pip install aspose-3d-foss. Biblioteca este pur Python, fără extensii native de compilat și fără pachete de sistem de instalat.

API-ul scene-graph reflectă modelul conceptual al instrumentelor 3D profesionale, astfel încât curba de învățare este scurtă pentru oricine este familiar cu modelul de date al Three.js sau Blender. Biblioteca este MIT-licensed, open-source și primește cu bucurie rapoarte de erori și contribuții pe GitHub.

Încarcă o scenă OBJ și exportă ca glTF

Instalați cu pip, apoi apelați Scene.open() cu ObjLoadOptions pentru a încărca fișierul OBJ împreună cu definițiile de material MTL. Un singur apel scene.save() cu o extensie .gltf scrie un fișier JSON glTF 2.0 — nu este necesar niciun registru de format sau obiect convertor.

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")

Convertiți STL în Binary GLB cu inversarea coordonatelor

Pentru a produce un GLB binar compact în locul glTF-ului implicit JSON, transmiteți o instanță GltfSaveOptions cu binary_mode = True. Același model se aplică ajustărilor sistemului de coordonate — înlocuiți clasa de opțiuni cu formatul pe care îl vizați.

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)

Frequently Asked Questions

Ce este Aspose.3D FOSS pentru Python?

Este o bibliotecă gratuită, licențiată MIT, pure-Python, pentru încărcarea, manipularea și salvarea scenelor 3D fără a instala niciun runtime nativ sau SDK extern.

Ce formate 3D sunt suportate?

OBJ (cu .mtl), STL (binare și ASCII), glTF 2.0 și GLB, COLLADA (DAE), 3MF și FBX. Fiecare format are o clasă dedicată de opțiuni de încărcare/salvare.

Necesită dependențe native?

Nu. Aspose.3D FOSS pentru Python este pure Python fără extensii native. Rulează pe Windows, macOS și Linux fără niciun pas de compilare.

Cum îl instalez?

Rulați pip install aspose-3d-foss. Nu sunt necesare pachete suplimentare de sistem sau extensii native.

Pot controla orientarea sistemului de coordonate?

Da. Clasele de opțiuni per-format vă permit să răsturnați axele, să ajustați scala și să normalizați normalele fără a scrie cod de parsare specific unui format.

Ce versiuni Python sunt suportate?

Python 3.7 până la 3.12 sunt suportate. Biblioteca rulează identic pe toate sistemele de operare majore.

Este codul sursă disponibil?

Da. Biblioteca este licențiată sub MIT și găzduită pe GitHub. Raportările de erori și cererile de pull sunt binevenite.

  

Support and Learning Resources

 Română