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

Aspose.3D FOSS for 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ą vienu npm install @aspose/3d komanda ir iš karto pradėkite skaityti, kurti ir rašyti 3D scenas TypeScript, be jokių 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 roundtrip), COLLADA (DAE), 3MF ir FBX. Kiekvienam formatui skirtos parinkčių klasės, tokios kaip ObjLoadOptions ir GltfSaveOptions, suteikia tikslų valdymą koordinatų sistemos orientacijai, mastui, normalų normalizavimui, binariniam vs. JSON išvedimui ir medžiagų įkėlimui.

Aspose.3D FOSS skirta Node.js 18, 20 ir 22+ su TypeScript 5.0+ ir kompiliuojama į CommonJS. Biblioteka tiekiama su griežtais TypeScript kompiliatoriaus nustatymais (noImplicitAny, strictNullChecks), todėl jūsų IDE suteikia pilną automatinį užbaigimą ir kompiliacijos laiko saugumą. Jos vienintelė vykdymo laiko priklausomybė, xmldom, įdiegiama automatiškai.

3D formatų palaikymas ir tipizuota scenų grafiko API

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

Kur galima naudoti Aspose.3D FOSS

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

Kiekvieno formato parinktys ir koordinatų valdymas

  • Koordinačių sistemos orientacija: Apversti ašis ir koreguoti mastelį pagal formatą naudojant parinkčių klases.
  • Normalų normalizavimas: Automatiškai normalizuoti viršūnių normalės įkeliant arba išsaugant.
  • Dvejetainis vs. JSON išvestis: Pasirinkite kompaktišką GLB arba skaitomą glTF naudodami GltfSaveOptions.
  • Medžiagų įkėlimo kontrolė: Įjunkite arba išjunkite MTL/tekstūrų įkėlimą, kad pagreitintumėte analizę.
  • Apdorojimo tikslumas: Nežinomi scenos grafiko mazgai išsaugomi nepakitę per pakartotinį įrašymą.

Kūrėjo patirtis

Aspose.3D FOSS TypeScript diegimams su vienu npm install @aspose/3d komanda. Nėra jokių natūralių papildinių, kuriuos reikėtų kompiliuoti. Biblioteka yra grynas TypeScript/JavaScript su viena automatiškai įdiegtą priklausomybę (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 licencijuota pagal MIT su atvira problemų sekimo sistema GitHub.

Įkelti OBJ sceną ir eksportuoti kaip glTF

Įdiekite naudodami npm, tada naudokite sinchroninį scene.open() metodą su ObjLoadOptions, kad įkeltumėte tinklą kartu su jo MTL medžiagos failu. 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());

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

Konvertuoti STL į binarinį GLB

Norėdami sukurti kompaktišką binarinį GLB vietoj numatytojo JSON glTF, perduokite GltfSaveOptions su binaryMode = true.

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

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

// Išsaugoti kaip kompaktišką binarinį GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Kas yra Aspose.3D FOSS TypeScript kalbai?

Tai yra nemokama, MIT-licencijuota TypeScript/Node.js biblioteka, skirta įkelti, manipuliuoti ir išsaugoti 3D scenas be jokio natyvaus papildinio 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), kuri automatiškai įdiegiama 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ės sistemos orientaciją?

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

Kur galiu rasti šaltinio kodą?

Biblioteka yra MIT licencijos ir talpinama GitHub platformoje. Klaidos pranešimai ir pull request’ai yra laukiami.

  

Support and Learning Resources

 Lietuvių