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

Aspose.3D FOSS för TypeScript

Läs in, konstruera, transformera och exportera 3D‑scener från Node.js — fullt typad, öppen källkod och produktionsklar med en enda npm‑installation.

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

Dokumentation GitHub

Öppen källkod TypeScript-bibliotek för 3D‑filbehandling

Aspose.3D FOSS för TypeScript är ett MIT-licensierat bibliotek för att arbeta med 3D-filformat i Node.js-applikationer. Installera det med ett enda npm install @aspose/3d-kommando och börja läsa, konstruera och skriva 3D-scener i TypeScript omedelbart, utan att behöva kompilera inhemska tillägg, utan externa SDK:er att installera och utan någon renderare krävs.

Biblioteket exponerar ett fullständigt typat scene‑graf‑API byggt kring Scene, Node, Entity, Mesh, Camera, Light och Transform, samma konceptuella modell som används av professionella 3D‑verktyg. Formatstöd inkluderar OBJ (Wavefront, med .mtl‑materialladdning), glTF 2.0 och GLB‑binär (PBR‑material), STL (binär och ASCII, full roundtrip), COLLADA (DAE), 3MF och FBX. Per‑format‑alternativklasser såsom ObjLoadOptions och GltfSaveOptions ger dig exakt kontroll över koordinatsystemets orientering, skala, normalisering av normaler, binärt vs. JSON‑utdata och materialladdning.

Aspose.3D FOSS riktar sig mot Node.js 18, 20 och 22+ med TypeScript 5.0+ och kompileras till CommonJS. Biblioteket levereras med strikta TypeScript‑kompilatorinställningar (noImplicitAny, strictNullChecks) så att din IDE ger fullständig autokomplettering och kompileringssäkerhet. Dess enda runtime‑beroende, xmldom, installeras automatiskt.

Stöd för 3D-format och typad scen‑graf‑API

  • OBJ / MTL: Ladda Wavefront OBJ‑filer med medföljande materialdefinitioner.
  • glTF 2.0 / GLB: PBR‑materialladdning och binär GLB‑utdata via GltfSaveOptions.
  • STL: Läs och skriv både binär och ASCII STL med full roundtrip‑verifiering.
  • COLLADA, 3MF, FBX: Ytterligare formatstöd med per‑format‑alternativklasser.
  • Fulla TypeScript‑typer: Varje klass, metod och alternativ är starkt typat med noImplicitAny och strictNullChecks.

Var Aspose.3D FOSS kan användas

  • Node.js‑tillgångspipelines: Importera OBJ‑filer, validera och omorientera geometri, och exportera som GLB i CI.
  • Spelverktyg: Batch‑processa 3D‑nät utan en inbyggd motor eller renderare.
  • 3D‑utskriftsarbetsflöden: Läs, validera och exportera STL‑ och 3MF‑filer på nytt.
  • Serverlösa backends: Kör 3D‑konverteringsändpunkter i Lambda eller Cloud Functions.
  • Innehållsmigrering: Konvertera mellan formatfamiljer i skala från ett enda skript.

Alternativ per format och koordinatkontroll

  • Koordinatsystemorientering: Vänd axlar och justera skala per format med alternativklasser.
  • Normalnormalisering: Normalisera automatiskt vertexnormaler vid inläsning eller sparning.
  • Binär vs. JSON-utdata: Välj kompakt GLB eller läsbar glTF via GltfSaveOptions.
  • Materialladdningskontroll: Aktivera eller inaktivera MTL-/texturladdning för snabbare parsning.
  • Rundresa-fidelitet: Okända scene-graph‑noder bevaras ordagrant vid återlagring.

Utvecklarupplevelse

Aspose.3D FOSS för TypeScript‑installationer med ett enda npm install @aspose/3d‑kommando. Det finns inga inhemska tillägg att kompilera. Biblioteket är ren TypeScript/JavaScript med ett automatiskt installerat beroende (xmldom).

Det starkt typade API:et ger fullständig IDE‑autokomplettering för varje scen‑grafklass och formatalternativ. Biblioteket riktar sig mot Node.js 18–22+ och TypeScript 5.0+, kör identiskt på Linux‑CI‑runners och utvecklares arbetsstationer, och är licensierat under MIT med en öppen ärende‑spårare på GitHub.

Läs in en OBJ-scen och exportera som glTF

Installera med npm, använd sedan den synkrona scene.open()‑metoden med ObjLoadOptions för att läsa in meshen tillsammans med dess MTL‑materialfil. Att anropa scene.save() med en .gltf‑filändelse skriver standard‑glTF 2.0‑JSON; formatet härleds automatiskt från filändelsen.

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

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

Konvertera STL till binär GLB

För att producera en kompakt binär GLB istället för standard‑JSON glTF, skicka GltfSaveOptions med binaryMode = true.

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

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

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

Vanliga Frågor

Vad är Aspose.3D FOSS för TypeScript?

Det är ett gratis, MIT-licensierat TypeScript/Node.js-bibliotek för att läsa in, manipulera och spara 3D-scener utan att installera någon native addon eller extern SDK.

Vilka 3D-format stöds?

OBJ (med .mtl), glTF 2.0 och GLB, STL (binär och ASCII), COLLADA (DAE), 3MF och FBX. Varje format har en dedikerad typad alternativklass.

Kräver det native Node.js‑tillägg?

Nej. Aspose.3D FOSS för TypeScript är ren JavaScript/TypeScript. Det kräver inget kompileringssteg och har ett enda runtime‑beroende (xmldom) som installeras automatiskt av npm.

Hur installerar jag det?

Kör npm install @aspose/3d. Inga ytterligare systempaket eller native addons krävs.

Vilka Node.js- och TypeScript-versioner stöds?

Node.js 18, 20 och 22+. TypeScript 5.0+. Biblioteket kompileras till CommonJS och fungerar med strikta TypeScript‑inställningar.

Levereras den med TypeScript-typdefinitioner?

Ja. Alla klasser, metoder, enum och alternativtyper är fullt typade med noImplicitAny och strictNullChecks aktiverade.

Kan jag kontrollera orienteringen av koordinatsystemet?

Ja. Per‑format alternativklasser såsom ObjLoadOptions och GltfSaveOptions låter dig vända axlar, justera skala och normalisera normaler utan egen parsingskod.

Var kan jag hitta källkoden?

Biblioteket är licensierat under MIT och finns på GitHub. Felrapporter och pull‑requests är välkomna.

  

Stöd och Lärande Resurser

 Svenska