Guida per sviluppatori

Aspose.3D FOSS per TypeScript è una libreria open-source, con licenza MIT, che consente agli sviluppatori Node.js di caricare, costruire, trasformare ed esportare scene 3D con piena sicurezza dei tipi TypeScript. Che tu stia creando una pipeline di asset, un servizio di conversione di formati, uno strumento di validazione della geometria o uno script di authoring di contenuti 3D, questa libreria offre un’API pulita e coerente supportata da un modello di scene-graph che rispecchia i concetti 3D standard del settore.

Questa Guida per Sviluppatori copre tutto ciò di cui hai bisogno per andare oltre l’installazione rapida e scrivere codice di elaborazione 3D di qualità produzione.

Cosa Troverai in Questa Sezione

Caratteristiche e Funzionalità

Il Funzionalità la pagina è il riferimento principale per lavorare con Aspose.3D FOSS per TypeScript. Copre:

  • Supporto dei formati: OBJ (con materiali .mtl), glTF 2.0 / GLB binario, STL (binario e ASCII), COLLADA (DAE), 3MF e FBX, con classi di opzioni di caricamento e salvataggio per formato includendo ObjLoadOptions e GltfSaveOptions.
  • Grafico della scena: Come Scene, Node, Entity, Transform, e SceneObject si compongono in una gerarchia completa della scena, includendo schemi di attraversamento dei nodi figli.
  • API di geometria e mesh: Lavorare con Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ReferenceMode per l’elaborazione della geometria.
  • Sistema dei materiali: Applicare LambertMaterial, PhongMaterial, e PbrMaterial (PBR per glTF) ai nodi della scena, e lettura delle proprietà dei materiali caricati dai file .mtl.
  • Utility matematiche: Utilizzo Vector3, Vector4, Matrix4, Quaternion, e BoundingBox per trasformazioni, query di bounding-box e calcoli geometrici.
  • Animazione: Costruzione e lettura AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, e Extrapolation dati.
  • Supporto per stream e buffer: Caricamento di scene 3D dalla memoria Buffer oggetti tramite scene.openFromBuffer() per casi d’uso serverless e di streaming.
  • Esempi completi di utilizzo: Script TypeScript end-to-end per caricare OBJ, esportare GLB, round-tripping STL e attraversare grafi di scena.
  • Suggerimenti, problemi comuni e FAQ: Indicazioni pratiche per evitare le insidie comuni in ambienti di produzione.
  • Riepilogo della reference API: Elenco di riferimento rapido di tutte le classi chiave e dei loro metodi principali.

Concetti Chiave

Grafo della scena: Tutto il contenuto 3D in Aspose.3D FOSS è rappresentato come un albero di Node oggetti radicati a scene.rootNode. Ogni nodo può contenere un Entity (ad esempio un Mesh, Camera, o Light) Transform che lo posiziona nella gerarchia.

API indipendente dal formato: È possibile aprire qualsiasi formato supportato tramite scene.open() o scene.openFromBuffer() e salvare in qualsiasi formato supportato tramite scene.save(). Gli stessi oggetti del grafo della scena vengono utilizzati indipendentemente dal formato di origine o di destinazione.

Tipizzazione TypeScript forte: La libreria è fornita con impostazioni del compilatore rigorose (noImplicitAny, strictNullChecks).

Dipendenza singola: L’unica dipendenza a runtime è xmldom, che viene installata automaticamente da npm. Non ci sono addon nativi da compilare e nessun pacchetto di sistema da installare.

Iniziare

Se non hai ancora installato la libreria, consulta il Iniziare sezione e il Installazione guida prima di leggere ulteriormente.

Argomenti disponibili

 Italiano