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

Aspose.3D FOSS per TypeScript

Carica, costruisci, trasforma ed esporta scene 3D da Node.js — completamente tipizzata, open source e pronta per la produzione con una singola installazione npm.

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

Documenti GitHub

Libreria TypeScript open source per l'elaborazione di file 3D

Aspose.3D FOSS per TypeScript è una libreria con licenza MIT per lavorare con formati di file 3D nelle applicazioni Node.js. Installala con un unico comando npm install @aspose/3d e inizia subito a leggere, costruire e scrivere scene 3D in TypeScript, senza addon nativi da compilare, senza SDK esterni da installare e senza necessità di un renderer.

La libreria espone un’API di scene‑graph completamente tipizzata costruita attorno a Scene, Node, Entity, Mesh, Camera, Light e Transform, lo stesso modello concettuale usato dagli strumenti 3D professionali. Il supporto dei formati include OBJ (Wavefront, con caricamento dei materiali .mtl), glTF 2.0 e GLB binario (materiali PBR), STL (binario e ASCII, round‑trip completo), COLLADA (DAE), 3MF e FBX. Classi di opzioni per formato come ObjLoadOptions e GltfSaveOptions ti offrono un controllo preciso sull’orientamento del sistema di coordinate, scala, normalizzazione delle normali, output binario vs. JSON e caricamento dei materiali.

Aspose.3D FOSS è destinato a Node.js 18, 20 e 22+ con TypeScript 5.0+ e si compila in CommonJS. La libreria è fornita con impostazioni rigorose del compilatore TypeScript (noImplicitAny, strictNullChecks) così il tuo IDE offre completamento automatico completo e sicurezza a tempo di compilazione. La sua unica dipendenza a runtime, xmldom, viene installata automaticamente.

Supporto ai formati 3D e API tipizzata per il grafo della scena

  • OBJ / MTL: Carica file Wavefront OBJ con le relative definizioni di materiale.
  • glTF 2.0 / GLB: Caricamento di materiali PBR e output binario GLB tramite GltfSaveOptions.
  • STL: Leggi e scrivi STL sia binari che ASCII con verifica round‑trip completa.
  • COLLADA, 3MF, FBX: Supporto aggiuntivo per formati con classi di opzioni per ciascun formato.
  • Tipi TypeScript completi: Ogni classe, metodo e opzione è fortemente tipizzato con noImplicitAny e strictNullChecks.

Dove Aspose.3D FOSS può essere usato

  • Pipeline di asset Node.js: Importa file OBJ, valida e ri‑orienta la geometria, ed esporta come GLB nella CI.
  • Strumenti per giochi: Elabora in batch mesh 3D senza un motore o renderer nativo.
  • Flussi di lavoro per stampa 3D: Leggi, valida e re‑esporta file STL e 3MF.
  • Backend serverless: Esegui endpoint di conversione 3D in Lambda o Cloud Functions.
  • Migrazione dei contenuti: Converti tra famiglie di formati su larga scala da un unico script.

Opzioni per formato e controllo delle coordinate

  • Orientamento del sistema di coordinate: Capovolgi gli assi e regola la scala per formato con le classi di opzione.
  • Normalizzazione delle normali: Normalizza automaticamente le normali dei vertici al caricamento o al salvataggio.
  • Output binario vs. JSON: Seleziona GLB compatto o glTF leggibile tramite GltfSaveOptions.
  • Controllo del caricamento dei materiali: Abilita o disabilita il caricamento di MTL/texture per un’analisi più veloce.
  • Fedeltà round‑trip: I nodi sconosciuti del grafo della scena sono preservati alla lettera al ri‑salvataggio.

Esperienza dello sviluppatore

Aspose.3D FOSS per installazioni TypeScript con un unico comando npm install @aspose/3d. Non ci sono addon nativi da compilare. La libreria è pure TypeScript/JavaScript con una dipendenza auto‑installata (xmldom).

L’API tipizzata fornisce il completamento automatico completo nell’IDE per ogni classe del grafo della scena e per ogni opzione di formato. La libreria è destinata a Node.js 18–22+ e TypeScript 5.0+, funziona identicamente su runner CI Linux e workstation degli sviluppatori, ed è rilasciata con licenza MIT con un tracker di issue aperto su GitHub.

Carica una scena OBJ e esporta come glTF

Installa con npm, poi usa il metodo sincrono scene.open() con ObjLoadOptions per caricare la mesh insieme al suo file materiale MTL. Chiamando scene.save() con un’estensione .gltf si scrive JSON glTF 2.0 standard; il formato viene inferito automaticamente dall’estensione del file.

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

// Esporta come JSON glTF 2.0
scene.save("model.gltf");

Converti STL in GLB binario

Per produrre un GLB binario compatto invece del glTF JSON predefinito, passa GltfSaveOptions con binaryMode = true.

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

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

// Salva come GLB binario compatto
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Domande Frequenti

Cos’è Aspose.3D FOSS per TypeScript?

È una libreria gratuita, con licenza MIT, per TypeScript/Node.js, per caricare, manipolare e salvare scene 3D senza installare alcun addon nativo o SDK esterno.

Quali formati 3D sono supportati?

OBJ (con .mtl), glTF 2.0 e GLB, STL (binario e ASCII), COLLADA (DAE), 3MF e FBX. Ogni formato ha una classe di opzioni tipizzata dedicata.

Richiede componenti aggiuntivi nativi di Node.js?

No. Aspose.3D FOSS per TypeScript è puro JavaScript/TypeScript. Non richiede alcuna fase di compilazione e ha una singola dipendenza runtime (xmldom) installata automaticamente da npm.

Come lo installo?

Esegui npm install @aspose/3d. Non sono richiesti pacchetti di sistema aggiuntivi né addon nativi.

Quali versioni di Node.js e TypeScript sono supportate?

Node.js 18, 20 e 22+. TypeScript 5.0+. La libreria si compila in CommonJS e funziona con impostazioni TypeScript rigorose.

Viene fornito con le definizioni di tipo TypeScript?

Sì. Tutte le classi, i metodi, gli enum e i tipi di opzione sono completamente tipizzati con noImplicitAny e strictNullChecks abilitati.

Posso controllare l’orientamento del sistema di coordinate?

Sì. Classi di opzioni per formato come ObjLoadOptions e GltfSaveOptions ti consentono di invertire gli assi, regolare la scala e normalizzare le normali senza codice di parsing personalizzato.

Dove posso trovare il codice sorgente?

La libreria è rilasciata sotto licenza MIT ed è ospitata su GitHub. Segnalazioni di bug e pull request sono benvenute.

  

Risorse di Supporto e Apprendimento

 Italiano