Referenčná dokumentácia API pre Aspose.3D 26.1.0 (.NET 10.0+, licencia MIT).
Všetky triedy sa nachádzajú v Aspose.ThreeD koreňovom mennom priestore. Korená using direktíva je:
Konvencia pomenovania v C#: Všetky vlastnosti používajú štandardnú syntax vlastností v C#. Napríklad použite scene.RootNode namiesto scene.getRootNode(), a transform.Translation = ... namiesto transform.setTranslation(...).
Veľkosť písmen vo vektorových poliach: Knižnica obsahuje dva súbory vektorových typov. Aspose.ThreeD.Utilities.Vector2/3/4 (používané v Mesh.ControlPoints, geometrii a väčšine matematických operácií) sú s dvojitou presnosťou s malé písmená verejné polia (v.x, v.y, v.z, v.w). Jednoduchší Aspose.ThreeD.Vector2/3/4 štruktúry (v Vector.cs) sú jednopresnostný (float) s veľkými písmenami verejné polia (v.X, v.Y, v.Z). FVector2/3/4 a Quaternion a Matrix4 používajte prístup k poľom veľkými písmenami. Použite Aspose.ThreeD.Utilities typy pre prácu s geometriou.
Základný graf scény
| Methods | Methods |
|---|
Scene | Kontajner najvyššej úrovne pre všetky 3D dáta scény. Obsahuje koreňový uzol, metadáta aktív a animačné klipy. Zverejňuje Open() a Save() ako hlavné vstupno‑výstupné vstupné body. |
Node | Pomenovaný uzol v hierarchii scény. Obsahuje zoznam poduzlov a zoznam pripojených Entity objektov ako siete, kamery a svetlá. Nesie lokálny Transform. |
Entity | Abstraktná základná trieda pre všetky objekty, ktoré môžu byť pripojené k Node. Poskytuje názov a identitu, ale nemá vlastnú geometriu. |
SceneObject | Základná trieda zdieľaná s Node a Entity. Poskytuje rozhranie kolekcie vlastností používané pre používateľom definované metadáta. |
A3DObject | Koreňová základná trieda pre všetky Aspose.3D spravované objekty. Zverejňuje Name vlastnosť a Properties kolekcia. |
INamedObject | Rozhranie, ktoré zaručuje Name vlastnosť. Implementované Node, Entity, a niekoľko formátovo-špecifických typov opisovačov. |
Geometria a sieť
| Methods | Methods |
|---|
Mesh | Entita polygonovej siete. Ukladá kontrolné body (pozície vrcholov ako Vector4), zoznamy polygonových plôch (zoznamy indexov kontrolných bodov) a vrstvy prvkov vrcholov (normály, UV, farby vrcholov). |
Geometry | Abstraktný základ pre typy geometrie podobnej sieti. Definuje pole kontrolných bodov a kolekciu VertexElement vrstiev. Mesh dedí od Geometry. |
VertexElement | Abstraktný základ pre dátovú vrstvu pripojenú k geometrii (normály, UV, farby, atď.). Nesie MappingMode, ReferenceMode, a zoznam dát. |
VertexElementNormal | Ukladá jeden vektor normály na vrchol alebo na roh polygonu, v závislosti od režimu mapovania. |
VertexElementUV | Ukladá páry textúrových súradníc (Vector2) na vrchol alebo na roh polygonu. |
VertexElementVertexColor | Ukladá RGBA farebné dáta na vrchol alebo na roh ako Vector4. |
Vstavané primitívy
| Methods | Methods |
|---|
Box | Parametrický osovo zarovnaný kváder s konfigurovateľnou šírkou, výškou a hĺbkou. Môže byť pripojený k Node priamo alebo konvertovaný na Mesh prostredníctvom ToMesh(). |
Sphere | Parametrická guľa s konfigurovateľným polomerom. Podporuje ToMesh() konverzia. |
Cylinder | Parametrický valec s konfigurovateľným horným polomerom, spodným polomerom a výškou. Podporuje ToMesh() konverzia. |
Transformácia a priestor
| Methods | Methods |
|---|
Transform | Lokálna transformácia pripojená k Node. Poskytuje Translation (FVector3), Rotation (Quaternion), Scale (FVector3), a Matrix (Matrix4) vlastnosti. |
GlobalTransform | Zobrazenie len na čítanie matice transformácie sveta uzla po zložením všetkých transformácií predkov. Prístupné cez node.GlobalTransform. Zverejňuje jediný Matrix vlastnosť. |
AssetInfo | Blok metadát pripojený k Scene. Dedičnosť od A3DObject poskytuje Name a Properties. V tejto edícii nie sú definované žiadne ďalšie vlastnosti. |
Materiály a tieňovanie
| Methods | Methods |
|---|
Material | Abstraktná základná trieda pre všetky typy materiálov. Poskytuje názov a kolekciu vlastností. |
LambertMaterial | Klasický materiál len s difúznym odrazom Ambient, Diffuse, Emissive, Reflective, Transparency, a Texture vlastnosti. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | Rozširuje Lambert o Specular, Shininess, a SpecularPower vlastnosti. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | Materiál Physically Based Rendering s BaseColor, Metallic, Roughness, Occlusion, a vlastnosti textúrových slotov. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entita kamery. Dedičí od Frustum. Pripojená k Node na definovanie transformácií pohľadu. V tejto edícii nie sú vystavené žiadne špecifické vlastnosti formátu. |
Matematické nástroje
| Methods | Methods |
|---|
Vector2 | Dvojitá presnosť 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Používa sa pre UV textúrové súradnice. |
Vector3 | Dvojitá presnosť 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Všeobecný priestorový vektor pre geometriu. |
Vector4 | Dvojitá presnosť 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. Používa sa na Mesh.ControlPoints a normálne dáta. |
FVector3 | Jednoprecízny 3-komponentový float vektor (poli s veľkými písmenami: X, Y, Z). Používa sa v Transform.Translation a Transform.Scale. |
FVector4 | Jednopresnostný 4‑komponentový float vektor (veľké písmená polí: X, Y, Z, W). |
Quaternion | Jednotkový kvaternion pre reprezentáciu rotácií (W, X, Y, Z). Používa sa v Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Osa‑zarovnaný ohraničujúci box definovaný Minimum a Maximum FVector3 rohy. |
Methods
| Methods | Methods |
|---|
AnimationClip | Pomenovaný kontajner pre rozsah animácie. A Scene môže obsahovať viacero klipov. Deklarácia stub — dáta kľúčových snímok a prehrávanie ešte nie sú implementované. |
Formát V/V
| Methods | Methods |
|---|
Scene.Open(path) | Otvorí súbor, zistí formát podľa prípony a naplní scénu. |
Scene.Open(path, options) | Otvorí súbor s formátovo‑špecifickým LoadOptions. |
Scene.Open(stream) | Otvorí zo streamu, automaticky detekujúc formát z obsahu. |
Scene.Open(stream, options) | Otvorí zo streamu s formátovo‑špecifickým LoadOptions. |
Scene.Save(path) | Uloží scénu do súboru; formát je odvodený od prípony. |
Scene.Save(path, options) | Uloží s formátovo špecifickým SaveOptions. |
Scene.Save(stream, options) | Uloží do prúdu s formátovo špecifickým SaveOptions. |
FileFormat | Register podporovaných formátov súborov. Použite FileFormat.Formats (an IList<FileFormat>) to enumerate all supported formats, or FileFormat.Detect(fileName) na zistenie formátu podľa názvu súboru. Pomenované konštanty (ObjFormat, GltfFormat, FbxFormat, atď.) sú internal a nie sú prístupné z používateľského kódu. |
IOService | Interná abstrakcia I/O. Poskytuje DetectFormat() pre detekciu formátu na základe prúdu. |
LoadOptions | Základná trieda pre formátovo-špecifické možnosti načítania. |
SaveOptions | Základná trieda pre formátovo-špecifické možnosti ukladania. |
Formát OBJ
Formát STL
Formát glTF
| Methods | Methods |
|---|
GltfLoadOptions | Možnosti načítania pre súbory glTF 2.0 a GLB. |
GltfSaveOptions | Možnosti ukladania pre výstup glTF 2.0 a GLB. V tejto edícii nie sú vystavené žiadne formátovo-špecifické vlastnosti; použite .glb rozšírenie pre binárny výstup. |
Formát FBX
| Methods | Methods |
|---|
FbxLoadOptions | Možnosti načítania pre súbory FBX. |
FbxSaveOptions | Možnosti ukladania pre výstup FBX. FBX export vždy vytvára binárny výstup; ASCII FBX export nie je v tejto verzii aktívny. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Popisovač typu obsahu: ASCII, Binary. Dostupné ako vlastnosť na FileFormat. |
Axis | Identifikuje súradnicovú os: XAxis, YAxis, ZAxis. |
CoordinateSystem | Určuje konvenciu pravotočivosti: RightHand alebo LeftHand. |
Systém vlastností
| Methods | Methods |
|---|
Property | Jedna pomenovaná typová vlastnosť na A3DObject. |
PropertyCollection | Iterovateľná kolekcia Property objekty pripojené k A3DObject. |
Pozri tiež
