StockCurve

Since: BlackBerry 10.0.0

#include <bb/cascades/StockCurve>

A set of defined easing curves used for animating properties.

Easing curves are functions that specify the speed of an animation. You can use them to make animations look more realistic without requiring you to do physics calculations. For example, when you animate a dropping ball, you want the ball to speed up as it drops. An easing curve that eases out would create that effect.

An easing curve is defined by two parameters: an interpolator function, and a type of curve that describes the velocity of the transition (how quickly it accelerates and decelerates at the beginning and the end of the animation).

The velocity easing curve types are:
  • easing In: animation is fast at the beginning, slow at the end.

  • easing Out: animation is slow at the beginning, fast at the end.

  • easing InOut: animation is slow at the beginning, fast in the middle, slow at the end.

Not all easing curves are appropriate for every situation. For example, Linear curve looks unnatural for most types of movement, but works well when changing opacity. QuarticOut is similar to the default implicit animation used for core controls; it works well with user-initiated animations since it's responsive and smooth at the same time.


Overview

Inheritance

bb::cascades::EasingCurve
bb::cascades::StockCurve

Public Functions Index

virtual ~StockCurve ()
EasingCurve (const EasingCurve &orig)Inherited
EasingCurve &operator= (const EasingCurve &other)Inherited

Public Static Attributes

const StockCurve BackIn ()

Starts in the opposite direction, and then animates quickly to the end.

This stock curve has a back interpolation function and ease in velocity type. This animation is similar to a jumping effect. If you want to jump high, you first have to crouch. This move lets the viewer anticipate fast movements. It's great for cartoonish effefcts things that need to move very quickly. Without the crouch, the user might miss a rapid jump entirely and the character may seem to disappear without reason or direction.

Since:

BlackBerry 10.0.0

const StockCurve BackInOut ()

Starts in the opposite direction and moves rather swiftly a bit past the endpoint before it settles.

This stock curve has a "back" interpolation function and ease InOut velocity type. It has an animated and cartoonish feel, like you need both strength and willpower to move this thing.

Since:

BlackBerry 10.0.0

const StockCurve BackOut ()

Goes slightly past the target value before settling on it.

This stock curve has a back interpolation function and ease out velocity type. This is the behavior a lot of lists use when you flick scroll and the list reaches the end.

Since:

BlackBerry 10.0.0

const StockCurve BounceIn ()

Eases in and bounces.

This stock curve has a single bounce interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve BounceInOut ()

Begins and ends slowly and bounces in the middle.

This stock curve has a single bounce interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve BounceOut ()

A curve that bounces once, like a marble being dropped on a hard surface.

This stock curve has a single bounce interpolation function and ease out velocity type. This curve has a very physical feel to it.

Since:

BlackBerry 10.0.0

const StockCurve CircularIn ()

Has a glacial slowness to the start and an explosive end.

This stock curve has a circular interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve CircularInOut ()

Begins and ends with glacial slowness and almost skips the middle.

This stock curve has a circular interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve CircularOut ()

Starts explosively and ends slowly, like sliding on ice.

This stock curve has a circular interpolation function and ease out velocity type.

Since:

BlackBerry 10.0.0

const StockCurve CubicIn ()

Starts quite slowly and ends abruptly.

This stock curve has a cubic interpolation function and ease in velocity type. Like SineIn, but feels heavier.

Since:

BlackBerry 10.0.0

const StockCurve CubicInOut ()

Begins and ends smoothly and moves quickly in the middle.

This stock curve has a cubic interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve CubicOut ()

Starts very abruptly and ends smoothly.

This stock curve has a cubic interpolation function and ease out velocity type.

Since:

BlackBerry 10.0.0

const StockCurve DoubleBounceIn ()

Eases in and bounces rapidly.

This stock curve has a double bounce interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve DoubleBounceInOut ()

Begins and ends slowly and bounces a lot in the middle.

This stock curve has a double bounce interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve DoubleBounceOut ()

A curve that bounces like a rubber ball.

This stock curve has a double bounce interpolation function and ease out velocity type. Like DoubleElasticOut, this curve has a very cartoonish feel to it.

Since:

BlackBerry 10.0.0

const StockCurve DoubleElasticIn ()

Like ElasticIn, but with an evenmore springy effect.

This stock curve has a double elastic bounce interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve DoubleElasticInOut ()

Begins and ends slowly, with a double elastic effect in the middle.

This stock curve has a double "elastic" bounce interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve DoubleElasticOut ()

A cartoonish curve, with lots of energy.

This stock curve has a double elastic bounce interpolation function and ease out velocity type.

Since:

BlackBerry 10.0.0

const StockCurve ElasticIn ()

Starts very slowly with an elastic effect at the end.

This stock curve has a single elastic bounce interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve ElasticInOut ()

Begins and ends very slowly, with an elastic effect in the middle.

This stock curve has a single "elastic" bounce interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve ElasticOut ()

Similar to BackOut, but with a more springy and physical feel.

This stock curve has an elastic bounce interpolation function and ease out velocity type.
Since:

BlackBerry 10.0.0

const StockCurve ExponentialIn ()

Starts very slowly and ends abruptly.

This stock curve has a "exponential" interpolation function and ease In velocity type. Very similar to QuarticIn.

Since:

BlackBerry 10.0.0

const StockCurve ExponentialInOut ()

Begins and ends very smoothly and moves very quickly in the middle.

This stock curve has an exponential interpolation function and ease InOut velocity type. Very similar to QuarticInout.

Since:

BlackBerry 10.0.0

const StockCurve ExponentialOut ()

Starts very abruptly and ends very smoothly.

This stock curve has an exponential interpolation function and ease out velocity type. Very similar to QuarticOut.

Since:

BlackBerry 10.0.0

const StockCurve Linear ()

A linear transition.

This curve has a linear interpolation function and no acceleration. Looks unnatural for most types of movement, but works well for changing opacity.

Since:

BlackBerry 10.0.0

const StockCurve QuadraticIn ()

Starts slowly and ends abruptly.

This stock curve has a quadratic interpolation function and ease in velocity type. Very similar to SineIn.

Since:

BlackBerry 10.0.0

const StockCurve QuadraticInOut ()

Begins and ends smoothly and moves rather quickly in the middle.

This stock curve has a quadratic interpolation function and ease InOut velocity type. Very similar to SineInOut.

Since:

BlackBerry 10.0.0

const StockCurve QuadraticOut ()

Starts abruptly, and ends smoothly.

This stock curve has a quadratic interpolation function and ease out velocity type. Very similar to SineOut.

Since:

BlackBerry 10.0.0

const StockCurve QuarticIn ()

Starts very slowly and ends abruptly.

This stock curve has a quartic interpolation function and ease In velocity type. Feels heavier than CubicOut.

Since:

BlackBerry 10.0.0

const StockCurve QuarticInOut ()

Begins and ends very smoothly and moves very quickly in the middle.

This stock curve has a quartic interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve QuarticOut ()

Performance similar to the default implicit animations.

This stock curve has a quartic interpolation function and ease out velocity type. It works well with animations that are initiated by the user, because it feels responsive and smooth at the same time.

Since:

BlackBerry 10.0.0

const StockCurve QuinticIn ()

Starts very slowly and ends abruptly.

This stock curve has a quintic interpolation function and ease in velocity type.

Since:

BlackBerry 10.0.0

const StockCurve QuinticInOut ()

Begins and ends super smoothly and moves super quickly in the middle.

This stock curve has a quintic interpolation function and ease InOut velocity type.

Since:

BlackBerry 10.0.0

const StockCurve QuinticOut ()

Starts abruptly and ends very smoothly.

This stock curve has a quintic interpolation function and ease out velocity type.

Since:

BlackBerry 10.0.0

const StockCurve SineIn ()

Starts slowly and ends abruptly.

This stock curve has a sine interpolation function and ease in velocity type. This curve is good if you're animating something off screen, because the user has more time to follow the start of the movement. It gives the animated object a feeling of weight.

Since:

BlackBerry 10.0.0

const StockCurve SineInOut ()

Begins and ends smoothly and moves rather quickly in the middle.

This stock curve has a "sine" interpolation function and ease InOut velocity type. It gives a nice physical feel, but it does not feel as responsive as SineOut.

Since:

BlackBerry 10.0.0

const StockCurve SineOut ()

Starts abruptly, and ends smoothly.

This curve uses a sine interpolation function and an ease out velocity type.

Since:

BlackBerry 10.0.0

Public Functions

virtual~StockCurve ()

Destructor.

Since:

BlackBerry 10.0.0

EasingCurve (Inherited

Copy constructor for EasingCurve objects.

Since:

BlackBerry 10.0.0

EasingCurve & operator= (Inherited

A = operator for EasingCurve objects.

Since:

BlackBerry 10.0.0

Last modified: 2014-03-13

comments powered by Disqus