Animation

Animation — Aspose.3D FOSS for Python API Reference

Example

Det Aspose.3D animationssystem er organiseret omkring en hierarki af objekter, der binder tidsprøve-data til scenegenskaber.

Example AnimationClip er et navngivet afspilningsområde (f.eks. “Walk”, “Run”) holdt af en Scene.
Example AnimationNode lever inde i et klip og binder animerede data til specifikke egenskaber på scenens objekter.
En BindPoint forbinder en AnimationNode til en navngivet Property på en A3DObject.
Example AnimationChannel holder en enkelt skalar KeyframeSequence i et bindepunkt.
En KeyframeSequence er en ordnet liste over KeyFrame tid‑værdi‑prøver.

Alle animationsklasser er i aspose.threed.animation underpakke, selvom de også er tilgængelige direkte fra aspose.threed.

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

AnimationClip

En navngivet beholder for et afspilningsinterval. En Scene kan indeholde flere klip. Arver fra SceneObject.

Example

Example	Example
`AnimationClip(name=None)`	Opretter et klip med et valgfrit navn

Example

Example	Example	Example
`name`	`str`	Klipnavn (f.eks. `"Walk"`)
`description`	`str`	Valgfri beskrivelse
`start`	`float`	Starttid i sekunder
`stop`	`float`	Sluttid i sekunder
`animations`	`list[AnimationNode]`	Skrivebeskyttet liste over animationsnoder i dette klip
`properties`	`PropertyCollection`	Brugerdefinerede egenskaber

Example

Example	Returtype	Example
`create_animation_node(node_name)`	`AnimationNode`	Opretter og registrerer en ny `AnimationNode` i dette klip

AnimationNode

Binder en AnimationClip til en eller flere BindPoint objekter, der målretter scene-objekt egenskaber. Arver fra A3DObject.

Example

Example	Example
`AnimationNode(name=None)`	Opretter en animationsnode med valgfrit navn

Example

Example	Example	Example
`name`	`str`	Node-navn
`bind_points`	`list[BindPoint]`	Skrivebeskyttet liste over bind-punkter
`sub_animations`	`list[AnimationNode]`	Skrivebeskyttet liste over børneanimationsnoder
`properties`	`PropertyCollection`	Brugerdefinerede egenskaber

Example

Example	Returtype	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

Forbinder en AnimationNode til en enkelt Property på en A3DObject. Hver BindPoint kan indeholde flere AnimationChannel objekter (én per skalar komponent). Arver fra A3DObject.

Example

Example	Example	Example
`property`	`Property`	Scene-objektets egenskab, som dette bind-punkt målretter
`channels_count`	`int`	Antal animationskanaler i dette bind-punkt

Example

Example	Returtype	Example
`add_channel(name, value, type=None)`	`bool`	Tilføjer en navngivet kanal med en standardværdi
`get_channel(channel_name)`	`AnimationChannel	None`
`get_keyframe_sequence(channel_name)`	`KeyframeSequence	None`
`create_keyframe_sequence(name)`	`KeyframeSequence`	Opretter en ny `KeyframeSequence` for dette bindepunkt
`bind_keyframe_sequence(channel_name, sequence)`	`None`	Tilknytter en eksisterende `KeyframeSequence` med en kanal
`reset_channels()`	`None`	Fjerner alle kanaler

AnimationChannel

Holder en enkelt skalar KeyframeSequence for en animeret komponent.

Example

Example	Example	Example
`name`	`str`	Kanalnavn (f.eks. `"X"`, `"Y"`, `"Z"`)
`default_value`	`Any`	Værdi, der bruges, når der ikke er nogen keyframe-data til stede
`keyframe_sequence`	`KeyframeSequence	None`

KeyframeSequence

En ordnet liste over KeyFrame prøver for en enkelt skalar kanal. Arver fra A3DObject.

Example

Example	Example
`KeyframeSequence(name=None)`	Opretter en tom keyframe-sekvens

Example

Example	Example	Example
`name`	`str`	Sekvensnavn
`key_frames`	`list[KeyFrame]`	Skrivebeskyttet liste over keyframes i kronologisk rækkefølge
`pre_behavior`	`Extrapolation`	Adfærd før den første keyframe
`post_behavior`	`Extrapolation`	Adfærd efter den sidste keyframe
`bind_point`	`BindPoint	None`

Example

Example	Returtype	Example
`add(time, value, interpolation=Interpolation.LINEAR)`	`None`	Tilføjer en keyframe ved `time` (sekunder) med den angivne `value` og `interpolation` tilstand
`reset()`	`None`	Rydder alle keyframes og nulstiller for-/efter‑adfærd

KeyFrame

Et enkelt tids‑værdi‑sample i en KeyframeSequence.

Example

KeyFrame objekter oprettes internt af KeyframeSequence.add(); opret dem ikke direkte.

Example

Example	Example	Example
`time`	`float`	Tidsposition i sekunder
`value`	`float`	Animeret værdi på dette tidspunkt
`interpolation`	`Interpolation`	Interpolationsmetode anvendt mellem denne nøgleframe og den næste
`tangent_weight_mode`	`WeightedMode`	Tangentvægt-tilstand (Bezier-kurver)
`step_mode`	`StepMode`	Trinadfærd (`PREVIOUS_VALUE` eller `NEXT_VALUE`)
`next_in_tangent`	`Vector2	None`
`out_tangent`	`Vector2	None`
`out_weight`	`float`	Udgående tangentvægt
`next_in_weight`	`float`	Indgående tangentvægt
`tension`	`float`	Spændingsparameter (TCB-spline)
`continuity`	`float`	Kontinuitetsparameter (TCB spline)
`bias`	`float`	Bias-parameter (TCB spline)
`independent_tangent`	`bool`	Example `True`, ind- og ud-tangenter er uafhængige
`flat`	`bool`	Example `True`, tangenter er fastlåst flade
`time_independent_tangent`	`bool`	Example `True`, tangentens retning er uafhængig af tids-skalering

Example

Styrer, hvordan værdier interpoleres mellem på hinanden følgende keyframes.

Example	Example
`CONSTANT`	Example
`LINEAR`	Lineær interpolation mellem værdier
`BEZIER`	Kubisk Bezier med ind/ud-tangenter
`B_SPLINE`	Uniform B-spline
`CARDINAL_SPLINE`	Cardinal spline
`TCB_SPLINE`	Tension–Continuity–Bias spline

Example

Styrer animationsadfærd ud over den første og sidste keyframe.

Example	Example
`CONSTANT`	Hold grænseværdien
`GRADIENT`	Ekstrapoler ved tangentgradienten for grænse‑nøglebilledet
`CYCLE`	Gentag nøglebilledintervallet (løkker)
`CYCLE_RELATIVE`	Gentag med kumulativ forskydning (relativt til slutværdien)
`OSCILLATE`	Ping-pong (alternativ fremad- og bagudgentagelse)

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

Se også