Как начать с Aspose.3D FOSS для .NET

Как начать с Aspose.3D FOSS для .NET

Aspose.3D FOSS для .NET является бесплатной библиотекой, лицензируемой MIT для загрузки, манипулирования и сохранения 3D-файлов — нет нужных коренных бинарных файлов, чистый C# от NuGet.

Пошаговое руководство

Шаг 1: Установите пакет

Инсталляция с нугета (в .NET 10.0 или более поздней версии требуется):

dotnet add package Aspose.3D --version 26.1.0

Проверьте, что установка заряжена правильно:

using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");

Шаг 2: Импортировать пространства имён

Импортировать названия пространств для сцены и формат классов:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

Как загрузить 3D файл?

Использование Scene.Open() загрузить любой поддерживаемый формат. библиотека обнаруживает форматирование автоматически из расширения файла:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");

Используйте статический заводский метод:

var scene = Scene.FromFile("model.glb");

Как обойти граф сцены?

Нагруженная сцена — это дерево, которое Node Объекты, заложенные в scene.RootNode:

using Aspose.ThreeD;

void Walk(Node node, int depth = 0)
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}Node: {node.Name}");
    foreach (var child in node.ChildNodes)
        Walk(child, depth + 1);
}

var scene = Scene.FromFile("model.obj");
Walk(scene.RootNode);

Шаг 3: Сохраните в целевой формат

Использование Scene.Save() для экспорта в любой поддерживаемый формат выхода. библиотека обнаруживает Формат выхода из расширения файла:

using Aspose.ThreeD;

var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");

Общие проблемы и решения

FileNotFoundException Когда звонить Scene.Open() Путь, который вы проехали не существует или использует неправильный разделитель. Path.Combine() Чтобы убедиться, что файл проходит правильно.

UnsupportedOperationException Для определенных методов Некоторые методы (рендерирование сцены, водосметка) не доступны в издании FOSS. Проверьте документацию ограничений, прежде чем использовать передовые функции.

Неизвестная форма ошибки Убедитесь, что расширение файла соответствует реальной форматизации. библиотека обнаруживает формат через Расширение для Scene.Open() и Scene.FromFile().Пройдите ясную FileFormat Параметры для передового обнаружения.

Пустая сцена после зарядки Некоторые бинарные формати могут потребовать конкретных опций загрузки. попробуйте использовать явный перегрузку С ObjLoadOptions или GltfLoadOptions Если зарядное нагружение создает пустую сцену.

Часто задаваемые вопросы

Нужны ли Aspose.3D FOSS Microsoft Office или какие-либо коренные DLL?

Библиотека чистая C# с отсутствием коренных зависимостей или внешних бинарных требований.

Какие версии .NET поддерживаются?

.NET 10.0 или более поздней. библиотека работает на контейнерах Windows, macOS, Linux и Docker.

Свободно ли библиотека для коммерческого использования?

Вы можете использовать, модифицировать и перераспространять его для любых целей, включая коммерческие приложения.

Какие 3D-форматы можно читать и писать?

Библиотека поддерживает OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA и 3MF для обоих. Читать и писать. PLY импортируется только. FileFormat.GetFormatByExtension() Для Поддерживаются формати в режиме реального времени.

Можно ли создать 3D-сцену из скратча?

Да. Создание A Scene без аргументов, добавьте детские узлы к scene.RootNode,и Сделайте в желаемом формате.

Смотреть также

 Русский