入门

开始使用 Aspose.3D FOSS for .NET

欢迎来到 Aspose.3D,，一个免费、开源的 .NET 库，用于加载、构建和导出 3D 场景。本指南可帮助您在几分钟内从全新环境创建出可运行的场景。.

先决条件

要求细节
.NET SDK.NET 10.0 或更高
IDEVisual Studio 2022+、Rider 或带 C# 扩展的 VS Code
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");

后续步骤

 中文