Aspose.3D FOSS for TypeScript

Referință API pentru @aspose/3d versiune 24.12.0. Instalați prin:

npm install @aspose/3d

Runtime: Node.js 18, 20, 22+ · Limbaj: TypeScript 5.0+ / JavaScript (CommonJS) · Licență: MIT

Grafică de scenă de bază

ImageRenderOptions

Containerul rădăcină pentru o scenă 3D. Apelați scene.open() sau scene.openFromBuffer() pentru a încărca un fișier, și scene.save() pentru a scrie ieșirea. Expune scene.rootNode ca punctul de intrare în ierarhia de noduri.

ImageRenderOptions

Un nod denumit în arborele scenei. Conține un Transform, un opțional entity (mesh, cameră, lumină sau alt SceneObject), și zero sau mai multe noduri copil accesibile prin childNodes.

ImageRenderOptions

Clasă de bază pentru toate obiectele care pot fi atașate la un Node ca entitatea sa principală. Subclasată de Mesh, Camera, Light, și altele.

SceneObject

Bază abstractă pentru obiecte denumite care aparțin unei scene. Oferă name proprietatea și urmărirea apartenenței la scenă, partajate de noduri, entități și obiecte la nivel de resursă.

A3DObject

Clasă de bază rădăcină pentru toate obiectele Aspose.3D. Oferă sistemul de proprietăți (getProperty, setProperty) și name câmp moștenit de fiecare clasă publică.

Geometrie și Mesh

ImageRenderOptions

Reprezintă o rețea de poligoane. Conține un controlPoints matrice de Vector4 vârfuri și definiții de poligoane create prin createPolygon(). Apel triangulate() pentru a converti toate poligoanele în triunghiuri înainte de export.

ImageRenderOptions

Clasă de bază pentru toate tipurile de geometrie. Deține controlPoints și colecția de elemente de vârf (normale, UV-uri, culori) atașate geometriei.

VertexElement

Clasă de bază pentru canalele de atribute per-vârf atașate la un Geometry.Subclasele conțin matrici de date tipizate și mappingMode / referenceMode metadate.

VertexElementNormal

A VertexElement subclasă care stochează normalele suprafeței. Datele sunt stocate intern ca FVector4[] (moștenit de la VertexElementFVector). Necesare pentru majoritatea rendererelor pentru iluminare corectă.

VertexElementUV

A VertexElement subclasă care stochează coordonate de textură 2D. Un singur mesh poate avea seturi UV multiple pentru diferite straturi de textură.

VertexElementVertexColor

A VertexElement subclasă care stochează valori de culoare RGBA pe fiecare vârf.

VertexElementType

Enumerare a tipurilor de canale de atribut pe care un VertexElement poate reprezenta (de exemplu,., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Enumerare care controlează modul în care datele elementului se mapă pe geometrie: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, sau ALL_SAME.

ReferenceMode

Enumerare care controlează modul în care indicii elementelor fac referire la date: DIRECT (one-to-one) sau INDEX_TO_DIRECT (printr-un array de indici).

TextureMapping

Enumerare a semanticii canalelor de textură: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, și altele.

Transformare și Spațial

ImageRenderOptions

Conține poziția locală (translation), rotație (rotation ca Quaternion), și scară (scaling) a unui Node. Modificările de aici afectează nodul și toți copiii săi.

GlobalTransform

Vizualizare numai în citire a transformării în spațiul mondial al unui nod, calculată prin acumularea tuturor strămoșilor Transform valori. Acces prin node.globalTransform.

BoundingBox

O cutie de delimitare aliniată pe axă definită de un minimum și maximum Vector3 colț. Folosită pentru a descrie extinderea spațială a unei rețele sau a unei scene.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Material este clasa de bază abstractă pentru toate tipurile de materiale. Sunt disponibile trei implementări concrete:

  • LambertMaterial — doar difuz cu canale de culoare ambient, difuz și emisiv. Potrivit pentru suprafețe non-speculare.
  • PhongMaterial — extinde LambertMaterial cu proprietăți de culoare speculară și strălucire pentru umbrire Phong.
  • PbrMaterial — material de redare bazat pe fizică cu canale metalic, rugozitate, culoare de bază și hartă normală. Se mapează direct la modelul de material PBR glTF 2.0.

Cameră și iluminare

ImageRenderOptions

O entitate nod de punct de vedere cu tip de proiecție, câmp de vizualizare, distanțe de tăiere apropiată/distantă și proprietăți de raport de aspect.

ImageRenderOptions

O entitate nod sursă de lumină. Tipul este controlat de LightType enumerare.

LightType

Enumerare a tipurilor de lumină suportate: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Enumerarea modurilor de proiecție ale camerei: PERSPECTIVE și ORTHOGRAPHIC.

Utilitare Matematice

ImageRenderOptions

Un vector cu virgulă mobilă din trei componente cu x, y, z câmpuri și metode aritmetice comune (dot, cross, normalize, minus, times). Exportat din @aspose/3d/utilities.

ImageRenderOptions

Un vector cu virgulă mobilă din patru componente cu x, y, z, w câmpuri. Folosit ca tip de intrări în Mesh.controlPoints.

ImageRenderOptions

Un vector cu dublă precizie, format din două componente, cu x și y câmpuri. Folosit pentru coordonatele de textură UV.

FVector3

Un vector compact cu trei componente, de tip float cu precizie simplă, utilizat în matricile de date ale elementelor de vârf pentru normale și tangente.

ImageRenderOptions

O matrice de transformare 4×4. Suportă concatenarea, inversarea, transpunerea și descompunerea în componente de translație, rotație și scară. Exportată din @aspose/3d/utilities.

ImageRenderOptions

Un quaternion unitar pentru reprezentarea rotațiilor fără gimbal lock. Oferă slerp() pentru interpolare lină și conversie către/din unghiuri Euler și Matrix4. Exportat din @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

O colecție denumită, limitată în timp, de AnimationNode piste. Containerul principal pentru datele de animație pe cadre cheie încărcate din fișiere FBX sau COLLADA.

AnimationNode

O pistă de animație denumită care vizează o cale de proprietate specifică pe un obiect din scenă. Conține una sau mai multe AnimationChannel obiecte.

AnimationChannel

Un singur canal de proprietate animată într-un AnimationNode. Conține un KeyframeSequence de perechi timp/valoare.

KeyFrame

Un singur eșantion timp/valoare într-un KeyframeSequence. Conține marcajul de timp (în secunde), valoarea și informațiile de tangentă pentru interpolare.

KeyframeSequence

O listă ordonată de KeyFrame mostre pentru un canal de proprietate, împreună cu Interpolation și Extrapolation setările care guvernează redarea.

ImageRenderOptions

Enumerarea modurilor de interpolare a cadrelor cheie. Membrii cunoscuți includ LINEAR și CONSTANT. Membri suplimentari, cum ar fi BEZIER poate fi disponibil.

ImageRenderOptions

Definește comportamentul în afara intervalului de cadre cheie (înainte de prima cheie și după ultima cheie). Controlat de ExtrapolationType.

StepMode

Enumerare care controlează modul în care interpolarea în trepte (constantă) este aplicată la limite.

WeightedMode

Enumerare pentru gestionarea greutății tangentei Bezier: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, sau BOTH.

ExtrapolationType

Enumerare a comportamentelor în afara intervalului: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, și OSCILLATE.

Intrare/Ieșire format

FileFormat

Descriptor de bază pentru un format de fișier 3D. Fiecare format suportat furnizează un singleton concret prin getInstance().

ImageRenderOptions

Clasă de bază pentru implementări de import specifice formatului. Nu este instanțiată direct; este invocată intern de către scene.open().

ImageRenderOptions

Clasă de bază pentru implementări de export specifice formatului. Nu este instanțiată direct; este invocată intern de către scene.save().

LoadOptions

Clasă de bază pentru obiecte de opțiuni de încărcare specifice formatului. Transmite o instanță a unei subclase către scene.open() sau scene.openFromBuffer().

SaveOptions

Clasă de bază pentru obiecte de opțiuni de salvare specifice formatului. Transmite o instanță a unei subclase către scene.save().

IOService

Interfață de serviciu internă care abstractizează I/O-ul sistemului de fișiere și al buffer-ului pentru importatori și exportatori.

Format OBJ

OBJ acceptă atât importul, cât și exportul. Când se salvează ca OBJ, biblioteca de materiale (.mtl) este scrisă automat alături de .obj fișierul.

ObjImporter

Importator intern care citește fișierele Wavefront OBJ, rezolvă .mtl bibliotecile de materiale și populează un Scene. Invocat automat când ObjLoadOptions este transmis către scene.open().

ObjExporter

Exportator intern care scrie fișiere Wavefront OBJ. Un companion .mtl biblioteca de materiale este scrisă automat. Invocat când scene.save() vizează un .obj cale.

ObjLoadOptions

Opțiuni de încărcare pentru fișiere OBJ. Proprietăți cheie: enableMaterials (boolean, implicit true), flipCoordinateSystem (boolean), normalizeNormal (boolean, implicit true), scale (număr). Vezi Opțiuni de încărcare și salvare a formatului pentru detalii complete.

ObjSaveOptions

Salvează opțiunile pentru exportul OBJ. Transmite către scene.save() pentru a controla comportamentul de ieșire OBJ. Vezi Opțiuni de încărcare și salvare a formatului pentru detalii complete.

ObjFormat

Descriptor de format singleton pentru OBJ. Ambele canImport și canExport sunt true.

Format glTF

GltfImporter

Citește JSON glTF 2.0 (.gltf) și GLB binar (.glb) fișiere. Gestionează referințe de buffer încorporate și externe, materiale PBR, skinuri și clipuri de animație.

GltfExporter

Scrie ieșire glTF 2.0. Când GltfSaveOptions.binaryMode este true, produce un GLB autonom; altfel scrie un JSON .gltf cu un companion .bin buffer.

GltfLoadOptions

Opțiuni de încărcare pentru fișiere glTF/GLB. Controlează rezoluția buffer-ului și comportamentul încărcării texturilor.

GltfSaveOptions

Salvează opțiunile pentru exportul glTF/GLB. Proprietăți notabile: binaryMode (boolean, true → GLB, implicit false), flipTexCoordV (boolean, inversează axa verticală UV, implicit true). Vezi Opțiuni de încărcare și salvare a formatului pentru detalii complete.

GltfFormat

Descriptor de format singleton. Obțineți prin GltfFormat.getInstance() și transmiteți către scene.save() ca al doilea argument.

Format STL

StlImporter

Citește fișiere STL atât ASCII, cât și binare într-un Scene care conține un singur Mesh entitate.

StlExporter

Scrie STL binar. Ieșirea conține mesh-ul triangulat din scenă; poligoanele care nu sunt triunghiuri sunt triangulate automat.

StlLoadOptions

Opțiuni de încărcare pentru STL. Controlează dacă importatorul inversează normalele în timpul importului.

StlSaveOptions

Opțiuni de salvare pentru exportul STL. Proprietatea cheie: binaryMode (boolean, implicit false). Controlează dacă ieșirea este STL ASCII sau binar. Vezi Opțiuni de încărcare și salvare a formatului pentru detalii complete.

StlFormat

Descriptor de format singleton. Obțineți prin StlFormat.getInstance().

3MF Format

ThreeMfImporter

Citește arhivele Open Packaging Convention 3MF și populează un Scene cu obiecte mesh, culori și proprietăți de material.

ThreeMfExporter

Scrie o arhivă 3MF validă din scena curentă. Potrivită pentru fluxurile de lucru de imprimare 3D.

ThreeMfLoadOptions

Opțiuni de încărcare pentru fișiere 3MF.

ThreeMfSaveOptions

Opțiuni de salvare pentru exportul 3MF.

ThreeMfFormat

Descriptor de format singleton. Obține prin ThreeMfFormat.getInstance().

Format FBX

FbxImporter

Citește fișiere FBX binare și ASCII, inclusiv geometrie, materiale, schelete, blend shapes și clipuri de animație.

FbxExporter

Scrie fișiere FBX din scena curentă. Sunt acceptate atât ieșiri FBX binare, cât și ASCII, în funcție de opțiuni.

FbxLoadOptions

Opțiuni de încărcare pentru FBX. Controlează dacă animația, skin-urile și blend shapes sunt importate.

FbxSaveOptions

Opțiuni de salvare pentru export FBX. Proprietatea cheie: embedTextures (boolean, implicit false). Vezi Opțiuni de încărcare și salvare a formatului pentru detalii complete.

FbxFormat

Descriptor de format singleton. Obțineți prin FbxFormat.getInstance().

Format COLLADA

Importul și exportul COLLADA necesită xmldom dependența peer, care este instalată automat cu @aspose/3d.

ColladaImporter

Citește fișiere COLLADA (.dae) fișiere XML utilizând xmldom. Gestionează geometria, materialele, camerele, luminile și animația.

ColladaExporter

Scrie ieșirea XML COLLADA din scena curentă. Potrivit pentru schimbul de date cu instrumente DCC (Blender, Maya etc.).

ColladaFormat

Descriptor de format singleton. Obțineți prin ColladaFormat.getInstance().

Sistem de proprietăți

ImageRenderOptions

O pereche tipizată nume/valoare care poate fi atașată la orice A3DObject. Suportă tipuri de valori scalare și vectoriale.

PropertyCollection

Un container ordonat de Property obiecte. Accesibil pe orice A3DObject prin properties accessor.

CustomObject

Un container de proprietăţi liber-formă care extinde A3DObject. Folosit pentru a stoca metadate arbitrare care nu se potrivește cu o clasă standard.

Informații despre asset

AssetInfo

Poartă metadate la nivel de scenă încărcate din fișierul sursă: autor, numele aplicației, data creării, scara unității și informațiile despre axele de coordonate.

ImageRenderOptions

Opţiuni care controlează modul în care texturile și imaginile sunt rezolvate și codificate la salvarea în formate care încorporează date de imagine (de ex., GLB cu binaryMode: true).

Vezi și

 Română