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

Aspose.3D FOSS til TypeScript

Indlæs, konstruer, transformer og eksporter 3D-scener fra Node.js — fuldt typet, open-source og produktionsklar 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 addons at kompilere, uden eksterne SDKs at installere, og ingen renderer 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 bruges af professionelle 3D‑værktøjer. 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 indstillingsklasser såsom ObjLoadOptions og GltfSaveOptions giver dig præcis kontrol over koordinatsystemorientering, skala, normalnormalisering, binær vs. JSON output og materialelæsning.

Aspose.3D FOSS har som mål Node.js 18, 20 og 22+ med TypeScript 5.0+ og kompilerer til CommonJS. Biblioteket leveres med strenge TypeScript-kompilatorindstillinger (noImplicitAny, strictNullChecks), så dit IDE giver fuld autoudfyldning og kompileringstidssikkerhed. Dets eneste runtime-afhængighed, xmldom, installeres automatisk. For enterprise-produktfamilien, se Aspose.3D — Enterprise Product Family.

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

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

Hvor Aspose.3D FOSS kan bruges

  • Node.js asset pipelines: Importer OBJ-filer, valider og re-orienter geometri, og eksporter som GLB i CI.
  • Game tooling: Batch-behandle 3D meshes uden en indbygget engine eller renderer.
  • 3D printing workflows: Læs, valider og gen-eksporter STL- og 3MF-filer.
  • Serverløse backends: Kør 3D‑konverteringsendepunkter i Lambda eller Cloud Functions.
  • Indholdsmigrering: Konverter mellem formatfamilier i stor skala fra et enkelt script.

Indstillinger pr. format og koordinatkontrol

  • Koordinatsystemorientering: Vend akser og justér skala pr. format med optionklasser.
  • Normal normalisering: Normaliser automatisk vertexnormale ved indlæsning eller gemning.
  • Binær vs. JSON output: Vælg kompakt GLB eller læsbar glTF via GltfSaveOptions.
  • Materialindlæsningskontrol: Aktiver eller deaktiver MTL/texture-indlæsning for hurtigere parsing.
  • Rundrejse‑nøjagtighed: Ukendte scene‑grafnoder bevares ordret ved genlagring.

Udvikleroplevelse

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

Den stærkt typede API giver fuld IDE autocomplete for hver scene‑graph‑klasse og formatindstilling. Biblioteket målretter Node.js 18–22+ og TypeScript 5.0+, kører identisk på Linux CI‑runners og udvikler‑arbejdsstationer, og er MIT-licensed med en open issue tracker på GitHub.

Indlæs en OBJ-scene og eksporter som glTF

Installer med npm, og brug derefter scene.open() med ObjLoadOptions til at indlæse mesh’en sammen med dens MTL-materialefil. Både open() og save() er synkrone — ingen await eller Promise‑kædning er nødvendig. Ved at kalde scene.save() med en .gltf-udvidelse skrives standard glTF 2.0 JSON — formatet udledes automatisk fra filudvidelsen.

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

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. Både open() og save() er synkrone — ingen await er nødvendig.

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 stillede spørgsmål

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 nogen native addon 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) installeret 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 det 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 som ObjLoadOptions og GltfSaveOptions giver dig mulighed for at vende akser, justere skala og normalisere normaler uden brugerdefineret parse‑kode.

Hvor kan jeg finde kildekoden?

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

  

Support og læringsressourcer

 Dansk