The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUIAnimationTransitionLibrary::CreateAccelerateDecelerateTransition method

Creates an accelerate-decelerate transition.


HRESULT CreateAccelerateDecelerateTransition(
  [in]   UI_ANIMATION_SECONDS duration,
  [in]   DOUBLE finalValue,
  [in]   DOUBLE accelerationRatio,
  [in]   DOUBLE decelerationRatio,
  [out]  IUIAnimationTransition **transition


duration [in]

The duration of the transition.

finalValue [in]

The value of the animation variable at the end of the transition.

accelerationRatio [in]

The ratio of the time spent accelerating to the duration.

decelerationRatio [in]

The ratio of the time spent decelerating to the duration.

transition [out]

The new accelerate-decelerate transition.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See Windows Animation Error Codes for a list of error codes.


During an accelerate-decelerate transition, the animation variable speeds up and then slows down over the duration of the transition, ending at a specified value. You can control how quickly the variable accelerates and decelerates independently, by specifying different acceleration and deceleration ratios.

When the initial velocity is zero, the acceleration ratio is the fraction of the duration that the variable will spend accelerating; likewise with the deceleration ratio. If the initial velocity is nonzero, it is the fraction of the time between the velocity reaching zero and the end of transition. The acceleration ratio and the deceleration ratio should sum to a maximum of 1.0.

The figures below show the effect on animation variables with different initial velocities during accelerate-decelerate transitions.

Diagram showing accellerate-decellerate transitions

Note  d' in the above figure on the right shows the time between the velocity reaching zero and the end of the transition.


For an example, see Create a Storyboard and Add Transitions.


Minimum supported client

Windows 7, Windows Vista and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

None supported [desktop apps | Windows Store apps]







See also




Community Additions

© 2014 Microsoft