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

Aspose.3D FOSS برای Java

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

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

مستندات GitHub

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

Aspose.3D FOSS برای Java یک کتابخانه تحت مجوز MIT، pure-Java برای کار با فرمت‌های فایل 3D است. یک وابستگی Maven اضافه کنید و بلافاصله شروع به خواندن، ساخت و نوشتن صحنه‌های 3D کنید بدون اینکه نیاز به نصب هیچ runtime بومی، SDK خارجی یا رندرر شخص ثالث داشته باشید.

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

Aspose.3D FOSS به Java نسخه 21 یا بالاتر نیاز دارد و به‌صورت یکسان بر روی Windows، macOS و Linux CI runnerها، کانتینرهای Docker و محیط‌های بدون سرور اجرا می‌شود. هیچ افزونه بومی برای کامپایل وجود ندارد و نیازی به نصب بسته سیستمی نیست.

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

  • OBJ / MTL: بارگذاری فایل‌های Wavefront OBJ همراه با تعاریف مواد مربوطه.
  • STL: خواندن و نوشتن هر دو نوع دودویی و ASCII STL با تأیید کامل دورگرد.
  • glTF 2.0 / GLB: بارگذاری مواد PBR و خروجی‌گیری از طریق GltfSaveOptions. برای خروجی GLB از setContentType(FileContentType.BINARY) استفاده کنید.
  • FBX: پشتیبانی از واردات برای بارگذاری فایل‌های FBX (خروجی در دسترس نیست).
  • Scene-graph API: Scene، Node، Mesh، Camera، Transform.

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

  • خطوط لوله اعتبارسنجی دارایی: در CI دارایی‌های 3D را بررسی، دوباره جهت‌دهی و دوباره صادر کنید.
  • ابزارهای توسعه بازی: مش‌های OBJ و STL را به‌صورت دسته‌ای پردازش کنید بدون نیاز به موتور بومی.
  • گردش‌کارهای چاپ سه‌بعدی: فایل‌های STL را بخوانید، اعتبارسنجی کنید و دوباره صادر کنید.
  • پشت‌صحنه‌های وب: ارائهٔ نقاط انتهایی تبدیل 3D در Docker یا توابع بدون سرور.
  • مهاجرت محتوا: تبدیل بین خانواده‌های فرمت به‌صورت مقیاس‌پذیر.

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

  • جهت‌گیری سیستم مختصات: محورها را معکوس کنید و مقیاس را بر حسب هر فرمت تنظیم کنید بدون نیاز به کد سفارشی.
  • نرمال‌سازی نرمال‌ها: به‌صورت خودکار نرمال‌های راس‌ها را هنگام بارگذاری یا ذخیره‌سازی نرمال کنید.
  • کنترل بارگذاری متریال: برای تجزیه سریع‌تر، بارگذاری MTL/تکستچر را فعال یا غیرفعال کنید.
  • خروجی زیبا چاپ‌شده: از طریق گزینه‌ها، خروجی JSON glTF را به صورت فشرده یا قابل خواندن برای انسان انتخاب کنید.
  • دقت دور‌دور: گره‌های ناشناخته گراف صحنه به‌صورت دقیق هنگام ذخیره‌مجدد حفظ می‌شوند.

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

Aspose.3D FOSS برای نصب‌های Java با یک وابستگی Maven (com.aspose:aspose-3d-foss:26.1.0). این کتابخانه کاملاً Java است، بدون افزونه‌های بومی برای کامپایل و بدون نیاز به نصب بسته‌های سیستمی.

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

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

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

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

import com.aspose.threed.*;

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

// صادرات به‌صورت glTF 2.0
scene.save("model.gltf");

تبدیل STL به glTF با GltfSaveOptions

برای تولید یک فایل glTF با تنظیمات تغییر سیستم مختصات، یک نمونه GltfSaveOptions را با setFlipCoordinateSystem(true) پاس دهید. همان الگو برای تمام گزینه‌های مربوط به هر فرمت اعمال می‌شود — کلاس گزینه‌ها را برای فرمت مورد نظر خود تعویض کنید.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// ذخیره به‌صورت glTF با گزینه‌ها
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

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

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

این یک کتابخانهٔ رایگان، تحت مجوز MIT، pure-Java برای بارگذاری، دستکاری و ذخیرهٔ صحنه‌های سه‌بعدی است که بدون نصب هیچ‌یک از زمان‌اجرای بومی یا SDK خارجی کار می‌کند.

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

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

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

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

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

وابستگی Maven com.aspose:aspose-3d-foss:26.1.0 را به پروژه‌تان اضافه کنید. هیچ بستهٔ سیستمی یا افزونه بومی اضافی مورد نیاز نیست.

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

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

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

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

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

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

  

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

 فارسی