Qt Graphs

The Qt Graphs module enables you to visualize data in 2D and 3D graphs.

In the 3D realm there is support for bar, scatter, and surface graphs. It's especially useful for visualizing depth maps and large quantities of rapidly changing data, such as data received from multiple sensors. The look and feel of graphs can be customized by using themes or by adding custom items and labels.

In the 2D realm, there is support for area, bar, donut, line, pie, scatter, and spline graphs, and they are easily combinable with any other QML content.

Qt Graphs is built on Qt 6 and the 3D graphs on Qt Quick 3D to take advantage of hardware acceleration and Qt Quick.

Using the Module

QtGraphs QML API

The QML types of the module are available through the QtGraphs import. To use the types, add the following import statement to your .qml file:

import QtGraphs

C++ API

Using a Qt module's C++ API requires linking against the module library, either directly or through other dependencies. Several build tools have dedicated support for this, including CMake and qmake.

Building with CMake

Use the find_package() command to locate the needed module component in the Qt6 package:

find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)

For more details, see the Build with CMake overview.

Building with qmake

To configure the module for building with qmake, add the module as a value of the QT variable in the project's .pro file:

QT += graphs

Building a widget application

• Building With Widgets

Articles and Guides

Limiting Features

In cases the target of an application is some embedded hardware with limited specifications, it is possible to build only 2D or 3D support into the module.

For more information, see configuring Qt Graphs.

Qt Graphs for 2D

• Overview
• Migration Guide from Qt Charts

Qt Graphs for 3D

• Overview
• Data Handling
• Interacting with Data
• Migration Guide from Qt DataVisualization
• Integration with Qt Quick 3D
• Known Issues

Qt Graphs Common

• Theme Overview

Examples

• Qt Graphs Examples

API Reference

• Qt Graphs C++ Classes
• Qt Graphs QML Types

Licenses and Attributions

Qt Graphs is available under commercial licenses from The Qt Company. In addition, it is available under the GNU General Public License, version 3. See Qt Licensing for further details.