Animate 3D Diagram

May 28, 2021
3 minutes to read

This topic lists animation effects that can be applied to a 3D Diagram, and also details how to customize animation settings for this chart element.

Overview

DXCharts for WPF allows you to animate a Diagram for 3D chart types.

The following is a list of animation actions that support a 3D chart diagram:

horizontal and/or vertical scrolling;
zooming;
rotation;
changing the perspective angle.

The image below shows the diagram’s rotation and zooming animations implemented for BarSeries3D.

Animation Customization

To apply one of the animation actions to the diagram, do the following:

add a trigger to the chart’s Triggers collection, which will start the diagram’s animation in response to the chart’s Loaded event;
add a ChartAnimationRecord with the Diagram3DAnimation object to ChartAnimationRecordCollection using the ChartControl.AnimationRecords property;
add an object that implements the corresponding animation action (e.g, Diagram3DRotationAction) to Diagram3DAnimationActionCollection, which is available via the Diagram3DAnimation.Actions property.

Note that you also need to specify the initial and final states for each animation effect using the corresponding properties. For example, use the Diagram3DAnimation.InitialZoomPercent and Diagram3DZoomAction.FinalZoomPercent properties to customize the zooming effect for a diagram.

Example

The following example shows how to provide zooming and rotation animation actions for a 3D chart diagram.

How to: Animate a 3D Chart Diagram

The table below lists properties that can be used to customize animation effects for a 3D chart diagram.

Member	Description
ChartControl.AnimationRecords	Provides access to a collection of animation records within a chart.
Diagram3DAnimation.Actions	Specifies which parameters of the Diagram3D object should be animated. This is a dependency property.
Diagram3DAnimation.InitialRotation	Provides access to the initial rotation settings of the series point animation.
Diagram3DRotationAction.Rotation	Provides access to the rotation settings of the AnimationRotation object to specify the final rotation angle for the Diagram3D animation action.
Diagram3DAnimation.InitialZoomPercent	Specifies the initial zoom percent for Diagram3DAnimation. This is a dependency property.
Diagram3DZoomAction.FinalZoomPercent	Specifies the final zoom percentage for the Diagram3D animation action. This is a dependency property.
Diagram3DAnimation.InitialPerspectiveAngle	Specifies the initial perspective angle for Diagram3DAnimation. This is a dependency property.
Diagram3DPerspectiveAction.FinalPerspectiveAngle	Specifies the final perspective angle for the Diagram3D animation action. This is a dependency property.
Diagram3DAnimation.InitialHorizontalScrollPercent	Specifies the initial horizontal scroll percent for Diagram3DAnimation. This is a dependency property.
Diagram3DHorizontalScrollPercentAction.FinalHorizontalScrollPercent	Specifies the final horizontal scroll percentage for the Diagram3D animation action. This is a dependency property.
Diagram3DAnimation.InitialVerticalScrollPercent	Specifies the initial vertical scroll percent for Diagram3DAnimation. This is a dependency property.
Diagram3DVerticalScrollPercentAction.FinalVerticalScrollPercent	Specifies the final vertical scroll percentage for the Diagram3D animation action. This is a dependency property.