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

Aspose.3D FOSS for TypeScript

Ielādējiet, izveidojiet, pārveidojiet un eksportējiet 3D ainas no Node.js — pilnīgi tipizēts, atvērtā koda un ražošanai gatavs ar vienu npm instalēšanu.

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, bez vajadzības kompilēt vietējos papildinājumus, bez ārējiem SDK instalēšanas un bez renderētāja.

Bibliotēka atklāj pilnīgi tipizētu ainas grafu API, kas būvēts ap 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 roundtrip), COLLADA (DAE), 3MF un FBX. Katram formātam paredzētā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ķē uz 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), tāpēc jūsu IDE nodrošina pilnīgu automātisko pabeigšanu un kompilācijas laikā drošību. Tās vienīgā izpildlaika atkarība, xmldom, tiek instalēta automātiski. Uz uzņēmuma produktu ģimenei skatiet Aspose.3D — Enterprise Product Family.

3D formātu atbalsts un tipizēts ainas grafiks 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 pilnīgu apgriezto pārbaudi.
  • COLLADA, 3MF, FBX: Papildu formāta atbalsts ar katram formātam paredzētām opciju klasēm.
  • Full TypeScript types: Katra klase, metode un opcija ir stingri tipizētas ar noImplicitAny un strictNullChecks.

Kur Aspose.3D FOSS var tikt izmantots

  • 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.

Formāta specifiskas iespējas un koordinātu vadība

  • Koordinātu sistēmas orientācija: Pagriezt asis un pielāgot mērogu atbilstoši 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 vadība: Iespējot vai atspējot MTL/tekstūru ielādi, lai paātrinātu parsēšanu.
  • Round-trip fidelity: Nezināmi scene-graph mezgli tiek saglabāti burtiski atkārtotā saglabāšanā.

Izstrādātāja pieredze

Aspose.3D FOSS priekš TypeScript instalēšanas 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ētais API nodrošina pilnīgu IDE automātisko pabeigšanu katrai ainas grafika klasei un formāta opcijai. Bibliotēka mērķējas uz Node.js 18–22+ un TypeScript 5.0+, darbojas identiski uz Linux CI izpildītājiem un izstrādātāju darba stacijām, un ir licencēta kā MIT ar atvērtu problēmu izsekotāju GitHub.

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

Instalējiet ar 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ēts 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ā es to instalēšu?

Izpildiet npm install @aspose/3d. Nav nepieciešami 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, enumi un opciju tipi ir pilnīgi tipizēti ar ieslēgtu 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 es varu atrast pirmkodu?

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