Animating 3D Diagram
- 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.
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;
- changing the perspective angle.
The image below shows the diagram's rotation and zooming animations implemented for BarSeries3D.
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.
The following example shows how to provide zooming and rotation animation actions for a 3D chart diagram.
The table below lists properties that can be used to customize animation effects for a 3D chart diagram.
|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.|