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

Aspose.3D FOSS for TypeScript

Laad, bouw, transformeer en exporteer 3D‑scènes vanuit Node.js — volledig getypeerd, open source en productie‑klaar met één npm‑installatie.

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

Leren GitHub

Open-Source TypeScript Library voor 3D bestandsverwerking

Aspose.3D FOSS voor TypeScript is een MIT-gelicentieerde bibliotheek voor het werken met 3D-bestandsformaten in Node.js-toepassingen. Installeer het met een enkele npm install @aspose/3d opdracht en begin onmiddellijk met het lezen, construeren en schrijven van 3D‑scènes in TypeScript, zonder native add‑ons te compileren, zonder externe SDK’s te installeren, en zonder renderer.

De bibliotheek biedt een volledig getypeerde scene‑graph API gebouwd rond Scene, Node, Entity, Mesh, Camera, Light en Transform, hetzelfde conceptuele model dat door professionele 3D‑tools wordt gebruikt. Ondersteunde formaten omvatten OBJ (Wavefront, met .mtl materiaallading), glTF 2.0 en GLB binary (PBR‑materialen), STL (binair en ASCII, volledige roundtrip), COLLADA (DAE), 3MF en FBX. Per‑formaat optieklassen zoals ObjLoadOptions en GltfSaveOptions geven u precieze controle over de oriëntatie van het coördinatensysteem, schaal, normalisatie van normalen, binair versus JSON output, en materiaallading.

Aspose.3D FOSS richt zich op Node.js 18, 20 en 22+ met TypeScript 5.0+ en compileert naar CommonJS. De bibliotheek wordt geleverd met strikte TypeScript‑compilerinstellingen (noImplicitAny, strictNullChecks) zodat uw IDE volledige autocomplete en compile‑tijd veiligheid biedt. De enige runtime‑afhankelijkheid, xmldom, wordt automatisch geïnstalleerd. Voor de enterprise‑productfamilie, zie Aspose.3D — Enterprise Product Family.

Ondersteuning van 3D-formaat en API voor getypte scènegrafieken

  • ** OBJ / MTL:** Load Wavefront-OBJ-bestanden met bijbehorende materiaaldefinities.
  • glTF 2.0 / GLB: PBR-materiaal laden en binaire GDB uitgang via GltfSaveOptions.
  • STL: Lees en schrijf zowel binaire als ASCII-ST L met volledige retourreferentie.
  • COLLADA, 3MF, FBX: Aanvullende formatondersteuning met optieclassen per formaat.
  • ** Volledige TypeScript-typen:** Elke klasse, methode en optie wordt sterk getypeerd met noImplicitAny en strictNullChecks.

Waar Aspose.3D FOSS kan worden gebruikt

  • Node.js-activa: Importeer OBJ-bestanden, valideer en oriënteer de geometrie opnieuw en uitvoer als GLB in CI.
  • ** Spelgereedschap:** Batch-processing 3D-meshes zonder een native engine of renderer.
  • ** 3D-printwerkstromen:** Lees, valideer en reexporteer STL- en 3MF-bestanden.
  • Serverless backends: Run 3D-conversie eindpunten in Lambda of Cloud Functions.
  • ** Inhoudsmigratie:** Converteren tussen formatfamilies op schaal vanuit één script.

Opties voor het performaat en coördinatencontrole

  • Coördinaten-systeemoriëntatie: Verander de assen en pas schaal per formaat aan met optieclassen.
  • ** Normale normalisatie:** Normaliseren van vertexnormaal op laden of opslaan.
  • Binary versus JSON-uitvoer: Selecteer compact GLB of leesbare glTF via GltfSaveOptions.
  • Materiaal laden: MTL/textuur laaden voor snellere analyse in of uitzetten.
  • Rondreis-getrouwheid: Onbekende scène-grafiek nodes worden letterlijk bewaard bij heropslag.

Ontwikkelaarservaring

Aspose.3D FOSS voor TypeScript‑installaties met één npm install @aspose/3d commando. Er zijn geen native add‑ons om te compileren. De bibliotheek is pure TypeScript/JavaScript met één automatisch geïnstalleerde afhankelijkheid (xmldom).

De sterk getypeerde API biedt volledige IDE‑autocompletie voor elke scene‑graph‑klasse en formatoptie. De bibliotheek richt zich op Node.js 18–22+ en TypeScript 5.0+, werkt identiek op Linux CI‑runners en ontwikkel‑werkstations, en is MIT‑gelicentieerd met een open issue‑tracker op GitHub.

Een OBJ-scene laden en als glTF exporteren

Installeer met npm, gebruik vervolgens scene.open() met ObjLoadOptions om de mesh samen met het MTL‑materiaalbestand te laden. Zowel open() als save() zijn synchroon — geen await of Promise chaining is nodig. Het aanroepen van scene.save() met een .gltf-extensie schrijft standaard glTF 2.0 JSON — het formaat wordt automatisch afgeleid van de bestandsextensie.

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

STL omzetten in binaire GLB

Om een compacte binaire GLB te produceren in plaats van de standaard JSON glTF, sla GltfSaveOptions door met binaryMode = true. Zowel open() als save() zijn synchroon geen await is nodig.

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

Veelgestelde vragen

Wat is Aspose.3D FOSS voor TypeScript?

Het is een gratis, MIT-gelicentieerde TypeScript/Node.js bibliotheek voor het laden, manipuleren en opslaan van 3D scènes zonder enige native addon of externe SDK te installeren.

Welke 3D-formaten worden ondersteund?

OBJ (met .mtl), glTF 2.0 en GLB, STL (binary and ASCII), COLLADA (DAE), 3MF en FBX. Elk formaat heeft een speciale getypte opties klas.

Is er een native Node.js-addon nodig?

Nee. Aspose.3D FOSS voor TypeScript is pure JavaScript/TypeScript. Het vereist geen compilatie stap en heeft een enkele runtime afhankelijkheid (xmldom) automatisch geïnstalleerd door npm.

Hoe installeer ik het?

Voer npm install @aspose/3d uit. Er zijn geen extra systeempakketten of native add-ons vereist.

Welke Node.js- en TypeScript-versies worden ondersteund?

Node.js 18, 20 en 22+. TypeScript 5.0+. De bibliotheek compilt naar CommonJS en werkt met strikte Type Script-instellingen.

Wordt het verzonden met TypeScript type definities?

Ja. Alle klassen, methoden, enums en optie types zijn volledig getypt met noImplicitAny en strictNullChecks ingeschakeld.

Kan ik de oriëntatie van het coördinatenstelsel regelen?

Ja. Per-format optie klassen zoals ObjLoadOptions en GltfSaveOptions laat je as omdraaien, schaal aanpassen en normaliseren zonder aangepaste parsing code.

Waar kan ik de broncode vinden?

De bibliotheek is MIT-licentie en wordt gehost op GitHub. bug rapporten en trek verzoeken zijn welkom.

  

Ondersteuning en leermiddelen

 Nederlands