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 één 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‑materialenladen), 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 je precieze controle over de oriëntatie van het coördinatensysteem, schaal, normalisatie van normalen, binaire versus JSON‑output en het laden van materialen.

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 je IDE volledige autocomplete en compile‑tijd veiligheid biedt. De enige runtime‑afhankelijkheid, xmldom, wordt automatisch geïnstalleerd.

3D‑formaatondersteuning en getypeerde scene‑graph‑API

  • OBJ / MTL: Laad Wavefront OBJ‑bestanden met bijbehorende materiaaldefinities.
  • glTF 2.0 / GLB: PBR‑materialen laden en binaire GLB‑output via GltfSaveOptions.
  • STL: Lees en schrijf zowel binaire als ASCII STL met volledige roundtrip‑verificatie.
  • COLLADA, 3MF, FBX: Extra formaatondersteuning 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-pijplijnen: Importeer OBJ-bestanden, valideer en heroriënteer geometrie, en exporteer als GLB in CI.
  • Game-tooling: Batch-verwerk 3D-meshes zonder een native engine of renderer.
  • 3D-print-workflows: Lees, valideer en exporteer STL- en 3MF-bestanden opnieuw.
  • Serverless backends: Voer 3D-conversie‑eindpunten uit in Lambda of Cloud Functions.
  • Contentmigratie: Converteer op schaal tussen formaatfamilies vanuit één script.

Per‑formaatopties en coördinatenbeheer

  • Coördinatensysteemoriëntatie: Asen omkeren en schaal per formaat aanpassen met optieklassen.
  • Normale normalisatie: Vertexnormals automatisch normaliseren bij laden of opslaan.
  • Binaire vs. JSON-uitvoer: Kies compact GLB of leesbare glTF via GltfSaveOptions.
  • Materiaallaadcontrole: Schakel MTL/textuur laden in of uit voor snellere parsing.
  • Round-trip fidelity: Onbekende scene-graph knooppunten worden letterlijk behouden bij opnieuw opslaan.

Ontwikkelaarservaring

Aspose.3D FOSS voor TypeScript‑installaties met één enkele npm install @aspose/3d opdracht. 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 formaatoptie. De bibliotheek richt zich op Node.js 18–22+ en TypeScript 5.0+, draait identiek op Linux CI‑runners en ontwikkelaars‑werkstations, en is gelicentieerd onder de MIT‑licentie met een open issue‑tracker op GitHub.

Laad een OBJ‑scène en exporteer als glTF

Installeer met npm, gebruik vervolgens de synchrone scene.open()‑methode met ObjLoadOptions om het mesh te laden samen met het bijbehorende MTL‑materiaalbestand. 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());

// Exporteren als glTF 2.0 JSON
scene.save("model.gltf");

Converteer STL naar binaire GLB

Om een compact binair GLB te produceren in plaats van de standaard JSON glTF, geef GltfSaveOptions door met binaryMode = true.

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

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

// Sla op als compact binair GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Frequently Asked Questions

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 systeem‑pakketten 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 geleverd met TypeScript-typedefinities?

Ja. Alle klassen, methoden, enums 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, schaal aanpassen en normalen normaliseren zonder aangepaste parsecode.

Waar kan ik de broncode vinden?

De bibliotheek is gelicentieerd onder de MIT‑licentie en gehost op GitHub. Bugrapporten en pull‑requests zijn welkom.

  

Ondersteuning en leermiddelen

 Nederlands