Ghid pentru dezvoltatori

Aspose.3D FOSS pentru Python este o bibliotecă open-source, licențiată sub MIT, care permite dezvoltatorilor Python să încarce, să construiască, să transforme și să exporte scene 3D fără nicio dependență externă de runtime. Indiferent dacă construiți un pipeline de active, un instrument de validare, un script de procesare a geometriei sau un serviciu de conversie de formate, această bibliotecă oferă un API curat și coerent, susținut de un model de graf de scenă care reflectă conceptele 3D standard din industrie.

Acest Ghid pentru dezvoltatori acoperă tot ce aveți nevoie pentru a depăși instalarea rapidă și a scrie cod de procesare 3D de calitate de producție.

Ce veți găsi în această secțiune

Caracteristici și funcționalități

The Caracteristici pagina este referința principală pentru lucrul cu Aspose.3D FOSS pentru Python. Acoperă:

  • Suport pentru formate: OBJ (cu materiale .mtl), STL (binare și ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF și tokenizer‑ul FBX în curs de dezvoltare, cu clase de opțiuni de încărcare și salvare pentru fiecare format.
  • Graf de scenă: Cum Scene, Node, Entity, Transform, și GlobalTransform compune într-o ierarhie completă a scenei, incluzând modele de traversare a nodurilor copil.
  • Mesh API: Lucrând cu control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, și VertexElementSmoothingGroup pentru procesarea geometriei.
  • Sistem de materiale: Aplicarea LambertMaterial și PhongMaterial la nodurile scenei, și citirea proprietăților materialului încărcate din fișiere .mtl.
  • Utilitare matematice: Utilizarea Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, și BoundingBox pentru transformări, interogări de tip cutie de delimitare și calcule geometrice.
  • Animație: Construirea și citirea AnimationClip, AnimationNode, KeyFrame, și KeyframeSequence date.
  • Încărcați și salvați opțiunile: Clase de opțiuni per-format, cum ar fi ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Exemple complete de utilizare: Scripturi Python de la cap la cap pentru încărcarea OBJ, exportarea STL, round-tripping glTF și parcurgerea grafurilor de scenă.
  • Sfaturi, probleme comune și Întrebări frecvente: Ghid practic pentru evitarea capcanelor comune în utilizarea în producție.
  • Rezumat al referinței API: Listă de referință rapidă cu toate clasele cheie.

Concepte cheie

Scene graph: Tot conținutul 3D din Aspose.3D FOSS este reprezentat ca un arbore de Node obiecte cu rădăcina în scene.root_node. Fiecare nod poate conține un Entity (cum ar fi un Mesh, Camera, sau Light) Transform care îl poziționează în ierarhie.

API agnostic de format: Deschideți orice format suportat prin Scene.open() sau Scene.from_file() și salvați în orice format acceptat prin Scene.save(). Obiectele de tip scenă-grafică sunt utilizate indiferent de formatul sursă sau destinație.

Zero dependențe: Biblioteca este pură Python. Nu există nicio extensie nativă de compilat, nici un pachet de sistem de instalat și nici o bibliotecă terță parte de gestionat.

Începeți

Dacă nu ați instalat încă biblioteca, consultați Începeți secțiunea și Instalare ghidul înainte de a citi mai departe.

Subiecte disponibile

 Română