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

Aspose.3D FOSS per a Python

Carrega, crea, transforma i exporta escenes 3D des de Python — gratuïta i de codi obert.

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

Aprèn GitHub

Biblioteca Python de codi obert per al processament de fitxers 3D

Aspose.3D FOSS per a Python és una biblioteca MIT-licenciada, pur-Python per treballar amb formats de fitxers 3D. Instal·la-la amb una única ordre pip i comença immediatament a llegir, construir i escriure escenes 3D sense instal·lar cap entorn d’execució natiu, SDK extern o renderitzador de tercers.

La biblioteca exposa una API neta de gràfic d’escena construïda al voltant de Scene, Node, Mesh, Camera, Light i Transform, el mateix model conceptual utilitzat per eines 3D professionals. El suport de formats inclou OBJ (amb càrrega de materials .mtl), STL (binari i ASCII, verificat en ida‑vuelta), glTF 2.0 / GLB (materials PBR), COLLADA (DAE), 3MF i FBX. Les opcions de càrrega i desament per format us permeten controlar la inversió de coordenades, l’escala, la normalització de normals i la càrrega de materials sense escriure cap codi d’anàlisi específic del format.

Aspose.3D FOSS admet Python 3.7 fins a 3.12 i s’executa de manera idèntica a Windows, macOS i Linux CI runners, contenidors Docker i entorns sense servidor. Per a funcions i suport empresarial, vegeu Aspose.3D for Python — Enterprise Product.

Compatibilitat amb formats 3D i API de gràfic d’escenes

  • OBJ / MTL: Carrega fitxers Wavefront OBJ amb definicions de material adjuntes.
  • STL: Llegeix i escriu STL tant binari com ASCII amb verificació completa de viatge d’anada i tornada.
  • glTF 2.0 / GLB: càrrega de material PBR i sortida binària GLB via GltfSaveOptions.
  • COLLADA, 3MF, FBX: Suport addicional de format amb classes d’opcions per a cada format.
  • API de graf de escena: Scene, Node, Mesh, Camera, Light, Transform.

On es pot utilitzar Aspose.3D FOSS

  • Fluxos de validació d’actius: Verifiqueu, reorienteu i reexporteu actius 3D en CI.
  • Eines de desenvolupament de jocs: Processa en lot malles OBJ/GLB sense un motor natiu.
  • Fluxos de treball d’impressió 3D: Llegir, validar i tornar a exportar fitxers STL i 3MF.
  • Backends web: Serveix punts finals de conversió 3D a Docker o funcions sense servidor.
  • Migració de contingut: Converteix entre famílies de formats a gran escala.

Opcions per format i control de coordenades

  • Orientació del sistema de coordenades: Inverteix els eixos i ajusta l’escala per format sense codi personalitzat.
  • Normalització de normals: Normalitza automàticament les normals de vèrtex en carregar o desar.
  • Control de càrrega de material: Habilita o deshabilita la càrrega de MTL/textura per a un anàlisi més ràpid.
  • Binari vs. JSON sortida: Trieu GLB compacte o glTF llegible per a humans mitjançant opcions.
  • Fidelitat d’anada i tornada: L’estructura del gràfic d’escena es manté durant els cicles de càrrega i desament (la fidelitat de preservació de nodes depèn del format i no s’ha verificat independentment per a tots els formats).

Experiència del desenvolupador

Aspose.3D FOSS per a Python s’instal·la amb una sola comanda pip install aspose-3d-foss. La biblioteca és pur Python, sense extensions natives per compilar i sense paquets del sistema per instal·lar.

L’API de graf de escena reflecteix el model conceptual de les eines 3D professionals, de manera que la corba d’aprenentatge és curta per a qualsevol familiaritzat amb el model de dades de Three.js o Blender. La biblioteca té llicència MIT, és de codi obert i dóna la benvinguda a informes d’errors i contribucions a GitHub.

Carrega una escena OBJ i exporta-la com a glTF

Instal·la amb pip, després crida Scene.open() amb ObjLoadOptions per carregar el fitxer OBJ juntament amb les seves definicions de material MTL. Una única crida scene.save() amb una extensió .gltf escriu un fitxer glTF 2.0 JSON — no cal cap registre de format ni objecte convertidor.

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

Converteix STL a GLB binari amb inversió de coordenades

Per generar un GLB binari compacte en lloc del glTF JSON per defecte, passa una instància GltfSaveOptions amb binary_mode = True. El mateix patró s’aplica als ajustaments del sistema de coordenades — substitueix la classe d’opcions pel format al qual estàs apuntant.

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)

Preguntes freqüents

Què és Aspose.3D FOSS per a Python?

És una biblioteca gratuïta, amb llicència MIT, pura-Python per a carregar, manipular i desar escenes 3D sense instal·lar cap entorn d’execució natiu ni cap SDK extern.

Quins formats 3D s’admeten?

OBJ (amb .mtl), STL (binari i ASCII), glTF 2.0 i GLB, COLLADA (DAE), 3MF i FBX. Cada format disposa d’una classe d’opcions de càrrega/desar dedicada.

Requereix alguna dependència nativa?

No. Aspose.3D FOSS per a Python és pur Python sense extensions natives. S’executa a Windows, macOS i Linux sense cap pas de compilació.

Com l’instal·lo?

Executeu pip install aspose-3d-foss. No es requereixen paquets de sistema addicionals ni extensions natives.

Puc controlar l’orientació del sistema de coordenades?

Sí. Les classes d’opcions per format us permeten invertir eixos, ajustar l’escala i normalitzar les normals sense haver d’escriure cap codi d’anàlisi específic del format.

Quines versions de Python són compatibles?

Python 3.7 fins a 3.12 són compatibles. La biblioteca s’executa de manera idèntica en tots els principals sistemes operatius.

El codi font està disponible?

Sí. La biblioteca té llicència MIT i està allotjada a GitHub. Es donen la benvinguda els informes d’errors i les pull requests.

  

Suport i recursos d aprenentatge

 Català