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 å 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 et fullt typet scene‑graph 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 målretter 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 kjøretidsavhengighet, xmldom, installeres automatisk. For bedriftsproduktfamilien, se Aspose.3D — Enterprise Product Family.

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ære og ASCII STL med full rundturverifisering.
  • COLLADA, 3MF, FBX: Tilleggsformatstø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: Import OBJ-filer, valider og reorienter geometri, og eksporter som GLB i CI.
  • Spillverktøy: Batch-behandle 3D meshes uten en innebygd motor eller renderer.
  • 3D printing workflows: Les, valider og eksporter STL- og 3MF-filer på nytt.
  • Serverless backends: Kjør 3D‑konverteringsendepunkter i Lambda eller Cloud Functions.
  • Innholdsmigrering: 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.
  • Normal normalisering: Normaliser automatisk vertexnormals ved lasting eller lagring.
  • Binær vs. JSON utdata: Velg kompakt GLB eller lesbar glTF via GltfSaveOptions.
  • Materialinnlastingskontroll: Aktiver eller deaktiver MTL/teksturlasting for raskere parsing.
  • Rundtur‑nøyaktighet: Ukjente scene‑grafnoder blir bevart ordrett ved lagring på nytt.

Utvikleropplevelse

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

Den sterkt typede API-en gir full IDE-autocomplete for hver scene-graph-klasse og formatalternativ. Biblioteket retter seg mot Node.js 18–22+ og TypeScript 5.0+, kjører identisk på Linux CI runners og utviklerarbeidsstasjoner, og er MIT-licensed med en åpen issue tracker på GitHub.

Last inn en OBJ-scene og eksporter som glTF

Installer med npm, deretter bruk scene.open() med ObjLoadOptions for å laste inn mesh’en sammen med MTL-materialfilen. Både open() og save() er synkrone — ingen await eller Promise-kjeder er nødvendig. Å kalle scene.save() med en .gltf-utvidelse skriver standard glTF 2.0 JSON — formatet blir automatisk avledet 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());
// Export as 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 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 stilte spørsmål

Hva er Aspose.3D FOSS for TypeScript?

Det er et gratis, MIT‑lisensiert TypeScript/Node.js‑bibliotek for lasting, 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 opsjonsklasse.

Krever det native Node.js-tillegg?

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

Kommer den med TypeScript-typedefinisjoner?

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

Kan jeg kontrollere orienteringen av koordinatsystemet?

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‑requests er velkomne.

  

Støtte og læringsressurser

 Norsk