چگونه با Aspose.3D FOSS برای جاوا شروع کنیم Java

چگونه با Aspose.3D FOSS برای جاوا شروع کنیم Java

Aspose.3D FOSS برای جاوا یک کتابخانه رایگان و مجوز MIT برای بارگذاری، دستکاری و ذخیره فایل های 3D است – هیچ دوگانه بومی مورد نیاز نیست، خالص جاو از Maven Central.

راهنمای گام به گام

مرحله اول: اضافه کردن اعتیاد به Maven

این اعتیاد را به خودتان اضافه کنید. pom.xml (Java 21 یا بعد از آن مورد نیاز است):

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

بررسی نصب شده به درستی:

import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");

مرحله دوم: کلاس های مورد نیاز واردات

واردات کلاس های اصلی برای بارگذاری صحنه و دستکاری:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

مرحله 3: فایل 3D را بارگذاری کنید.

استفاده از Scene.fromFile() برای هر فرمت پشتیبانی شده، کتابخانه می تواند فرم را تشخیص دهد. به صورت اتوماتیک از فایل افزونه:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());

یا از آن استفاده کنید. open() روش موردی :

Scene scene = new Scene();
scene.open("model.glb");

مرحله چهارم: از روی صحنه عبور کنید.

یک صحنه بارگذاری شده، درختی است که در آن Node اشیاء ریشه دار در scene.getRootNode():

import com.aspose.threed.Node;
import com.aspose.threed.Scene;

void walk(Node node, int depth) {
    String indent = " ".repeat(depth * 2);
    System.out.println(indent + "Node: " + node.getName());
    for (Node child : node.getChildNodes()) {
        walk(child, depth + 1);
    }
}

Scene scene = Scene.fromFile("model.obj");
walk(scene.getRootNode(), 0);

مرحله 5: ذخیره به فرمت های مختلف

استفاده از Scene.save() برای هر نوع از کتابخانه ها، به صورت زیر می توانید آن را مشاهده کنید. فرمت خروجی از فایل افزونه:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");

مشکلات و اصلاحات مشترک

FileNotFoundException وقتی تماس می گیرند Scene.fromFile() مسیر عبور شما وجود ندارد یا از جداساز اشتباه استفاده می کند. java.nio.file.Paths.get() برای اطمینان از اینکه مسیر فایل صحیح است.

خطای ناشناخته فرمت اطمینان حاصل کنید که فایل ها با فرمت واقعی مطابقت دارند.کتابخانه فرم را تشخیص می دهد تمدید برای open() و fromFile().یک پارامتر مشخصی را برای عبور از آن وارد کنید.

صحنه خالی پس از بارگذاری برخی از فرمت های باینری ممکن است نیاز به گزینه های بار خاص داشته باشند. سعی کنید با استفاده از یک بار اضافی صریح با گزینه های بارگذاری اگر پیش فرض یک صحنه خالی تولید می کند.

UnsupportedOperationException برای روش های خاص برخی از روش ها (نمایش صحنه، برچسب آب) در نسخه FOSS در دسترس نیست. قبل از استفاده از ویژگی های پیشرفته، مستندات محدودیت ها را بررسی کنید.

پرسش های متداول

آیا Aspose.3D FOSS نیاز به هر DLL های بومی دارد؟?

کتابخانه خالص جاوا است و هیچ وابستگی های بومی یا دوگانه خارجی مورد نیاز نیست.

کدام نسخه های جاوا پشتیبانی می شوند؟?

جاوا 21 یا بعد از آن. کتابخانه در ویندوز، macOS، لینوکس و داکر کانتینر اجرا می شود.

آیا کتابخانه برای استفاده تجاری رایگان است؟?

بله، تحت مجوز MIT منتشر می شود.شما می توانید آن را برای هر هدف از جمله برنامه های تجاری استفاده کنید، ویرایش و توزیع مجدد.

چه فرمت های 3D را می توانم بخوانم و بنویسم؟?

کتابخانه از OBJ، STL، glTF 2.0 / GLB و FBX برای خواندن و نوشتن پشتیبانی می کند. استفاده از آن Scene.save() API مبتنی بر افزونه برای صادرات به هر فرمت پشتیبانی شده.

آیا می توانم یک صحنه 3D را از اسکاتچ ایجاد کنم؟?

بله، ساختن یک Scene بدون هیچ گونه استدلال، اضافه کردن گره های کودک به scene.getRootNode(),و به فرمت مورد نظر برسید.

همچنین ببینید

 فارسی