Animation

Animation — Aspose.3D FOSS for Python API Reference

Example

מערכת האנימציה Aspose.3D מאורגנת סביב היררכיה של אובייקטים הקושרים נתונים מדגמים בזמן למאפייני הסצנה.

Example AnimationClip הוא טווח הפעלה בעל שם (למשל “Walk”, “Run”) שנשמר ב- Scene.
Example AnimationNode מתקיים בתוך קטע ומקשר נתוני אנימציה לתכונות ספציפיות על עצמים בסצנה.
A BindPoint מחבר AnimationNode ל Property על A3DObject.
Example AnimationChannel מחזיק סקלר יחיד KeyframeSequence בתוך נקודת קישור.
A KeyframeSequence הוא רשימה מסודרת של KeyFrame דגימות זמן‑ערך.

כל מחלקות האנימציה נמצאות ב- aspose.threed.animation תת‑החבילה, למרות שהן נגישות גם ישירות מ- aspose.threed.

from aspose.threed.animation import (
    AnimationClip,
    AnimationNode,
    AnimationChannel,
    BindPoint,
    KeyFrame,
    KeyframeSequence,
    Interpolation,
    ExtrapolationType,
)

AnimationClip

מכולה בעלת שם עבור טווח הפעלה אחד. A Scene יכול להכיל קטעים מרובים. יורש מ- SceneObject.

Example

Example	Example
`AnimationClip(name=None)`	יוצר קטע עם שם אופציונלי

Example

Example	Example	Example
`name`	`str`	שם הקליפ (למשל. `"Walk"`)
`description`	`str`	תיאור אופציונלי
`start`	`float`	זמן התחלה בשניות
`stop`	`float`	זמן סיום בשניות
`animations`	`list[AnimationNode]`	רשימה לקריאה בלבד של צמתים של אנימציה בקטע זה
`properties`	`PropertyCollection`	מאפיינים מותאמים אישית

Example

Example	סוג החזרה	Example
`create_animation_node(node_name)`	`AnimationNode`	יוצר ומרשם חדש `AnimationNode` בקטע זה

AnimationNode

קושר AnimationClip לאחד או יותר BindPoint אובייקטים המכוונים למאפייני אובייקט‑סצנה. יורש מ A3DObject.

Example

Example	Example
`AnimationNode(name=None)`	יוצר צומת אנימציה עם שם אופציונלי

Example

Example	Example	Example
`name`	`str`	שם הצומת
`bind_points`	`list[BindPoint]`	רשימה לקריאה בלבד של נקודות קישור
`sub_animations`	`list[AnimationNode]`	רשימה לקריאה בלבד של צמתים של אנימציה לילדים
`properties`	`PropertyCollection`	מאפיינים מותאמים אישית

Example

Example	סוג החזרה	Example
`find_bind_point(target, name)`	`BindPoint	None`
`get_bind_point(target, prop_name, create)`	`BindPoint	None`
`create_bind_point(obj, prop_name)`	`BindPoint	None`
`get_keyframe_sequence(target, prop_name, channel_name, create)`	`KeyframeSequence	None`

BindPoint

מחבר את AnimationNode לאחד Property על A3DObject. כל BindPoint יכול להכיל מספר AnimationChannel אובייקטים (אחד לכל רכיב סקלרי). יורש מ A3DObject.

Example

Example	Example	Example
`property`	`Property`	המאפיין של אובייקט הסצנה שהנקודה הזו מקשרת אליו
`channels_count`	`int`	מספר ערוצי האנימציה בנקודת הקישור הזו

Example

Example	סוג החזרה	Example
`add_channel(name, value, type=None)`	`bool`	מוסיף ערוץ בשם עם ערך ברירת מחדל
`get_channel(channel_name)`	`AnimationChannel	None`
`get_keyframe_sequence(channel_name)`	`KeyframeSequence	None`
`create_keyframe_sequence(name)`	`KeyframeSequence`	יוצר חדש `KeyframeSequence` לנקודת הקישור הזו
`bind_keyframe_sequence(channel_name, sequence)`	`None`	מקשר קיים `KeyframeSequence` עם ערוץ
`reset_channels()`	`None`	מסיר את כל הערוצים

AnimationChannel

מחזיק סקלר יחיד KeyframeSequence לרכיב מונפש אחד.

Example

Example	Example	Example
`name`	`str`	שם ערוץ (למשל. `"X"`, `"Y"`, `"Z"`)
`default_value`	`Any`	הערך המשמש כאשר אין נתוני keyframe
`keyframe_sequence`	`KeyframeSequence	None`

KeyframeSequence

רשימה מסודרת של KeyFrame דגימות לערוץ סקלרי יחיד. יורש מ A3DObject.

Example

Example	Example
`KeyframeSequence(name=None)`	יוצר סדרת keyframe ריקה

Example

Example	Example	Example
`name`	`str`	שם הסדרה
`key_frames`	`list[KeyFrame]`	רשימת keyframes לקריאה בלבד בסדר כרונולוגי
`pre_behavior`	`Extrapolation`	התנהגות לפני ה-keyframe הראשון
`post_behavior`	`Extrapolation`	התנהגות אחרי ה-keyframe האחרון
`bind_point`	`BindPoint	None`

Example

Example	סוג החזרה	Example
`add(time, value, interpolation=Interpolation.LINEAR)`	`None`	מוסיף keyframe ב `time` (שניות) עם הנתון `value` ו `interpolation` מצב
`reset()`	`None`	מוחק את כל ה-keyframes ומאפס את ההתנהגות לפני/אחרי

KeyFrame

דוגמת ערך זמן יחיד ב- KeyframeSequence.

Example

KeyFrame אובייקטים נוצרו פנימית על ידי KeyframeSequence.add(); אל תבנה אותם ישירות.

Example

Example	Example	Example
`time`	`float`	מיקום זמן בשניות
`value`	`float`	ערך מונפש בזמן זה
`interpolation`	`Interpolation`	מצב אינטרפולציה המיושם בין פריים מפתח זה לפריים הבא
`tangent_weight_mode`	`WeightedMode`	מצב משקל המשיק (עקומות Bezier)
`step_mode`	`StepMode`	התנהגות שלב (`PREVIOUS_VALUE` או `NEXT_VALUE`)
`next_in_tangent`	`Vector2	None`
`out_tangent`	`Vector2	None`
`out_weight`	`float`	משקל המשיק היוצא
`next_in_weight`	`float`	משקל המשיק הנכנס
`tension`	`float`	פרמטר המתח (TCB spline)
`continuity`	`float`	פרמטר רציפות (TCB spline)
`bias`	`float`	פרמטר הטייה (TCB spline)
`independent_tangent`	`bool`	Example `True`, הטנגנטים פנימה והחוצה הם עצמאיים
`flat`	`bool`	Example `True`, הטנגנטים קבועים שטוחים
`time_independent_tangent`	`bool`	Example `True`, כיוון הטנגנט הוא עצמאי מהקנה מידה של זמן

Example

שולט באופן שבו ערכים מתווכים בין מסגרות מפתח רצופות.

Example	Example
`CONSTANT`	Example
`LINEAR`	אינטרפולציה ליניארית בין ערכים
`BEZIER`	Bezier קוביית עם טנגנטים פנימה/החוצה
`B_SPLINE`	B‑ספליין אחיד
`CARDINAL_SPLINE`	ספליין קארדינלי
`TCB_SPLINE`	ספליין מתיחות–רציפות–הטייה

Example

שולט בהתנהגות האנימציה מעבר למסגרת המפתח הראשונה והאחרונה.

Example	Example
`CONSTANT`	החזק את ערך הגבול
`GRADIENT`	הרחב בגרדיאנט המשיק של keyframe הגבול
`CYCLE`	חזור על טווח ה-keyframe (לולאות)
`CYCLE_RELATIVE`	חזור עם היסט מצטבר (יחסית לערך הסופי)
`OSCILLATE`	פינג-פונג (חזרה מתחלפת קדימה ואחורה)

Example

from aspose.threed import Scene
from aspose.threed.animation import AnimationClip, Interpolation
from aspose.threed.utilities import Vector3

scene = Scene()
node = scene.root_node.create_child_node("animated_box")
node.transform.translation = Vector3(0.0, 0.0, 0.0)

# Create an animation clip
clip = AnimationClip("Move")
clip.start = 0.0
clip.stop  = 2.0

# Create an animation node inside the clip
anim_node = clip.create_animation_node("box_anim")

# Get keyframe sequences for the X and Y translation channels
seq_x = anim_node.get_keyframe_sequence(node.transform, "Translation", "X", True)
seq_y = anim_node.get_keyframe_sequence(node.transform, "Translation", "Y", True)

if seq_x:
    seq_x.add(0.0,  0.0,  Interpolation.LINEAR)
    seq_x.add(1.0, 10.0,  Interpolation.LINEAR)
    seq_x.add(2.0,  0.0,  Interpolation.LINEAR)

if seq_y:
    seq_y.add(0.0,  0.0, Interpolation.BEZIER)
    seq_y.add(1.0,  5.0, Interpolation.BEZIER)
    seq_y.add(2.0,  0.0, Interpolation.BEZIER)

# Export to FBX to preserve animation data
scene.save("animated.fbx")

Animation — Aspose.3D FOSS for Python API Reference

Example

AnimationClip

Example

Example

Example

AnimationNode

Example

Example

Example

BindPoint

Example

Example

AnimationChannel

Example

KeyframeSequence

Example

Example

Example

KeyFrame

Example

Example

Example

Example

Example

ראה גם