Kehittäjän opas

Aspose.3D FOSS for TypeScript on avoimen lähdekoodin, MIT-lisenssin alainen kirjasto, jonka avulla Node.js‑kehittäjät voivat ladata, rakentaa, muuntaa ja viedä 3D‑kohtauksia täyden TypeScript‑tyyppiturvallisuuden kanssa. Olitpa sitten rakentamassa asset‑putkea, formaattimuunnospalvelua, geometrian validointityökalua tai 3D‑sisällön authorointiskriptiä, tämä kirjasto tarjoaa puhtaan, yhdenmukaisen API:n, jota tukee kohtausgrafiikkamalli, joka heijastaa alan standardeja 3D‑käsitteitä.

Tämä kehittäjäopas kattaa kaiken, mitä tarvitset nopean aloitusasennuksen ylittämiseen ja tuotantotason 3D‑käsittelykoodin kirjoittamiseen.

Mitä löydät tässä osiossa

Ominaisuudet ja toiminnot

Se Ominaisuudet sivu on ensisijainen viite Aspose.3D FOSS:n käyttöön TypeScriptissä. Se kattaa:

  • Formaattituen: OBJ (mtl-materiaalien kanssa), glTF 2.0 / GLB binaari, STL (binaari ja ASCII), COLLADA (DAE), 3MF ja FBX, per formaatti lataus- ja tallennusvaihtoehtoluokkien kanssa, mukaan lukien ObjLoadOptions ja GltfSaveOptions.
  • Kohtausgrafi: Kuinka Scene, Node, Entity, Transform, ja SceneObject koostuvat täydelliseksi kohtaushierarkiaksi, sisältäen alisolmujen läpikäyntimallit.
  • Geometria- ja verkko-API: Työskenteleminen Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode geometriankäsittelyyn.
  • Materiaalijärjestelmä: Soveltaminen LambertMaterial, PhongMaterial, ja PbrMaterial (PBR for glTF) kohtiin, ja .mtl-tiedostoista ladattujen materiaalien ominaisuuksien lukeminen.
  • Matematiikkatyökalut: Käyttäen Vector3, Vector4, Matrix4, Quaternion, ja BoundingBox muunnoksille, raja-aluekyselyille ja geometrisille laskelmille.
  • Animaatio: Rakentaminen ja lukeminen AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, ja Extrapolation tiedot.
  • Suoratoisto- ja puskurituki: 3D‑kohtauksien lataaminen muistista Buffer objekteja kautta scene.openFromBuffer() palvelimettomiin ja suoratoisto‑käyttötapauksiin.
  • Täydelliset käyttöesimerkit: End-to-end TypeScript -skriptit OBJ:n lataamiseen, GLB:n vientiin, STL:n kaksisuuntaiseen käsittelyyn ja kohtausgraafien läpikäyntiin.
  • Vinkkejä, yleisiä ongelmia ja UKK: Käytännön ohjeita yleisten sudenkuoppien välttämiseksi tuotantokäytössä.
  • API‑viitteiden yhteenveto: Nopean viittauksen luettelo kaikista keskeisistä luokista ja niiden tärkeimmistä metodeista.

Keskeiset käsitteet

Kohtauskaavio: Kaikki 3D-sisältö Aspose.3D FOSS:issa esitetään puuna, jonka Node objekteja, joiden juuri on scene.rootNode. Jokainen solmu voi kantaa Entity (kuten Mesh, Camera, tai Light) ja Transform joka sijoittaa sen hierarkiassa.

Formaatti-agnostinen API: Avaa mikä tahansa tuettu formaatti kautta scene.open() tai scene.openFromBuffer() ja tallenna mihin tahansa tuettuun formaattiin scene.save(). Samat scene-graph-objektit käytetään riippumatta lähde- tai kohdeformaatista.

Vahva TypeScript‑tyypitys: Kirjasto toimitetaan tiukkojen kääntäjäasetusten kanssa (noImplicitAny, strictNullChecks) ja täydelliset tyyppimäärittelyt. Jokainen luokka, metodi ja asetusominaisuus on täysin tyypitetty, mikä tarjoaa IDE:n automaattisen täydennyksen ja käännösaikaisen turvallisuuden koko 3D‑käsittelykoodissasi.

Yksi riippuvuus: Ainoa ajonaikainen riippuvuus on xmldom, joka asennetaan automaattisesti npm:n kautta. Ei ole natiivilisäosia käännettävänä eikä järjestelmäpaketteja asennettavana.

Aloittaminen

Jos et ole vielä asentanut kirjastoa, katso​ Aloittaminen osio ja the Asennus opas ennen kuin luet eteenpäin.

Saatavilla olevat aiheet

 Suomi