IUIAnimationTransitionLibrary2::CreateCubicBezierLinearVectorTransition method (uianimation.h)

Creates a cubic Bézier linear vector transition for each specified dimension.

Syntax

HRESULT CreateCubicBezierLinearVectorTransition(
  [in]  UI_ANIMATION_SECONDS    duration,
  [in]  const DOUBLE            *finalValue,
  [in]  UINT                    cDimension,
  [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

A vector (of size cDimension) that contains the final values of the animation variable at the end of the transition.

[in] cDimension

The number of dimensions to apply the transition. This parameter specifies the number of values listed in finalValue.

[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 of an animation variable during a cubic Bézier linear transition.

Requirements

See also

IUIAnimationTransition2

IUIAnimationTransitionLibrary2