Aspose.3D FOSS for .NET

Referință API pentru Aspose.3D 26.1.0 (.NET 10.0+, licență MIT).

Toate clasele se află în Aspose.ThreeD spațiul de nume rădăcină. Directiva using rădăcină este:

using Aspose.ThreeD;

Convenția de denumire C#: Toate proprietățile utilizează sintaxa standard a proprietăților C#. De exemplu, folosiți scene.RootNode în loc de scene.getRootNode(), și transform.Translation = ... în loc de transform.setTranslation(...).

Capitalizarea câmpului vector: Biblioteca are două seturi de tipuri de vectori. Aspose.ThreeD.Utilities.Vector2/3/4 (folosit de Mesh.ControlPoints, geometrie și majoritatea operațiilor matematice) sunt precizie dublă cu litere mici câmpuri publice (v.x, v.y, v.z, v.w). Mai simplu Aspose.ThreeD.Vector2/3/4 structuri (în Vector.cs) sunt precizie simplă (float) cu majuscule câmpuri publice (v.X, v.Y, v.Z). FVector2/3/4 și Quaternion și Matrix4 utilizați acces la câmpuri în majuscule. Utilizați Aspose.ThreeD.Utilities tipuri pentru lucrul cu geometria.


Grafic de scenă de bază

MethodsMethods
SceneContainer de nivel superior pentru toate datele scenei 3D. Conține nodul rădăcină, metadatele activelor și clipurile de animație. Expune Open() și Save() ca punctele principale de intrare I/O.
NodeUn nod denumit în ierarhia scenei. Deține o listă de noduri copil și o listă de atașate Entity obiecte precum plase, camere și lumini. Poartă o locală Transform.
EntityClasă de bază abstractă pentru toate obiectele care pot fi atașate la un Node. Furnizează nume și identitate, dar nu are geometrie proprie.
SceneObjectClasă de bază partajată de Node și Entity. Furnizează interfața de colecție a proprietăților utilizată pentru metadate definite de utilizator.
A3DObjectClasă de bază rădăcină pentru toate obiectele gestionate Aspose.3D. Expune Name proprietatea și Properties colecție.
INamedObjectInterfață care garantează un Name proprietate. Implementată de Node, Entity, și mai multe tipuri de descriptor specifice formatului.

Geometrie și Mesh

MethodsMethods
MeshEntitate de plasă poligonală. Stochează punctele de control (pozițiile vârfurilor ca Vector4), liste de fețe poligonale (liste de indici ai punctelor de control) și straturi de elemente de vârf (normale, UV-uri, culori de vârf).
GeometryBază abstractă pentru tipuri de geometrie asemănătoare plaselor. Definește matricea de puncte de control și colecția de VertexElement straturi. Mesh moștenește de la Geometry.
VertexElementBază abstractă pentru un strat de date atașat geometriei (normale, UV-uri, culori etc.). Poartă MappingMode, ReferenceMode, și o listă de date.
VertexElementNormalStochează un vector normal per vârf sau per colț de poligon, în funcție de modul de mapare.
VertexElementUVStochează perechi de coordonate de textură (Vector2) per vârf sau per colț de poligon.
VertexElementVertexColorStochează date de culoare RGBA per-vertex sau per-corner ca Vector4.

Primitive încorporate

MethodsMethods
BoxCutie parametrică aliniată pe axă cu lățime, înălțime și adâncime configurabile. Poate fi atașată la un Node direct sau convertit în Mesh prin ToMesh().
SphereSferă parametrică cu rază configurabilă. Suportă ToMesh() conversia.
CylinderCilindru parametric cu rază superioară, rază inferioară și înălțime configurabile. Suportă ToMesh() conversia.

Transformare și Spatial

MethodsMethods
TransformTransformare locală atașată la un Node. Oferă Translation (FVector3), Rotation (Quaternion), Scale (FVector3), and Matrix (Matrix4) properties.
GlobalTransformVizualizare numai în citire a matricei de transformare în spațiul mondial al unui nod, după compunerea tuturor transformărilor strămoșe. Accesată prin node.GlobalTransform. Expune o singură Matrix proprietate.
AssetInfoBloc de metadate atașat unui Scene. Moștenește de la A3DObject furnizând Name și Properties. Nu sunt definite proprietăți suplimentare în această ediție.

Materiale și umbrire

MethodsMethods
MaterialClasă de bază abstractă pentru toate tipurile de material. Oferă un nume și o colecție de proprietăți.
LambertMaterialMaterial clasic doar difuz cu Ambient, Diffuse, Emissive, Reflective, Transparency, și Texture proprietăți. Spațiu de nume: Aspose.ThreeD.Shading.
PhongMaterialExtinde Lambert cu Specular, Shininess, și SpecularPower proprietăți. Spațiu de nume: Aspose.ThreeD.Shading.
PbrMaterialMaterial de redare bazată pe fizică cu BaseColor, Metallic, Roughness, Occlusion, și proprietăți de slot de textură. Spațiu de nume: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraEntitate de cameră. Moștenește de la Frustum. Atașat la un Node pentru a defini transformările punctului de vedere. Nu sunt expuse proprietăți specifice formatului în această ediție.

Utilitare matematice

MethodsMethods
Vector2Precizie dublă 2-component vector (lowercase fields: x, y). Spațiu de nume: Aspose.ThreeD.Utilities. Folosit pentru coordonatele de textură UV.
Vector3Precizie dublă 3-component vector (lowercase fields: x, y, z). Spațiu de nume: Aspose.ThreeD.Utilities. Vector spațial de uz general pentru geometrie.
Vector4Precizie dublă 4-component vector (lowercase fields: x, y, z, w). Spațiu de nume: Aspose.ThreeD.Utilities. Folosit pentru Mesh.ControlPoints și date normale.
FVector3Vector float cu 3 componente, precizie simplă (câmpuri majuscule: X, Y, Z). Utilizat de Transform.Translation și Transform.Scale.
FVector4Vector float cu 4 componente, precizie simplă (câmpuri majuscule: X, Y, Z, W).
QuaternionCuaternion unitar pentru reprezentarea rotațiilor (W, X, Y, Z). Utilizat de Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxCutie de delimitare aliniată pe axe definită de Minimum și Maximum FVector3 colțuri.

Methods

MethodsMethods
AnimationClipContainer denumit pentru un interval de animație. Un Scene poate conține mai multe clipuri. Stub de declarație — datele de keyframe și redarea nu sunt încă implementate.

Intrare/Ieșire format

MethodsMethods
Scene.Open(path)Deschide un fișier, detectează formatul din extensie și populează scena.
Scene.Open(path, options)Deschide un fișier cu specificul formatului LoadOptions.
Scene.Open(stream)Deschide dintr-un flux, detectând automat formatul din conținut.
Scene.Open(stream, options)Deschide dintr-un flux cu specificul formatului LoadOptions.
Scene.Save(path)Salvează scena într-un fișier; formatul este dedus din extensie.
Scene.Save(path, options)Salvează cu specificul formatului SaveOptions.
Scene.Save(stream, options)Salvează într-un flux cu specificul formatului SaveOptions.
FileFormatRegistru al formatelor de fișiere suportate. Utilizați FileFormat.Formats (un IList<FileFormat>) pentru a enumera toate formatele acceptate, sau FileFormat.Detect(fileName) pentru a detecta un format după numele fișierului. Constantele numite (ObjFormat, GltfFormat, FbxFormat, etc.) sunt internal și nu sunt accesibile din codul utilizatorului.
IOServiceAbstracție internă I/O. Oferă DetectFormat() pentru detectarea formatului bazată pe flux.
LoadOptionsClasă de bază pentru opțiuni de încărcare specifice formatului.
SaveOptionsClasă de bază pentru opțiuni de salvare specifice formatului.

Format OBJ

MethodsMethods
ObjLoadOptionsOpțiuni de încărcare pentru fișiere Wavefront OBJ.
ObjSaveOptionsOpțiuni de salvare pentru ieșirea Wavefront OBJ.

Format STL

MethodsMethods
StlLoadOptionsÎncărcați opțiunile pentru fișiere STL.
StlSaveOptionsSalvați opțiunile pentru ieșirea STL.

Format glTF

MethodsMethods
GltfLoadOptionsÎncărcați opțiunile pentru fișiere glTF 2.0 și GLB.
GltfSaveOptionsSalvați opțiunile pentru ieșirea glTF 2.0 și GLB. Nu sunt expuse proprietăți specifice formatului în această ediție; utilizați .glb extensia pentru ieșire binară.

Format FBX

MethodsMethods
FbxLoadOptionsÎncărcați opțiunile pentru fișiere FBX.
FbxSaveOptionsSalvați opțiunile pentru ieșirea FBX. Exportul FBX produce întotdeauna ieșire binară; exportul FBX ASCII nu este activ în această versiune.

3MF Format

MethodsMethods
TmfLoadOptionsÎncărcați opțiunile pentru fișiere 3MF.
TmfSaveOptionsSalvați opțiunile pentru ieșirea 3MF.

Methods

MethodsMethods
FileContentTypeDescriptor tip de conținut: ASCII, Binary. Disponibil ca proprietate pe FileFormat.
AxisIdentifică o axă de coordonate: XAxis, YAxis, ZAxis.
CoordinateSystemSpecifică convenția de orientare: RightHand sau LeftHand.

Sistem de proprietăţi

MethodsMethods
PropertyO singură proprietate tipizată, denumită, pe un A3DObject.
PropertyCollectionColecție iterabilă de Property obiecte atașate la un A3DObject.

Vezi și

 Română