IUIAnimationTransitionLibrary2::CreateCubicBezierLinearTransition method (uianimation.h)

Creates a cubic Bézier linear scalar transition.

Syntax

HRESULT CreateCubicBezierLinearTransition(
  [in]  UI_ANIMATION_SECONDS    duration,
  [in]  DOUBLE                  finalValue,
  [in]  DOUBLE                  x1,
  [in]  DOUBLE                  y1,
  [in]  DOUBLE                  x2,
  [in]  DOUBLE                  y2,
  [out] IUIAnimationTransition2 **ppTransition
);

Parameters

[in] duration

The duration of the transition.

[in] finalValue

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

[in] x1

The x-coordinate of the first control point.

[in] y1

The y-coordinate of the first control point.

[in] x2

The x-coordinate of the second control point.

[in] y2

The y-coordinate of the second control point.

[out] ppTransition

The new cubic Bézier linear transition.

Return value

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

Remarks

During a cubic Bézier linear transition, the value of the animation variable changes from its initial value to the finalValue over the duration of the transition. The ordered pairs, (x1, y1) and (x2, y2), act as control points that provide directional information to transform the linear path of the transition into a smooth parametric curve.

The following figure shows the change in value over time for an animation variable during a cubic Bézier linear transition.

Requirements

See also

IUIAnimationTransition2

IUIAnimationTransitionLibrary2