1. מוצרים
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS for Java

טעינה, יצירה, שינוי וייצוא של סצנות תלת‑ממד מ‑Java — חינמי וקוד פתוח.

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

לִלמוֹד GitHub

ספרייה קוד פתוח Java לעיבוד קבצי תלת‑ממד

Aspose.3D FOSS עבור Java היא ספרייה ברישיון MIT, pure-Java, לעבודה עם פורמטים תלת‑ממדיים. הוסיפו תלות Maven אחת והתחילו מיד לקרוא, לבנות ולכתוב סצנות תלת‑ממדיות ללא צורך בהתקנת זמן ריצה מקורי, 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 runners, מכולות Docker, וסביבות ללא שרת. אין הרחבה מקומית לקימפול ואין חבילת מערכת להתקנה.

תמיכה בפורמטים תלת‑ממדיים ו‑API של גרף סצנות

  • OBJ / MTL: טען קבצי Wavefront OBJ עם הגדרות חומרים נלוות.
  • STL: קרא וכתוב קבצי STL בינאריים ו‑ASCII עם אימות סיבוב מלא.
  • glTF 2.0 / GLB: טעינת חומרים PBR וייצוא באמצעות GltfSaveOptions. השתמש ב‑setContentType(FileContentType.BINARY) לפלט GLB.
  • FBX: תמיכה בייבוא לטעינת קבצי FBX (ייצוא אינו זמין).
  • Scene-graph API: Scene, Node, Mesh, Camera, Transform.

היכן ניתן להשתמש ב-Aspose.3D FOSS

  • צינורות אימות נכסים: אמת, הפוך מחדש, וייצא מחדש נכסי 3D ב‑CI.
  • כלי פיתוח משחקים: עיבוד אצווה של רשתות OBJ ו‑STL ללא מנוע מקורי.
  • תהליכי הדפסת תלת‑ממד: קרא, אמת, וייצא מחדש קבצי STL.
  • Web backends: משרת נקודות קצה של המרת 3D ב‑Docker או בפונקציות ללא שרת.
  • Content migration: המרה בין משפחות פורמטים בקנה מידה גדול.

אפשרויות לכל פורמט ושליטה בקואורדינטות

  • כיוון מערכת הקואורדינטות: הפוך צירים והתאם קנה מידה לפי פורמט ללא קוד מותאם אישית.
  • נרמול נורמליים: נרמל באופן אוטומטי את נורמליות הקודקודים בטעינה או שמירה.
  • בקרת טעינת חומרים: אפשר או בטל טעינת 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);

Frequently Asked Questions

מהו Aspose.3D FOSS עבור Java?

זהו ספרייה חינמית, ברישיון MIT, pure-Java לטעינה, מניפולציה ושמירת סצנות תלת‑ממד ללא צורך בהתקנת זמן ריצה מקורי או SDK חיצוני.

אילו פורמטים תלת‑ממד נתמכים?

OBJ (עם .mtl), STL (בינארי ו‑ASCII), glTF 2.0, GLB (glTF בינארי), ו‑FBX (יבוא בלבד). לכל פורמט יש מחלקת אפשרויות טעינה/שמירה ייעודית.

האם הוא דורש תלותיות מקומיות?

לא. Aspose.3D FOSS עבור Java הוא pure Java ללא הרחבות מקומיות. הוא פועל ב‑Windows, macOS ו‑Linux ללא צורך בצעד קומפילציה.

איך מתקינים אותו?

הוסף את תלות Maven com.aspose:aspose-3d-foss:26.1.0 לפרויקט שלך. אין צורך בחבילות מערכת נוספות או הרחבות מקומיות.

האם אני יכול לשלוט בכיוון מערכת הקואורדינטות?

כן. מחלקות אפשרויות לכל פורמט מאפשרות לך להפוך צירים, להתאים קנה מידה, ולנרמל נורמליות ללא כתיבת קוד ניתוח ספציפי לפורמט.

אילו גרסאות של Java נתמכות?

Java 21 ומעלה נתמכים. הספרייה פועלת באופן זהה על כל מערכות ההפעלה המרכזיות.

האם קוד המקור זמין?

כן. הספרייה ברישיון MIT ומתארחת ב‑GitHub. דיווחי באגים ובקשות משיכה מוזמנים.

  

משאבי תמיכה ולמידה

 עברית