Начало работы

Начало работы с Aspose.3D FOSS для .NET

Добро пожаловать в Aspose.3D, бесплатная, открытая библиотека .NET для загрузки, построения и экспорта 3D‑сцен. Это руководство проведёт вас от чистой среды к работающей сцене за несколько минут.

Требования

ТребованияПодробности
.NET SDK.NET 10.0 или новее
IDEVisual Studio 2022+, Rider или VS Code с расширением C#
OSWindows, macOS или Linux
Менеджер пакетовNuGet (включён в .NET SDK)

Установка

  1. Создайте или откройте проект .NET:
dotnet new console -n My3DApp
cd My3DApp
  1. Добавьте пакет NuGet:
dotnet add package Aspose.3D --version 26.1.0
  1. Проверьте, что ссылка компилируется:
using Aspose.ThreeD;

var scene = new Scene();
Console.WriteLine("Aspose.3D loaded successfully.");
dotnet run

См. Руководство по установке для получения более подробной информации о настройке проекта и проверке.

Что вы можете сделать

После установки вы можете сразу:

  • Загрузить файлы OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY и 3MF через Scene.Open()
  • Просмотр иерархии сцены: обход Node деревья, чтение Mesh геометрия, доступ к нормалям вершин и UV‑координатам
  • Трансформ узлы: набор Translation, Rotation (через Quaternion), и Scale через Transform класс
  • Применить материалы: назначить LambertMaterial, PhongMaterial, или PbrMaterial к узлам
  • Экспортировать в любой поддерживаемый формат с настройками для каждого формата SaveOptions
  • Создать геометрию: создать Box, Sphere, и Cylinder примитивы и преобразовать их в Mesh через ToMesh()

Быстрый старт

Загрузите 3D‑файл, выведите иерархию сцены и сохраните заново в формате GLB:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("input.obj");

Console.WriteLine($"Root children: {scene.RootNode.ChildNodes.Count}");
foreach (var node in scene.RootNode.ChildNodes)
{
    var entityType = node.Entity?.GetType().Name ?? "no entity";
    Console.WriteLine($"  {node.Name} [{entityType}]");
}

scene.Save("output.glb");
Console.WriteLine("Saved output.glb");

Следующие шаги

 Русский