The Qt Graphs module provides a way to develop rapidly responding, complex, and dynamic 3D graphs for analytically demanding industries such as academic research and medical. Qt Graphs provides 3D bars, scatter, and surface graphs. Combining user interaction and real-time 3D drawing graphs enables creating user interfaces that use space effectively. Changing between 3D and 2D presentation enables truly utilizing the value of 3D in visualizing data.
The look and feel of the graphs can be customized by using the predefined themes or defining new ones. In addition, scenes can be customized by specifying settings for the camera, and individual items can be customized by using predefined or user-defined meshes.
Qt Graphs offers ready-made data proxies that can be used to visualize data from Qt item models and height maps. Each graph type has a basic proxy type, which accepts data in a format suitable for that graph. For more information, see Qt Graphs Data Handling with 3D .
End users can interact with the data presented by graphs in several ways, including rotating graphs, zooming into and out of data, selecting items, and viewing 2D slices of the 3D data for increased readability. For more information, see Qt Graphs Interacting with Data in 3D .
The Qt Graphs module provides the following 3D graph types:
The QAbstract3DGraph class subclasses a QQuickWidget and provides a renderer based on QtQuick3D for its own subclasses that implement the different graph types: Q3DBars , Q3DScatter ，和 Q3DSurface . The graph type determines how the data is presented.
3D bar graphs present data as 3D bars that are grouped by category. The Q3DBars class is used to create a graph, and the QBar3DSeries and QBarDataProxy classes are used to set data to the graph, as well as to control the visual properties of the graph, such as draw mode and shading. In QML, the corresponding types are Bars3D , Bar3DSeries ，和 BarDataProxy .
更多信息，见 如何构造最小 Q3DBars 图形 ，和 Simple Bar Graph 范例。
3D scatter graphs present data as a collection of points. The Q3DScatter class is used to create a graph, and the QScatter3DSeries and QScatterDataProxy classes are used to set data to the graph, as well as to control the visual properties of the graph. In QML, the corresponding types are Scatter3D , Scatter3DSeries ，和 ScatterDataProxy .
更多信息，见 如何构造最小 Q3DScatter 图形 ，和 Simple Scatter Graph 范例。
3D surface graphs present data as 3D surface plots. The Q3DSurface class is used to create a graph, and the QSurface3DSeries and QSurfaceDataProxy classes are used to set data to the graph, as well as to control the visual properties of the graph. In QML, the corresponding types are Surface3D , Surface3DSeries ，和 SurfaceDataProxy .
更多信息，见 How to construct a minimal Q3DSurface graph , 图形图库 ，和 Surface Graph Gallery 范例。
As Qt Graphs is based on QtQuick3D , it automatically uses the native backend of the target platform for rendering. However, if OpenGL ES2 ends up being used in targets that do not support anything above it, such as OpenGL ES3 or Vulkan, the following features are not supported:
在 QML，可以设置 AbstractGraph3D.RenderingMode property to determine whether the graph will be rendered directly on the window background or to an offscreen surface that is then drawn during normal QML item rendering.
Background rendering modes offer slightly better performance than the indirect rendering mode, at the cost of non-standard QML behavior. For example, the graphs do not support anti-aliasing. Therefore, changing the rendering mode is a question of performance versus quality.
Qt Quick uses a dedicated scenegraph for data rendering, and is therefore the best choice for graphs.
Qt Graphs supports the following axis types:
An axis can be set up to show a line or a grid. Both axis types are specializations of the QAbstract3DAxis 类或 AbstractAxis3D QML 类型。
A value axis can be given a range of values and segment and subsegment counts to divide the range into. Labels are drawn between each segment. Grid lines are drawn between each segment and each subsegment. The value axis is implemented using the QValue3DAxis 类或 ValueAxis3D QML 类型。
A category axis has named ranges and adjustable range widths. It is divided into equal-sized categories based on the data window size defined by the axis range. Labels are drawn to the positions of categories, if provided. Grid lines are drawn between categories, if visible. A category axis is implemented using the QCategory3DAxis 类或 CategoryAxis3D QML 类型。
If no axes are set explicitly for a graph, temporary default axes with no labels are created. These default axes can be modified via axis accessors, but as soon as any axis is set explicitly for a particular orientation, the default axis for that orientation is destroyed.
All graph types support showing multiple series simultaneously. All the series do not need to contain the same number of rows and columns. Row and column labels are taken from the first series added, unless they are explicitly defined for the row and column axes.
Axis formatters can be used to customize value axis grid lines and labels. The QValue3DAxisFormatter class and ValueAxis3DFormatter QML type provide formatting rules for a linear value 3D axis. The QLogValue3DAxisFormatter 类和 LogValueAxis3DFormatter QML type provide formatting rules for a logarithmic value 3D axis.
Polar horizontal axes can be used for surface and scatter graphs by setting the polar property. It can be set for bars as well, but doing so will produce a warning and be ignored.
A theme is a built-in collection of UI style related settings applied to all the visual elements of a graph, such as the colors, fonts, and visibility of the elements, as well as the strenght of the light and ambient light.
Qt Graphs comes with the following predefined themes that can be used as basis for custom themes:
Custom themes can also be created from scratch.
If a graph displays the data from several data series, some settings can be specified separately for each series. For example, different gradients can be specified for different layers of the graph to make it look more realistic. For an example, see Surface Graph Gallery .
As Qt Graphs is built on top of QtQuick3D , it is possible to integrate QtQuick3D scenes into Qt Graphs scenes. For more information, see Qt Graphs Integration with Qt Quick 3D .
Qt Graphs has predefined mesh types for bars and scatter items. The mesh type determines how a bar or a scatter item looks on a graph. In addition to the pre-defined meshes, a user-defined geometry can be specified as a mesh file. For more information, see QAbstract3DSeries::userDefinedMesh (). For more variety, a quaternion can be set for mesh rotation.
In addition to customizing individual items, the QCustom3DItem 类或 Custom3DItem QML type can be used to add custom items to graphs. The items have custom mesh, position, scaling, rotation, and an optional texture.
The QCustom3DVolume 类和 Custom3DVolume QML type can be used to create volume-rendered objects to be added to a graph. A volume-rendered object is a box with a 3D texture. Three slice planes are supported for the volume, one along each main axis of the volume.
The QCustom3DLabel 类和 Custom3DLabel QML type implement custom labels with the specified text, font, position, scaling, and rotation. Label colors, borders, and background are determined by the active theme.
