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

Aspose.3D FOSS for 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 formate 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 renderer terț.

Biblioteca expune un 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. Nu există nicio extensie nativă de compilat și niciun pachet de sistem de instalat.

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

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

Unde poate fi utilizat Aspose.3D FOSS

  • Pipe‑line‑uri de validare a activelor: Verifică, reorientează și reexportă activele 3D în CI.
  • Unelte pentru dezvoltarea de jocuri: Procesează în lot mesh‑uri 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.
  • Content migration: Convertiți între familii de formate la scară largă.

Opțiuni per-format și control al coordonatelor

  • Orientarea sistemului de coordonate: Inversează axele și ajustează scara în funcție de format fără cod personalizat.
  • Normalizarea normalelor: Normalizează automat normalele vârfurilor la încărcare sau salvare.
  • Controlul încărcării materialelor: Activează sau dezactivează încărcarea MTL/texturilor pentru o parsare mai rapidă.
  • Ieșire binară vs. JSON: Alege GLB compact sau glTF lizibil pentru oameni prin opțiuni.
  • Fidelitatea round‑trip: Structura graficului de scenă este menținută pe parcursul ciclurilor de încărcare și salvare (fidelitatea păstrării nodurilor depinde de format și nu este verificată independent pentru toate formatele).

Experiența dezvoltatorului

Aspose.3D FOSS pentru instalări Python 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 al Blender. Biblioteca este licențiată sub MIT, 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 extensia .gltf scrie un fișier JSON glTF 2.0, fără a fi necesar niciun registru de formate sau obiect convertor.

pip install aspose-3d-foss

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

# Încarcă un fișier OBJ (cu materiale .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Exportă ca glTF 2.0
scene.save("model.gltf")

Convertește STL în GLB binar cu inversarea coordonatelor

Pentru a produce un GLB binar compact în locul glTF JSON implicit, 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")

# Salvează ca GLB binar
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 de sistem suplimentare sau extensii native.

Pot controla orientarea sistemului de coordonate?

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

Care versiuni ale 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 pull requests sunt binevenite.

  

Support and Learning Resources

 Română