شروع کار

شروع کار با Aspose.3D FOSS برای Java

خوش آمدید به aspose-3d-foss, یک کتابخانه رایگان و متن‌باز Java برای بارگذاری، ساخت و خروجی‌گیری صحنه‌های 3D است. این راهنما شما را از یک پروژه تازه تا یک صحنهٔ کارآمد در عرض چند دقیقه می‌برد.

پیش‌نیازها

نصب

وابستگی Maven را به pom.xml:

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

تأیید کنید:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

به راهنمای نصب برای راه‌اندازی Gradle و مراحل تأیید.

کارهایی که می‌توانید انجام دهید

پس از نصب می‌توانید بلافاصله:

• بارگذاری فایل‌های OBJ، STL، glTF 2.0 / GLB و FBX از طریق scene.open()
• بازرسی سلسله‌مراتب صحنه: پیمایش Node درخت‌ها، خواندن Mesh هندسه، دسترسی به نرمال‌های راس و UVها
• Transform گره‌ها: تنظیم انتقال، چرخش و مقیاس از طریق Transform کلاس
• اعمال متریال‌ها: اختصاص Material یا PbrMaterial به گره‌ها
• صادرات به هر قالب پشتیبانی‌شده با scene.save()
• ساخت هندسه: ایجاد Mesh اشیاء را به‌صورت برنامه‌نویسی با نقاط کنترل و چندضلعی‌ها

شروع سریع

یک فایل 3D را بارگذاری کنید، سلسله‌مراتب صحنه را چاپ کنید، و دوباره در قالب GLB ذخیره کنید:

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

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

مراحل بعدی

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