התחלה

התחלה עם Aspose.3D FOSS עבור Java

ברוכים הבאים ל aspose-3d-foss, ספרייה חינמית וקוד פתוח Java לטעינה, בנייה וייצוא של סצנות תלת‑ממד. מדריך זה מוביל אותך מפרויקט חדש לסצנה עובדתית בתוך דקות.


דרישות מקדימות

דרישהפרט
JavaJDK 21 או גרסה מאוחרת יותר
כלי בנייהMaven או Gradle
OSWindows, macOS או Linux

התקנה

הוסף את תלות 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 גאומטריה, גישה לנורמליות קודקוד ו-UVs
  • טרנספורם צמתים: הגדר תזוזה, סיבוב וקנה מידה דרך ה Transform מחלקה
  • החל חומרים: הקצה Material או PbrMaterial לצמתים
  • ייצא לכל פורמט נתמך עם scene.save()
  • בנה גאומטריה: צור Mesh אובייקטים באופן תכנותי עם נקודות שליטה ופוליגונים

התחלה מהירה

טען קובץ תלת‑ממדי, הדפס את היררכיית הסצנה, ושמור מחדש בפורמט 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");
    }
}

הצעדים הבאים

 עברית