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

Aspose.3D FOSS for TypeScript

Carica, costruisci, trasforma ed esporta scene 3D da Node.js — completamente tipizzato, open‑source e pronto 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 for 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 grafo della scena completamente tipizzato, costruito 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 è destinata 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 fornisce completamento automatico completo e sicurezza a tempo di compilazione. La sua unica dipendenza di runtime, xmldom, viene installata automaticamente. Per la famiglia di prodotti enterprise, vedi Aspose.3D — Enterprise Product Family.

Supporto al formato 3D e API di grafici scenici digitati

  • ** OBJ / MTL:** Caricare i file Wavefront OB J con le definizioni dei materiali.
  • glTF 2.0 / GLB: Carico del materiale PBR e uscita binaria di GDB tramite GltfSaveOptions.
  • STL: Leggere e scrivere sia STL binario che ASCII con verifica completa di andata e ritorno.
  • COLLADA, 3MF, FBX: Supporto aggiuntivo di formati con classi per opzioni per formato.
  • Tippi di TypeScript completi: Ogni classe, metodo e opzione è fortemente digitato con noImplicitAny e strictNullChecks.

Dove Aspose.3D FOSS può essere utilizzato

  • Node.js asset pipelines: Importa i file OBJ, valida e riorient la geometria ed esporta come GLB in CI.
  • ** Strumenti di gioco:** Mazzi 3D a batch senza motore o renderer nativo.
  • Flussi di lavoro per la stampa 3D: Leggere, convalidare e re-esportare file STL e 3MF.
  • ** Backend senza server:** Eseguire endpoint di conversione 3D in Lambda o Cloud Functions.
  • Migrazione dei contenuti: Convertire tra famiglie di formati su scala da un singolo script.

Opzioni per formato e controllo delle coordinate

  • Orientazione al sistema di coordinate: Sposta gli assi e regola la scala per formato con le classi opzionali.
  • Normalizzazione normale: Normalizza automaticamente le norme dei vertici al carico o alla salvaglia.
  • **Scelta GLB compatto o glTF leggibile tramite GltfSaveOptions.
  • Controllo del caricamento dei materiali: Abilitare o disattivare il carico MTL/tessura per un’analisi più rapida.
  • Fidelità di andata e ritorno: I nodi sceni-grafici sconosciuti vengono conservati letteralmente al ri salvataggio.

Esperienza dello sviluppatore

Aspose.3D FOSS per TypeScript si installa con un singolo comando npm install @aspose/3d. Non ci sono add-on nativi da compilare. La libreria è pura Type Script / JavaScript con una dipendenza autoinstallata (xmldom).

L’API fortemente digitata fornisce un autocompleto IDE completo per ogni classe e opzione di formato della scena-grafico. La libreria è rivolta a Node.js 1822+ e TypeScript 5.0+, funziona identicamente su Linux CI runner e stazioni di lavoro degli sviluppatori, ed è concessa in licenza MIT con un tracker aperto sul GitHub .

Caricare una scena OBJ ed esportare come glTF

Installa con npm, quindi usa scene.open() con ObjLoadOptions per caricare la rete insieme al suo file di materiale MTL. Sia open() che save() sono sincroni no await o è necessario un incatenamento Promise . Chiamando scene.save() tramite un’estensione .gltf si scrive lo standard glTF 2.0 JSON ?? il formato viene dedotto automaticamente dall’ estensiore 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Convertire STL in GLB binario

Per produrre un GLB binario compatto al posto del glTF JSON predefinito, passa GltfSaveOptions con binaryMode = true. Sia open() che save() sono sincroni non è necessario await.

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

Domande Frequenti

Che cos’è Aspose.3D FOSS per TypeScript?

È una libreria TypeScript/Node.js gratuita con licenza MIT per il caricamento, la manipolazione e il salvataggio di 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 digitali dedicate.

Richiede aggiunte Node.js native?

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 instalo?

Esegui npm install @aspose/3d. Non sono richiesti pacchetti di sistema aggiuntivi o componenti aggiuntivi nativi.

Quali versioni di Node.js e TypeScript sono supportate?

Node.js 18, 20 e 22+. TypeScript 5.0+. La libreria compila su CommonJS e funziona con impostazioni di Type Script rigorose.

Contiene definizioni di tipo TypeScript?

Sì. Tutte le classi, i metodi, gli enumi e i tipi di opzione sono completamente digitati con noImplicitAny e strictNullChecks abilitato.

Posso controllare l’orientamento del sistema di coordinate?

Sì. Per-format opzione classi come ObjLoadOptions e GltfSaveOptions permettono di girare gli assi, regolare la scala, e normalizzare le norme senza codice di analisi personalizzato.

Dove posso trovare il codice sorgente?

La libreria è concessa in licenza dal MIT e ospitata su GitHub. I report di bug e le richieste di pull sono benvenute.

  

Risorse di Supporto e Apprendimento

 Italiano