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

Aspose.3D FOSS voor 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-bibliotheek 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. Formaatondersteuning omvat OBJ (Wavefront, met .mtl‑materiaal laden), 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, binary vs. JSON output, en materiaal laden.

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‑tijdveiligheid biedt. Zijn enige runtime‑afhankelijkheid, xmldom, wordt automatisch geïnstalleerd. Voor de enterprise‑productfamilie, zie Aspose.3D — Enterprise Product Family.

3D‑formaatondersteuning en getypeerde scene‑graph‑API

  • OBJ / MTL: Laad Wavefront OBJ-bestanden met bijbehorende materiaaldefinities.
  • glTF 2.0 / GLB: PBR-materiaal laden en binaire GLB-uitvoer via GltfSaveOptions.
  • STL: Lees en schrijf zowel binaire als ASCII STL met volledige roundtrip‑verificatie.
  • COLLADA, 3MF, FBX: Extra formatondersteuning met per‑formaat optieklassen.
  • Full TypeScript types: Elke klasse, methode en optie is sterk getypeerd met noImplicitAny en strictNullChecks.

Waar Aspose.3D FOSS kan worden gebruikt

  • Node.js asset pipelines: Import OBJ-bestanden, valideer en heroriënteer geometrie, en exporteer als GLB in CI.
  • Game tooling: Batchverwerk 3D-meshes zonder een native engine of renderer.
  • 3D printing workflows: Lezen, valideren en opnieuw exporteren van STL- en 3MF-bestanden.
  • Serverless backends: Voer 3D-conversie‑endpoints uit in Lambda of Cloud Functions.
  • Content migration: Converteer op schaal tussen formaatfamilies vanuit één script.

Opties per formaat en coördinatenbeheer

  • Coördinatensysteemoriëntatie: Draai assen om en pas de schaal per formaat aan met optieklassen.
  • Normal normalisatie: Normaliseer automatisch vertex normals bij laden of opslaan.
  • Binaire vs. JSON output: Selecteer compacte GLB of leesbare glTF via GltfSaveOptions.
  • Materiaal laadcontrole: Inschakelen of uitschakelen van MTL/texture laden voor snellere parsing.
  • Round-trip-fideliteit: Onbekende scene-graph knooppunten worden letterlijk bewaard bij opnieuw opslaan.

Ontwikkelaarservaring

Aspose.3D FOSS voor TypeScript installeert met een enkel 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+, draait identiek op Linux CI‑runners en ontwikkelaarswerkstations, en is MIT-licensed met een open issue tracker op GitHub.

Laad een OBJ‑scène en exporteer als glTF

Installeer met npm, gebruik vervolgens scene.open() met ObjLoadOptions om het mesh te laden samen met het MTL‑materiaalbestand. Zowel open() als save() zijn synchroon — er is geen await of Promise chaining 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");

Converteer STL naar Binary GLB

Om een compact binair GLB te produceren in plaats van de standaard JSON glTF, geef GltfSaveOptions door met binaryMode = true. Zowel open() als save() zijn synchroon — er is geen await 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 een native add‑on of externe SDK te installeren.

Welke 3D-formaten worden ondersteund?

OBJ (met .mtl), glTF 2.0 en GLB, STL (binair en ASCII), COLLADA (DAE), 3MF en FBX. Elk formaat heeft een eigen getypeerde opties‑klasse.

Vereist het native Node.js-addons?

Nee. Aspose.3D FOSS voor TypeScript is pure JavaScript/TypeScript. Het vereist geen compilatiestap en heeft één runtime‑afhankelijkheid (xmldom) die automatisch door npm wordt geïnstalleerd.

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 compileert naar CommonJS en werkt met strikte TypeScript‑instellingen.

Wordt het meegeleverd met TypeScript-typedefinities?

Ja. Alle klassen, methoden, enumeraties en optietypen zijn volledig getypeerd met noImplicitAny en strictNullChecks ingeschakeld.

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

Ja. Per‑formaat optieklassen zoals ObjLoadOptions en GltfSaveOptions laten je assen omkeren, de schaal aanpassen en normalen normaliseren zonder aangepaste parsecode.

Waar kan ik de broncode vinden?

De bibliotheek heeft een MIT‑licentie en wordt gehost op GitHub. Bugrapporten en pull‑requests zijn welkom.

  

Ondersteuning en leermiddelen

 Nederlands