Aspose.3D FOSS for .NET

API-referencia a Aspose.3D 26.1.0 (.NET 10.0+, MIT licenc).

Minden osztály a Aspose.ThreeD gyökér névtérben. A gyökér using direktíva:

using Aspose.ThreeD;

C# elnevezési konvenció: Minden tulajdonság a szabványos C# tulajdonság szintaxist használja. Például használja scene.RootNode helyett scene.getRootNode(), és transform.Translation = ... helyett transform.setTranslation(...).

Vektormező elnevezése: A könyvtár két vektortípus-készlettel rendelkezik. Aspose.ThreeD.Utilities.Vector2/3/4 (használva a Mesh.ControlPoints, geometria, és a legtöbb matematikai művelet) vannak dupla pontosságú val kisbetűs nyilvános mezők (v.x, v.y, v.z, v.w). Az egyszerűbb Aspose.ThreeD.Vector2/3/4 struktúrák (ban Vector.cs) vannak egyszeres pontosságú (float) val nagybetű publikus mezők (v.X, v.Y, v.Z). FVector2/3/4 és Quaternion és Matrix4 használjon nagybetűs mezőhozzáférést. Aspose.ThreeD.Utilities típusok geometriai munkához.

Alap Jelenetgrafikon

MethodsMethods
SceneFelső szintű tároló az összes 3D jelenetadat számára. Tartalmazza a gyökércsomópontot, az eszköz metaadatait és az animációs klipeket. Kitetti Open() és Save() mint az elsődleges I/O belépési pontok.
NodeEgy elnevezett csomópont a jelenet hierarchiájában. Tart egy listát a gyermekcsomópontokról és egy listát a csatolt Entity objektumok, például hálók, kamerák és fények. Tartalmaz egy helyi Transform.
EntityAbsztrakt bázisosztály minden olyan objektum számára, amely csatolható egy Node. Név és azonosító biztosítja, de saját geometriát nem tartalmaz.
SceneObjectAlaposztály, amelyet megoszt Node és Entity. Biztosítja a tulajdonsággyűjtemény interfészt, amelyet a felhasználó által definiált metaadatokhoz használnak.
A3DObjectGyökér alaposztály minden Aspose.3D kezelt objektumhoz. Kitetti a Name tulajdonság és a Properties gyűjtemény.
INamedObjectInterfész, amely garantál egy Name tulajdonság. Megvalósítja Node, Entity, és több formátum-specifikus leíró típus.

Geometria és háló

MethodsMethods
MeshPoligon háló entitás. Tárolja a vezérlőpontokat (csúcspozíciókat mint Vector4), poligon felületlistákat (vezérlőpont-indexek listái), valamint csúcs elem rétegeket (normálok, UV-k, csúcs színek).
GeometryAbsztrakt alap a hálóhoz hasonló geometriai típusokhoz. Meghatározza a vezérlőpont tömböt és a gyűjteményt a VertexElement rétegeket. Mesh örököl Geometry.
VertexElementAbsztrakt alap egy geometriai adatréteghez (normálok, UV-k, színek, stb.). Tartalmaz MappingMode, ReferenceMode, és egy adatlistát.
VertexElementNormalEgy normálvektort tárol csúcsonként vagy sokszög-sarokként, a leképezési módtól függően.
VertexElementUVTextúra-koordináta párokat tárol (Vector2) csúcsonként vagy sokszög-sarokként.
VertexElementVertexColorPer-vertex vagy per-corner RGBA színadatokat tárolja mint Vector4.

Beépített primitívek

MethodsMethods
BoxParaméteres, tengelyekhez igazított doboz, amelynek szélessége, magassága és mélysége konfigurálható. Csatolható egy Node közvetlenül vagy átalakítható Mesh keresztül ToMesh().
SphereParaméteres gömb, amelynek sugara konfigurálható. Támogatja ToMesh() konverzió.
CylinderParaméteres henger, amelynek a felső sugara, az alsó sugara és a magassága konfigurálható. Támogatja ToMesh() konverzió.

Transzformáció és tér

MethodsMethods
TransformHelyi transzformáció csatolva egy Node. Biztosít Translation (FVector3), Rotation (Quaternion), Scale (FVector3), és Matrix (Matrix4) tulajdonságok.
GlobalTransformCsak olvasható nézet egy csomópont világ-térbeli transzformációs mátrixáról, miután az összes ős transzformációt összeállították. Elérhető a node.GlobalTransform. Kitet egyetlen Matrix tulajdonság.
AssetInfoMetaadat blokk csatolva egy Scene. Örököl A3DObject biztosítva Name és Properties. Ebben a kiadásban nincsenek további tulajdonságok definiálva.

Anyagok és árnyalás

MethodsMethods
MaterialAbsztrakt alaposztály minden anyagtípushoz. Nevet és egy tulajdonsággyűjteményt biztosít.
LambertMaterialKlasszikus, csak diffúz anyag a Ambient, Diffuse, Emissive, Reflective, Transparency, és Texture tulajdonságok. Névterület: Aspose.ThreeD.Shading.
PhongMaterialKiterjeszti a Lambert-et a Specular, Shininess, és SpecularPower tulajdonságok. Névtere: Aspose.ThreeD.Shading.
PbrMaterialPhysically Based Rendering anyag a következővel BaseColor, Metallic, Roughness, Occlusion, és a textúrahely tulajdonságok. Névtér: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraKamera entitás. Örökli a Frustum. Csatolva egy Node a nézetpont transzformációk meghatározásához. Formátum-specifikus tulajdonságok nincsenek kitéve ebben a kiadásban.

Matematikai segédeszközök

MethodsMethods
Vector2Dupla pontosságú 2-component vector (lowercase fields: x, y). Névtér: Aspose.ThreeD.Utilities. UV textúra koordinátákhoz használják.
Vector3Dupla pontosságú 3-component vector (lowercase fields: x, y, z). Névtér: Aspose.ThreeD.Utilities. Általános célú térbeli vektor a geometriához.
Vector4Dupla pontosságú 4-component vector (lowercase fields: x, y, z, w). Névtér: Aspose.ThreeD.Utilities. Használva Mesh.ControlPoints és normál adat.
FVector3Egyszeres pontosságú 3 komponensű lebegőpontos vektor (nagybetűs mezők: X, Y, Z). Használja Transform.Translation és Transform.Scale.
FVector4Egyszeres pontosságú 4 komponensű lebegőpontos vektor (nagybetűs mezők: X, Y, Z, W).
QuaternionEgységkvaternion a forgatások ábrázolásához (W, X, Y, Z). Használja Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxTengelyekhez igazított határoló doboz, amelyet meghatároz Minimum és Maximum FVector3 sarkok.

Methods

MethodsMethods
AnimationClipElnevezett tároló egy animációs tartományhoz. A Scene több klipet is tartalmazhat. Deklaráció váz — a kulcskeret adatok és a lejátszás még nincs megvalósítva.

Formátum I/O

MethodsMethods
Scene.Open(path)Megnyit egy fájlt, a kiterjesztés alapján felismeri a formátumot, és feltölti a jelenetet.
Scene.Open(path, options)Megnyit egy fájlt formátum‑specifikus LoadOptions.
Scene.Open(stream)Megnyit egy adatfolyamból, automatikusan felismerve a formátumot a tartalom alapján.
Scene.Open(stream, options)Megnyit egy adatfolyamból formátum-specifikus. LoadOptions.
Scene.Save(path)Mentse a jelenetet egy fájlba; a formátum a kiterjesztésből következtethető.
Scene.Save(path, options)Ment formátum-specifikus. SaveOptions.
Scene.Save(stream, options)Ment egy adatfolyamra formátum-specifikus. SaveOptions.
FileFormatA támogatott fájlformátumok nyilvántartása. Használja FileFormat.Formats (egy IList<FileFormat>) az összes támogatott formátum felsorolásához, vagy FileFormat.Detect(fileName) a formátum fájlnév alapján történő felismeréséhez. A megnevezett állandók (ObjFormat, GltfFormat, FbxFormat, stb.) vannak internal és nem érhető el a felhasználói kódból.
IOServiceBelső I/O absztrakció. Biztosítja DetectFormat() a folyam-alapú formátumfelismeréshez.
LoadOptionsAlaposztály a formátum-specifikus betöltési beállításokhoz.
SaveOptionsAlaposztály a formátum-specifikus mentési beállításokhoz.

OBJ formátum

MethodsMethods
ObjLoadOptionsBetöltési beállítások a Wavefront OBJ fájlokhoz.
ObjSaveOptionsMentési beállítások a Wavefront OBJ kimenethez.

STL formátum

MethodsMethods
StlLoadOptionsBetöltési beállítások az STL fájlokhoz.
StlSaveOptionsMentési beállítások az STL kimenethez.

glTF formátum

MethodsMethods
GltfLoadOptionsBetöltési beállítások a glTF 2.0 és GLB fájlokhoz.
GltfSaveOptionsMentési beállítások a glTF 2.0 és GLB kimenethez. Formátum-specifikus tulajdonságok nincsenek elérhetők ebben a kiadásban; használja .glb kiterjesztést a bináris kimenethez.

FBX formátum

MethodsMethods
FbxLoadOptionsBetöltési beállítások FBX fájlokhoz.
FbxSaveOptionsMentési beállítások FBX kimenethez. Az FBX exportálás mindig bináris kimenetet eredményez; az ASCII FBX exportálás ebben a verzióban nem aktív.

3MF Format

MethodsMethods
TmfLoadOptionsBetöltési beállítások 3MF fájlokhoz.
TmfSaveOptionsMentési beállítások a 3MF kimenethez.

Methods

MethodsMethods
FileContentTypeTartalomtípus leíró: ASCII, Binary. Elérhető tulajdonságként a FileFormat.
AxisAzonosít egy koordináta tengelyt: XAxis, YAxis, ZAxis.
CoordinateSystemMeghatározza a kézességi konvenciót: RightHand vagy LeftHand.

Tulajdonságok rendszere

MethodsMethods
PropertyEgyetlen elnevezett típusú tulajdonság egy A3DObject.
PropertyCollectionIterálható gyűjtemény Property objektumok, amelyek egyhez vannak csatolva A3DObject.

Lásd még

 Magyar