شروع کار

شروع کار با Aspose.3D متن‌باز برای .NET

خوش آمدید به Aspose.3D, یک کتابخانه رایگان و متن‌باز .NET برای بارگذاری، ساخت و خروجی‌گیری صحنه‌های سه‌بعدی. این راهنما شما را از یک محیط تازه به یک صحنهٔ کارآمد در عرض چند دقیقه می‌برد.

پیش‌نیازها

نصب

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 primitive‌ها و تبدیل آن‌ها به 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");

مراحل بعدی

• راهنمای نصب: راه‌اندازی دقیق NuGet، پیکربندی پروژه و تأیید
• راهنمای توسعه‌دهنده: پشتیبانی از فرمت‌ها، عملیات مش، مواد و تبدیل‌ها
• ویژگی‌ها و عملکردها: بررسی عمیق هر حوزه ویژگی با مثال‌های C#