Class

BisSpringAnimation

Description [src]

final class Bis.SpringAnimation : Bis.Animation {
  /* No available fields */
}

A spring-based BisAnimation.

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

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

If BisSpringAnimation:latch 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 BisSpringAnimation: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.

Available since:1.0

Ancestors

Constructors

bis_spring_animation_new

Creates a new BisSpringAnimation on widget.

Available since: 1.0

Instance methods

bis_spring_animation_get_epsilon

Gets the precision of the spring.

Available since: 1.0

bis_spring_animation_get_estimated_duration

Gets the estimated duration of self.

Available since: 1.0

bis_spring_animation_get_initial_velocity

Gets the initial velocity of self.

Available since: 1.0

bis_spring_animation_get_latch

Gets whether self should be latched.

Available since: 1.0

bis_spring_animation_get_spring_params

Gets the physical parameters of the spring of self.

Available since: 1.0

bis_spring_animation_get_value_from

Gets the value self will animate from.

Available since: 1.0

bis_spring_animation_get_value_to

Gets the value self will animate to.

Available since: 1.0

bis_spring_animation_get_velocity

Gets the current velocity of self.

Available since: 1.0

bis_spring_animation_set_epsilon

Sets the precision of the spring.

Available since: 1.0

bis_spring_animation_set_initial_velocity

Sets the initial velocity of self.

Available since: 1.0

bis_spring_animation_set_latch

Sets whether self should be latched.

Available since: 1.0

bis_spring_animation_set_spring_params

Sets the physical parameters of the spring of self.

Available since: 1.0

bis_spring_animation_set_value_from

Sets the value self will animate from.

Available since: 1.0

bis_spring_animation_set_value_to

Sets the value self will animate to.

Available since: 1.0

Methods inherited from BisAnimation (10)
bis_animation_get_state

Gets the current value of self.

Available since: 1.0

bis_animation_get_target

Gets the target self animates.

Available since: 1.0

bis_animation_get_value

Gets the current value of self.

Available since: 1.0

bis_animation_get_widget

Gets the widget self was created for.

Available since: 1.0

bis_animation_pause

Pauses a playing animation for self.

Available since: 1.0

bis_animation_play

Starts the animation for self.

Available since: 1.0

bis_animation_reset

Resets the animation for self.

Available since: 1.0

bis_animation_resume

Resumes a paused animation for self.

Available since: 1.0

bis_animation_set_target

Sets the target self animates to target.

Available since: 1.0

bis_animation_skip

Skips the animation for self.

Available since: 1.0

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Bis.SpringAnimation:epsilon

Precision of the spring.

Available since: 1.0

Bis.SpringAnimation:estimated-duration

Estimated duration of the animation, in milliseconds.

Available since: 1.0

Bis.SpringAnimation:initial-velocity

The initial velocity to start the animation with.

Available since: 1.0

Bis.SpringAnimation:latch

Whether the animation should be latched.

Available since: 1.0

Bis.SpringAnimation:spring-params

Physical parameters describing the spring.

Available since: 1.0

Bis.SpringAnimation:value-from

The value to animate from.

Available since: 1.0

Bis.SpringAnimation:value-to

The value to animate to.

Available since: 1.0

Bis.SpringAnimation:velocity

Current velocity of the animation.

Available since: 1.0

Properties inherited from BisAnimation (4)
Bis.Animation:state

The animation state.

Available since: 1.0

Bis.Animation:target

The target to animate.

Available since: 1.0

Bis.Animation:value

The current value of the animation.

Available since: 1.0

Bis.Animation:widget

The animation widget.

Available since: 1.0

Signals

Signals inherited from BisAnimation (1)
Bis.Animation::done

This signal is emitted when the animation has been completed, either on its own or via calling bis_animation_skip().

Available since: 1.0

Signals inherited from GObject (1)
GObject.Object::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.

Class structure

struct BisSpringAnimationClass {
  /* no available fields */
}