SpringAnimation

A spring-based class@Animation.

adw.spring_animation.SpringAnimation implements an animation driven by a physical model of a spring described by struct@SpringParams, with a resting position in property@SpringAnimation:value-to, stretched to property@SpringAnimation: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 property@SpringAnimation:epsilon, or immediately when it reaches property@SpringAnimation:value-to if property@SpringAnimation:clamp is set to TRUE. The estimated duration can be obtained with property@SpringAnimation:estimated-duration.

Due to the nature of spring-driven motion the animation can overshoot property@SpringAnimation:value-to before coming to a rest. Whether the animation will overshoot or not depends on the damping ratio of the spring. See struct@SpringParams for more information about specific damping ratio values.

If property@SpringAnimation: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 property@SpringAnimation: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.

class SpringAnimation : Animation {

this(gtk.widget.Widget widget, double from, double to, adw.spring_params.SpringParams springParams, adw.animation_target.AnimationTarget target);

double calculateValue(uint time);

double calculateVelocity(uint time);

bool getClamp();

double getEpsilon();

uint getEstimatedDuration();

double getInitialVelocity();

adw.spring_params.SpringParams getSpringParams();

double getValueFrom();

double getValueTo();

double getVelocity();

void setClamp(bool clamp);

void setEpsilon(double epsilon);

void setInitialVelocity(double velocity);

void setSpringParams(adw.spring_params.SpringParams springParams);

void setValueFrom(double value);

void setValueTo(double value);

}

Constructors

this this(gtk.widget.Widget widget, double from, double to, adw.spring_params.SpringParams springParams, adw.animation_target.AnimationTarget target): Creates a new adw.spring_animation.SpringAnimation on widget.

Members

Functions

calculateValue double calculateValue(uint time): Calculates the value self will have at time.
calculateVelocity double calculateVelocity(uint time): Calculates the velocity self will have at time.
getClamp bool getClamp(): Gets whether self should be clamped.
getEpsilon double getEpsilon(): Gets the precision of the spring.
getEstimatedDuration uint getEstimatedDuration(): Gets the estimated duration of self, in milliseconds.
getInitialVelocity double getInitialVelocity(): Gets the initial velocity of self.
getSpringParams adw.spring_params.SpringParams getSpringParams(): Gets the physical parameters of the spring of self.
getValueFrom double getValueFrom(): Gets the value self will animate from.
getValueTo double getValueTo(): Gets the value self will animate to.
getVelocity double getVelocity(): Gets the current velocity of self.
setClamp void setClamp(bool clamp): Sets whether self should be clamped.
setEpsilon void setEpsilon(double epsilon): Sets the precision of the spring.
setInitialVelocity void setInitialVelocity(double velocity): Sets the initial velocity of self.
setSpringParams void setSpringParams(adw.spring_params.SpringParams springParams): Sets the physical parameters of the spring of self.
setValueFrom void setValueFrom(double value): Sets the value self will animate from.
setValueTo void setValueTo(double value): Sets the value self will animate to.

Inherited Members

From Animation

getFollowEnableAnimationsSetting bool getFollowEnableAnimationsSetting(): Gets whether self should be skipped when animations are globally disabled.
getState adw.types.AnimationState getState(): Gets the current value of self.
getTarget adw.animation_target.AnimationTarget getTarget(): Gets the target self animates.
getValue double getValue(): Gets the current value of self.
getWidget gtk.widget.Widget getWidget(): Gets the widget self was created for.
pause void pause(): Pauses a playing animation for self.
play void play(): Starts the animation for self.
reset void reset(): Resets the animation for self.
resume void resume(): Resumes a paused animation for self.
setFollowEnableAnimationsSetting void setFollowEnableAnimationsSetting(bool setting): Sets whether to skip self when animations are globally disabled.
setTarget void setTarget(adw.animation_target.AnimationTarget target): Sets the target self animates to target.
skip void skip(): Skips the animation for self.
connectDone ulong connectDone(T callback, Flag!"After" after): Connect to Done signal.

adw spring_animation classes

SpringAnimation