Як почати з Aspose.3D FOSS для .NET

Aspose.3D FOSS для .NET - це безкоштовна бібліотека, ліцензована MIT для завантаження, маніпулювання та збереження 3D-файлів — немає необхідності в нашому веб-сайті.

Крок за кроком посібник

Крок 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;

Використовуйте 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 Якщо завантаження по умові створює порожню сцену.

Часті запитання

Чи потрібен Microsoft Office або будь-який надійний DLL?

Бібліотека є чистою C# без необхідності вживати рідних залежностей або зовнішніх бінарних копій.

Які версії .NET підтримуються?

.NET 10.0 або пізніше. Бібліотека працює на контейнерах Windows, macOS, Linux та Docker.

Чи є бібліотека вільною для комерційного використання?

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

Які 3D-формати можна читати і писати?

Бібліотека підтримує OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA та 3MF для обох. читати і писати. PLY є імпорт-лише. використовувати FileFormat.GetFormatByExtension() 2 Підтримка форматів у формі runtime.

Чи можна створити 3D-сцену з нуля?

Будівництво a Scene Без аргументів додайте дитячі вузли до scene.RootNode,І Зберегти до бажаного формату.