API reference pro Aspose.3D 26.1.0 (.NET 10.0+, licence MIT).
Všechny třídy se nacházejí v Aspose.ThreeD kořenovém jmenném prostoru. Kořenová direktiva using je:
Konvence pojmenování v C#: Všechny vlastnosti používají standardní syntaxi vlastností C#. Například použijte scene.RootNode namísto scene.getRootNode(), a transform.Translation = ... namísto transform.setTranslation(...).
Pojmenování vektorových polí: Knihovna má dvě sady vektorových typů. Aspose.ThreeD.Utilities.Vector2/3/4 (používáno v Mesh.ControlPoints, geometrie a většina matematických operací) jsou s dvojitou přesností s malá písmena veřejná pole (v.x, v.y, v.z, v.w). Jednodušší Aspose.ThreeD.Vector2/3/4 struktury (v Vector.cs) jsou jednopřesnost (float) s velká písmena veřejná pole (v.X, v.Y, v.Z). FVector2/3/4 a Quaternion a Matrix4 používejte přístup k polím velkými písmeny. Použijte Aspose.ThreeD.Utilities typy pro práci s geometrií.
Základní graf scény
| Methods | Methods |
|---|
Scene | Kontejner nejvyšší úrovně pro všechna 3D data scény. Obsahuje kořenový uzel, metadata assetů a animační klipy. Zpřístupňuje Open() a Save() jako hlavní vstupní/výstupní body. |
Node | Pojmenovaný uzel v hierarchii scény. Vlastní seznam podřízených uzlů a seznam připojených Entity objektů jako jsou sítě, kamery a světla. Nese lokální Transform. |
Entity | Abstraktní základní třída pro všechny objekty, které mohou být připojeny k Node. Poskytuje název a identitu, ale nemá vlastní geometrii. |
SceneObject | Základní třída sdílená s Node a Entity. Poskytuje rozhraní kolekce vlastností používané pro uživatelsky definovaná metadata. |
A3DObject | Kořenová základní třída pro všechny Aspose.3D spravované objekty. Zveřejňuje the Name vlastnost a Properties kolekce. |
INamedObject | Rozhraní, které zaručuje Name vlastnost. Implementováno v Node, Entity, a několik formátově specifických typů popisovačů. |
Geometrie a síť
| Methods | Methods |
|---|
Mesh | Entita polygonové sítě. Ukládá řídicí body (pozice vrcholů jako Vector4), seznamy polygonových ploch (seznamy indexů řídicích bodů) a vrstvy vrcholových elementů (normály, UV, barvy vrcholů). |
Geometry | Abstraktní základ pro typy geometrie podobné sítím. Definuje pole řídicích bodů a kolekci VertexElement vrstev. Mesh dědí z Geometry. |
VertexElement | Abstraktní základ pro datovou vrstvu připojenou k geometrii (normály, UV, barvy, atd.). Nese MappingMode, ReferenceMode, a seznam dat. |
VertexElementNormal | Ukládá jeden normálový vektor na vrchol nebo na roh polygonu, v závislosti na režimu mapování. |
VertexElementUV | Ukládá páry texturovacích souřadnic (Vector2) na vrchol nebo na roh polygonu. |
VertexElementVertexColor | Ukládá RGBA barevná data na vrchol nebo na roh jako Vector4. |
Vestavěné primitivy
| Methods | Methods |
|---|
Box | Parametrický osově zarovnaný box s konfigurovatelnou šířkou, výškou a hloubkou. Lze připojit k Node přímo nebo převést na Mesh pomocí ToMesh(). |
Sphere | Parametrická sféra s konfigurovatelným poloměrem. Podporuje ToMesh() konverze. |
Cylinder | Parametrický válec s nastavitelným horním poloměrem, spodním poloměrem a výškou. Podporuje ToMesh() konverze. |
Transformace a prostor
| Methods | Methods |
|---|
Transform | Místní transformace připojená k Node. Poskytuje Translation (FVector3), Rotation (Quaternion), Scale (FVector3), a Matrix (Matrix4) vlastnosti. |
GlobalTransform | Zobrazení pouze pro čtení matice transformace ve světovém prostoru uzlu po složení všech transformací předků. Přístupné přes node.GlobalTransform. Zveřejňuje jediný Matrix vlastnost. |
AssetInfo | Blok metadat připojený k Scene. Dědí z A3DObject poskytující Name a Properties. Žádné další vlastnosti nejsou v této edici definovány. |
Materiály a stínování
| Methods | Methods |
|---|
Material | Abstraktní základní třída pro všechny typy materiálů. Poskytuje název a kolekci vlastností. |
LambertMaterial | Klasický materiál pouze s difúzním odrazem s Ambient, Diffuse, Emissive, Reflective, Transparency, a Texture vlastnosti. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | Rozšiřuje Lambert o Specular, Shininess, a SpecularPower vlastnosti. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | Materiál Physically Based Rendering s BaseColor, Metallic, Roughness, Occlusion, a vlastnosti texturových slotů. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Entita Camera. Dědí z Frustum. Připojeno k Node k definování transformací pohledu. V této edici nejsou vystaveny žádné formátově specifické vlastnosti. |
Matematické utility
| Methods | Methods |
|---|
Vector2 | Dvojitá přesnost 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Použito pro UV texturové souřadnice. |
Vector3 | Dvojitá přesnost 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Obecný prostorový vektor pro geometrii. |
Vector4 | Dvojitá přesnost 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. Používá se pro Mesh.ControlPoints a normální data. |
FVector3 | Jednopřesnostní 3‑komponentový float vektor (velká písmena polí: X, Y, Z). Používáno v Transform.Translation a Transform.Scale. |
FVector4 | Jednopřesný 4-komponentový float vektor (velká písmena polí: X, Y, Z, W). |
Quaternion | Jednotkový kvaternion pro reprezentaci rotací (W, X, Y, Z). Používáno v Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Osově zarovnaná ohraničující krabice definovaná Minimum a Maximum FVector3 rohy. |
Methods
| Methods | Methods |
|---|
AnimationClip | Pojmenovaný kontejner pro rozsah animace. A Scene může obsahovat více klipů. Deklarace zástupce — data klíčových snímků a přehrávání ještě nejsou implementovány. |
Formát I/O
| Methods | Methods |
|---|
Scene.Open(path) | Otevře soubor, zjistí formát podle přípony a naplní scénu. |
Scene.Open(path, options) | Otevře soubor s formátově specifickým LoadOptions. |
Scene.Open(stream) | Otevře ze streamu, automaticky detekuje formát podle obsahu. |
Scene.Open(stream, options) | Otevře ze streamu s formátově specifickým LoadOptions. |
Scene.Save(path) | Uloží scénu do souboru; formát je odvozen z přípony. |
Scene.Save(path, options) | Ukládá s formátově specifickým SaveOptions. |
Scene.Save(stream, options) | Ukládá do proudu s formátově specifickým SaveOptions. |
FileFormat | Registr podporovaných formátů souborů. Použijte FileFormat.Formats (an IList<FileFormat>) k vyjmenování všech podporovaných formátů, nebo FileFormat.Detect(fileName) k detekci formátu podle názvu souboru. Pojmenované konstanty (ObjFormat, GltfFormat, FbxFormat, atd.) jsou internal a nejsou přístupné z uživatelského kódu. |
IOService | Interní abstrakce I/O. Poskytuje DetectFormat() pro detekci formátu založenou na streamu. |
LoadOptions | Základní třída pro formátově specifické možnosti načítání. |
SaveOptions | Základní třída pro formátově specifické možnosti ukládání. |
Formát OBJ
Formát STL
Formát glTF
| Methods | Methods |
|---|
GltfLoadOptions | Možnosti načítání pro soubory glTF 2.0 a GLB. |
GltfSaveOptions | Možnosti ukládání pro výstup glTF 2.0 a GLB. V této edici nejsou vystaveny žádné formátově specifické vlastnosti; použijte .glb rozšíření pro binární výstup. |
Formát FBX
| Methods | Methods |
|---|
FbxLoadOptions | Možnosti načítání pro soubory FBX. |
FbxSaveOptions | Možnosti uložení pro výstup FBX. Export FBX vždy vytváří binární výstup; ASCII export FBX není v této verzi aktivní. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Popis typu obsahu: ASCII, Binary. K dispozici jako vlastnost na FileFormat. |
Axis | Identifikuje souřadnicovou osu: XAxis, YAxis, ZAxis. |
CoordinateSystem | Určuje konvenci pravotočivosti: RightHand nebo LeftHand. |
Systém vlastností
| Methods | Methods |
|---|
Property | Jedna pojmenovaná typová vlastnost na A3DObject. |
PropertyCollection | Iterovatelná kolekce Property objekty připojené k A3DObject. |
Viz také