[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Expand]Providing Data
    [Collapse]Chart Elements
     [Collapse]Diagram
       Simple 2D Diagram
       Simple 3D Diagram
       2D XY Diagram
       3D XY Diagram
       2D Polar Diagram
       2D Radar Diagram
     [Expand]Series
     [Expand]Panes
     [Expand]Axes
      Legends
      Chart Titles
      Annotations
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

3D XY Diagram

The 3D XY Diagram displays Cartesian series in a high-resolution 3D view. Refer to the 2D XY Diagram document to learn more about its 2D counterpart.

This topic includes the following sections:

Expanded Compatible Series

The diagram can only display the following compatible series:

Refer to the Series Types Compatibility document for more information.

Expanded How to Create a Chart with a 3D XY Diagram

The markup below shows how to create a chart with a 3D XY Diagram:

The following table lists all the classes and properties that the markup above uses:

Class or Property Description
ChartControl The Chart Control.
ChartControlBase.Titles The Chart's title collection.
Title An individual title.
TitleBase.Content Specifies title content.
ChartControlBase.Legends The Chart's legend collection.
Legend A legend.
XYDiagram3D The 3D XY diagram.
XYDiagram3D.HeightToWidthRatio Specifies the diagram's height to width ratio as a percentage.
XYDiagram3D.PlaneDepthFixed Specifies coordinate planes' depth (thickness).
XYDiagram3D.AxisX Stores diagram x-axis settings.
AxisX3D The 3D XY diagram's x-axis.
XYDiagram3D.AxisY Stores a diagram's y-axis settings.
AxisY3D The 3D XY diagram's y-axis.
BarSideBySideSeries3D The 3D Side-by-Side Bar series.
Series.DisplayName Specifies a series's display name.
SeriesPoint A series point.
SeriesPoint.Argument The series point's argument.
SeriesPoint.Value The series point's value.

You can also access a 3D XY diagram's options at runtime as shown below:

Expanded 3D XY Diagram's Specific Options

Below is a list of 3D XY Diagram-specific properties:

Note

Diagram pixels is a measurement unit that was introduced specially for 3D diagrams to meet their unique requirements.

The following list details specific properties for a 3D Diagram:

Zooming and Scrolling

The Diagram3D.HorizontalScrollPercent and Diagram3D.VerticalScrollPercent properties determine the distance the chart can move in relation to the central position within a diagram as a diagram width percentage. These properties can be specified using positive or negative values. If the ScrollPercent properties specify values that are too large, the series inside the diagram may be moved outside. Use the Diagram3D.RuntimeScrolling property to provide end users with scrolling capabilities at runtime.

The Diagram3D.ZoomPercent property specifies a chart magnification value. This value should be between 1 and 500 percents and is equal to 100 by default. Use the Diagram3D.RuntimeZooming property to enable zooming at runtime.

Refer to Zooming and Scrolling (3D Charts) for more information.

Perspective

In a perspective projection, the lines that are parallel to the object converge as they move towards a horizon line on the projection surface. The rate at which parallel lines converge is called the perspective angle. Use the Diagram3D.PerspectiveAngle property to specify a perspective angle for a 3D diagram in a perspective projection. The Perspective Angle may be equal to or more than 0, and must be less than 180.

Rotation

Use the Diagram3D.RuntimeRotation property to allow chart rotation at runtime.

3D charts can be rotated using the Ctrl+mouse pointer (design time) or mouse pointer only (runtime).

Refer to Rotation (3D Charts) for more details.

Expanded See Also

Is this topic helpful?​​​​​​​