Vodič za programere
Aspose.3D FOSS za TypeScript je open‑source, MIT‑licencirana biblioteka koja omogućuje Node.js programerima učitavanje, izgradnju, transformaciju i izvoz 3D scena uz potpunu TypeScript tipnu sigurnost. Bilo da gradite pipeline za resurse, uslugu za konverziju formata, alat za provjeru geometrije ili skriptu za autoriranje 3D sadržaja, ova biblioteka pruža čist, dosljedan API potkrijepljen modelom scene‑graph koji odražava industrijske standarde 3D koncepata.
Ovaj Vodič za programere pokriva sve što vam je potrebno da nadmašite brzu instalaciju i napišete 3D kod za obradu proizvodne kvalitete.
Što ćete pronaći u ovom odjeljku
Značajke i funkcionalnosti
The Značajke stranica je primarni referentni materijal za rad s Aspose.3D FOSS za TypeScript. Pokriva:
- Podrška za formate: OBJ (s .mtl materijalima), glTF 2.0 / GLB binarni, STL (binarni i ASCII), COLLADA (DAE), 3MF i FBX, s klasama opcija učitavanja i spremanja po formatu, uključujući
ObjLoadOptionsiGltfSaveOptions. - Graf scene: Kako
Scene,Node,Entity,Transform, iSceneObjectsastavi u potpunu hijerarhiju scene, uključujući child-node traversal patterns. - API za geometriju i mrežu:Rad s
Mesh,Geometry,VertexElementNormal,VertexElementUV,VertexElementVertexColor,MappingMode, iReferenceModeza obradu geometrije. - Materijalni sustav: Primjena
LambertMaterial,PhongMaterial, iPbrMaterial(PBR for glTF) na čvorove scene, i čitanje svojstava materijala učitanih iz .mtl datoteka. - Matematički alati: Korištenje
Vector3,Vector4,Matrix4,Quaternion, iBoundingBoxza transformacije, upite okvira ograničenja i geometrijske izračune. - Animacija: Izgradnja i čitanje
AnimationClip,AnimationNode,AnimationChannel,KeyFrame,KeyframeSequence,Interpolation, iExtrapolationpodaci. - Podrška za stream i međuspremnik: Učitavanje 3D scena iz memorije
Bufferobjekata putemscene.openFromBuffer()za serverless i streaming slučajeve upotrebe. - Potpuni primjeri upotrebe: End-to-end TypeScript skripte za učitavanje OBJ, izvoz GLB, povratno pretvaranje STL i prolazak kroz grafove scena.
- Savjeti, česti problemi i FAQ: Praktični savjeti za izbjegavanje čestih zamki u produkcijskoj upotrebi.
- Sažetak API reference: Brzi popis svih ključnih klasa i njihovih glavnih metoda.
Ključni pojmovi
Graf scene: Sav 3D sadržaj u Aspose.3D FOSS je predstavljen kao stablo Node objekata ukorijenjenih u scene.rootNode. Svaki čvor može nositi Entity (kao što je a Mesh, Camera, ili Light) Transform koji ga pozicionira u hijerarhiji.
API neovisan o formatu: Otvorite bilo koji podržani format putem scene.open() ili scene.openFromBuffer() i spremite u bilo koji podržani format putem scene.save().
Jako tipiziranje u TypeScriptu: Biblioteka dolazi s rigoroznim postavkama kompajlera (noImplicitAny, strictNullChecks) i potpune definicije tipova. Svaka klasa, metoda i svojstvo opcije potpuno su tipizirani, pružajući vam automatsko dovršavanje u IDE-u i sigurnost u vrijeme kompilacije kroz cijeli vaš 3D procesni kod.
Jedna ovisnost: Jedina runtime ovisnost je xmldom, koji se automatski instalira putem npm-a. Nema native dodataka za kompilaciju i nema sistemskih paketa za instalaciju.
Početak rada
Ako još niste instalirali biblioteku, pogledajte the Početak rada odjeljak i Instalacija vodič prije nego što nastavite čitati.
Dostupne teme
- Značajke i funkcionalnosti: Potpuna referenca API-ja s kodnim primjerima za svako glavno područje značajki.