API довідка для Aspose.3D 26.1.0 (.NET 10.0+, MIT license).
Усі класи розташовані в Aspose.ThreeD кореневому просторі імен. Кореневий using‑директива:
Конвенція іменування C#: Усі властивості використовують стандартний синтаксис властивостей C#. Наприклад, використовуйте scene.RootNode замість scene.getRootNode(), і transform.Translation = ... замість transform.setTranslation(...).
Кейсинг векторного поля: Бібліотека має два набори типів векторів. Aspose.ThreeD.Utilities.Vector2/3/4 (використовується Mesh.ControlPoints, geometry, та більшістю математичних операцій) є подвійної точності з нижній регістр публічні поля (v.x, v.y, v.z, v.w). Простішi Aspose.ThreeD.Vector2/3/4 структури (у Vector.cs) є одиночна точність (float) з верхній регістр публічні поля (v.X, v.Y, v.Z). FVector2/3/4 і Quaternion і Matrix4 використовуйте доступ до полів у верхньому регістрі. Використовуйте Aspose.ThreeD.Utilities типи для роботи з геометрією.
Основний граф сцени
| Methods | Methods |
|---|
Scene | Контейнер верхнього рівня для всіх даних 3D‑сцени. Містить кореневий вузол, метадані ресурсів та анімаційні кліпи. Надає Open() і Save() як основні точки входу вводу/виводу. |
Node | Іменований вузол у ієрархії сцени. Містить список дочірніх вузлів та список приєднаних Entity об’єктів, таких як сітки, камери та освітлення. Має локальний Transform. |
Entity | Абстрактний базовий клас для всіх об’єктів, які можна приєднати до Node. Надає назву та ідентифікатор, але не має власної геометрії. |
SceneObject | Базовий клас, спільний для Node і Entity. Надає інтерфейс колекції властивостей, що використовується для користувацьких метаданих. |
A3DObject | Кореневий базовий клас для всіх керованих об’єктів Aspose.3D. Надає Name властивість і Properties колекцію. |
INamedObject | Інтерфейс, який гарантує Name властивість. Реалізовано Node, Entity, і кілька специфічних для формату типів дескрипторів. |
Геометрія та сітка
| Methods | Methods |
|---|
Mesh | Об’єкт полігональної сітки. Зберігає контрольні точки (позиції вершин як Vector4), списки граней полігонів (списки індексів контрольних точок), та шари елементів вершин (нормалі, UV, кольори вершин). |
Geometry | Абстрактна база для типів геометрії, схожих на сітки. Визначає масив контрольних точок та колекцію VertexElement шарів. Mesh наслідує від Geometry. |
VertexElement | Абстрактна база для шару даних, прикріпленого до геометрії (normals, UVs, colours, etc.). Переносить MappingMode, ReferenceMode, і список даних. |
VertexElementNormal | Зберігає один вектор нормалі на вершину або на кут полігону, залежно від режиму мапінгу. |
VertexElementUV | Зберігає пари текстурних координат (Vector2) на вершину або на кут полігону. |
VertexElementVertexColor | Зберігає дані кольору RGBA на вершину або на кут у вигляді Vector4. |
Вбудовані примітиви
| Methods | Methods |
|---|
Box | Параметричний паралелепіпед, орієнтований за осями, з налаштовуваною шириною, висотою та глибиною. Можна приєднати до Node безпосередньо або перетворити на Mesh за допомогою ToMesh(). |
Sphere | Параметрична сфера з налаштовуваним радіусом. Підтримує ToMesh() конвертацію. |
Cylinder | Параметричний циліндр з налаштовуваним верхнім радіусом, нижнім радіусом та висотою. Підтримує ToMesh() конвертацію. |
Трансформація та простір
| Methods | Methods |
|---|
Transform | Локальне перетворення, прикріплене до Node. Надає Translation (FVector3), Rotation (Quaternion), Scale (FVector3), і Matrix (Matrix4) властивості. |
GlobalTransform | Тільки для читання представлення матриці перетворення у світовому просторі вузла після композиції всіх трансформацій предків. Доступно через node.GlobalTransform. Надає один Matrix властивість. |
AssetInfo | Блок метаданих, прикріплений до Scene. Наслідує від A3DObject надаючи Name і Properties. У цій редакції не визначено додаткових властивостей. |
Матеріали та затінення
| Methods | Methods |
|---|
Material | Абстрактний базовий клас для всіх типів матеріалів. Забезпечує назву та колекцію властивостей. |
LambertMaterial | Класичний матеріал лише з дифузним розсіюванням, що Ambient, Diffuse, Emissive, Reflective, Transparency, і Texture властивості. Простір імен: Aspose.ThreeD.Shading. |
PhongMaterial | Розширює Lambert, додаючи Specular, Shininess, і SpecularPower властивості. Простір імен: Aspose.ThreeD.Shading. |
PbrMaterial | Матеріал фізично‑заснованого рендерингу з BaseColor, Metallic, Roughness, Occlusion, та властивості слотів текстур. Простір імен: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Сутність камери. Наслідує від Frustum. Прикріплено до Node для визначення трансформацій точки зору. У цьому випуску не розкрито властивостей, специфічних для формату. |
Математичні утиліти
| Methods | Methods |
|---|
Vector2 | Подвійна точність 2-component vector (lowercase fields: x, y). Простір імен: Aspose.ThreeD.Utilities. Використовується для UV-координат текстури. |
Vector3 | Подвійна точність 3-component vector (lowercase fields: x, y, z). Простір імен: Aspose.ThreeD.Utilities. Універсальний просторовий вектор для геометрії. |
Vector4 | Подвійна точність 4-component vector (lowercase fields: x, y, z, w). Простір імен: Aspose.ThreeD.Utilities. Використовується для Mesh.ControlPoints і нормальні дані. |
FVector3 | Вектор з плаваючою точкою одинарної точності з 3 компонентами (поля у верхньому регістрі: X, Y, Z) Transform.Translation і Transform.Scale. |
FVector4 | Вектор з плаваючою точкою одинарної точності з 4 компонентами (поля у верхньому регістрі: X, Y, Z, W). |
Quaternion | Одиничний кватерніон для представлення обертів (W, X, Y, Z). Використовується Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Прямокутна обмежувальна коробка, орієнтована за осями, визначена Minimum і Maximum FVector3 кутами. |
Methods
| Methods | Methods |
|---|
AnimationClip | Названий контейнер для діапазону анімації. A Scene може містити кілька кліпів. Заглушка оголошення — дані ключових кадрів та відтворення ще не реалізовані. |
Ввід/вивід форматів
| Methods | Methods |
|---|
Scene.Open(path) | Відкриває файл, визначає формат за розширенням і заповнює сцену. |
Scene.Open(path, options) | Відкриває файл з урахуванням формату. LoadOptions. |
Scene.Open(stream) | Відкриває з потоку, автоматично визначаючи формат за вмістом. |
Scene.Open(stream, options) | Відкриває з потоку з урахуванням формату. LoadOptions. |
Scene.Save(path) | Зберігає сцену у файл; формат визначається за розширенням. |
Scene.Save(path, options) | Зберігає з урахуванням формату. SaveOptions. |
Scene.Save(stream, options) | Зберігає у потік з урахуванням формату SaveOptions. |
FileFormat | Реєстр підтримуваних форматів файлів. Використовуйте FileFormat.Formats (один IList<FileFormat>) щоб перерахувати всі підтримувані формати, або FileFormat.Detect(fileName) щоб визначити формат за назвою файлу. Іменовані константи (ObjFormat, GltfFormat, FbxFormat, тощо) є internal і недоступні з коду користувача. |
IOService | Внутрішня абстракція I/O. Забезпечує DetectFormat() для виявлення формату на основі потоку. |
LoadOptions | Базовий клас для параметрів завантаження, специфічних для формату. |
SaveOptions | Базовий клас для параметрів збереження, специфічних для формату. |
Формат OBJ
Формат STL
Формат glTF
| Methods | Methods |
|---|
GltfLoadOptions | Параметри завантаження для файлів glTF 2.0 та GLB. |
GltfSaveOptions | Параметри збереження для виводу glTF 2.0 та GLB. У цьому випуску не надаються властивості, специфічні для формату; використовуйте .glb розширення для бінарного виводу. |
Формат FBX
| Methods | Methods |
|---|
FbxLoadOptions | Параметри завантаження для файлів FBX. |
FbxSaveOptions | Параметри збереження для виводу FBX. Експорт FBX завжди створює бінарний вивід; ASCII-експорт FBX у цій версії не активний. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Опис типу вмісту: ASCII, Binary. Доступно як властивість у FileFormat. |
Axis | Визначає координатну вісь: XAxis, YAxis, ZAxis. |
CoordinateSystem | Визначає конвенцію правосторонності: RightHand або LeftHand. |
Система властивостей
| Methods | Methods |
|---|
Property | Одна називна типізована властивість у A3DObject. |
PropertyCollection | Ітерабельна колекція Property об’єкти, прикріплені до A3DObject. |
Див. також
