תיעוד API עבור aspose-3d-foss 26.1.0 (Java 21+, רישיון MIT).
כל המחלקות ממוקמות ב- com.aspose.threed חבילת השורש. הייבוא הראשי הוא:
מבנה החבילות: כמעט כל המחלקות הציבוריות נמצאות ב- com.aspose.threed. תת‑החבילה היחידה שבדרך כלל משמשת היא com.aspose.threed.shading (ל PbrMaterial). ה com.aspose.threed.formats תת‑החבילה מכילה מייבאים/מייצאים פנימיים ולא בדרך כלל מיובאת ישירות.
Java קונבנציית שמות: כל המאפיינים משתמשים במתודות getter/setter. לדוגמה, השתמש ב- node.getTransform() במקום node.transform, ו transform.setTranslation(...) במקום transform.translation = .... שים לב ש Vector3, Vector4, Quaternion, Matrix4, ו FVector סוגים משתמשים שדות ציבוריים (v.x, v.y, v.z) במקום getters לגישה לרכיבים.
גרף סצנה מרכזי
| Enumerations | Enumerations |
|---|
Scene | מכולה ברמת העל עבור כל נתוני הסצנה בתלת‑ממד. מכילה את צומת השורש, מטא‑נתוני הנכסים, וקטעי האנימציה. חושפת fromFile(), open(), ו save() כנקודות הכניסה הראשיות לקלט/פלט. |
Node | צומת בעל שם במבנה ההיררכי של הסצנה. מחזיק ברשימת צמתים צאצאים וברשימת מצורפים Entity אובייקטים כגון רשתות, מצלמות ותאורות. נושא מקומי Transform. |
Entity | מחלקה בסיסית מופשטת לכל האובייקטים שניתן לצרף ל Node. מספקת שם וזהות אך ללא גאומטריה משלה. |
SceneObject | מחלקת בסיס משותפת ל Node ו Entity. |
A3DObject | מחלקת בסיס שורש לכל האובייקטים המנוהלים של Aspose.3D. חושפת את מאפיין השם ואת Properties האוסף. |
INamedObject | ממשק שמבטיח getName() מתודה. ממומש על ידי Node, Entity, וכמה סוגי מתארים ספציפיים לפורמט. |
גאומטריה ורשת
| Enumerations | Enumerations |
|---|
Mesh | ישות רשת פוליגון. מאחסנת נקודות שליטה (מיקומי קודקוד כ Vector4), רשימות פנים של פוליגון (רשימות של אינדקסי נקודות שליטה), ושכבות אלמנטי קודקוד (נורמליות, UVs, צבעי קודקוד). |
Geometry | בסיס מופשט לסוגי גיאומטריה דמויי רשת. מגדיר את מערך נקודות השליטה ואת האוסף של VertexElement שכבות. Mesh יורש מ Geometry. |
VertexElement | בסיס מופשט לשכבת נתונים המחוברת לגאומטריה (נורמליות, UVs, צבעים, וכו’). נושא getMappingMode(), getReferenceMode(), ורשימת נתונים. |
VertexElementNormal | מאחסן וקטור נורמל אחד לכל קודקוד או לכל פינת פוליגון, בהתאם למצב המיפוי. ערכי הנתונים הם Vector4 מופעים עם w לא בשימוש. |
VertexElementUV | מאחסן זוגות קואורדינטות מרקם (Vector2) לכל קודקוד או לכל פינת פוליגון. רשת עשויה לשאת שכבות UV מרובות לערוצי מרקם שונים. |
VertexElementVertexColor | מאחסן נתוני צבע RGBA לכל קודקוד או לכל פינה כ Vector4 (r, g, b, a בטווח 0–1). |
VertexElementType | מנייה המזהה את התפקיד הסמנטי של שכבת אלמנט קודקוד: NORMAL, UV, VERTEX_COLOR, ואחרים. העבר ערכים ל Mesh.getElement(). |
MappingMode | מנייה השולטת לאיזה פרימיטיב ערך אלמנט קודקוד ממופה: CONTROL_POINT, POLYGON_VERTEX, או POLYGON. |
ReferenceMode | מנייה השולטת כיצד ערכים מאונדקסים: DIRECT (ערך אחד לכל פרימיטיב מיפוי) או INDEX_TO_DIRECT (מערך ערכים בתוספת מערך אינדקסים נפרד). |
טרנספורם ומרחב
| Enumerations | Enumerations |
|---|
Transform | טרנספורמציה מקומית המחוברת ל- Node. מספקת תזוזה, סיבוב (כ Quaternion), ורכיבי קנה מידה, בנוסף לשיטות נוחות לזוויות אוילר. |
GlobalTransform | תצוגה לקריאה בלבד של שינוי המרחב העולמי של צומת לאחר הרכבת כל שינויי האבות. נגישה דרך node.getGlobalTransform(). |
AssetInfo | בלוק מטא-נתונים מצורף ל- Scene. מאחסן שם יישום הכתיבה, שם היחידה, גורם קנה מידה של היחידה, הגדרות צירי מערכת הקואורדינטות, וחותמות זמן של יצירה/שינוי. |
חומרים והצללה
| Enumerations | Enumerations |
|---|
Material | מחלקת בסיס מופשטת לכל סוגי החומרים. מספקת שם ואוסף מאפיינים לפרמטרים מספריים וצבעיים. |
PbrMaterial | חומר רינדור פיזיקלי מבוסס (Physically Based Rendering). מאחסן אלבדו, גורם מתכתי, גורם גסות, צבע פולט, שקיפות, וטקסטורות משויכות. משמש ב‑glTF 2.0 ובפורמטים אחרים התומכים ב‑PBR. ייבוא: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | ישות מצלמה. יורשת מ- Entity. אין מאפיינים ספציפיים לפורמט החשופים בגרסת Java FOSS מעבר לשם ולאוסף המאפיינים שהורש. מצורפת ל- Node כדי להגדיר שינויי נקודת מבט. |
הערה: Enumerations Light המחלקה אינה זמינה בגרסת Java של Aspose.3D FOSS. נתוני התאורה של הסצנה מקבצים מיובאים מאוחסנים כ- Entity אובייקטים.
כלי מתמטיקה
| Enumerations | Enumerations |
|---|
Vector2 | וקטור דו‑רכיבי ברמת דיוק כפולה (x, y). משמש לקואורדינטות טקסטורה UV. |
Vector3 | וקטור תלת‑רכיבי ברמת דיוק כפולה (x, y, z). משמש למיקומים, כיוונים וקנה מידה. |
Vector4 | וקטור ארבע‑רכיבי ברמת דיוק כפולה (x, y, z, w). משמש לנקודות בקרה (מיקומים הומוגניים) ונתוני נורמל. |
FVector3 | וקטור float בת 3 רכיבים בדיוק יחיד. מופיע במערכי נתוני רכיבי קודקוד עבור נורמליים וטנגנטים. |
FVector4 | וקטור float בת 4 רכיבים בדיוק יחיד. סוג האחסון של VertexElementFVector נתונים. |
Quaternion | קוואטרניון יחיד לייצוג סיבובים (w, x, y, z). משמש ב Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | תיבת גבול מיושרת לציר המוגדרת על ידי getMinimum() ו getMaximum() Vector3 פינות. משמש לשאילתות מרחביות ועוזרי frustum culling. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | מכולה בעלת שם לטווח אנימציה. A Scene יכול להכיל מספר קטעים (למשל, “Walk”, “Run”). תבנית הצהרה — נתוני keyframe והפעלה עדיין לא מומשו. |
קלט/פלט של פורמט
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | מתודה סטטית. פותחת את הקובץ ב path, מזהה את הפורמט מההרחבה, ומחזירה Scene. זורקת שגיאה כאשר הקובץ לא נמצא או שהפורמט אינו נתמך. |
Scene.open(path, options) | מתודה של מופע. פותחת קובץ לתוך Scene מופע קיים, באופן אופציונלי תוך שימוש ב LoadOptions מחלקה נגזרת. |
Scene.save(path, options) | מתודה של מופע. מסדרת את הסצנה ל path באמצעות הפורמט שנקבע מההרחבה, באופן אופציונלי באמצעות פורמט-ספציפי SaveOptions מחלקה משנית. |
FileFormat | רישום של פורמטים קבצים נתמכים. מכיל ערכים כגון FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | הפשטה פנימית של קלט/פלט המשמשת מייבאי ומייצאי פורמטים. בדרך כלל אינה משמשת ישירות בקוד היישום. |
LoadOptions | מחלקת בסיס לכל אובייקטי אפשרויות טעינה ספציפיות לפורמט. משמשת כמחלקת‑על עבור ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | מחלקת בסיס לכל אובייקטי אפשרויות שמירה ספציפיות לפורמט. משמשת כמחלקת‑על עבור ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
פורמט OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | מחלקת מייבא פנימית שמפרשת קבצי Wavefront OBJ ו‑MTL. מופעלת אוטומטית על‑ידי Scene.fromFile() ל .obj הרחבות. |
ObjLoadOptions | אפשרויות טעינה לקבצי Wavefront OBJ. תכונות מפתח: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | אפשרויות שמירה לפלט Wavefront OBJ. שולט ב‑normals, UVs, הפניות חומרים, ובמצב ענן‑נקודות. |
ObjFormat | מתאר פורמט עבור Wavefront OBJ. נגיש כ‑ FileFormat.WAVEFRONT_OBJ(). |
פורמט STL
| Enumerations | Enumerations |
|---|
StlImporter | מייבא פנימי הקורא קבצי STL בינריים ו‑ASCII. נבחר אוטומטית לפי הרחבה. |
StlExporter | מייצא פנימי כותב קבצי STL. |
StlLoadOptions | אפשרויות טעינה לקבצי STL. תומך ב‑ setFlipCoordinateSystem(), setRecalculateNormal(), ו‑ setContentType(). |
StlSaveOptions | אפשרויות שמירה לפלט STL. שולט ב‑ setFlipCoordinateSystem(), setAxisSystem(), ו‑ setContentType(). |
StlFormat | מתאר פורמט עבור STL. |
פורמט glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | טען אפשרויות עבור קבצי glTF 2.0 ו-GLB. תכונות מפתח: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | שמור אפשרויות עבור פלט glTF 2.0 ו-GLB. השתמש setContentType(FileContentType.BINARY) ליצור חבילה .glb עצמאית. |
GltfFormat | מתאר פורמט עבור glTF 2.0 / GLB. נגיש כ‑ FileFormat.GLTF2(). |
פורמט FBX
FBX נתמך עבור יבוא בלבד. יצוא ל‑FBX אינו זמין בגרסת Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | אפשרויות טעינה לקבצי FBX. מאפיין מפתח: setFlipCoordinateSystem(). |
FbxFormat | מתאר פורמט עבור FBX. נגיש כ‑ FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | מזהה ציר קואורדינטות: X_AXIS, Y_AXIS, Z_AXIS. משמש באפשרויות מיפוי מחדש של מערכת הקואורדינטות. |
CoordinateSystem | מציין קונבנציית ידיות: RIGHT_HANDED או LEFT_HANDED. |
TextureMapping | מזהה כיצד מרקם ממופה לגיאומטריה: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, וכו'. |
BooleanOperation | סוג פעולה בוליאנית של CSG: UNION, DIFFERENCE, INTERSECTION. |
מערכת מאפיינים
| Enumerations | Enumerations |
|---|
Property | מאפיין יחיד בעל שם וסוג על A3DObject. מאחסן את שם המאפיין, מתאר הסוג, והערך הנוכחי. |
PropertyCollection | אוסף איטרטיבי של Property אובייקטים מצורפים ל- A3DObject. תומך בחיפוש לפי שם ובאיטרציה על כל המאפיינים המוגדרים. |
CustomObject | קַל משקל A3DObject מחלקה משנה שנושאת רק שם ושרירותי PropertyCollection. משמש לאחסון מטא‑נתונים מוגדרים על ידי המשתמש על אובייקטי סצנה. |
תמונה והדמיה
| Enumerations | Enumerations |
|---|
ImageRenderOptions | אפשרויות ל‑software rasterisation בעת רינדור סצנה למאגר תמונה. מאחסנת צבע רקע, ממדי תמונה והפניה למצלמה. תכונה זו זמינה בתצורות נתמכות. |
ראה גם
