چگونه با Aspose.3D FOSS برای .NET شروع کنیم
Aspose.3D FOSS برای .NET یک کتابخانه رایگان و مجوز MIT برای بارگذاری، دستکاری و ذخیره فایل های 3D است – هیچ دوگانه بومی مورد نیاز نیست، C# خالص از NuGet.
راهنمای گام به گام
مرحله اول: نصب بسته بندی
نصب از NuGet (.NET 10.0 یا بالاتر مورد نیاز است):
dotnet add package Aspose.3D --version 26.1.0بررسی نصب شده به درستی:
using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");مرحله دوم: واردات فضاهای نامی مورد نیاز
وارد کردن فضاهای نام برای صحنه و کلاس های فرمت:
using Aspose.ThreeD;
using Aspose.ThreeD.Formats;مرحله 3: فایل 3D را بارگذاری کنید.
استفاده از 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");مرحله چهارم: از روی صحنه عبور کنید.
یک صحنه بارگذاری شده، درختی است که در آن 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);مرحله 3: ذخیره به فرمت هدف
استفاده از 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 اگر بار پیش فرض یک صحنه خالی ایجاد کند.
سوالات متداول
آیا Aspose.3D FOSS نیاز به Microsoft Office یا هر DLL بومی دارد؟?
کتابخانه خالص C# است و هیچ وابستگی های بومی یا دوگانه خارجی مورد نیاز نیست.
کدام نسخه های .NET پشتیبانی می شوند؟?
.NET 10.0 یا بالاتر. کتابخانه در ویندوز، macOS، لینوکس و داکر کار می کند.
آیا کتابخانه برای استفاده تجاری رایگان است؟?
بله، تحت مجوز MIT منتشر می شود.شما می توانید آن را برای هر هدف از جمله برنامه های تجاری استفاده کنید، ویرایش و توزیع مجدد.
چه فرمت های 3D را می توانم بخوانم و بنویسم؟?
کتابخانه از OBJ، STL، glTF 2.0 / GLB، FBX، COLLADA و 3MF برای هر دو پشتیبانی می کند. خواندن و نوشتن. PLY واردات است. استفاده از FileFormat.GetFormatByExtension() به پرسش ها در زمان اجرا پشتیبانی می شود.
آیا می توانم یک صحنه 3D را از اسکاتچ ایجاد کنم؟?
بله، ساختن یک Scene بدون هیچ گونه استدلال، اضافه کردن گره های کودک به scene.RootNode,و به فرمت مورد نظر برسید.