Как да започнете с Aspose.3D FOSS за .NET
Aspose.3D FOSS за .NET е безплатна, лицензирана от MIT библиотека за изтегляне, манипулиране и спасяване на 3D файлове – без нужни бинарни изисквания, чист C# от NuGet.
Стъпка по стъпка ръководство
Стъпка 1: Инсталирайте пакета
Инсталиране от NuGet (.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;Стъпка 3: Изтегляне на 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");Стъпка 4: Преминаване през сцената график
Сцената е дърво на 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);Стъпка 5: Съхранявайте в различен формат
Използване 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 ако стандартното натоварване създава празна сцена.
Често задавани въпроси
АСПОЗ.3Д FOSS изисква Microsoft Office или някакви коренни DLLs?
Библиотеката е чиста C# с никакви вътрешни зависимост или външни бинарни изисквания.
Какви версии на .NET се поддържат?
.NET 10.0 или по-късно. библиотеката работи на контейнери Windows, macOS, Linux и Docker.
Библиотеката е свободна за търговско ползване.?
Да. Тя е издадена под лиценза на MIT. Можете да я използвате, модифицирате и преразпределите за всякакви цели, включително търговски приложения.
Какви 3D формати мога да чета и пиша?
Библиотеката поддържа OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA и 3MF за двете. четене и писане. PLY е само внос. използвайте FileFormat.GetFormatByExtension() за Поддържани формати за търсене в работно време.
Мога ли да създам 3D сцена от скратено?
Да. Създаване на A Scene без аргументи, добавете детски възли към scene.RootNode,и Използвайте желания формат.