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

یک محفظه نام‌دار برای یک بازه پخش. یک 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_sequence`	`KeyframeSequence	None`

KeyframeSequence

یک فهرست مرتب از KeyFrame نمونه‌ها برای یک کانال اسکالر تک. ارث‌بری از A3DObject.

Example

Example	Example
`KeyframeSequence(name=None)`	یک دنباله فریم کلیدی خالی ایجاد می‌کند

Example

Example	Example	Example
`name`	`str`	نام دنباله
`key_frames`	`list[KeyFrame]`	فهرست فقط‑خواندنی فریم‌های کلیدی به ترتیب زمانی
`pre_behavior`	`Extrapolation`	رفتار قبل از اولین فریم کلیدی
`post_behavior`	`Extrapolation`	رفتار پس از آخرین فریم کلیدی
`bind_point`	`BindPoint	None`

Example

Example	نوع بازگشت	Example
`add(time, value, interpolation=Interpolation.LINEAR)`	`None`	یک فریم کلیدی را در `time` (ثانیه) با مقدار داده شده `value` و `interpolation` حالت
`reset()`	`None`	تمام فریم‌های کلیدی را پاک می‌کند و رفتار پیش/پس را بازنشانی می‌نماید

KeyFrame

یک نمونه تک‌مقدار زمان در یک KeyframeSequence.

Example

KeyFrame اشیاء به‌صورت داخلی توسط KeyframeSequence.add(); آن‌ها را به‌صورت مستقیم ساخت نکنید.

Example

Example	Example	Example
`time`	`float`	موقعیت زمان به ثانیه
`value`	`float`	مقدار انیمیشن در این زمان
`interpolation`	`Interpolation`	حالت درون‌یابی اعمال‌شده بین این فریم کلیدی و فریم بعدی
`tangent_weight_mode`	`WeightedMode`	حالت وزن تانژانت (Bezier curves)
`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)
`bias`	`float`	پارامتر بایاس (اسپلین TCB)
`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

موارد مرتبط