Class
AdwSpringAnimation
Description [src]
final class Adw.SpringAnimation : Adw.Animation
{
/* No available fields */
}
A spring-based AdwAnimation
.
AdwSpringAnimation
implements an animation driven by a physical model of a
spring described by AdwSpringParams
, with a resting position in
AdwSpringAnimation:value-to
, stretched to
AdwSpringAnimation:value-from
.
Since the animation is physically simulated, spring animations don’t have a
fixed duration. The animation will stop when the simulated spring comes to a
rest - when the amplitude of the oscillations becomes smaller than
AdwSpringAnimation:epsilon
, or immediately when it reaches
AdwSpringAnimation:value-to
if
AdwSpringAnimation:clamp
is set to TRUE
. The estimated duration can
be obtained with AdwSpringAnimation:estimated-duration
.
Due to the nature of spring-driven motion the animation can overshoot
AdwSpringAnimation:value-to
before coming to a rest. Whether the
animation will overshoot or not depends on the damping ratio of the spring.
See AdwSpringParams
for more information about specific damping ratio values.
If AdwSpringAnimation:clamp
is TRUE
, the animation will abruptly
end as soon as it reaches the final value, preventing overshooting.
Animations can have an initial velocity value, set via
AdwSpringAnimation:initial-velocity
, which adjusts the curve without
changing the duration. This makes spring animations useful for deceleration
at the end of gestures.
If the initial and final values are equal, and the initial velocity is not 0, the animation value will bounce and return to its resting position.
Instance methods
Methods inherited from AdwAnimation (12)
adw_animation_get_follow_enable_animations_setting
Gets whether self
should be skipped when animations are globally disabled.
since: 1.3
adw_animation_get_state
Gets the current value of self
.
adw_animation_get_target
Gets the target self
animates.
adw_animation_get_value
Gets the current value of self
.
adw_animation_get_widget
Gets the widget self
was created for.
adw_animation_pause
Pauses a playing animation for self
.
adw_animation_play
Starts the animation for self
.
adw_animation_reset
Resets the animation for self
.
adw_animation_resume
Resumes a paused animation for self
.
adw_animation_set_follow_enable_animations_setting
Sets whether to skip self
when animations are globally disabled.
since: 1.3
adw_animation_set_target
Sets the target self
animates to target
.
adw_animation_skip
Skips the animation for self
.
Properties
Properties inherited from AdwAnimation (5)
Adw.Animation:follow-enable-animations-setting
Whether to skip the animation when animations are globally disabled.
since: 1.3
Adw.Animation:state
The animation state.
Adw.Animation:target
The target to animate.
Adw.Animation:value
The current value of the animation.
Adw.Animation:widget
The animation widget.
Signals
Signals inherited from AdwAnimation (1)
AdwAnimation::done
This signal is emitted when the animation has been completed, either on its
own or via calling adw_animation_skip()
.
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.