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

Aspose.3D FOSS for TypeScript

Last inn, bygg, transformer og eksporter 3D‑scener fra Node.js — fullt typet, åpen kilde og klar for produksjon med kun én npm‑installasjon.

Åpenkildekode TypeScript-bibliotek for 3D filbehandling

Aspose.3D FOSS for TypeScript er et MIT-lisensiert bibliotek for å jobbe med 3D-filformater i Node.js-applikasjoner. Installer det med en enkelt npm install @aspose/3d-kommando og begynn å lese, konstruere og skrive 3D-scener i TypeScript umiddelbart, uten native add-ons å kompilere, uten eksterne SDK-er å installere, og uten renderer nødvendig.

Biblioteket eksponerer en fullt typet scene‑graf API bygget rundt Scene, Node, Entity, Mesh, Camera, Light og Transform, den samme konseptuelle modellen som brukes av profesjonelle 3D‑verktøy. Formatstøtte inkluderer OBJ (Wavefront, med .mtl-materiallasting), glTF 2.0 og GLB-binær (PBR-materialer), STL (binær og ASCII, full rundtur), COLLADA (DAE), 3MF og FBX. Per‑format alternativklasser som ObjLoadOptions og GltfSaveOptions gir deg presis kontroll over koordinatsystemorientering, skala, normalisering av normaler, binær vs. JSON-utdata, og materiallasting.

Aspose.3D FOSS retter seg mot Node.js 18, 20 og 22+ med TypeScript 5.0+ og kompilerer til CommonJS. Biblioteket leveres med strenge TypeScript-kompilatorinnstillinger (noImplicitAny, strictNullChecks) slik at IDE-en din gir full autofullføring og kompileringstidssikkerhet. Dens eneste runtime‑avhengighet, xmldom, installeres automatisk. For bedriftsproduktfamilien, se Aspose.3D — Enterprise Product Family.

Støtte for 3D-format og API for typede scener.

  • ** OBJ / MTL:** Last Wavefront-OBJ-filer med tilhørende materialedefinisjoner.
  • glTF 2.0 / GLB: Lasting av PBR-materiale og binær utgang fra GDB via GltfSaveOptions.
  • STL: Les og skriv både binær- og ASCII STL med full rundreiseverifisering.
  • COLLADA, 3MF, FBX: Supplerende formatstøtte med alternativklass per-format.
  • Full TypeScript-typer: Hver klasse, metode og alternativ er sterkt typert med noImplicitAny og strictNullChecks.

Hvor Aspose.3D FOSS kan brukes

  • Node.js-aktivsrør: Importerer OBJ-filer, validerer og omorienterer geometri og eksporter som GLB i CI.
  • ** Spillverktøy:** Batch-prosess 3D-masker uten en innfødt motor eller renderer.
  • ** 3D-printingsarbeidsflyter:** Les, valider og reeksporter STL- og 3MF-filer.
  • Serverless backends: Kjør 3D konvertering sluttpunkter i Lambda eller Cloud Functions.
  • ** Innholdsmigrasjon:** Konvertere mellom formatfamilier i skala fra et enkelt skript.

Forfatningsalternativer og koordinatkontroll

  • ** Koordinat-systemorientering:** Vender aksene og justerer skala per format med valgklass.
  • Normal normalisering: Normaliserer automatisk normaler for topppunkt ved lasting eller lagring.
  • ** Binær vs. JSON-utgang:** Velg kompakte GLB eller lesbar glTF via GltfSaveOptions.
  • Materiell lastekontroll: Aktiverer eller deaktiver MTL/teksturer for raskere analyse.
  • ** Rundtur-troverdighet:** Ukjente scene-grafknuter bevares bokstavelig ved gjenoppsparing.

Utvikleropplevelse

Aspose.3D FOSS for TypeScript‑installasjoner med en enkelt npm install @aspose/3d-kommando. Det finnes ingen native‑tillegg som må kompileres. Biblioteket er ren TypeScript/JavaScript med én automatisk installert avhengighet (xmldom).

Den sterkt typede API gir full IDE‑autofullføring for hver scene‑graf‑klasse og formatalternativ. Biblioteket retter seg mot Node.js 18–22+ og TypeScript 5.0+, kjører identisk på Linux CI‑runnere og utviklerarbeidsstasjoner, og er MIT‑lisensiert med en åpen feilsporer på GitHub.

Last opp en OBJ-scene og eksporter som glTF

Installer med npm, og deretter bruke scene.open() med ObjLoadOptions for å laste nettverket sammen med MTL-materialefilen. Både open() og save() er synkrone ingen await eller Promise kjedebringing er nødvendig. Å ringe scene.save() til en .gltf utvidelse skriver standard glTF 2.0 JSON ?? formatet utledes automatisk fra filen utvidelsen.

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

Konvertere STL til binær GLB

For å produsere en kompakt binær GLB i stedet for standard JSON glTF, passerer du GltfSaveOptions med binaryMode = true. Både open() og save() er synkrone ingen await trengs.

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

Ofte stilte spørsmål

Hva er Aspose.3D FOSS for TypeScript?

Det er et gratis, MIT-lisensert TypeScript/Node.js bibliotek for å laste opp, manipulere og lagre 3D scener uten å installere noen native addon eller ekstern SDK.

Hvilke 3D-formater støttes?

OBJ (med .mtl), glTF 2.0 og GLB, STL (binær og ASCII), COLLADA (DAE), 3MF og FBX. Hvert format har en dedikert typede alternativer klasse.

Trenger det native Node.js-tillegg?

Nei. Aspose.3D FOSS for TypeScript er ren JavaScript/TypeScript. Den krever ingen kompileringstrinn og har en enkelt kjøretidsavhengighet (xmldom) installert automatisk av npm.

Hvordan installerer jeg den?

Kjør npm install @aspose/3d. Ingen ekstra systempakker eller native‑tillegg er påkrevd.

Hvilke Node.js- og TypeScript-versjoner støttes?

Node.js 18, 20 og 22+. TypeScript 5.0+. Biblioteket kompirer til CommonJS og fungerer med strenge Type Script-innstillinger.

Leveres det med TypeScript type definisjoner?

Ja. Alle klasser, metoder, enumer og alternativtyper er fullt skrevet med noImplicitAny og strictNullChecks aktivert.

Kan jeg styre koordinat-system orientering?

Ja. Per-format alternativ klasser som ObjLoadOptions og GltfSaveOptions lar deg flippe akser, justere skala, og normalisere normaler uten egendefinert parsing kode.

Hvor kan jeg finne kildekoden?

Biblioteket er lisensiert av MIT og vert på GitHub. Bug-rapporter og trekkforespørsler er velkommen.

  

Støtte og læringsressurser

 Norsk