1. Tuotteet
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Lataa, rakenna, muunna ja vie 3D‑kohtauksia Node.js:stä — täysin tyypitetty, avoimen lähdekoodin ja tuotantovalmiina yhdellä npm-asennuksella.

Avoimen lähdekoodin TypeScript-kirjasto 3D‑tiedostojen käsittelyyn

Aspose.3D FOSS for TypeScript on MIT-lisenssiä käyttävä kirjasto 3D-tiedostomuotojen käsittelyyn Node.js-sovelluksissa. Asenna se yhdellä npm install @aspose/3d -komennolla ja ala lukea, rakentaa ja kirjoittaa 3D‑kohtauksia TypeScriptissä heti, ilman natiivisia lisäosia käännettäväksi, ilman ulkoisia SDK:ita asennettavaksi eikä renderöijää tarvita.

Kirjasto tarjoaa täysin tyypitetyn kohtausgrafiikka-API:n, joka on rakennettu Scene, Node, Entity, Mesh, Camera, Light ja Transform -objektien ympärille, sama konseptuaalinen malli kuin ammattilais‑3D‑työkalut. Tuetut formaatit sisältävät OBJ (Wavefront, .mtl‑materiaalilataus), glTF 2.0 ja GLB‑binaari (PBR‑materiaalit), STL (binaari ja ASCII, täysi round‑trip), COLLADA (DAE), 3MF ja FBX. Formaattikohtaiset asetusluokat, kuten ObjLoadOptions ja GltfSaveOptions, antavat tarkan hallinnan koordinaattijärjestelmän suuntaan, skaalaan, normaalien normalisointiin, binaari‑ vs. JSON‑tulosteeseen ja materiaalilataukseen.

Aspose.3D FOSS kohdistuu Node.js 18, 20 ja 22+ -versioihin TypeScript 5.0+ kanssa ja käännetään CommonJS‑muotoon. Kirjasto toimitetaan tiukkojen TypeScript‑kääntäjän asetusten (noImplicitAny, strictNullChecks) kanssa, jotta IDE:si tarjoaa täyden automaattisen täydennyksen ja käännösaikaisen turvallisuuden. Sen ainoa ajonaikainen riippuvuus, xmldom, asennetaan automaattisesti.

3D‑formaattituki ja tyypitetty Scene-Graph‑API

  • OBJ / MTL: Lataa Wavefront OBJ -tiedostoja mukana tulevien materiaalimääritelmien kanssa.
  • glTF 2.0 / GLB: PBR‑materiaalilataus ja binaarinen GLB‑tuloste GltfSaveOptions‑luokan kautta.
  • STL: Lue ja kirjoita sekä binaari- että ASCII‑STL‑tiedostoja täysillä round‑trip‑vahvistuksilla.
  • COLLADA, 3MF, FBX: Lisäformaattituki formaattikohtaisten asetusluokkien avulla.
  • Täydelliset TypeScript‑tyypit: Jokainen luokka, metodi ja asetus on vahvasti tyypitetty noImplicitAny‑ ja strictNullChecks‑asetuksilla.

Missä Aspose.3D FOSS:ia voidaan käyttää

  • Node.js‑omaisuuspipeline: Tuo OBJ‑tiedostoja, validoi ja uudelleensuuntaa geometria, ja vie GLB‑muodossa CI:ssä.
  • Pelikomponentit: Eräprosessoi 3D‑verkkoja ilman natiivimoottoria tai renderöijää.
  • 3D‑tulostusprosessit: Lue, validoi ja vie STL- ja 3MF‑tiedostot uudelleen.
  • Serverless-taustajärjestelmät: Suorita 3D-muunnospäätteet Lambdassa tai Cloud Functionsissa.
  • Sisällön migraatio: Muunna formaattiperheiden välillä mittakaavassa yhdestä skriptistä.

Formaattikohtaiset asetukset ja koordinaattien hallinta

  • Koordinaattijärjestelmän suuntaus: Käännä akselit ja säädä mittakaavaa formaatin mukaan valintaluokkien avulla.
  • Normaalin normalisointi: Normalisoi automaattisesti vertex-normaalit latauksen tai tallennuksen yhteydessä.
  • Binääri vs. JSON -tuloste: Valitse tiivis GLB tai luettavissa oleva glTF GltfSaveOptions:n avulla.
  • Materiaalin latauksen hallinta: Ota käyttöön tai poista käytöstä MTL/tekstuurien lataus nopeamman jäsentämisen vuoksi.
  • Kierrospalautuksen tarkkuus: Tuntemattomat scene-graph -solmut säilytetään tarkasti uudelleentallennettaessa.

Kehittäjäkokemus

Aspose.3D FOSS TypeScript-asennuksille yhdellä npm install @aspose/3d -komennolla. Natiivisia lisäosia ei tarvitse kääntää. Kirjasto on puhdas TypeScript/JavaScript, jossa on yksi automaattisesti asennettu riippuvuus (xmldom).

Vahvasti tyypitetty API tarjoaa täyden IDE-automaattisen täydennyksen jokaiselle scene-graph-luokalle ja formaatti­valinnalle. Kirjasto kohdistuu Node.js 18–22+ ja TypeScript 5.0+ -versioihin, toimii identtisesti Linux CI runners -ympäristössä ja kehittäjien työasemilla, ja on MIT-licensed with an open issue tracker on GitHub.

Lataa OBJ‑kohtaus ja vie glTF‑muotoon

Asenna npm:llä, sitten käytä synkronista scene.open()-metodia ObjLoadOptions-parametrilla ladataksesi verkon sen MTL-materiaali­tiedoston kanssa. Kun kutsut scene.save()-metodia .gltf-tiedostopäätteellä, se kirjoittaa standardin glTF 2.0 JSON:n; formaatti pääteltiin automaattisesti tiedostopäätteestä.

npm install @aspose/3d
import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";

const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());

// Vie glTF 2.0 JSON
scene.save("model.gltf");

Muunna STL binääriseksi GLB:ksi

Tuottaaksesi tiiviin binäärisen GLB:n oletus JSON glTF:n sijaan, anna GltfSaveOptions-parametrina, jossa binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Tallenna tiiviinä binäärisenä GLB:nä
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Mikä on Aspose.3D FOSS TypeScriptille?

Se on ilmainen, MIT-lisenssiä käyttävä TypeScript/Node.js-kirjasto 3D‑kohtauksien lataamiseen, muokkaamiseen ja tallentamiseen ilman natiivilisäosan tai ulkoisen SDK:n asentamista.

Mitkä 3D-formaatit ovat tuettuja?

OBJ (with .mtl), glTF 2.0 ja GLB, STL (binääri ja ASCII), COLLADA (DAE), 3MF ja FBX. Jokaisella formaatilla on oma tyyppinen asetusluokka.

Vaatiiko se natiiveja Node.js‑lisäosia?

Ei. Aspose.3D FOSS for TypeScript on puhdas JavaScript/TypeScript. Se ei vaadi käännösvaihetta ja siinä on vain yksi ajonaikainen riippuvuus (xmldom), joka asennetaan automaattisesti npm:n kautta.

Kuinka asennan sen?

Suorita npm install @aspose/3d. Lisäjärjestelmäpaketteja tai natiivilisäosia ei tarvita.

Mitä Node.js- ja TypeScript-versioita tuetaan?

Node.js 18, 20 ja 22+. TypeScript 5.0+. Kirjasto käännetään CommonJS:ksi ja toimii tiukkojen TypeScript-asetusten kanssa.

Sisältyvätkö TypeScript-tyyppimäärittelyt?

Kyllä. Kaikki luokat, metodit, enumit ja asetustyypit on täysin tyypitetty noImplicitAny- ja strictNullChecks-asetusten ollessa käytössä.

Voinko hallita koordinaattijärjestelmän suuntausta?

Kyllä. Kunkin formaatin asetusluokat, kuten ObjLoadOptions ja GltfSaveOptions, antavat sinun kääntää akselit, säätää skaalaa ja normalisoida normaalit ilman räätälöityä jäsentämiskoodia.

Missä löydän lähdekoodin?

Kirjasto on MIT-lisenssiä ja isännöity GitHubissa. Virheraportit ja pull-pyynnöt ovat tervetulleita.

  

Tuki- ja oppimisresurssit

 Suomi