Animation

Animation — Aspose.3D FOSS for Python API Reference

Example

Het Aspose.3D-animatiesysteem is georganiseerd rond een hiërarchie van objecten die tijd-gesamplede gegevens aan scène-eigenschappen binden.

Example AnimationClip is een benoemd afspeelbereik (bijv. “Walk”, “Run”) dat wordt vastgehouden door een Scene.
Example AnimationNode bevindt zich binnen een clip en bindt geanimeerde data aan specifieke eigenschappen van scène‑objecten.
Een BindPoint verbindt een AnimationNode naar een benoemde Property op een A3DObject.
Example AnimationChannel bevat een enkele scalair KeyframeSequence binnen een bindpunt.
Een KeyframeSequence is een geordende lijst van KeyFrame tijd‑waarde monsters.

Alle animatieklassen bevinden zich in de aspose.threed.animation sub‑package, hoewel ze ook direct toegankelijk zijn vanaf aspose.threed.

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

AnimationClip

Een benoemde container voor één afspeelbereik. Een Scene kan meerdere clips bevatten. Erft van SceneObject.

Example

Example	Example
`AnimationClip(name=None)`	Maakt een clip met een optionele naam

Example

Example	Example	Example
`name`	`str`	Clipnaam (bijv. `"Walk"`)
`description`	`str`	Optionele beschrijving
`start`	`float`	Starttijd in seconden
`stop`	`float`	Eindtijd in seconden
`animations`	`list[AnimationNode]`	Alleen-lezen lijst van animatienodes in deze clip
`properties`	`PropertyCollection`	Aangepaste eigenschappen

Example

Example	Retourtype	Example
`create_animation_node(node_name)`	`AnimationNode`	Creëert en registreert een nieuwe `AnimationNode` in deze clip

AnimationNode

Bindt een AnimationClip aan één of meer BindPoint objecten die zich richten op scène-objecteigenschappen. Erft van A3DObject.

Example

Example	Example
`AnimationNode(name=None)`	Maakt een animatieknooppunt met optionele naam

Example

Example	Example	Example
`name`	`str`	Knooppuntnaam
`bind_points`	`list[BindPoint]`	Alleen-lezen lijst van bindpunten
`sub_animations`	`list[AnimationNode]`	Alleen-lezen lijst van onderliggende animatieknooppunten
`properties`	`PropertyCollection`	Aangepaste eigenschappen

Example

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

Verbindt een AnimationNode naar een enkele Property op een A3DObject. Elke BindPoint kan meerdere bevatten AnimationChannel objecten (één per scalair component). Erft van A3DObject.

Example

Example	Example	Example
`property`	`Property`	De scene-object eigenschap waarop dit bindpunt zich richt
`channels_count`	`int`	Aantal animatiekanalen in dit bindpunt

Example

Example	Retourtype	Example
`add_channel(name, value, type=None)`	`bool`	Voegt een benoemd kanaal toe met een standaardwaarde
`get_channel(channel_name)`	`AnimationChannel	None`
`get_keyframe_sequence(channel_name)`	`KeyframeSequence	None`
`create_keyframe_sequence(name)`	`KeyframeSequence`	Maakt een nieuwe `KeyframeSequence` voor dit bindpunt
`bind_keyframe_sequence(channel_name, sequence)`	`None`	Koppelt een bestaande `KeyframeSequence` met een kanaal
`reset_channels()`	`None`	Verwijdert alle kanalen

AnimationChannel

Bevat een enkele scalar KeyframeSequence voor één geanimeerde component.

Example

Example	Example	Example
`name`	`str`	Kanaalnaam (bijv. `"X"`, `"Y"`, `"Z"`)
`default_value`	`Any`	Waarde die wordt gebruikt wanneer er geen keyframe-gegevens aanwezig zijn
`keyframe_sequence`	`KeyframeSequence	None`

KeyframeSequence

Een geordende lijst van KeyFrame samples voor een enkel scalar-kanaal. Erft van A3DObject.

Example

Example	Example
`KeyframeSequence(name=None)`	Maakt een lege keyframe-reeks

Example

Example	Example	Example
`name`	`str`	Reeksnaam
`key_frames`	`list[KeyFrame]`	Alleen-lezen lijst van keyframes in chronologische volgorde
`pre_behavior`	`Extrapolation`	Gedrag vóór de eerste keyframe
`post_behavior`	`Extrapolation`	Gedrag na de laatste keyframe
`bind_point`	`BindPoint	None`

Example

Example	Retourtype	Example
`add(time, value, interpolation=Interpolation.LINEAR)`	`None`	Voegt een keyframe toe op `time` (seconden) met de gegeven `value` en `interpolation` modus
`reset()`	`None`	Verwijdert alle keyframes en reset het pre/post‑gedrag

KeyFrame

Een enkele tijd‑waarde monster in een KeyframeSequence.

Example

KeyFrame objecten worden intern aangemaakt door KeyframeSequence.add(); maak ze niet direct aan.

Example

Example	Example	Example
`time`	`float`	Tijdpositie in seconden
`value`	`float`	Geanimeerde waarde op dit moment
`interpolation`	`Interpolation`	Interpolatiemodus toegepast tussen dit keyframe en het volgende
`tangent_weight_mode`	`WeightedMode`	Tangentsgewichtsmodus (Bezier-curves)
`step_mode`	`StepMode`	Stapgedrag (`PREVIOUS_VALUE` of `NEXT_VALUE`)
`next_in_tangent`	`Vector2	None`
`out_tangent`	`Vector2	None`
`out_weight`	`float`	Uitgaande tangentsgewicht
`next_in_weight`	`float`	Inkomende tangentsgewicht
`tension`	`float`	Spanningsparameter (TCB-spline)
`continuity`	`float`	Continuïteitsparameter (TCB spline)
`bias`	`float`	Biasparameter (TCB spline)
`independent_tangent`	`bool`	Example `True`, in- en out-tangenten zijn onafhankelijk
`flat`	`bool`	Example `True`, tangenten zijn plat geklemd
`time_independent_tangent`	`bool`	Example `True`, de richting van de tangent is onafhankelijk van tijdschaling

Example

Bepaalt hoe waarden worden geïnterpoleerd tussen opeenvolgende keyframes.

Example	Example
`CONSTANT`	Example
`LINEAR`	Lineaire interpolatie tussen waarden
`BEZIER`	Kubieke Bezier met in/out-tangenten
`B_SPLINE`	Uniforme B-spline
`CARDINAL_SPLINE`	Cardinale spline
`TCB_SPLINE`	Tension–Continuity–Bias spline

Example

Bepaalt het animatiegedrag buiten het eerste en laatste keyframe.

Example	Example
`CONSTANT`	Bewaar de grenswaarde
`GRADIENT`	Extrapoleer op de tangentiële gradiënt van het grens‑keyframe
`CYCLE`	Herhaal het keyframe‑bereik (lussen)
`CYCLE_RELATIVE`	Herhaal met cumulatieve offset (relatief ten opzichte van eindwaarde)
`OSCILLATE`	Ping-pong (afwisselend voorwaarts en achterwaarts herhalen)

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

Zie ook