Getting Started

Getting Started with Aspose.3D FOSS for .NET

Welcome to Aspose.3D, a free, open-source .NET library for loading, building, and exporting 3D scenes. This guide takes you from a fresh environment to a working scene in minutes.

Prerequisites

RequirementDetail
.NET SDK.NET 10.0 or later
IDEVisual Studio 2022+, Rider, or VS Code with C# extension
OSWindows, macOS, or Linux
Package managerNuGet (included with .NET SDK)

Installation

  1. Create or open a .NET project:
dotnet new console -n My3DApp
cd My3DApp
  1. Add the NuGet package:
dotnet add package Aspose.3D --version 26.1.0
  1. Verify the reference compiles:
using Aspose.ThreeD;

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

See the Installation Guide for more detail on project setup and verification.

What You Can Do

Once installed you can immediately:

  • Load OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY, and 3MF files via Scene.Open()
  • Inspect scene hierarchies: traverse Node trees, read Mesh geometry, access vertex normals and UVs
  • Transform nodes: set Translation, Rotation (via Quaternion), and Scale through the Transform class
  • Apply materials: assign LambertMaterial, PhongMaterial, or PbrMaterial to nodes
  • Export to any supported format with per-format SaveOptions
  • Build geometry: create Box, Sphere, and Cylinder primitives and convert them to Mesh via ToMesh()

Quick Start

Load a 3D file, print the scene hierarchy, and re-save in GLB format:

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");

Next Steps

See Also

 English