QAbstract3DGraph Class

The QAbstract3DGraph class provides a window and render loop for graphs. More...

• List of all members, including inherited members
• Obsolete members

Public Types

Properties

• 16 properties inherited from QWindow
• 1 property inherited from QObject

Public Functions

• 82 public functions inherited from QWindow
• 145 public functions inherited from QOpenGLFunctions
• 31 public functions inherited from QObject
• 6 public functions inherited from QSurface

Signals

• 18 signals inherited from QWindow
• 2 signals inherited from QObject

Static Public Members

• 1 static public member inherited from QWindow
• 9 static public members inherited from QObject

Related Non-Members

Additional Inherited Members

• 24 public slots inherited from QWindow
• 1 public slot inherited from QObject
• 18 protected functions inherited from QWindow
• 9 protected functions inherited from QObject

Detailed Description

The QAbstract3DGraph class provides a window and render loop for graphs.

This class subclasses a QWindow and provides render loop for graphs inheriting it.

You should not need to use this class directly, but one of its subclasses instead.

Anti-aliasing is turned on by default on C++, except in OpenGL ES2 environments, where anti-aliasing is not supported by Qt Data Visualization. To specify non-default anti-aliasing for a graph, give a custom surface format as a constructor parameter. You can use the convenience function QtDataVisualization::qDefaultSurfaceFormat() to create the surface format object.

Note: QAbstract3DGraph sets window flag Qt::FramelessWindowHint on by default. If you want to display graph windows as standalone windows with regular window frame, clear this flag after constructing the graph. For example:

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

See also Q3DBars, Q3DScatter, Q3DSurface, and Qt Data Visualization C++ Classes.

Member Type Documentation

enum QAbstract3DGraph::ElementType

Type of an element in the graph.

This enum was introduced or modified in QtDataVisualization 1.1.

enum QAbstract3DGraph::OptimizationHintflags QAbstract3DGraph::OptimizationHints

The optimization hint for rendering.

This enum was introduced or modified in Qt Data Visualization 1.1.

The OptimizationHints type is a typedef for QFlags<OptimizationHint>. It stores an OR combination of OptimizationHint values.

enum QAbstract3DGraph::SelectionFlagflags QAbstract3DGraph::SelectionFlags

Item selection modes. Values of this enumeration can be combined with OR operator.

The SelectionFlags type is a typedef for QFlags<SelectionFlag>. It stores an OR combination of SelectionFlag values.

enum QAbstract3DGraph::ShadowQuality

Quality of shadows.

Member Function Documentation

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

Destroys QAbstract3DGraph.

int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

Adds a QCustom3DItem item to the graph. Graph takes ownership of the added item.

Returns the index to the added item if the add operation was successful, -1 if trying to add a null item, and the index of the item if trying to add an already added item.

Items are rendered in the order they have been inserted. The rendering order needs to be taken into account when having solid and transparent items.

This function was introduced in QtDataVisualization 1.1.

See also removeCustomItems(), removeCustomItem(), removeCustomItemAt(), and customItems().

void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)

Adds the given inputHandler to the graph. The input handlers added via addInputHandler are not taken in to use directly. Only the ownership of the inputHandler is given to the graph. The inputHandler must not be null or already added to another graph.

See also releaseInputHandler() and setActiveInputHandler().

void QAbstract3DGraph::addTheme(Q3DTheme *theme)

Adds the given theme to the graph. The themes added via addTheme are not taken in to use directly. Only the ownership of the theme is given to the graph. The theme must not be null or already added to another graph.

See also releaseTheme() and setActiveTheme().

void QAbstract3DGraph::clearSelection()

Clears selection from all attached series.

QList<QCustom3DItem *> QAbstract3DGraph::customItems() const

Returns the list of all added custom items.

This function was introduced in QtDataVisualization 1.2.

See also addCustomItem().

bool QAbstract3DGraph::hasContext() const

Returns true if the OpenGL context of the graph has been successfully initialized. Trying to use a graph when the context initialization has failed typically results in a crash. A common reason for a context initialization failure is lack of sufficient platform support for OpenGL.

QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const

Returns the list of all added input handlers.

See also addInputHandler().

void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)

Gets ownership of given item back and removes the item from the graph.

Note: If the same item is added back to the graph, the texture or the texture file needs to be re-set.

This function was introduced in QtDataVisualization 1.1.

See also QCustom3DItem::setTextureImage() and QCustom3DItem::setTextureFile().

void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)

Releases the ownership of the inputHandler back to the caller, if it was added to this graph. If the released inputHandler is in use there will be no input handler active after this call.

If the default input handler is released and added back later, it behaves as any other input handler would.

See also addInputHandler() and setActiveInputHandler().

void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)

Releases the ownership of the theme back to the caller, if it was added to this graph. If the released theme is in use, a new default theme will be created and set active.

If the default theme is released and added back later, it behaves as any other theme would.

See also addTheme() and setActiveTheme().

void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)

Removes the custom item. Deletes the resources allocated to it.

This function was introduced in QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)

Removes all custom items at position. Deletes the resources allocated to them.

This function was introduced in QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItems()

Removes all custom items. Deletes the resources allocated to them.

This function was introduced in QtDataVisualization 1.1.

QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())

Renders current frame to an image of imageSize. Default size is the window size. Image is rendered with antialiasing level given in msaaSamples. Default level is 0.

Returns the rendered image.

Note: OpenGL ES2 does not support anitialiasing, so msaaSamples is always forced to 0.

This function was introduced in QtDataVisualization 1.1.

QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const

Can be used to get the selected axis after receiving selectedElementChanged signal with any label type. Selection is valid until the next selectedElementChanged signal.

Returns the pointer to the selected axis, or null.

This function was introduced in QtDataVisualization 1.1.

See also selectedElement.

QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const

Can be used to get the selected custom item after receiving selectedElementChanged signal with QAbstract3DGraph::ElementCustomItem type. Ownership of the item remains with the graph. Selection is valid until the next selectedElementChanged signal.

Returns the pointer to the selected custom item, or null.

This function was introduced in QtDataVisualization 1.1.

See also selectedElement.

int QAbstract3DGraph::selectedCustomItemIndex() const

Can be used to query the index of the selected custom item after receiving selectedElementChanged signal with QAbstract3DGraph::ElementCustomItem type. Selection is valid until the next selectedElementChanged signal.

Returns the index of the selected custom item, or -1.

This function was introduced in QtDataVisualization 1.1.

See also selectedElement.

int QAbstract3DGraph::selectedLabelIndex() const

Can be used to query the index of the selected label after receiving selectedElementChanged signal with any label type. Selection is valid until the next selectedElementChanged signal.

Returns the index of the selected label, or -1.

This function was introduced in QtDataVisualization 1.1.

See also selectedElement.

void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

Sets inputHandler as the active input handler used in the graph. Implicitly calls addInputHandler() to transfer ownership of inputHandler to this graph.

If inputHandler is null, no input handler will be active after this call.

Note: Setter function for property activeInputHandler.

See also activeInputHandler(), addInputHandler(), and releaseInputHandler().

void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)

Sets theme as the active theme to be used for the graph. Implicitly calls addTheme() to transfer the ownership of the theme to this graph.

If theme is null, a temporary default theme is created. This temporary theme is destroyed if any theme is explicitly set later. Properties of the theme can be modified even after setting it, and the modifications take effect immediately.

Note: Setter function for property activeTheme.

See also activeTheme().

[virtual] bool QAbstract3DGraph::shadowsSupported() const

Returns true if shadows are supported with the current configuration. OpenGL ES2 configurations do not support shadows.

QList<Q3DTheme *> QAbstract3DGraph::themes() const

Returns the list of all added themes.

See also addTheme().

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(QtDataVisualization::qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(QtDataVisualization::qDefaultSurfaceFormat());