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

Aspose.3D FOSS TypeScript

Ielādējiet, veidojiet, pārveidojiet un eksportējiet 3D skenējumus no Node.js — pilnīgi tipizēti, atvērtā koda un gatavi ražošanai ar vienu npm instalāciju.

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

Documentation GitHub

Atvērtā koda TypeScript bibliotēka 3D failu apstrādei

Aspose.3D FOSS for TypeScript ir MIT licences bibliotēka darbam ar 3D failu formātiem Node.js lietojumprogrammās. Instalējiet to ar vienu npm install @aspose/3d komandu un uzreiz sāciet lasīt, konstruēt un rakstīt 3D ainas TypeScript valodā, bez vajadzības kompilēt vietējos papildinājumus, bez ārējiem SDK instalēšanas un bez renderera.

Bibliotēka nodrošina pilnīgi tipizētu ainas grafika API, kas balstīts uz Scene, Node, Entity, Mesh, Camera, Light un Transform, to pašu konceptuālo modeli, ko izmanto profesionālie 3D rīki. Formātu atbalsts ietver OBJ (Wavefront, ar .mtl materiālu ielādi), glTF 2.0 un GLB bināro (PBR materiāli), STL (bināro un ASCII, pilna apstrāde), COLLADA (DAE), 3MF un FBX. Formātam specifiskās opciju klases, piemēram, ObjLoadOptions un GltfSaveOptions, sniedz precīzu kontroli pār koordinātu sistēmas orientāciju, mērogu, normālu normalizāciju, bināro pret JSON izvadi un materiālu ielādi.

Aspose.3D FOSS mērķē Node.js 18, 20 un 22+ ar TypeScript 5.0+ un kompilē uz CommonJS. Bibliotēka tiek piegādāta ar stingriem TypeScript kompilatora iestatījumiem (noImplicitAny, strictNullChecks), lai jūsu IDE nodrošinātu pilnīgu automātisko pabeigšanu un kompilācijas laika drošību. Tās vienīgā izpildlaika atkarība, xmldom, tiek instalēta automātiski. Uzņēmuma produktu ģimenei skatiet Aspose.3D — Enterprise Product Family.

3D formātu atbalsts un tipizēta skenējumu grafika API

  • OBJ / MTL: Ielādēt Wavefront OBJ failus ar pievienotajām materiālu definīcijām.
  • glTF 2.0 / GLB: PBR materiālu ielāde un binārā GLB izvade caur GltfSaveOptions.
  • STL: Lasīt un rakstīt gan bināro, gan ASCII STL ar pilnu apgriešanas verifikāciju.
  • COLLADA, 3MF, FBX: Papildu formāta atbalsts ar katram formātam paredzētām opciju klasēm.
  • Pilni TypeScript tipi: Katrs klase, metode un opcija ir stingri tipizēta ar noImplicitAny un strictNullChecks.

Kur Aspose.3D FOSS var izmantot

  • Node.js asset pipelines: Importēt OBJ failus, validēt un pārorientēt ģeometriju, un eksportēt kā GLB CI.
  • Game tooling: Apstrādājiet 3D režģus paketē, neizmantojot iebūvētu dzinēju vai renderētāju.
  • 3D drukāšanas darba plūsmas: Lasīt, pārbaudīt un atkārtoti eksportēt STL un 3MF failus.
  • Serverless backends: Palaidiet 3D konvertēšanas galapunktus Lambda vai Cloud Functions.
  • Satura migrācija: Pārvērst starp formāta ģimenēm lielā mērogā no viena skripta.

Opcijas katram formātam un koordinātu vadība

  • Koordinātu sistēmas orientācija: Pagriezt asis un pielāgot mērogu katram formātam, izmantojot opciju klases.
  • Normālu normalizācija: Automātiski normalizēt virsotnes normālus ielādē vai saglabājot.
  • Binārais pret JSON izvade: Izvēlieties kompakto GLB vai lasāmu glTF, izmantojot GltfSaveOptions.
  • Materiālu ielādes kontrole: Iespējot vai atspējot MTL/tekstūru ielādi, lai paātrinātu parsēšanu.
  • Round-trip fidelity: Nezināmi ainas grafika mezgli tiek saglabāti burtiski pēc atkārtotas saglabāšanas.

Izstrādātāja pieredze

Aspose.3D FOSS for TypeScript instalējas ar vienu npm install @aspose/3d komandu. Nav nevienu vietējo papildinājumu, ko kompilēt. Bibliotēka ir tīri TypeScript/JavaScript ar vienu automātiski instalētu atkarību (xmldom).

Stipri tipizētā API nodrošina pilnīgu IDE automātisko pabeigšanu katrai ainas grafika klasei un formāta opcijai. Bibliotēka ir paredzēta Node.js 18–22+ un TypeScript 5.0+, darbojas identiski Linux CI izpildītājos un izstrādātāju darba stacijās, un ir MIT-licensed ar atvērtu problēmu izsekotāju GitHub.

Ielādēt OBJ ainu un eksportēt kā glTF

Instalējiet, izmantojot npm, pēc tam izmantojiet scene.open() ar ObjLoadOptions, lai ielādētu režģi kopā ar tā MTL materiāla failu. Gan open(), gan save() ir sinhroni — nav vajadzīgs await vai Promise ķēde. Izsaucot scene.save() ar .gltf paplašinājumu, tiek rakstīts standarta glTF 2.0 JSON — formāts tiek automātiski noteikts no faila paplašinājuma.

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");

Konvertēt STL uz bināro GLB

Lai izveidotu kompakto bināro GLB, nevis noklusējuma JSON glTF, nododiet GltfSaveOptions ar binaryMode = true. Gan open() gan save() ir sinhroni — nav vajadzīgs await.

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);

Frequently Asked Questions

Kas ir Aspose.3D FOSS priekš TypeScript?

Tas ir bezmaksas, MIT licencēta TypeScript/Node.js bibliotēka, kas ļauj ielādēt, manipulēt un saglabāt 3D ainas, neinstalējot nevienu vietējo papildinājumu vai ārēju SDK.

Kuri 3D formāti tiek atbalstīti?

OBJ (ar .mtl), glTF 2.0 un GLB, STL (binārais un ASCII), COLLADA (DAE), 3MF un FBX. Katram formātam ir īpaša tipizēta opciju klase.

Vai tas pieprasa vietējus Node.js papildinājumus?

Nr. Aspose.3D FOSS priekš TypeScript ir tīrs JavaScript/TypeScript. Tas neprasa kompilācijas soli un ir tikai viena izpildlaika atkarība (xmldom) instalēta automātiski ar npm.

Kā to instalēt?

Izpildiet npm install @aspose/3d. Nav vajadzīgas papildu sistēmas pakotnes vai vietējie papildinājumi.

Kuras Node.js un TypeScript versijas tiek atbalstītas?

Node.js 18, 20 un 22+. TypeScript 5.0+. Bibliotēka tiek kompilēta uz CommonJS un darbojas ar stingriem TypeScript iestatījumiem.

Vai tas tiek piegādāts ar TypeScript tipa definīcijām?

Jā. Visas klases, metodes, enum un opciju tipi ir pilnīgi tipizēti, izmantojot noImplicitAny un strictNullChecks.

Vai es varu kontrolēt koordinātu sistēmas orientāciju?

Jā. Formāta specifiskās opciju klases, piemēram, ObjLoadOptions un GltfSaveOptions, ļauj pārslēgt asis, pielāgot mērogu un normalizēt normāles bez pielāgota parsēšanas koda.

Kur var atrast avota kodu?

Bibliotēka ir licencēta ar MIT licenci un tiek mitināta GitHub. Kļūdu ziņojumi un pull pieprasījumi ir laipni gaidīti.

  

Support and Learning Resources

 Latviešu