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

Aspose.3D FOSS, skirta TypeScript

Įkelkite, sukurkite, transformuokite ir eksportuokite 3D scenas iš Node.js — pilnai tipizuota, atviro kodo ir pasiruošusi gamybai su viena npm įdiegimu.

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

Documentation GitHub

Atviro kodo TypeScript biblioteka 3D failų apdorojimui

Aspose.3D FOSS for TypeScript yra MIT licencijuota biblioteka, skirta dirbti su 3D failų formatais Node.js programose. Įdiekite ją viena npm install @aspose/3d komanda ir pradėkite skaityti, kurti ir rašyti 3D scenas TypeScript iš karto, be natūralių papildinių kompiliavimui, be išorinių SDK diegimo ir be reikiamo rendererio.

Biblioteka pateikia pilnai tipizuotą scenų grafų API, sukurtą aplink Scene, Node, Entity, Mesh, Camera, Light ir Transform, tą patį konceptualinį modelį, kurį naudoja profesionalios 3D priemonės. Formato palaikymas apima OBJ (Wavefront, su .mtl medžiagų įkėlimu), glTF 2.0 ir GLB binarinį (PBR medžiagos), STL (binari ir ASCII, pilnas grįžtamasis kelias), COLLADA (DAE), 3MF ir FBX. Kiekvienam formatui skirtos parinkčių klasės, tokios kaip ObjLoadOptions ir GltfSaveOptions, suteikia tikslų valdymą koordinatės sistemos orientacijai, mastui, normalių normalizavimui, binariniam vs. JSON išvedimui ir medžiagų įkėlimui.

Aspose.3D FOSS orientuotas į Node.js 18, 20 ir 22+ su TypeScript 5.0+ ir kompiliuoja į CommonJS. Biblioteka tiekiama su griežtais TypeScript kompiliatoriaus nustatymais (noImplicitAny, strictNullChecks), todėl jūsų IDE suteikia pilną automatinį užbaigimą ir kompiliavimo laiko saugumą. Jos vienintelė vykdymo laiko priklausomybė, xmldom, įdiegiama automatiškai. Dėl įmonės produktų šeimos žiūrėkite Aspose.3D — Enterprise Product Family.

3D formatų palaikymas ir tipizuota scenų grafiko API

  • OBJ / MTL: Įkelti Wavefront OBJ failus su pridedamais medžiagų apibrėžimais.
  • glTF 2.0 / GLB: PBR medžiagos įkėlimas ir dvejetainis GLB išvestis per GltfSaveOptions.
  • STL: Skaityti ir rašyti tiek binarinius, tiek ASCII STL su pilna apdorojimo patikra.
  • COLLADA, 3MF, FBX: Papildomas formato palaikymas su kiekvienam formatui skirtomis parinkčių klasėmis.
  • Visi TypeScript tipai: Kiekviena klasė, metodas ir parinktis yra griežtai tipizuoti su noImplicitAny ir strictNullChecks.

Kur Aspose.3D FOSS gali būti naudojamas

  • Node.js asset pipelines: Importuokite OBJ failus, patikrinkite ir pertvarkykite geometriją, ir eksportuokite kaip GLB CI.
  • Žaidimų įrankiai: Masinis 3D tinklų apdorojimas be natūralios variklio ar rendererio.
  • 3D printing workflows: Skaityti, patikrinti ir iš naujo eksportuoti STL ir 3MF failus.
  • Serverless backendai: Paleiskite 3D konvertavimo galinius taškus Lambda arba Cloud Functions.
  • Content migration: Konvertuokite tarp formatų šeimų dideliu mastu iš vieno scenarijaus.

Formatų specifinės parinktys ir koordinatų valdymas

  • Koordinačių sistemos orientacija: Apverskite ašis ir pakoreguokite mastelį pagal formatą naudojant parinkčių klases.
  • Normalų normalizavimas: Automatiškai normalizuoti viršūnių normalus įkeliant arba išsaugant.
  • Dvejetainis vs. JSON išvestis: Pasirinkite kompaktišką GLB arba skaitomą glTF per GltfSaveOptions.
  • Material loading control: Įjunkite arba išjunkite MTL/tekstūrų įkėlimą greitesniam analizavimui.
  • Apkrovimo tikslumas: Nežinomi scenos grafiko mazgai išsaugomi nepakitę per pakartotinį įrašymą.

Kūrėjo patirtis

Aspose.3D FOSS for TypeScript įdiegiama viena npm install @aspose/3d komanda. Nėra natūralių papildinių, kurių reikia kompiliuoti. Biblioteka yra grynas TypeScript/JavaScript su viena automatiškai įdiegtą priklausomybe (xmldom).

Stipriai tipizuota API suteikia pilną IDE automatinį užbaigimą kiekvienai scenos grafiko klasei ir formato parinkčiai. Biblioteka skirta Node.js 18–22+ ir TypeScript 5.0+, veikia identiškai Linux CI vykdytojuose ir kūrėjų darbo vietose, ir yra MIT-licensed su atviru issue tracker GitHub platformoje.

Įkelti OBJ sceną ir eksportuoti kaip glTF

Įdiekite su npm, tada naudokite scene.open() su ObjLoadOptions, kad įkeltumėte tinklą kartu su jo MTL medžiagos failu. Abu open() ir save() yra sinchroniniai — nereikia await ar Promise grandinės. Iškviečiant scene.save() su .gltf plėtiniu, rašomas standartinis glTF 2.0 JSON — formatas automatiškai nustatomas iš failo plėtinio.

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

Konvertuoti STL į binarinį GLB

Norint sukurti kompaktų binarinį GLB vietoj numatyto JSON glTF, perduokite GltfSaveOptions su binaryMode = true. Abu open() ir save() yra sinchroniniai — await nereikia.

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 yra Aspose.3D FOSS TypeScript?

Tai yra nemokama, MIT licencijuota TypeScript/Node.js biblioteka, skirta įkelti, manipuliuoti ir išsaugoti 3D scenas be jokio natūralios plėtinio ar išorinio SDK įdiegimo.

Kokie 3D formatai palaikomi?

OBJ (su .mtl), glTF 2.0 ir GLB, STL (binarinis ir ASCII), COLLADA (DAE), 3MF ir FBX. Kiekvienas formatas turi atskirą tipizuotą parametrų klasę.

Ar tai reikalauja natūralių Node.js papildinių?

Ne. Aspose.3D FOSS for TypeScript yra grynas JavaScript/TypeScript. Jis nereikalauja jokio kompiliavimo žingsnio ir turi vieną vykdymo laiką priklausomybę (xmldom) įdiegtą automatiškai per npm.

Kaip jį įdiegti?

Paleiskite npm install @aspose/3d. Nereikia jokių papildomų sistemos paketų ar natūralių papildinių.

Kokios Node.js ir TypeScript versijos palaikomos?

Node.js 18, 20 ir 22+. TypeScript 5.0+. Biblioteka kompiliuojama į CommonJS ir veikia su griežtais TypeScript nustatymais.

Ar ji tiekiama su TypeScript tipų apibrėžimais?

Taip. Visos klasės, metodai, enumai ir parinkčių tipai yra visiškai tipizuoti su įjungtais noImplicitAny ir strictNullChecks.

Ar galiu valdyti koordinatų sistemos orientaciją?

Taip. Formato parinkčių klasės, tokios kaip ObjLoadOptions ir GltfSaveOptions, leidžia apversti ašis, reguliuoti mastelį ir normalizuoti normales be specialaus analizės kodo.

Kur galiu rasti šaltinio kodą?

Biblioteka yra licencijuota pagal MIT licenciją ir talpinama GitHub platformoje. Klaidos pranešimai ir pull request’ai yra laukiami.

  

Support and Learning Resources

 Lietuvių