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

Aspose.3D FOSS for TypeScript

Last inn, konstruer, transformer og eksporter 3D‑scener fra Node.js — fullt typet, open‑source og produksjonsklar med kun én npm‑installasjon.

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

Lære GitHub

Open‑source TypeScript‑bibliotek for 3D‑filbehandling

Aspose.3D FOSS for TypeScript er et MIT-lisensiert bibliotek for å arbeide 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 at en renderer kreves.

Biblioteket eksponerer et 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 autfullføring og sikkerhet på kompileringstidspunktet. Dens eneste kjøretidsavhengighet, xmldom, installeres automatisk.

Støtte for 3D‑formater og typet scene‑graf‑API

  • OBJ / MTL: Last inn Wavefront OBJ‑filer med tilhørende materialdefinisjoner.
  • glTF 2.0 / GLB: PBR‑materiallasting og binær GLB‑utdata via GltfSaveOptions.
  • STL: Les og skriv både binær og ASCII STL med full rundtur‑verifisering.
  • COLLADA, 3MF, FBX: Ekstra formatstøtte med per‑format alternativklasser.
  • Full TypeScript-typer: Hver klasse, metode og alternativ er sterkt typet med noImplicitAny og strictNullChecks.

Hvor Aspose.3D FOSS kan brukes

  • Node.js‑asset‑pipelines: Importer OBJ‑filer, valider og re‑orienter geometri, og eksporter som GLB i CI.
  • Spillverktøy: Batch‑behandle 3D‑mesher uten en innebygd motor eller renderer.
  • 3D‑utskriftsarbeidsflyter: Les, valider og eksporter STL‑ og 3MF‑filer på nytt.
  • Serverløse backends: Kjør 3D-konverteringsendepunkter i Lambda eller Cloud Functions.
  • Innholdsmigrasjon: Konverter mellom formatfamilier i stor skala fra ett enkelt skript.

Alternativer per format og koordinatkontroll

  • Koordinatsystemorientering: Vend akser og juster skala per format med alternativklasser.
  • Normalnormalisering: Normaliser automatisk vertexnormaler ved lasting eller lagring.
  • Binær vs. JSON-utdata: Velg kompakt GLB eller lesbar glTF via GltfSaveOptions.
  • Kontroll av materiallasting: Aktiver eller deaktiver MTL-/teksturlasting for raskere parsing.
  • Rundtur-nøyaktighet: Ukjente scene‑grafnoder bevares ordrett ved gjenlagring.

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

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

Last inn en OBJ-scene og eksporter som glTF

Installer med npm, og bruk deretter den synkrone scene.open()‑metoden med ObjLoadOptions for å laste inn mesh‑en sammen med dens MTL‑materialfil. Å kalle scene.save() med en .gltf‑utvidelse skriver standard glTF 2.0 JSON; formatet blir automatisk inferert fra filutvidelsen.

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 å produsere en kompakt binær GLB i stedet for standard JSON glTF, send inn GltfSaveOptions med binaryMode = true.

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

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

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

Frequently Asked Questions

Hva er Aspose.3D FOSS for TypeScript?

Det er et gratis, MIT-lisensiert TypeScript/Node.js-bibliotek for innlasting, manipulering og lagring av 3D-scener uten å installere noen native-tillegg 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 typet alternativklasse.

Krever det native Node.js-tillegg?

Nei. Aspose.3D FOSS for TypeScript er ren JavaScript/TypeScript. Den krever ingen kompileringstrinn og har kun én kjøretidsavhengighet (xmldom) som installeres automatisk av npm.

Hvordan installerer jeg det?

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 kompileres til CommonJS og fungerer med strenge TypeScript‑innstillinger.

Kommer den med TypeScript-type-definisjoner?

Ja. Alle klasser, metoder, enum‑er og alternativtyper er fullt typet med noImplicitAny og strictNullChecks aktivert.

Kan jeg styre koordinatsystemets orientering?

Ja. Per‑format alternativklasser som ObjLoadOptions og GltfSaveOptions lar deg snu akser, justere skala og normalisere normaler uten egendefinert parse‑kode.

Hvor kan jeg finne kildekoden?

Biblioteket er lisensiert under MIT og er vert på GitHub. Feilrapporter og pull‑forespørsler er velkomne.

  

Støtte og læringsressurser

 Norsk