Ghid pentru dezvoltatori

Aspose.3D FOSS for TypeScript este o bibliotecă open-source, licențiată MIT, care permite dezvoltatorilor Node.js să încarce, să construiască, să transforme și să exporte scene 3D cu siguranță completă a tipurilor TypeScript. Indiferent dacă construiți un pipeline de active, un serviciu de conversie de formate, un instrument de validare a geometriei sau un script de creare de conținut 3D, 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 pentru producție.

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

Funcționalități și Caracteristici

The Funcționalități pagina este referința principală pentru lucrul cu Aspose.3D FOSS pentru TypeScript. Acoperă:

  • Suport pentru formate: OBJ (cu materiale .mtl), glTF 2.0 / GLB binar, STL (binar și ASCII), COLLADA (DAE), 3MF și FBX, cu clase de opțiuni de încărcare și salvare pentru fiecare format, incluzând ObjLoadOptions și GltfSaveOptions.
  • Graf de scenă: Cum Scene, Node, Entity, Transform, și SceneObject se compun într-o ierarhie completă a scenei, incluzând modele de traversare a nodurilor copil.
  • API pentru geometrie și rețea: Lucrând cu Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, și ReferenceMode pentru procesarea geometriei.
  • Sistem de materiale: Aplicarea LambertMaterial, PhongMaterial, și PbrMaterial (PBR pentru glTF) la nodurile scenei, și citirea proprietăților materialelor încărcate din fișiere .mtl.
  • Utilitare matematice: Utilizarea Vector3, Vector4, Matrix4, Quaternion, și BoundingBox pentru transformări, interogări de cutii de delimitare și calcule geometrice.
  • Animație: Construirea și citirea AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, și Extrapolation date.
  • Suport pentru flux și buffer: Încărcarea scenelor 3D din memorie Buffer obiecte prin scene.openFromBuffer() pentru cazuri de utilizare serverless și streaming.
  • Exemple complete de utilizare: Scripturi TypeScript de la cap la cap pentru încărcarea OBJ, exportarea GLB, round-tripping STL ș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ă a tuturor claselor cheie și a metodelor lor principale.

Concepte cheie

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

API independent de format: Deschideți orice format acceptat prin scene.open() sau scene.openFromBuffer() și salvați în orice format acceptat prin scene.save().Aceleași obiecte ale graficului de scenă sunt utilizate indiferent de formatul sursă sau destinație.

Tipizare puternică în TypeScript: Biblioteca este livrată cu setări stricte ale compilatorului (noImplicitAny, strictNullChecks) și definiții complete de tipuri. Fiecare clasă, metodă și proprietate de opțiune este complet tipizată, oferindu-vă completare automată în IDE și siguranță la compilare pe tot parcursul codului dvs. de procesare 3D.

Dependență unică: Singura dependență la rulare este xmldom, care este instalat automat prin npm. Nu există addon-uri native de compilat și nici pachete de sistem de instalat.

Î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ă