1. محصولات
  2.   Aspose.3D
  3.   Aspose.3D FOSS for .NET

Aspose.3D FOSS برای .NET

صحنه‌های سه‌بعدی را از .NET بارگذاری، ایجاد، تبدیل و صادر کنید — رایگان و منبع باز.

Aspose.3D FOSS for .NET Aspose.3D FOSS
for .NET

مستندات GitHub

کتابخانه منبع باز .NET برای پردازش فایل‌های سه‌بعدی

Aspose.3D FOSS برای .NET یک کتابخانه MIT-licensed، pure-C# است برای کار با فرمت‌های فایل 3D. تنها یک بسته NuGet اضافه کنید و بلافاصله شروع به خواندن، ساخت و نوشتن صحنه‌های 3D کنید بدون نصب هیچ native runtime، external SDK یا third-party renderer.

کتابخانه یک API گراف صحنهٔ تمیز را ارائه می‌دهد که دور Scene، Node، Mesh، Camera و Transform ساخته شده است، همان مدل مفهومی که ابزارهای حرفه‌ای 3D استفاده می‌کنند. پشتیبانی از فرمت‌ها شامل OBJ (با بارگذاری مواد .mtl)، STL (دودویی و ASCII)، glTF 2.0 (مواد PBR)، GLB (binary glTF)، FBX (import و export)، Collada و 3MF می‌شود. گزینه‌های بارگذاری و ذخیره‌سازی برای هر فرمت به شما امکان می‌دهد تا چرخش مختصات، مقیاس، نرمال‌سازی نرمال‌ها و بارگذاری مواد را کنترل کنید بدون نوشتن کد تجزیه‌گر مخصوص هر فرمت.

Aspose.3D FOSS هدف .NET 10.0 را دارد و بر روی Windows، macOS و Linux اجرا می‌شود. هیچ native extension برای کامپایل وجود ندارد و نیازی به نصب بستهٔ سیستمی نیست.

پشتیبانی از فرمت‌های سه‌بعدی و API گراف صحنه

  • OBJ / MTL: فایل‌های Wavefront OBJ را همراه با تعاریف مواد مربوطه بارگذاری کنید.
  • STL: هر دو نوع binary و ASCII STL را بخوانید و بنویسید با تأیید کامل roundtrip.
  • glTF 2.0 / GLB: بارگذاری و صادرات مواد PBR. به‌عنوان .glb ذخیره کنید برای خروجی binary glTF.
  • FBX: فایل‌های FBX را در هر دو حالت ASCII و binary وارد و صادر کنید.
  • Collada / 3MF: پشتیبانی اضافی از فرمت برای تعامل‌پذیری گسترده‌تر.
  • API گراف صحنه: Scene, Node, Mesh, Camera, Transform.

جایی که Aspose.3D FOSS می‌تواند استفاده شود

  • Asset validation pipelines: در CI دارایی‌های 3D را بررسی، جهت‌گیری مجدد و خروجی مجدد کنید.
  • Game development tooling: مش‌های OBJ و STL را به‌صورت دسته‌ای پردازش کنید بدون نیاز به موتور بومی.
  • 3D printing workflows: خواندن، اعتبارسنجی و دوباره‌صادرات فایل‌های STL و 3MF.
  • Web backends: ارائهٔ نقاط انتهایی تبدیل 3D در Docker یا توابع بدون سرور.
  • Content migration: تبدیل بین خانواده‌های فرمت به‌صورت مقیاس‌پذیر.

گزینه‌های هر فرمت و کنترل مختصات

  • جهت‌گیری سیستم مختصات: محورها را معکوس کنید و مقیاس را برای هر فرمت تنظیم کنید بدون کد سفارشی.
  • Normal normalization: به‌صورت خودکار نرمال‌های راس را هنگام بارگذاری یا ذخیره‌سازی نرمال کنید.
  • Material loading control: برای تجزیه سریع‌تر، بارگذاری MTL/texture را فعال یا غیرفعال کنید.
  • Per-format load options: معکوس‌کردن مختصات، مقیاس و بارگذاری مواد را برای هر فرمت پیکربندی کنید.
  • Round-trip fidelity: گره‌های ناشناخته گراف صحنه به‌صورت دقیق هنگام ذخیره‌مجدد حفظ می‌شوند.

تجربه توسعه‌دهنده

Aspose.3D FOSS برای نصب‌های .NET با یک بستهٔ NuGet (dotnet add package Aspose.3D.Converter --version 1.0.0). این کتابخانه کاملاً C# است، بدون افزونه‌های بومی برای کامپایل و بدون نیاز به نصب بسته‌های سیستمی.

API گراف صحنه مدل مفهومی ابزارهای حرفه‌ای 3D را بازتاب می‌دهد، بنابراین منحنی یادگیری برای هر کسی که با Three.js یا مدل داده‌ای Blender آشناست کوتاه است. این کتابخانه تحت مجوز MIT، منبع باز است و گزارش‌های باگ و مشارکت‌ها را در GitHub خوش‌آمد می‌گوید.

صحنه OBJ را بارگذاری کنید و به‌صورت glTF صادر کنید

بستهٔ NuGet را اضافه کنید، سپس Scene.Open("model.obj") را فراخوانی کنید تا فایل OBJ همراه با تعاریف مواد MTL آن بارگذاری شود. یک فراخوانی scene.Save() با پسوند .gltf یک فایل JSON glTF 2.0 می‌نویسد، بدون نیاز به رجیستری فرمت یا شیء مبدل.

dotnet add package Aspose.3D.Converter --version 1.0.0

using Aspose.ThreeD;

// بارگذاری یک فایل OBJ (با مواد .mtl)
var scene = new Scene();
scene.Open("model.obj");

// خروجی به صورت glTF 2.0
scene.Save("model.gltf");

OBJ را با گزینه‌ها بارگذاری کنید و به‌صورت STL صادر کنید

کلاس‌های گزینه‌ per‑format به شما امکان کنترل رفتار وارد کردن را می‌دهند. به عنوان مثال، ObjLoadOptions به شما اجازه می‌دهد تا چرخش مختصات، مقیاس و بارگذاری مواد را تغییر دهید. همین الگو برای تمام فرمت‌ها اعمال می‌شود — کلاس گزینه‌ها را برای فرمت هدف خود تعویض کنید.

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

var scene = new Scene();
var opts = new ObjLoadOptions();
opts.FlipCoordinateSystem = true;
opts.NormalizeNormal = true;
scene.Open("mesh.obj", opts);

// دوباره به صورت STL صادر کنید
scene.Save("mesh.stl");

سوالات متداول

Aspose.3D FOSS برای .NET چیست؟

این یک کتابخانهٔ رایگان، تحت مجوز MIT و کاملاً به‌صورت C# خالص است که برای بارگذاری، دستکاری و ذخیره‌سازی صحنه‌های سه‌بعدی بدون نصب هیچ‌گونه زمان‌اجرای بومی یا SDK خارجی می‌باشد.

کدام فرمت‌های 3D پشتیبانی می‌شوند؟

OBJ (با .mtl)، STL (دودویی و متنی)، glTF 2.0، GLB (glTF دودویی)، FBX (واردات و صادرات)، Collada و 3MF. هر قالب یک کلاس گزینه‌های بارگذاری/ذخیره‌سازی اختصاصی دارد.

آیا به هیچ وابستگی بومی نیاز دارد؟

خیر. Aspose.3D FOSS برای .NET به‌صورت خالص C# است و هیچ افزونه بومی ندارد. این کتابخانه بر روی Windows، macOS و Linux بدون نیاز به هیچ مرحلهٔ کامپایل اجرا می‌شود.

چگونه آن را نصب کنم؟

دستور dotnet add package Aspose.3D.Converter --version 1.0.0 را اجرا کنید تا بسته NuGet به پروژهٔ شما اضافه شود. هیچ بستهٔ سیستمی یا افزونه بومی اضافی مورد نیاز نیست.

آیا می‌توانم جهت‌گیری سیستم مختصات را کنترل کنم؟

بله. کلاس‌های گزینهٔ هر قالب به شما امکان می‌دهند محورها را معکوس کنید، مقیاس را تنظیم کنید و نرمال‌ها را نرمال‌سازی کنید بدون اینکه نیاز به نوشتن کد تجزیه‌گر مخصوص هر قالب داشته باشید.

کدام نسخه‌های .NET پشتیبانی می‌شوند؟

.NET 10.0 و بالاتر پشتیبانی می‌شود. این کتابخانه بر روی تمام سیستم‌عامل‌های اصلی اجرا می‌شود.

آیا کد منبع در دسترس است؟

بله. این کتابخانه تحت مجوز MIT است و در GitHub میزبانی می‌شود. گزارش‌های باگ و pull requests خوش‌آمد می‌گویند.

  

منابع پشتیبانی و آموزش

 فارسی