Animation

Animation — Aspose.3D FOSS for Python API Reference

Example

Systém animácie Aspose.3D je organizovaný okolo hierarchie objektov, ktoré viažu časovo vzorkované dáta na vlastnosti scény.

Example AnimationClip je pomenovaný rozsah prehrávania (napr. “Walk”, “Run”) držaný Scene.
Example AnimationNode žije vnútri klipu a viaže animované dáta na konkrétne vlastnosti objektov scény.
A BindPoint spája AnimationNode k pomenovanému Property na A3DObject.
Example AnimationChannel obsahuje jeden skalár KeyframeSequence v rámci bodu viazania.
A KeyframeSequence je usporiadaný zoznam KeyFrame časovo‑hodnotové vzorky.

Všetky triedy animácie sú v aspose.threed.animation podbalíku, hoci sú tiež priamo prístupné z aspose.threed.

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

AnimationClip

Pomenovaný kontajner pre jeden rozsah prehrávania. A Scene môže obsahovať viacero klipov. dedí od SceneObject.

Example

Example	Example
`AnimationClip(name=None)`	Vytvorí klip s voliteľným názvom

Example

Example	Example	Example
`name`	`str`	Názov klipu (napr. `"Walk"`)
`description`	`str`	Voliteľný popis
`start`	`float`	Počiatočný čas v sekundách
`stop`	`float`	Koncový čas v sekundách
`animations`	`list[AnimationNode]`	Zoznam animačných uzlov v tomto klipe len na čítanie
`properties`	`PropertyCollection`	Vlastné vlastnosti

Example

Example	Návratový typ	Example
`create_animation_node(node_name)`	`AnimationNode`	Vytvorí a zaregistruje nový `AnimationNode` v tomto klipe

AnimationNode

Viaže AnimationClip k jednému alebo viacerým BindPoint objektom zameraným na vlastnosti scény-objektu. Dedičí od A3DObject.

Example

Example	Example
`AnimationNode(name=None)`	Vytvorí animačný uzol s voliteľným názvom

Example

Example	Example	Example
`name`	`str`	Názov uzla
`bind_points`	`list[BindPoint]`	Zoznam väzbových bodov len na čítanie
`sub_animations`	`list[AnimationNode]`	Zoznam podriadených animačných uzlov len na čítanie
`properties`	`PropertyCollection`	Vlastné vlastnosti

Example

Example	Návratový typ	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

Pripojí AnimationNode k jednému Property na A3DObject. Každý BindPoint môže obsahovať viacero AnimationChannel objektov (jeden na skalárnu komponentu). Dedičí od A3DObject.

Example

Example	Example	Example
`property`	`Property`	Vlastnosť scény-objektu, na ktorú tento väzobný bod smeruje
`channels_count`	`int`	Počet animačných kanálov v tomto väzobnom bode

Example

Example	Návratový typ	Example
`add_channel(name, value, type=None)`	`bool`	Pridá pomenovaný kanál s predvolenou hodnotou
`get_channel(channel_name)`	`AnimationChannel	None`
`get_keyframe_sequence(channel_name)`	`KeyframeSequence	None`
`create_keyframe_sequence(name)`	`KeyframeSequence`	Vytvorí nový `KeyframeSequence` pre tento väzobný bod
`bind_keyframe_sequence(channel_name, sequence)`	`None`	Priradí existujúci `KeyframeSequence` s kanálom
`reset_channels()`	`None`	Odstráni všetky kanály

AnimationChannel

Obsahuje jeden skalár KeyframeSequence pre jeden animovaný komponent.

Example

Example	Example	Example
`name`	`str`	Názov kanála (napr. `"X"`, `"Y"`, `"Z"`)
`default_value`	`Any`	Hodnota použitá, keď nie sú k dispozícii dáta kľúčových snímok
`keyframe_sequence`	`KeyframeSequence	None`

KeyframeSequence

Usporiadaný zoznam KeyFrame vzorky pre jeden skalárny kanál. Dedičí z A3DObject.

Example

Example	Example
`KeyframeSequence(name=None)`	Vytvorí prázdnu sekvenciu kľúčových snímok

Example

Example	Example	Example
`name`	`str`	Názov sekvencie
`key_frames`	`list[KeyFrame]`	Zoznam kľúčových snímok len na čítanie v chronologickom poradí
`pre_behavior`	`Extrapolation`	Správanie pred prvou kľúčovou snímkou
`post_behavior`	`Extrapolation`	Správanie po poslednej kľúčovej snímke
`bind_point`	`BindPoint	None`

Example

Example	Návratový typ	Example
`add(time, value, interpolation=Interpolation.LINEAR)`	`None`	Pripojí kľúčovú snímku na `time` (sekúnd) s daným `value` a `interpolation` režim
`reset()`	`None`	Vymaže všetky kľúčové snímky a resetuje pred/po správanie

KeyFrame

Jedna vzorka časovej hodnoty v KeyframeSequence.

Example

KeyFrame objekty sú vytvárané interne KeyframeSequence.add(); nevytvárajte ich priamo.

Example

Example	Example	Example
`time`	`float`	Časová pozícia v sekundách
`value`	`float`	Animovaná hodnota v tomto čase
`interpolation`	`Interpolation`	Režim interpolácie aplikovaný medzi týmto kľúčovým snímkom a nasledujúcim
`tangent_weight_mode`	`WeightedMode`	Režim váhy tangentu (Bezier curves)
`step_mode`	`StepMode`	Správanie kroku (`PREVIOUS_VALUE` alebo `NEXT_VALUE`)
`next_in_tangent`	`Vector2	None`
`out_tangent`	`Vector2	None`
`out_weight`	`float`	Váha výstupného tangentu
`next_in_weight`	`float`	Váha vstupného tangentu
`tension`	`float`	Parameter napätia (TCB spline)
`continuity`	`float`	Parameter spojitosti (TCB spline)
`bias`	`float`	Parameter sklonu (TCB spline)
`independent_tangent`	`bool`	Example `True`, vstupné a výstupné tangenty sú nezávislé
`flat`	`bool`	Example `True`, tangenty sú stlačené ploché
`time_independent_tangent`	`bool`	Example `True`, smer tangentu je nezávislý od časového škálovania

Example

Riadi, ako sa hodnoty interpolujú medzi po sebe nasledujúcimi kľúčovými snímkami.

Example	Example
`CONSTANT`	Example
`LINEAR`	Lineárna interpolácia medzi hodnotami
`BEZIER`	Kubický Bézier s vstupnými/výstupnými tečnými
`B_SPLINE`	Jednotný B-spline
`CARDINAL_SPLINE`	Kardinálny splajn
`TCB_SPLINE`	Tension–Continuity–Bias splajn

Example

Riadi správanie animácie mimo prvého a posledného kľúčového snímku.

Example	Example
`CONSTANT`	Udržať hranicovú hodnotu
`GRADIENT`	Extrapolovať pri tangenciálnom gradientu hranicového kľúčového snímku
`CYCLE`	Opakovať rozsah kľúčových snímok (smyčky)
`CYCLE_RELATIVE`	Opakovať s kumulatívnym posunom (relatívne k koncovej hodnote)
`OSCILLATE`	Ping-pong (striedavé opakovanie dopredu a dozadu)

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

Pozri tiež