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

Aspose.3D FOSS for TypeScript

Indlæs, konstruer, transformer og eksporter 3D-scener fra Node.js — fuldt typet, open-source og klar til produktion med kun én npm-installation.

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

Lære GitHub

Open-Source TypeScript-bibliotek til 3D-filbehandling

Aspose.3D FOSS for TypeScript er et MIT-licenseret bibliotek til at arbejde med 3D-filformater i Node.js-applikationer. Installer det med en enkelt npm install @aspose/3d-kommando og begynd straks at læse, konstruere og skrive 3D-scener i TypeScript, uden native add‑ons at kompilere, uden eksterne SDK’er at installere, og uden at en renderer er påkrævet.

Biblioteket eksponerer et fuldt typet scene‑graf‑API bygget omkring Scene, Node, Entity, Mesh, Camera, Light og Transform, den samme konceptuelle model som professionelle 3D‑værktøjer bruger. Formatunderstøttelse omfatter OBJ (Wavefront, med .mtl-materialelæsning), glTF 2.0 og GLB-binær (PBR-materialer), STL (binær og ASCII, fuld roundtrip), COLLADA (DAE), 3MF og FBX. Per‑format option‑klasser såsom ObjLoadOptions og GltfSaveOptions giver dig præcis kontrol over koordinatsystemorientering, skala, normalisering af normaler, binær vs. JSON‑output og materialelæsning.

Aspose.3D FOSS målretter Node.js 18, 20 og 22+ med TypeScript 5.0+ og kompilerer til CommonJS. Biblioteket leveres med strenge TypeScript‑kompilatorindstillinger (noImplicitAny, strictNullChecks), så din IDE giver fuld autoudfyldning og compile‑time‑sikkerhed. Dens eneste runtime‑afhængighed, xmldom, installeres automatisk.

3D-formatunderstøttelse og typet Scene-Graph API

  • OBJ / MTL: Indlæs Wavefront OBJ‑filer med tilhørende materialdefinitioner.
  • glTF 2.0 / GLB: PBR-materialelæsning og binær GLB‑output via GltfSaveOptions.
  • STL: Læs og skriv både binær og ASCII STL med fuld roundtrip‑verifikation.
  • COLLADA, 3MF, FBX: Yderligere formatunderstøttelse med per‑format option‑klasser.
  • Full TypeScript-typer: Hver klasse, metode og option er stærkt typet med noImplicitAny og strictNullChecks.

Hvor Aspose.3D FOSS kan bruges

  • Node.js‑asset‑pipelines: Importér OBJ‑filer, valider og re‑orientér geometri, og eksporter som GLB i CI.
  • Spil‑værktøj: Batch‑behandl 3D‑meshes uden en indbygget engine eller renderer.
  • 3D‑print‑arbejdsgange: Læs, valider og eksporter STL‑ og 3MF‑filer igen.
  • Serverløse backends: Kør 3D-konverteringsendepunkter i Lambda eller Cloud Functions.
  • Indholdsmigrering: Konvertér mellem formatfamilier i stor skala fra et enkelt script.

Indstillinger pr. format og koordinatkontrol

  • Koordinatsystemorientering: Vend akser og justér skala pr. format med option classes.
  • Normalnormalisering: Normaliser automatisk vertexnormale ved indlæsning eller gemning.
  • Binær vs. JSON-output: Vælg kompakt GLB eller læsbar glTF via GltfSaveOptions.
  • Kontrol af materialelæsning: Aktiver eller deaktiver MTL-/teksturlæsning for hurtigere parsing.
  • Rundtur-nøjagtighed: Ukendte scene‑graf‑noder bevares ordret ved gen‑gemning.

Udvikleroplevelse

Aspose.3D FOSS for TypeScript‑installationer med en enkelt npm install @aspose/3d‑kommando. Der er ingen native add‑ons at kompilere. Biblioteket er ren TypeScript/JavaScript med én automatisk installeret afhængighed (xmldom).

Det stærkt typede API giver fuld IDE‑autofuldførelse for hver scene‑graf‑klasse og formatindstilling. Biblioteket målretter Node.js 18–22+ og TypeScript 5.0+, kører identisk på Linux CI‑runnere og udvikler‑arbejdsstationer, og er MIT‑licenseret med en åben issue‑tracker på GitHub.

Indlæs en OBJ-scene og eksporter som glTF

Installer med npm, og brug derefter den synkrone scene.open()‑metode med ObjLoadOptions for at indlæse mesh’en sammen med dens MTL‑materialefil. Når du kalder scene.save() med en .gltf‑filendelse, skrives standard glTF 2.0 JSON; formatet udledes automatisk fra filendelsen.

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

// Eksporter som glTF 2.0 JSON
scene.save("model.gltf");

Konverter STL til binær GLB

For at producere en kompakt binær GLB i stedet for standard JSON glTF, skal du videregive GltfSaveOptions med binaryMode = true.

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

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

// Gem som kompakt binær GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

Hvad er Aspose.3D FOSS for TypeScript?

Det er et gratis, MIT-licenseret TypeScript/Node.js-bibliotek til indlæsning, manipulation og gemning af 3D-scener uden at installere noget native add‑on eller ekstern SDK.

Hvilke 3D-formater understøttes?

OBJ (med .mtl), glTF 2.0 og GLB, STL (binær og ASCII), COLLADA (DAE), 3MF og FBX. Hvert format har en dedikeret typet options‑klasse.

Kræver det native Node.js-tilføjelser?

Nej. Aspose.3D FOSS for TypeScript er ren JavaScript/TypeScript. Det kræver ingen kompileringstrin og har kun én runtime‑afhængighed (xmldom), som installeres automatisk af npm.

Hvordan installerer jeg det?

Kør npm install @aspose/3d. Ingen yderligere systempakker eller native add‑ons er påkrævet.

Hvilke Node.js- og TypeScript-versioner understøttes?

Node.js 18, 20 og 22+. TypeScript 5.0+. Biblioteket kompilerer til CommonJS og fungerer med strenge TypeScript-indstillinger.

Leveres den med TypeScript-typedefinitioner?

Ja. Alle klasser, metoder, enums og option-typer er fuldt typede med noImplicitAny og strictNullChecks aktiveret.

Kan jeg styre koordinatsystemets orientering?

Ja. Per-format option-klasser såsom ObjLoadOptions og GltfSaveOptions giver dig mulighed for at vende akser, justere skala og normalisere normaler uden brugerdefineret parsekode.

Hvor kan jeg finde kildekoden?

Biblioteket er MIT-licenseret og hostet på GitHub. Fejlrapporter og pull requests er velkomne.

  

Support og læringsressourcer

 Dansk