Animation

Animation — Aspose.3D FOSS for Python API Reference

Example

Το σύστημα animation Aspose.3D οργανώνεται γύρω από μια ιεραρχία αντικειμένων που συνδέουν δεδομένα δειγματοληπτημένα στο χρόνο με τις ιδιότητες της σκηνής.

Example AnimationClip είναι ένα ονομαστικό εύρος αναπαραγωγής (π.χ. “Walk”, “Run”) που κρατιέται από ένα Scene.
Example AnimationNode ζει μέσα σε ένα κλιπ και συνδέει τα κινούμενα δεδομένα με συγκεκριμένες ιδιότητες στα αντικείμενα της σκηνής.
Ένα BindPoint συνδέει ένα AnimationNode σε ένα ονομασμένο Property σε ένα A3DObject.
Example AnimationChannel κρατά ένα μοναδικό scalar KeyframeSequence μέσα σε ένα σημείο σύνδεσης.
Ένα KeyframeSequence είναι μια ταξινομημένη λίστα από KeyFrame δείγματα χρόνου‑τιμής.

Όλες οι κλάσεις animation βρίσκονται στο 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]`	Λίστα μόνο για ανάγνωση των κόμβων animation σε αυτό το κλιπ
`properties`	`PropertyCollection`	Προσαρμοσμένες ιδιότητες

Example

Example	Τύπος Επιστροφής	Example
`create_animation_node(node_name)`	`AnimationNode`	Δημιουργεί και καταχωρεί ένα νέο `AnimationNode` σε αυτό το κλιπ

AnimationNode

Δέσμευει ένα AnimationClip σε ένα ή περισσότερα BindPoint αντικείμενα που στοχεύουν σε ιδιότητες αντικειμένου σκηνής. Κληρονομεί από A3DObject.

Example

Example	Example
`AnimationNode(name=None)`	Δημιουργεί έναν κόμβο animation με προαιρετικό όνομα

Example

Example	Example	Example
`name`	`str`	Όνομα κόμβου
`bind_points`	`list[BindPoint]`	Λίστα μόνο για ανάγνωση των σημείων δέσμευσης
`sub_animations`	`list[AnimationNode]`	Λίστα μόνο για ανάγνωση των παιδικών κόμβων animation
`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`	Η ιδιότητα scene-object που στοχεύει αυτό το bind point
`channels_count`	`int`	Αριθμός καναλιών animation σε αυτό το bind point

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 point
`bind_keyframe_sequence(channel_name, sequence)`	`None`	Συσχετίζει ένα υπάρχον `KeyframeSequence` με ένα κανάλι
`reset_channels()`	`None`	Αφαιρεί όλα τα κανάλια

AnimationChannel

Διατηρεί ένα μοναδικό scalar KeyframeSequence για ένα κινούμενο στοιχείο.

Example

Example	Example	Example
`name`	`str`	Όνομα καναλιού (π.χ. `"X"`, `"Y"`, `"Z"`)
`default_value`	`Any`	Τιμή που χρησιμοποιείται όταν δεν υπάρχουν δεδομένα keyframe
`keyframe_sequence`	`KeyframeSequence	None`

KeyframeSequence

Μια διατεταγμένη λίστα των KeyFrame δείγματα για ένα μοναδικό scalar κανάλι. Κληρονομεί από 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`	Λειτουργία παρεμβολής που εφαρμόζεται μεταξύ αυτού του keyframe και του επόμενου
`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

Ελέγχει πώς οι τιμές παρεμβάλλονται μεταξύ διαδοχικών keyframes.

Example	Example
`CONSTANT`	Example
`LINEAR`	Γραμμική παρεμβολή μεταξύ τιμών
`BEZIER`	Κυβική Bezier με εσωτερικές/εξωτερικές εφαπτόμενες
`B_SPLINE`	Ομοιόμορφη B-spline
`CARDINAL_SPLINE`	Καρδινάλ spline
`TCB_SPLINE`	Tension–Continuity–Bias spline

Example

Ελέγχει τη συμπεριφορά του animation πέρα από το πρώτο και το τελευταίο keyframe.

Example	Example
`CONSTANT`	Κρατήστε την τιμή του ορίου
`GRADIENT`	Εξαπλώστε στην κλίση εφαπτομένης του οριακού keyframe
`CYCLE`	Επαναλάβετε το εύρος του keyframe (βρόχοι)
`CYCLE_RELATIVE`	Επανάληψη με συσσωρευμένο offset (σχετικά με την τελική τιμή)
`OSCILLATE`	Ping-pong (εναλλασσόμενη επανάληψη εμπρός-πίσω)

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

Δείτε επίσης