Kūrėjo vadovas

Aspose.3D FOSS for TypeScript yra atviro kodo, MIT licencijuota biblioteka, leidžianti Node.js kūrėjams įkelti, kurti, transformuoti ir eksportuoti 3D scenas su pilna TypeScript tipų sauga. Nesvarbu, ar kuriate turto konvejerį, formato konvertavimo paslaugą, geometrijos validacijos įrankį ar 3D turinio kūrimo skriptą, ši biblioteka suteikia švarią, nuoseklią API, paremta scenų grafiko modeliu, atspindinčiu pramonės standartus 3D koncepcijoms.

Šis kūrėjo vadovas apima viską, ko jums reikia, kad išeitumėte už greitosios pradžios diegimo ir rašytumėte gamybos kokybės 3D apdorojimo kodą.

Ką rasite šiame skyriuje

Savybės ir funkcionalumas

Ši Savybės puslapis yra pagrindinė nuoroda darbui su Aspose.3D FOSS for TypeScript. Jame aptariama:

  • Formato palaikymas: OBJ (su .mtl medžiagomis), glTF 2.0 / GLB binarinis, STL (binari ir ASCII), COLLADA (DAE), 3MF ir FBX, su kiekvienam formatui skirtomis įkėlimo ir įrašymo parinkčių klasėmis, įskaitant ObjLoadOptions ir GltfSaveOptions.
  • Scenos grafas: Kaip Scene, Node, Entity, Transform, ir SceneObject sudaro pilną scenos hierarchiją, įskaitant vaikų mazgų perėjimo šablonus.
  • Geometrijos ir tinklo API: Darbas su Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ir ReferenceMode geometrijos apdorojimui.
  • Medžiagų sistema: Taikant LambertMaterial, PhongMaterial, ir PbrMaterial (PBR for glTF) į scenos mazgus, ir medžiagų savybių skaitymas iš .mtl failų.
  • Matematikos įrankiai: Naudojant Vector3, Vector4, Matrix4, Quaternion, ir BoundingBox transformacijoms, ribų dėžės užklausoms ir geometriniams skaičiavimams.
  • Animacija: Kūrimas ir skaitymas AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, ir Extrapolation duomenys.
  • Srauto ir buferio palaikymas: 3D scenų įkėlimas iš atminties Buffer objektų per scene.openFromBuffer() serverless ir srautinio naudojimo atvejams.
  • Visuotiniai naudojimo pavyzdžiai: Visuotiniai TypeScript scenarijai OBJ įkėlimui, GLB eksportavimui, STL dvigubam konvertavimui ir scenų grafų peržiūrai.
  • Patarimai, dažnos problemos ir DUK: Praktiniai patarimai, kaip išvengti dažnų klaidų gamybinėje aplinkoje.
  • API nuorodų santrauka: Greitosios nuorodos sąrašas su visomis pagrindinėmis klasėmis ir jų pagrindiniais metodais.

Pagrindinės sąvokos

Scenos grafas: Visas 3D turinys Aspose.3D FOSS yra atvaizduojamas kaip medžio struktūra Node objektų, kurių šaknis yra scene.rootNode. Kiekvienas mazgas gali nešti Entity (pvz., Mesh, Camera, ar Light) ir a Transform kuris jį pozicionuoja hierarchijoje.

Formatui nepriklausoma API: Jūs atidarote bet kurį palaikomą formatą per scene.open() ar scene.openFromBuffer() ir išsaugokite bet kuriuo palaikomu formatu per scene.save(). Tie patys scenos grafiko objektai naudojami nepriklausomai nuo šaltinio ar paskirties formato.

Stiprus TypeScript tipavimas: Biblioteka pristatoma su griežtais kompiliatoriaus nustatymais (noImplicitAny, strictNullChecks) ir pilni tipų apibrėžimai. Kiekviena klasė, metodas ir parinkčių savybė yra visiškai tipizuota, suteikdama IDE automatinį užbaigimą ir kompiliavimo metu saugumą visame jūsų 3D apdorojimo kode.

Vienas priklausomumas: Vienintelė vykdymo laiko priklausomybė yra xmldom, kuris automatiškai įdiegtas per npm. Nėra jokių natūralių papildinių kompiliavimui ir nėra jokių sistemos paketų diegimui.

Pradžia

Jei dar neįdiegėte bibliotekos, žiūrėkite. Pradžia skyrius ir Įdiegimas gidas prieš tęsiant skaitymą.

Available Topics Prieinamos temos

 Lietuvių