Aspose.3D FOSS for .NET

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:

using Aspose.ThreeD;

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

MethodsMethods
SceneKontejner 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.
NodePojmenovaný 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.
EntityAbstraktní 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.
SceneObjectZákladní třída sdílená s Node a Entity. Poskytuje rozhraní kolekce vlastností používané pro uživatelsky definovaná metadata.
A3DObjectKořenová základní třída pro všechny Aspose.3D spravované objekty. Zveřejňuje the Name vlastnost a Properties kolekce.
INamedObjectRozhraní, které zaručuje Name vlastnost. Implementováno v Node, Entity, a několik formátově specifických typů popisovačů.

Geometrie a síť

MethodsMethods
MeshEntita 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ů).
GeometryAbstraktní základ pro typy geometrie podobné sítím. Definuje pole řídicích bodů a kolekci VertexElement vrstev. Mesh dědí z Geometry.
VertexElementAbstraktní základ pro datovou vrstvu připojenou k geometrii (normály, UV, barvy, atd.). Nese MappingMode, ReferenceMode, a seznam dat.
VertexElementNormalUkládá jeden normálový vektor na vrchol nebo na roh polygonu, v závislosti na režimu mapování.
VertexElementUVUkládá páry texturovacích souřadnic (Vector2) na vrchol nebo na roh polygonu.
VertexElementVertexColorUkládá RGBA barevná data na vrchol nebo na roh jako Vector4.

Vestavěné primitivy

MethodsMethods
BoxParametrický 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().
SphereParametrická sféra s konfigurovatelným poloměrem. Podporuje ToMesh() konverze.
CylinderParametrický válec s nastavitelným horním poloměrem, spodním poloměrem a výškou. Podporuje ToMesh() konverze.

Transformace a prostor

MethodsMethods
TransformMístní transformace připojená k Node. Poskytuje Translation (FVector3), Rotation (Quaternion), Scale (FVector3), a Matrix (Matrix4) vlastnosti.
GlobalTransformZobrazení 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.
AssetInfoBlok 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í

MethodsMethods
MaterialAbstraktní základní třída pro všechny typy materiálů. Poskytuje název a kolekci vlastností.
LambertMaterialKlasický materiál pouze s difúzním odrazem s Ambient, Diffuse, Emissive, Reflective, Transparency, a Texture vlastnosti. Namespace: Aspose.ThreeD.Shading.
PhongMaterialRozšiřuje Lambert o Specular, Shininess, a SpecularPower vlastnosti. Namespace: Aspose.ThreeD.Shading.
PbrMaterialMateriál Physically Based Rendering s BaseColor, Metallic, Roughness, Occlusion, a vlastnosti texturových slotů. Namespace: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraEntita 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

MethodsMethods
Vector2Dvojitá přesnost 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Použito pro UV texturové souřadnice.
Vector3Dvojitá přesnost 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Obecný prostorový vektor pro geometrii.
Vector4Dvojitá 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.
FVector3Jednopřesnostní 3‑komponentový float vektor (velká písmena polí: X, Y, Z). Používáno v Transform.Translation a Transform.Scale.
FVector4Jednopřesný 4-komponentový float vektor (velká písmena polí: X, Y, Z, W).
QuaternionJednotkový kvaternion pro reprezentaci rotací (W, X, Y, Z). Používáno v Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxOsově zarovnaná ohraničující krabice definovaná Minimum a Maximum FVector3 rohy.

Methods

MethodsMethods
AnimationClipPojmenovaný 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

MethodsMethods
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.
FileFormatRegistr 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.
IOServiceInterní abstrakce I/O. Poskytuje DetectFormat() pro detekci formátu založenou na streamu.
LoadOptionsZákladní třída pro formátově specifické možnosti načítání.
SaveOptionsZákladní třída pro formátově specifické možnosti ukládání.

Formát OBJ

MethodsMethods
ObjLoadOptionsMožnosti načítání pro soubory Wavefront OBJ.
ObjSaveOptionsMožnosti ukládání pro výstup Wavefront OBJ.

Formát STL

MethodsMethods
StlLoadOptionsMožnosti načítání pro soubory STL.
StlSaveOptionsMožnosti ukládání pro výstup STL.

Formát glTF

MethodsMethods
GltfLoadOptionsMožnosti načítání pro soubory glTF 2.0 a GLB.
GltfSaveOptionsMož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

MethodsMethods
FbxLoadOptionsMožnosti načítání pro soubory FBX.
FbxSaveOptionsMož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

MethodsMethods
TmfLoadOptionsMožnosti načítání pro soubory 3MF.
TmfSaveOptionsMožnosti uložení pro výstup 3MF.

Methods

MethodsMethods
FileContentTypePopis typu obsahu: ASCII, Binary. K dispozici jako vlastnost na FileFormat.
AxisIdentifikuje souřadnicovou osu: XAxis, YAxis, ZAxis.
CoordinateSystemUrčuje konvenci pravotočivosti: RightHand nebo LeftHand.

Systém vlastností

MethodsMethods
PropertyJedna pojmenovaná typová vlastnost na A3DObject.
PropertyCollectionIterovatelná kolekce Property objekty připojené k A3DObject.

Viz také

 Čeština