תיעוד API עבור Aspose.3D 26.1.0 (.NET 10.0+, רישיון MIT).
כל המחלקות נמצאות ב- Aspose.ThreeD מרחב השמות הראשי. הפקודה using הראשית היא:
קונבנציית שמות ב‑C#: כל המאפיינים משתמשים בתחביר המאפיינים הסטנדרטי של C#. לדוגמה, השתמש ב- scene.RootNode במקום scene.getRootNode(), ו transform.Translation = ... במקום transform.setTranslation(...).
קייסינג של שדה וקטורי: הספרייה כוללת שני סטים של סוגי וקטורים. Aspose.ThreeD.Utilities.Vector2/3/4 (משמש ב Mesh.ControlPoints, גאומטריה, ורוב פעולות המתמטיקה) הם דיוק כפול עם אותיות קטנות שדות ציבוריים (v.x, v.y, v.z, v.w). הפשוט יותר Aspose.ThreeD.Vector2/3/4 מבנים (ב Vector.cs) הם דיוק יחיד (float) עם אותיות רישיות שדות ציבוריים (v.X, v.Y, v.Z). FVector2/3/4 ו Quaternion ו Matrix4 השתמש בגישה לשדות באותיות גדולות. Aspose.ThreeD.Utilities סוגים לעבודה עם גאומטריה.
גרף סצנה מרכזי
| Methods | Methods |
|---|
Scene | מכולה ברמת העל עבור כל נתוני הסצנה בתלת‑ממד. מחזיקה את צומת השורש, מטא‑נתוני הנכס, וקלאפי האנימציה. חושפת Open() ו Save() כנקודות הכניסה הראשיות ל‑I/O. |
Node | צומת בעל שם במבנה הסצנה. מחזיק ברשימת צמתים צאצאים וברשימת מצורפים Entity אובייקטים כגון רשתות, מצלמות ותאורות. נושא מקומי Transform. |
Entity | מחלקה בסיסית מופשטת לכל האובייקטים שניתן לצרף ל‑ Node. מספק שם וזהות אך אין לו גאומטריה משלו. |
SceneObject | מחלקת בסיס משותפת ל Node ו Entity. מספק את ממשק איסוף המאפיינים המשמש למטא-נתונים המוגדרים על ידי המשתמש. |
A3DObject | מחלקת בסיס שורש לכל האובייקטים המנוהלים של Aspose.3D. חושפת את Name המאפיין וה Properties אוסף. |
INamedObject | ממשק שמבטיח Name מאפיין. מיושם על ידי Node, Entity, וסוגי מתארים ספציפיים לפורמט שונים. |
גאומטריה ורשת
| Methods | Methods |
|---|
Mesh | ישות רשת פוליגון. מאחסנת נקודות שליטה (מיקומי קודקוד כ Vector4), רשימות פנים של פוליגון (רשימות של אינדקסי נקודות שליטה), ושכבות אלמנטי קודקוד (נורמליות, UVs, צבעי קודקוד). |
Geometry | בסיס מופשט לסוגי גיאומטריה דמויי רשת. מגדיר את מערך נקודות השליטה ואת האוסף של VertexElement שכבות. Mesh יורש מ Geometry. |
VertexElement | בסיס מופשט לשכבת נתונים המחוברת לגאומטריה (נורמליות, UVs, צבעים, וכו’). נושא MappingMode, ReferenceMode, ורשימת נתונים. |
VertexElementNormal | מאחסן וקטור נורמלי אחד לכל קודקוד או לכל פינת פוליגון, בהתאם למצב המיפוי. |
VertexElementUV | מאחסן זוגות של קואורדינטות מרקם (Vector2) לכל קודקוד או לכל פינת פוליגון. |
VertexElementVertexColor | אוחסן נתוני צבע RGBA לכל קודקוד או לכל פינה כ Vector4. |
פרימיטיבים מובנים
| Methods | Methods |
|---|
Box | תיבה פרמטרית מיושרת לציר עם רוחב, גובה ועומק שניתנים להגדרה. ניתן לצרף ל Node ישירות או מומר ל Mesh באמצעות ToMesh(). |
Sphere | כדור פרמטרי עם רדיוס שניתן להגדרה. תומך ToMesh() המרה. |
Cylinder | צילינדר פרמטרי עם רדיוס עליון, רדיוס תחתון וגובה שניתן להגדרה. תומך ToMesh() המרה. |
טרנספורם ומרחב
| Methods | Methods |
|---|
Transform | טרנספורמציה מקומית המחוברת ל- Node. מספק Translation (FVector3), Rotation (Quaternion), Scale (FVector3), ו Matrix (Matrix4) מאפיינים. |
GlobalTransform | תצוגה לקריאה בלבד של מטריצת ההמרה במרחב העולם של צומת לאחר הרכבת כל ההמרות של האבות. נגישה דרך node.GlobalTransform. חושף יחיד Matrix תכונה. |
AssetInfo | בלוק מטא‑נתונים מצורף ל‑ Scene. יורש מ‑ A3DObject מספק Name ו Properties. לא מוגדרות תכונות נוספות במהדורה זו. |
חומרים והצללה
| Methods | Methods |
|---|
Material | מחלקה בסיסית מופשטת לכל סוגי החומר. מספקת שם ואוסף מאפיינים. |
LambertMaterial | חומר קלאסי פיזור-בלעדי עם Ambient, Diffuse, Emissive, Reflective, Transparency, ו Texture מאפיינים. מרחב שמות: Aspose.ThreeD.Shading. |
PhongMaterial | מרחיב את Lambert עם Specular, Shininess, ו SpecularPower מאפיינים. מרחב שמות: Aspose.ThreeD.Shading. |
PbrMaterial | חומר רינדור מבוסס פיזיקה עם BaseColor, Metallic, Roughness, Occlusion, ותכונות משבצת מרקם. מרחב שם: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | ישות מצלמה. יורשת מ- Frustum. מצורפת ל- Node להגדיר טרנספורמציות נקודת מבט. אין תכונות ספציפיות לפורמט שנחשפות במהדורה זו. |
כלי מתמטיקה
| Methods | Methods |
|---|
Vector2 | דיוק כפול 2-component vector (lowercase fields: x, y). מרחב שמות: Aspose.ThreeD.Utilities. משמש לתיאומי מרקם UV. |
Vector3 | דיוק כפול 3-component vector (lowercase fields: x, y, z). מרחב שמות: Aspose.ThreeD.Utilities. וקטור מרחבי כללי עבור גאומטריה. |
Vector4 | דו-דיוק 4-component vector (lowercase fields: x, y, z, w). מרחב שם: Aspose.ThreeD.Utilities. משמש ל Mesh.ControlPoints ולנתונים רגילים. |
FVector3 | דיוק יחיד וקטור צף בעל 3 רכיבים (שדות באותיות גדולות: X, Y, Z). בשימוש על ידי Transform.Translation ו Transform.Scale. |
FVector4 | וקטור צף בעל 4 רכיבים בדיוק יחיד (שדות באותיות גדולות: X, Y, Z, W). |
Quaternion | קווטרניון יחידה לייצוג סיבובים (W, X, Y, Z). בשימוש על ידי Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | תיבה תוחמת מיושרת לציר המוגדרת על ידי Minimum ו Maximum FVector3 פינות. |
Methods
| Methods | Methods |
|---|
AnimationClip | מכולה בשם לטווח אנימציה. A Scene יכול להכיל מספר קטעים. תבנית הצהרה — נתוני keyframe והפעלה עדיין לא מומשו. |
קלט/פלט של פורמט
| Methods | Methods |
|---|
Scene.Open(path) | פותח קובץ, מזהה את הפורמט מההרחבה, וממלא את הסצנה. |
Scene.Open(path, options) | פותח קובץ עם פורמט-ספציפי LoadOptions. |
Scene.Open(stream) | פותח מזרם, מזהה אוטומטית את הפורמט מהתוכן. |
Scene.Open(stream, options) | פותח מזרם עם פורמט-ספציפי LoadOptions. |
Scene.Save(path) | שומר את הסצנה לקובץ; הפורמט נובע מהסיומת. |
Scene.Save(path, options) | שומר עם פורמט-ספציפי SaveOptions. |
Scene.Save(stream, options) | שומר לזרם עם פורמט-ספציפי SaveOptions. |
FileFormat | רשימת פורמטים נתמכים. השתמש FileFormat.Formats (an IList<FileFormat>) כדי למנות את כל הפורמטים הנתמכים, או FileFormat.Detect(fileName) כדי לזהות פורמט לפי שם קובץ. הקבועים בשם (ObjFormat, GltfFormat, FbxFormat, וכו’) הם internal ולא נגיש מקוד המשתמש. |
IOService | הפשטה פנימית של קלט/פלט. מספקת DetectFormat() לזיהוי פורמט מבוסס זרם. |
LoadOptions | מחלקה בסיסית לאפשרויות טעינה ספציפיות לפורמט. |
SaveOptions | מחלקה בסיסית לאפשרויות שמירה ספציפיות לפורמט. |
פורמט OBJ
פורמט STL
פורמט glTF
| Methods | Methods |
|---|
GltfLoadOptions | טען אפשרויות עבור קבצי glTF 2.0 ו‑GLB. |
GltfSaveOptions | אפשרויות שמירה עבור glTF 2.0 ופלט GLB. אין חשיפה של מאפיינים ספציפיים לפורמט בגרסה זו; השתמש .glb הרחבה לפלט בינארי. |
פורמט FBX
| Methods | Methods |
|---|
FbxLoadOptions | אפשרויות טעינה עבור קבצי FBX. |
FbxSaveOptions | אפשרויות שמירה עבור פלט FBX. ייצוא FBX תמיד מייצר פלט בינארי; ייצוא FBX בפורמט ASCII אינו פעיל בגרסה זו. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | מתאר סוג תוכן: ASCII, Binary. זמין כמאפיין ב FileFormat. |
Axis | מזהה ציר קואורדינטה: XAxis, YAxis, ZAxis. |
CoordinateSystem | מציין קונבנציה של כיוון יד: RightHand או LeftHand. |
מערכת מאפיינים
| Methods | Methods |
|---|
Property | תכונה אחת בעלת שם וסוג על A3DObject. |
PropertyCollection | אוסף איטרטיבי של Property אובייקטים מצורפים ל A3DObject. |
ראה גם
