Guia del desenvolupador

Aspose.3D FOSS per a TypeScript és una biblioteca de codi obert, amb llicència MIT que permet als desenvolupadors de Node.js carregar, construir, transformar i exportar escenes 3D amb seguretat de tipus TypeScript completa. Ja sigui que estigui construint un pipeline d’actius, un servei de conversió de format, una eina de validació de geometria o un guió d’autoria de contingut 3D, aquesta biblioteca proporciona una API neta i coherent recolzada per un model de gràfic d’escena que reflecteix els conceptes 3D estàndard de la indústria.

Aquesta guia de desenvolupadors cobreix tot el que necessita per anar més enllà de la instal·lació ràpida i escriure codi de processament 3D de qualitat de producció.

Què trobaràs en aquesta secció

Característiques i funcionalitats

El Funcionalitats la pàgina és la referència principal per treballar amb Aspose.3D FOSS per a TypeScript. Cobreix:

  • Suport de format: OBJ (amb materials .mtl), glTF 2.0 / GLB binari, STL (binari i ASCII), COLLADA (DAE), 3MF i FBX, amb classes d’opcions de càrrega i desament per format que inclouen ObjLoadOptions i GltfSaveOptions.
  • Graf de escena: Com Scene, Node, Entity, Transform, i SceneObject compón en una jerarquia completa d’escena, incloent patrons de recorregut de nodes fills.
  • Geometria i API de malla: Treballant amb Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, i ReferenceMode per al processament de geometria.
  • Sistema de material: Aplicant LambertMaterial, PhongMaterial, i PbrMaterial (PBR per a glTF) als nodes de l’escena, i llegint les propietats del material carregades des de fitxers .mtl.
  • Utilitats matemàtiques: Usant Vector3, Vector4, Matrix4, Quaternion, i BoundingBox per a transformacions, consultes de caixes delimitadores i càlculs geomètrics.
  • Animació: Construint i llegint AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, i Extrapolation dades.
  • Suport de flux i memòria intermèdia: Carregant escenes 3D des de la memòria Buffer objectes via scene.openFromBuffer() per a casos d’ús sense servidor i de transmissió.
  • Exemples d’ús complets: Scripts TypeScript de principi a fi per a carregar OBJ, exportar GLB, fer round‑tripping STL i recórrer grafs d’escena.
  • Consells, problemes comuns i FAQ: Guia pràctica per evitar errors comuns en l’ús de producció.
  • Resum de la referència de l’API: Llista de referència ràpida de totes les classes clau i els seus mètodes principals.

Conceptes clau

Graf de escena: Tot el contingut 3D a Aspose.3D FOSS es representa com un arbre de Node objectes arrelats a scene.rootNode. Cada node pot portar un Entity (com ara un Mesh, Camera, o Light) i un Transform que el posiciona a la jerarquia.

API independent del format: Obriu qualsevol format compatible a través de scene.open() o scene.openFromBuffer() i deseu a qualsevol format compatible a través de scene.save(). Els mateixos objectes del gràfic d’escena s’utilitzen independentment del format d’origen o de destinació.

Tipatge fort de TypeScript: La biblioteca ve amb configuracions estrictes del compilador (noImplicitAny, strictNullChecks) i definicions de tipus completes. Cada classe, mètode i propietat d’opció està completament tipada, proporcionant autocompleció a l’IDE i seguretat en temps de compilació al llarg del teu codi de processament 3D.

Una única dependència: L’única dependència d’execució és xmldom, que s’instal·la automàticament amb npm. No hi ha cap complement natiu per compilar i cap paquet del sistema per instal·lar.

Començar

Si encara no has instal·lat la biblioteca, consulta el Començar secció i la Instal·lació guia abans de llegir més.

Temes disponibles

 Català