Skip to main content
IUIAnimationTransitionLibrary2::CreateCubicBezierLinearVectorTransition method

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

duration [in]

The duration of the transition.

finalValue [in]

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

cDimension [in]

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

x1 [in]

The x-coordinate of the first control point.

y1 [in]

The y-coordinate of the first control point.

x2 [in]

The x-coordinate of the second control point.

y2 [in]

The y-coordinate of the second control point.

ppTransition [out]

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.

Diagram showing a cubic Bezier linear vector transition

Requirements

Minimum supported client

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

Minimum supported server

None supported [desktop apps | Windows Store apps]

Header

UIAnimation.h

IDL

UIAnimation.idl

DLL

UIAnimation.dll

IID

IID_IUIAnimationTransitionLibrary2 is defined as 03CFAE53-9580-4ee3-B363-2ECE51B4AF6A

See also

IUIAnimationTransitionLibrary2
IUIAnimationTransition2