Справочник API для Aspose.3D.Converter 1.0.0 (.NET 10.0+, лицензия MIT).
Все классы находятся в Aspose.ThreeD корневом пространстве имён. Корневая директива using:
Конвенция именования в C#: Все свойства используют стандартный синтаксис свойств C#. Например, используйте scene.RootNode вместо scene.getRootNode(), и transform.Translation = ... вместо transform.setTranslation(...). Vector3, Vector4, Quaternion, Matrix4, и FVector типы используют публичные поля (v.X, v.Y, v.Z) для доступа к компоненту.
Основной граф сцены
| Example | Example |
|---|
Scene | Контейнер верхнего уровня для всех данных 3D‑сцены. Содержит корневой узел, метаданные ассетов и анимационные клипы. Предоставляет Open() и Save() в качестве основных точек входа ввода/вывода. |
Node | Именованный узел в иерархии сцены. Содержит список дочерних узлов и список присоединённых Entity объекты, такие как сетки, камеры и источники света. Содержит локальный Transform. |
Entity | Абстрактный базовый класс для всех объектов, которые могут быть присоединены к Node. Предоставляет имя и идентификатор, но не имеет собственной геометрии. |
SceneObject | Базовый класс, общий для Node и Entity. Предоставляет интерфейс коллекции свойств, используемый для пользовательских метаданных. |
A3DObject | Корневой базовый класс для всех управляемых объектов Aspose.3D. Предоставляет Name свойство и Properties коллекцию. |
INamedObject | Интерфейс, гарантирующий Name свойство. Реализуется Node, Entity, а также несколькими типами дескрипторов, специфичными для формата. |
Геометрия и сетка
| Example | Example |
|---|
Mesh | Сущность полигональной сетки. Хранит контрольные точки (позиции вершин как Vector4), списки граней полигонов (списки индексов контрольных точек) и слои элементов вершин (нормали, UV, цвета вершин). |
Geometry | Абстрактная базовая часть для типов геометрии, похожей на сетку. Определяет массив контрольных точек и набор VertexElement слоёв. Mesh наследуется от Geometry. |
VertexElement | Абстрактная базовая часть для слоя данных, прикреплённого к геометрии (нормали, UV, цвета и т.д.). Содержит MappingMode, ReferenceMode, и список данных. |
VertexElementNormal | Сохраняет один вектор нормали на вершину или на угол полигона, в зависимости от режима отображения. |
VertexElementUV | Сохраняет пары текстурных координат (Vector2) на вершину или на угол полигона. |
VertexElementVertexColor | Сохраняет данные цвета RGBA на вершину или на угол в виде Vector4. |
Встроенные примитивы
| Example | Example |
|---|
Box | Параметрический прямоугольный параллелепипед, выровненный по осям, с настраиваемой шириной, высотой и глубиной. Может быть прикреплён к a Node непосредственно или преобразовано в Mesh через ToMesh(). |
Sphere | Параметрическая сфера с настраиваемым радиусом. Поддерживает ToMesh() преобразование. |
Cylinder | Параметрический цилиндр с настраиваемыми радиусом верхней части, радиусом нижней части и высотой. Поддерживает ToMesh() преобразование. |
Трансформ и Spatial
| Example | Example |
|---|
Transform | Локальное преобразование, привязанное к Node. Предоставляет Translation (FVector3), Rotation (Quaternion), Scale (FVector3), и Matrix (Matrix4) свойства. |
GlobalTransform | Только для чтения представление матрицы преобразования узла в мировом пространстве после композиции всех трансформаций предков. Доступно через node.GlobalTransform. Предоставляет единственное Matrix свойство. |
AssetInfo | Блок метаданных, прикреплённый к Scene. Наследуется от A3DObject предоставляющий Name и Properties. В этом издании не определено дополнительных свойств. |
Материалы и затенение
| Example | Example |
|---|
Material | Абстрактный базовый класс для всех типов материалов. Предоставляет имя и коллекцию свойств. |
LambertMaterial | Классический материал, отражающий только диффузно, с Ambient, Diffuse, Emissive, Reflective, Transparency, и Texture свойства. Пространство имён: Aspose.ThreeD.Shading. |
PhongMaterial | Расширяет Lambert с Specular, Shininess, и SpecularPower свойства. Пространство имён: Aspose.ThreeD.Shading. |
PbrMaterial | Материал физически основанного рендеринга с BaseColor, Metallic, Roughness, Occlusion, и свойства слотов текстур. Namespace: Aspose.ThreeD.Shading. |
Example
| Example | Example |
|---|
Camera | Сущность камеры. Наследует от Frustum. Прикреплено к Node для определения трансформаций точки зрения. Свойства, специфичные для формата, не раскрыты в этом издании. |
Математические утилиты
| Example | Example |
|---|
Vector2 | Вектор одинарной точности с 2 компонентами (X, Y). Используется для UV‑текстурных координат. |
Vector3 | Вектор одинарной точности с 3 компонентами (X, Y, Z). Универсальный пространственный вектор. |
Vector4 | Вектор из 4 компонентов одинарной точности (X, Y, Z, W). Используется для контрольных точек и данных о нормалях. |
FVector3 | Вектор из 3 компонентов одинарной точности (float). Используется Transform.Translation и Transform.Scale. |
FVector4 | Вектор из 4 компонентов одинарной точности (float). |
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 углами. |
Example
| Example | Example |
|---|
AnimationClip | Именованный контейнер для диапазона анимации. A Scene может содержать несколько клипов. Заглушка декларации — данные ключевых кадров и воспроизведение пока не реализованы. |
Ввод/вывод форматов
| Example | Example |
|---|
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.WavefrontOBJ, FileFormat.GLTF2, FileFormat.FBX7400ASCII. |
IOService | Внутренняя абстракция ввода/вывода. Предоставляет DetectFormat() для обнаружения формата на основе потока. |
LoadOptions | Базовый класс для параметров загрузки, специфичных для формата. |
SaveOptions | Базовый класс для параметров сохранения, специфичных для формата. |
Формат OBJ
Формат STL
Формат glTF
| Example | Example |
|---|
GltfLoadOptions | Параметры загрузки для файлов glTF 2.0 и GLB. |
GltfSaveOptions | Параметры сохранения для вывода glTF 2.0 и GLB. Свойства, специфичные для формата, в этом издании не доступны; используйте .glb расширение для бинарного вывода. |
Формат FBX
| Example | Example |
|---|
FbxLoadOptions | Параметры загрузки для файлов FBX. |
FbxSaveOptions | Параметры сохранения для вывода FBX. Используйте IsAscii для переключения режима ASCII/бинарного. |
3MF Format
Example
| Example | Example |
|---|
FileContentType | Дескриптор типа содержимого: ASCII, Binary. Доступно как свойство у FileFormat. |
Axis | Идентифицирует координатную ось: XAxis, YAxis, ZAxis. |
CoordinateSystem | Указывает конвенцию правосторонности: RightHand или LeftHand. |
Система свойств
| Example | Example |
|---|
Property | Один именованный типизированный свойство на A3DObject. |
PropertyCollection | Итерируемая коллекция Property объекты, прикреплённые к A3DObject. |
См. также
