Aspose.3D FOSS for .NET

Referencja API dla Aspose.3D 26.1.0 (.NET 10.0+, licencja MIT).

Wszystkie klasy znajdują się w Aspose.ThreeD przestrzeni nazw root. Dyrektywa using root to:

using Aspose.ThreeD;

Konwencja nazewnictwa C#: Wszystkie właściwości używają standardowej składni właściwości C#. Na przykład, użyj scene.RootNode zamiast scene.getRootNode(), oraz transform.Translation = ... zamiast transform.setTranslation(...).

Nazewnictwo pól wektorowych: Biblioteka posiada dwa zestawy typów wektorowych. Aspose.ThreeD.Utilities.Vector2/3/4 (używany przez Mesh.ControlPoints, geometria i większość operacji matematycznych) są podwójna precyzja z małe litery pola publiczne (v.x, v.y, v.z, v.w). Prostszy Aspose.ThreeD.Vector2/3/4 struktury (in Vector.cs) są pojedynczej precyzji (float) z wielkimi literami publiczne pola (v.X, v.Y, v.Z). FVector2/3/4 i Quaternion i Matrix4 użyj dostępu do pól wielkimi literami. Użyj Aspose.ThreeD.Utilities typy do pracy z geometrią.


Podstawowy graf sceny

MethodsMethods
SceneKontener najwyższego poziomu dla wszystkich danych sceny 3D. Zawiera węzeł główny, metadane zasobów i klipy animacji. Udostępnia Open() i Save() jako główne punkty wejścia I/O.
NodeNazwany węzeł w hierarchii sceny. Posiada listę węzłów potomnych oraz listę dołączonych Entity obiektów, takich jak siatki, kamery i światła. Przenosi lokalne Transform.
EntityAbstrakcyjna klasa bazowa dla wszystkich obiektów, które mogą być dołączone do Node. Dostarcza nazwę i tożsamość, ale nie posiada własnej geometrii.
SceneObjectKlasa bazowa współdzielona przez Node i Entity. Udostępnia interfejs kolekcji właściwości używany do metadanych definiowanych przez użytkownika.
A3DObjectPodstawowa klasa bazowa dla wszystkich zarządzanych obiektów Aspose.3D. Udostępnia Name właściwość i Properties kolekcję.
INamedObjectInterfejs, który gwarantuje Name właściwość. Implementowany przez Node, Entity, oraz kilka typów deskryptorów specyficznych dla formatu.

Geometria i siatka

MethodsMethods
MeshEncja siatki wielokątnej. Przechowuje punkty kontrolne (pozycje wierzchołków jako Vector4), listy ścian wielokątów (listy indeksów punktów kontrolnych) oraz warstwy elementów wierzchołka (normale, UV, kolory wierzchołków).
GeometryAbstrakcyjna baza dla typów geometrii podobnych do siatek. Definiuje tablicę punktów kontrolnych oraz kolekcję VertexElement warstwy. Mesh dziedziczy po Geometry.
VertexElementAbstrakcyjna baza dla warstwy danych dołączonej do geometrii (normale, UV, kolory, itp.). Przenosi MappingMode, ReferenceMode, oraz listę danych.
VertexElementNormalPrzechowuje jeden wektor normalny na wierzchołek lub na róg wielokąta, w zależności od trybu mapowania.
VertexElementUVPrzechowuje pary współrzędnych tekstury (Vector2) na wierzchołek lub na róg wielokąta.
VertexElementVertexColorPrzechowuje dane koloru RGBA na wierzchołek lub na róg jako Vector4.

Wbudowane prymitywy

MethodsMethods
BoxParametryczna prostopadłościenna skrzynka wyrównana do osi z konfigurowalną szerokością, wysokością i głębokością. Może być dołączona do a Node bezpośrednio lub przekształcona na Mesh przez ToMesh().
SphereParametryczna sfera z konfigurowalnym promieniem. Obsługuje ToMesh() konwersja.
CylinderCylinder parametryczny z konfigurowalnym promieniem górnym, dolnym i wysokością. Obsługuje ToMesh() konwersja.

Transform i Spatial

MethodsMethods
TransformLokalna transformacja dołączona do Node. Zapewnia Translation (FVector3), Rotation (Quaternion), Scale (FVector3), i Matrix (Matrix4) właściwości.
GlobalTransformWidok tylko do odczytu macierzy transformacji w przestrzeni świata węzła po złożeniu wszystkich transformacji przodków. Dostępny poprzez node.GlobalTransform. Udostępnia pojedynczy Matrix właściwość.
AssetInfoBlok metadanych dołączony do Scene. Dziedziczy po A3DObject zapewniając Name i Properties. Nie zdefiniowano dodatkowych właściwości w tej edycji.

Materiały i cieniowanie

MethodsMethods
MaterialAbstrakcyjna klasa bazowa dla wszystkich typów materiałów. Dostarcza nazwę i kolekcję właściwości.
LambertMaterialKlasyczny materiał diffuse-only z Ambient, Diffuse, Emissive, Reflective, Transparency, i Texture właściwości. Przestrzeń nazw: Aspose.ThreeD.Shading.
PhongMaterialRozszerza Lambert o Specular, Shininess, i SpecularPower właściwości. Namespace: Aspose.ThreeD.Shading.
PbrMaterialMateriał Physically Based Rendering z BaseColor, Metallic, Roughness, Occlusion, oraz właściwości slotu tekstury. Przestrzeń nazw: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraEncja kamery. Dziedziczy po Frustum. Dołączony do Node w celu zdefiniowania przekształceń punktu widzenia. Żadne właściwości specyficzne dla formatu nie są udostępniane w tej edycji.

Narzędzia matematyczne

MethodsMethods
Vector2Podwójna precyzja 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. Używane do współrzędnych tekstury UV.
Vector3Podwójna precyzja 3-component vector (lowercase fields: x, y, z). Namespace: Aspose.ThreeD.Utilities. Ogólnego przeznaczenia wektor przestrzenny dla geometrii.
Vector4Podwójna precyzja 4-component vector (lowercase fields: x, y, z, w). Przestrzeń nazw: Aspose.ThreeD.Utilities. Używany do Mesh.ControlPoints i normalne dane.
FVector3Wektor zmiennoprzecinkowy 3-składnikowy pojedynczej precyzji (pola wielkimi literami: X, Y, Z). Używany przez Transform.Translation i Transform.Scale.
FVector4Wektor zmiennoprzecinkowy 4‑składnikowy w pojedynczej precyzji (pola wielkimi literami: X, Y, Z, W).
QuaternionJednostkowy kwaternion do reprezentacji obrotów (W, X, Y, Z). Używany przez Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxPudełko ograniczające wyrównane do osi określone przez Minimum i Maximum FVector3 rogi.

Methods

MethodsMethods
AnimationClipNazwany kontener dla zakresu animacji. A Scene może zawierać wiele klipów. Szkic deklaracji — dane klatek kluczowych i odtwarzanie nie są jeszcze zaimplementowane.

Wejście/wyjście formatów

MethodsMethods
Scene.Open(path)Otwiera plik, wykrywa format na podstawie rozszerzenia i wypełnia scenę.
Scene.Open(path, options)Otwiera plik specyficzny dla formatu LoadOptions.
Scene.Open(stream)Otwiera ze strumienia, automatycznie wykrywając format na podstawie zawartości.
Scene.Open(stream, options)Otwiera ze strumienia specyficznego dla formatu LoadOptions.
Scene.Save(path)Zapisuje scenę do pliku; format jest wywnioskowany z rozszerzenia.
Scene.Save(path, options)Zapisuje z formatem specyficznym SaveOptions.
Scene.Save(stream, options)Zapisuje do strumienia specyficznego dla formatu SaveOptions.
FileFormatRejestr obsługiwanych formatów plików. Użyj FileFormat.Formats (enum IList<FileFormat>) aby wyliczyć wszystkie obsługiwane formaty, lub FileFormat.Detect(fileName) aby wykryć format na podstawie nazwy pliku. Nazwane stałe (ObjFormat, GltfFormat, FbxFormat, itp.) są internal i nie są dostępne z kodu użytkownika.
IOServiceWewnętrzna abstrakcja I/O. Zapewnia DetectFormat() do wykrywania formatu opartego na strumieniu.
LoadOptionsKlasa bazowa dla opcji ładowania specyficznych dla formatu.
SaveOptionsKlasa bazowa dla opcji zapisu specyficznych dla formatu.

Format OBJ

MethodsMethods
ObjLoadOptionsOpcje ładowania dla plików Wavefront OBJ.
ObjSaveOptionsOpcje zapisu dla wyjścia Wavefront OBJ.

Format STL

MethodsMethods
StlLoadOptionsOpcje ładowania dla plików STL.
StlSaveOptionsOpcje zapisu dla wyjścia STL.

Format glTF

MethodsMethods
GltfLoadOptionsOpcje ładowania dla plików glTF 2.0 i GLB.
GltfSaveOptionsOpcje zapisu dla wyjścia glTF 2.0 i GLB. W tej edycji nie udostępniono właściwości specyficznych dla formatu; użyj .glb rozszerzenia dla wyjścia binarnego.

Format FBX

MethodsMethods
FbxLoadOptionsOpcje ładowania dla plików FBX.
FbxSaveOptionsOpcje zapisu dla wyjścia FBX. Eksport FBX zawsze generuje wyjście binarne; eksport ASCII FBX nie jest aktywny w tej wersji.

3MF Format

MethodsMethods
TmfLoadOptionsOpcje wczytywania dla plików 3MF.
TmfSaveOptionsOpcje zapisu dla wyjścia 3MF.

Methods

MethodsMethods
FileContentTypeDeskryptor typu zawartości: ASCII, Binary. Dostępny jako właściwość w FileFormat.
AxisIdentyfikuje oś współrzędnych: XAxis, YAxis, ZAxis.
CoordinateSystemOkreśla konwencję praworęczności: RightHand lub LeftHand.

System właściwości

MethodsMethods
PropertyJedna nazwana typowana właściwość na A3DObject.
PropertyCollectionIterowalna kolekcja Property obiekty dołączone do A3DObject.

Zobacz także

 Polski