Aspose.3D FOSS for Python

הפניה ל-API עבור aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, רישיון MIT).

כל המחלקות מיובאות מ- aspose.threed חבילה או תתי‑חבילות שלה. ייבוא השורש הוא:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

גרף סצנה ליבה

MethodsMethods
Sceneמכולה ברמת העל עבור כל נתוני סצנת 3D. מחזיקה את צומת השורש, מטא‑נתוני הנכס, וקטעי האנימציה. חושפת from_file(), open(), ו save() כנקודות הכניסה הראשיות ל‑I/O.
Nodeצומת בעל שם במבנה הסצנה. מחזיק ברשימת צמתים צאצאים וברשימת Entity אובייקטים כגון רשתות, מצלמות ותאורות. נושא Transform.
Entityמחלקה בסיסית מופשטת לכל האובייקטים שניתן לצרף ל- Node. מספקת שם וזהות אך ללא גאומטריה משלה.
SceneObjectמחלקת בסיס משותפת ל- Node ו Entity. מספקת את ממשק איסוף המאפיינים המשמש למטא‑נתונים המוגדרים על‑ידי המשתמש.
A3DObjectמחלקת בסיס שורש לכל האובייקטים המנוהלים של Aspose.3D. חושפת את מאפיין השם ואת Properties אוסף.
INamedObjectממשק שמבטיח name מאפיין. מיושם על ידי Node, Entity, וסוגי מתארים ספציפיים לפורמט.

גאומטריה ורשת

MethodsMethods
Meshישות רשת פוליגון. מאחסנת נקודות שליטה (מיקומי קודקודים כ Vector4), רשימות פנים של פוליגון (רשימות של אינדקסי נקודות שליטה), ושכבות אלמנטי קודקוד (נורמליות, UVs, צבעי קודקוד).
Geometryבסיס מופשט לסוגי גיאומטריה דמויי רשת. מגדיר את מערך נקודות השליטה ואת האוסף של VertexElement שכבות. Mesh יורש מ- Geometry.
VertexElementבסיס מופשט לשכבת נתונים המחוברת לגיאומטריה (נורמליות, UVs, צבעים, וכו’). נושא mapping_mode, reference_mode, ו- data רשימה.
VertexElementNormalמאחסנת וקטור נורמלי אחד לכל קודקוד או לכל פינה של פוליגון, בהתאם ל mapping_mode. ערכי הנתונים הם FVector4 מופעים (דיוק יחיד) עם w לא בשימוש.
VertexElementUVמאחסנת נתוני קואורדינטות מרקם כ FVector4 לכל קודקוד או לכל פינה של פוליגון (רק x ו y מרכיבים משמשים ל-UV). רשת עשויה לשאת מספר שכבות UV לערוצים שונים של מרקם.
VertexElementVertexColorאוחסן נתוני צבע RGBA לכל קודקוד או לכל פינה כ FVector4 (r, g, b, a בטווח 0–1).
VertexElementSmoothingGroupאוחסן מזהי מספר שלם של קבוצות החלקה לכל פוליגון, המשמשים על ידי מייבא ה‑OBJ לשחזר את הקצאות קבוצות ההחלקה המקוריות מקובץ המקור.
VertexElementTypeמנייה המזהה את התפקיד הסמנטי של שכבת אלמנט קודקוד: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, ואחרים. העבר ערכים ל Mesh.get_element().
MappingModeמניין השולט באיזה פרימיטיב ערך של רכיב קודקוד ממופה אליו: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, או ALL_SAME.
ReferenceModeמניין השולט באופן שבו ערכים מאונדקסים: DIRECT (ערך אחד לכל פרימיטיב מיפוי) או INDEX_TO_DIRECT (מערך ערכים בתוספת מערך אינדקסים נפרד).
PolygonModifierמחלקת שירות סטטית עם שיטות לטריאנגולציה Mesh אובייקטים ו- Scene גרפים.

טרנספורמציה ומרחב

MethodsMethods
Transformטרנספורמציה מקומית המחוברת ל- Node. מספקת תרגום, סיבוב (כ Quaternion), ורכיבי קנה מידה, בנוסף לתכונות נוחות לזוויות אוילר.
GlobalTransformתצוגה לקריאה בלבד של הטרנספורמציה במרחב העולם של צומת לאחר הרכבת כל הטרנספורמציות של האבות. נגישה דרך Node.global_transform.
AssetInfoבלוק מטא-דאטה המחובר ל- Scene. מאחסן שם יישום הכתיבה, שם היחידה, גורם קנה מידה של היחידה, הגדרות צירי מערכת הקואורדינטות, וחותמות זמן של יצירה/שינוי.

חומרים והצללה

MethodsMethods
Materialמחלקת בסיס מופשטת לכל סוגי החומר. מספקת שם ואוסף מאפיינים לפרמטרים מספריים וצבעוניים.
LambertMaterialמודל חומר רק פיזור. מאחסן צבע אמביינט, צבע פיזור, צבע פולט, ושקיפות. נטען מקבצי OBJ שמשתמשים ב‑basic Ka/Kd/Ke הצהרות.
PhongMaterialMethods LambertMaterial עם צבע ספקטורלי וברק (מקדם ספקטורלי). נטען מקבצי OBJ שמשתמשים ב‑ Ks/Ns הצהרות.
PbrMaterialחומר רינדור פיזיקלי מבוסס. מאחסן אלבדו, גורם מתכתי, גורם משקעים, וטקסטורות משויכות. משמש ב‑glTF 2.0 ובפורמטים אחרים התומכים ב‑PBR.

מצלמה ותאורה

MethodsMethods
Cameraישות מצלמה. רק projection_type ו name פועלים בגרסה זו; כל שאר המאפיינים המספריים (near_plane, far_plane, field_of_view, aspect_ratio) הם תבניות שמחזירות ערכי ברירת מחדל. מצורף ל‑ Node להגדרת טרנספורמציות נקודת מבט.
Lightישות מקור אור. יורשת מ‑ Camera כמחלקת תבנית; ה‑ Light מחלקה עצמה אינה חושפת מאפיינים נוספים במהדורה זו.
LightTypeרשימת קטגוריות האור הנתמכות: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeרשימת מצבי ההקרנה של המצלמה: PERSPECTIVE ו ORTHOGRAPHIC.

כלי מתמטיקה

MethodsMethods
Vector2וקטור דו-רכיבי ברמת דיוק כפולה (x, y) המשמש לקואורדינטות טקסטורה UV.
Vector3וקטור תלת-רכיבי ברמת דיוק כפולה (x, y, z) המשמש למיקומים, כיוונים וקנה מידה.
Vector4וקטור בעל 4 רכיבים דו‑דיוק (x, y, z, w). משמש לנקודות בקרה (מיקומים הומוגניים) ונתוני נורמל.
FVector2וקטור צף בעל 2 רכיבים בדיוק יחיד. משמש פנימית לאחסון קומפקטי במערכי נתוני רכיבי קודקוד.
FVector3וקטור צף בעל 3 רכיבים בדיוק יחיד. מופיע במערכי נתוני רכיבי קודקוד לנורמליים ולמשיקים.
FVector4וקטור צף בעל 4 רכיבים בדיוק יחיד. סוג האחסון של VertexElementFVector.data.
Quaternionקוואטרניון יחידה לייצוג סיבובים (w, x, y, z). משמש על ידי Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxתיבת גבול מיושרת לציר המוגדרת על ידי minimum ו maximum Vector3 פינות. משמשת לשאילתות מרחביות ועוזרות בחיתוך פרסטרום.

Methods

MethodsMethods
AnimationClipמכולה בעלת שם למערך של ערוצים מונפשים המכסים טווח הפעלה אחד. A Scene יכול להכיל מספר קטעים (למשל, “Walk”, “Run”).
AnimationNodeקושר AnimationClip לאובייקט סצנה ספציפי או למאפיין. פועל כגשר בין נתוני הקטע לבין אובייקטי גרף הסצנה.
AnimationChannelזרם מאפיין מונפש יחיד בתוך קטע, המכוון למאפיין בעל שם על אובייקט (למשל,., Transform.translation.x).
KeyFrameדגימה יחידה של זמן‑ערך בתוך KeyframeSequence. מאחסנת את הזמן (בשניות) ואת הערך באותו זמן.
KeyframeSequenceרשימה מסודרת של KeyFrame אובייקטים לערוץ סקלרי אחד, יחד עם הגדרות אינטרפולציה ואקסטרפולציה.
Interpolationמיפוי של מצבי אינטרפולציה בין מסגרות מפתח: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeמיפוי של התנהגויות מעבר לפריים הראשון והאחרון: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

קלט/פלט של פורמט

MethodsMethods
Scene.from_file(path)מתודה סטטית. פותחת את הקובץ ב path, מזהה את הפורמט מההרחבה, ומחזירה ממולאת Scene. מעלה שגיאה כאשר הקובץ לא נמצא או בפורמט לא נתמך.
Scene.open(path, options=None)מתודה של מופע. פותחת קובץ במופע קיים Scene מופע, באופן אופציונלי באמצעות תת‑מחלקה ספציפית לפורמט LoadOptions תת‑מחלקה.
Scene.save(path, options=None)מתודה של מופע. ממירה את הסצנה ל path באמצעות הפורמט שנקבע מההרחבה, באופן אופציונלי באמצעות תת‑מחלקה ספציפית לפורמט SaveOptions תת‑מחלקה.
FileFormatרשימת פורמטים קבצים נתמכים. מכילה ערכים כגון FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. גרסאות ספציפיות לפורמט נגישות דרך מחלקות אפשרות (למשל,., ColladaSaveOptions, GltfSaveOptions).
IOServiceהפשטה פנימית של קלט/פלט המשמשת מייבאי ויצואני פורמט. בדרך כלל אינה משמשת ישירות בקוד היישום.
LoadOptionsמחלקת בסיס לכל אובייקטי אפשרות טעינה ספציפיים לפורמט. משמשת כתת‑מחלקה עבור ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsמחלקת בסיס לכל אובייקטי אפשרות שמירה ספציפיים לפורמט. משמשת כתת‑מחלקה עבור ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

פורמט OBJ

MethodsMethods
ObjImporterמחלקת מייבא פנימית שמפרשת קבצי Wavefront OBJ ו‑MTL. נקראת אוטומטית על ידי Scene.from_file() ל .obj הרחבות.
ObjLoadOptionsאפשרויות טעינה לקבצי Wavefront OBJ. תכונות מפתח: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsאפשרויות שמירה לפלט Wavefront OBJ. שולטת בנורמליות, UVs, הפניות חומרים, ובמצב ענן‑נקודות.
ObjFormatמתאר פורמט עבור Wavefront OBJ. נגיש כ FileFormat.WAVEFRONT_OBJ().

פורמט STL

MethodsMethods
StlImporterמייבא פנימי הקורא קבצי STL בינאריים ו‑ASCII כאחד. נבחר אוטומטית לפי סיומת.
StlExporterמייצא פנימי שכותב קבצי STL.
StlLoadOptionsאפשרויות טעינה לקבצי STL. תומך flip_coordinate_system ו scale.
StlSaveOptionsאפשרויות שמירה לפלט STL. שולט ב binary_mode, scale, ו flip_coordinate_system.
StlFormatמתאר פורמט עבור STL.

פורמט glTF

MethodsMethods
GltfLoadOptionsאפשרויות טעינה לקבצי glTF 2.0 ו-GLB. תכונה מרכזית: flip_tex_coord_v.
GltfSaveOptionsאפשרויות שמירה לפלט glTF 2.0. השתמש ב binary_mode=True לחבילה GLB עצמאית.
GltfFormatמתאר פורמט עבור glTF 2.0 / GLB. נגיש כ FileFormat.GLTF2().

פורמט FBX

MethodsMethods
FbxLoadOptionsאפשרויות טעינה לקבצי FBX. תכונות מרכזיות: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsאפשרויות שמירה לפלט FBX. יצוא FBX מעלה NotImplementedError בלי תנאי; FbxSaveOptions קיים אך הייצוא אינו מיושם.
FbxFormatמתאר פורמט עבור FBX. נגיש כ FileFormat.FBX7400ASCII().

פורמט COLLADA

MethodsMethods
ColladaLoadOptionsאפשרויות טעינה עבור COLLADA (.dae) קבצים. שולט במיפוי צירים וקנה מידה של יחידות בייבוא.
ColladaSaveOptionsשמור אפשרויות לפלט COLLADA. פקדים indented, flip_coordinate_system, וייצוא חומרים.
ColladaFormatמתאר פורמט עבור COLLADA. נפתר אוטומטית מ .dae סיומת קובץ.

3MF Format

MethodsMethods
ThreeMfLoadOptionsטען אפשרויות עבור 3MF (.3mf) קבצים.
ThreeMfSaveOptionsשמור אפשרויות עבור פלט 3MF. 3MF הוא הפורמט המועדף לתהליכי הדפסת תלת‑ממד.
ThreeMfFormatמתאר פורמט עבור 3MF. נגיש כ‑ FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingמזהה כיצד מרקם ממופה לגאומטריה: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, וכו׳.
BooleanOperationסוג פעולה בוליאנית של CSG: UNION, DIFFERENCE, INTERSECTION.

מערכת מאפיינים

MethodsMethods
Propertyמאפיין יחיד בעל שם וסוג על A3DObject. מאחסן את שם המאפיין, מתאר הסוג והערך הנוכחי.
PropertyCollectionאוסף איטרבילי של Property אובייקטים המחוברים ל‑ A3DObject. תומך בחיפוש לפי שם ובאיטרציה על כל המאפיינים המוגדרים.
CustomObjectקלה משקל A3DObject מחלקה משנה שנושאת רק שם ו‑ PropertyCollection. משמשת לאחסון מטא‑נתונים שהוגדרו על ידי המשתמש על אובייקטי סצנה.

תמונה ו-Render

MethodsMethods
ImageRenderOptionsאפשרויות לרסטריזציה בתוכנה בעת רינדור סצנה למאגר תמונה. מאחסנת צבע רקע, ממדי התמונה והפניה למצלמה. Scene.render() מעלה NotImplementedError; העיבוד אינו מיושם בגרסה זו.

ראה גם

 עברית