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

Aspose.3D FOSS TypeScriptille

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

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Oppia GitHub

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

Aspose.3D FOSS for TypeScript on MIT-lisenssiä käyttävä kirjasto, jonka avulla voidaan työskennellä 3D-tiedostomuotojen kanssa 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 scene-graph API:n, joka on rakennettu Scene, Node, Entity, Mesh, Camera, Light ja Transform ympärille, sama konseptuaalinen malli kuin ammattilais 3D-työkaluissa käytetty. Formaattituki sisältää OBJ:n (Wavefront, .mtl-materiaalilataus), glTF 2.0:n ja GLB-binäärin (PBR-materiaalit), STL (binary and ASCII, full roundtrip), COLLADA:n (DAE), 3MF:n ja FBX:n. Jokaiselle formaatille tarkoitetut asetusluokat, kuten ObjLoadOptions ja GltfSaveOptions, antavat tarkan hallinnan koordinaattijärjestelmän suuntaan, skaalaan, normaalien normalisointiin, binary vs. JSON -tulostukseen ja materiaalilataukseen.

Aspose.3D FOSS kohdistuu Node.js 18, 20 ja 22+ versioihin TypeScript 5.0+ kanssa ja kääntyy CommonJS:ksi. 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. Yritysversioiden tuoteryhmää varten katso Aspose.3D — Enterprise Product Family.

3D‑formaattituki ja tyypitetty Scene-Graph‑API

  • OBJ / MTL: Lataa Wavefront OBJ -tiedostoja, joissa on mukana materiaalimäärittelyt.
  • glTF 2.0 / GLB: PBR-materiaalin lataus ja binäärinen GLB-tulostus via GltfSaveOptions.
  • STL: Lue ja kirjoita sekä binäärisiä että ASCII STL -tiedostoja täydellisellä roundtrip‑varmistuksella.
  • COLLADA, 3MF, FBX: Lisämuoto tuki per-muotoisten asetusten luokkien avulla.
  • Täydelliset TypeScript-tyypit: Jokainen luokka, metodi ja asetus on vahvasti tyypitetty noImplicitAny ja strictNullChecks.

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

  • Node.js asset pipelines: Tuo OBJ-tiedostoja, tarkista ja uudelleensuuntaa geometria, ja vie GLB-muodossa CI:ssä.
  • Pelin työkalut: Eräprosessoi 3D-verkkoja ilman natiivimoottoria tai renderöijää.
  • 3D-tulostusprosessit: Lue, validoi ja vie STL- ja 3MF-tiedostot uudelleen.
  • Palvelimettomat taustajärjestelmät: Suorita 3D-muunnospäätteet Lambda- tai Cloud Functions -ympäristössä.
  • Sisällön migraatio: Muunna formaattiperheiden välillä laajassa mittakaavassa yhdestä skriptistä.

Formaattikohtaiset asetukset ja koordinaattien hallinta

  • Koordinaatistojärjestelmän suuntaus: Käännä akselit ja säädä mittakaavaa formaatin mukaan vaihtoehtoluokkien avulla.
  • Normal normalization: Normalisoi vertex-normaalit automaattisesti latauksen tai tallennuksen yhteydessä.
  • Binääri vs. JSON tuloste: Valitse tiivis GLB tai luettavissa oleva glTF GltfSaveOptions kautta.
  • Material loading control: Ota käyttöön tai poista käytöstä MTL/tekstuurien lataus nopeampaa jäsentämistä varten.
  • Round-trip fidelity: Tuntemattomat scene-graph-solmut säilytetään kirjaimellisesti uudelleensavattaessa.

Kehittäjäkokemus

Aspose.3D FOSS for TypeScript asennetaan yhdellä npm install @aspose/3d-komennolla. Natiivisia lisäosia ei ole käännettäväksi. Kirjasto on puhdas TypeScript/JavaScript, jossa on yksi automaattisesti asennettu riippuvuus (xmldom).

Vahvasti tyypitetty API tarjoaa täyden IDE:n automaattisen täydennyksen jokaiselle scene-graph -luokalle ja formaattivalinnalle. Kirjasto kohdistuu Node.js 18–22+ ja TypeScript 5.0+ -versioihin, toimii identtisesti Linux CI -ajajien ja kehittäjien työasemilla, ja on MIT-lisenssiä käyttäen avoimella issue‑trackerilla GitHubissa.

Lataa OBJ‑kohtaus ja vie glTF‑muotoon

Asenna npm:llä, sitten käytä scene.open() yhdessä ObjLoadOptions kanssa ladataksesi meshin sen MTL-materiaalityylitiedoston kanssa. Sekä open() että save() ovat synkronisia — await tai Promise-ketjutusta ei tarvita. Kutsuttaessa scene.save() .gltf-päätteellä kirjoitetaan standardi glTF 2.0 JSON — formaatti päätellään 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Muunna STL binääriseksi GLB:ksi

Tuottaaksesi kompaktin binäärisen GLB:n oletus JSON glTF:n sijaan, käytä GltfSaveOptions yhdessä binaryMode = true:n kanssa. Sekä open() että save() ovat synkronisia — await ei ole tarpeen.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Usein kysytyt kysymykset

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, että tarvitsee asentaa mitään natiivilisäosaa tai ulkoista SDK:ta.

Mitkä 3D-formaatit ovat tuettuja?

OBJ (yhteensä .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 puhdasta JavaScriptiä/TypeScriptiä. Se ei vaadi käännösvaihetta ja siinä on vain yksi ajonaikainen riippuvuus (xmldom) asennettuna automaattisesti npm:n kautta.

Kuinka asennan sen?

Suorita npm install @aspose/3d. Lisäpaketteja tai natiiveja lisäosia ei tarvita.

Mitkä Node.js- ja TypeScript-versiot ovat tuettuja?

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

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

Kyllä. Kaikki luokat, metodit, enumit ja vaihtoehtotyypit on täysin tyypitetty noImplicitAny ja strictNullChecks käytössä.

Voinko hallita koordinaatistojärjestelmän suuntausta?

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

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