class Q3DGraphsWidgetItem¶

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

Inherited by: Q3DSurfaceWidgetItem, Q3DScatterWidgetItem, Q3DBarsWidgetItem

Synopsis¶

Properties¶

activeThemeᅟ - Active theme of the graph
ambientLightStrengthᅟ - Ambient light strength for the whole graph
aspectRatioᅟ - Ratio of the graph scaling between the longest axis on the horizontal plane and the y-axis
cameraPresetᅟ
cameraTargetPositionᅟ - Camera target position as a vector or vertex in the 3D space
cameraXRotationᅟ - X-rotation angle of the camera around the target point in degrees
cameraYRotationᅟ - Y-rotation angle of the camera around the target point in degrees
cameraZoomLevelᅟ - Camera zoom level in percentage
currentFpsᅟ - Rendering results for the last second
gridLineTypeᅟ - Whether the grid lines type is Q3DGraphsWidgetItem::GridLineType::Shader or Q3DGraphsWidgetItem::GridLineType::Geometry
horizontalAspectRatioᅟ - Ratio of the graph scaling between the x-axis and z-axis
labelMarginᅟ - This property specifies the margin for the placement of the axis labels
lightColorᅟ - Color for the ambient and specular light
lightStrengthᅟ - Specular light strength for the whole graph
localeᅟ - Used for formatting various numeric labels
marginᅟ - Absolute value used for the space left between the edge of the plottable graph area and the edge of the graph background
maxCameraXRotationᅟ - Maximum X-rotation angle of the camera around the target point in degrees
maxCameraYRotationᅟ - Maximum Y-rotation angle of the camera around the target point in degrees
maxCameraZoomLevelᅟ - Maximum allowed camera zoom level
measureFpsᅟ - Whether rendering is done continuously instead of on demand
minCameraXRotationᅟ - Minimum X-rotation angle of the camera around the target point in degrees
minCameraYRotationᅟ - Minimum Y-rotation angle of the camera around the target point in degrees
minCameraZoomLevelᅟ - Minimum allowed camera zoom level
msaaSamplesᅟ - Number of used samples in MSAA
optimizationHintᅟ - Whether the default, static, or legacy mode is used for rendering optimization
orthoProjectionᅟ - Whether orthographic projection is used for displaying the graph
polarᅟ - Whether horizontal axes are changed into polar axes
queriedGraphPositionᅟ - Latest queried graph position values along each axis
radialLabelOffsetᅟ - Normalized horizontal offset for the axis labels of the radial polar axis
rotationEnabledᅟ - Whether this input handler allows graph rotation
sceneᅟ - Q3DScene pointer that can be used to manipulate the scene and access the scene elements
selectedElementᅟ - Element selected in the graph
selectionEnabledᅟ - Whether this input handler allows selection from the graph
selectionModeᅟ - Item selection mode
shadowQualityᅟ - Quality of the shadow
shadowStrengthᅟ - Shadow strength for the whole graph
wrapCameraXRotationᅟ - Behavior of the minimum and maximum limits in the X-rotation
wrapCameraYRotationᅟ - Behavior of the minimum and maximum limits in the Y-rotation
zoomAtTargetEnabledᅟ - Whether zooming should change the camera target so that the zoomed point of the graph stays at the same location after the zoom
zoomEnabledᅟ - Whether this input handler allows graph zooming

Methods¶

def activeTheme()
def addCustomItem()
def addTheme()
def ambientLightStrength()
def aspectRatio()
def cameraPreset()
def cameraTargetPosition()
def cameraXRotation()
def cameraYRotation()
def cameraZoomLevel()
def clearSelection()
def currentFps()
def customItems()
def doPicking()
def gridLineType()
def hasSeries()
def horizontalAspectRatio()
def isOrthoProjection()
def isPolar()
def isRotationEnabled()
def isSelectionEnabled()
def isZoomAtTargetEnabled()
def isZoomEnabled()
def labelMargin()
def lightColor()
def lightStrength()
def locale()
def margin()
def maxCameraXRotation()
def maxCameraYRotation()
def maxCameraZoomLevel()
def measureFps()
def minCameraXRotation()
def minCameraYRotation()
def minCameraZoomLevel()
def msaaSamples()
def optimizationHint()
def queriedGraphPosition()
def radialLabelOffset()
def releaseCustomItem()
def releaseTheme()
def removeCustomItem()
def removeCustomItemAt()
def removeCustomItems()
def renderToImage()
def scene()
def selectedAxis()
def selectedCustomItem()
def selectedCustomItemIndex()
def selectedElement()
def selectedLabelIndex()
def selectionMode()
def setActiveTheme()
def setAmbientLightStrength()
def setAspectRatio()
def setCameraPosition()
def setCameraPreset()
def setCameraTargetPosition()
def setCameraXRotation()
def setCameraYRotation()
def setCameraZoomLevel()
def setDefaultInputHandler()
def setDragButton()
def setGridLineType()
def setHorizontalAspectRatio()
def setLabelMargin()
def setLightColor()
def setLightStrength()
def setLocale()
def setMargin()
def setMaxCameraXRotation()
def setMaxCameraYRotation()
def setMaxCameraZoomLevel()
def setMeasureFps()
def setMinCameraXRotation()
def setMinCameraYRotation()
def setMinCameraZoomLevel()
def setMsaaSamples()
def setOptimizationHint()
def setOrthoProjection()
def setPolar()
def setRadialLabelOffset()
def setRotationEnabled()
def setSelectionEnabled()
def setSelectionMode()
def setShadowQuality()
def setShadowStrength()
def setWidget()
def setWrapCameraXRotation()
def setWrapCameraYRotation()
def setZoomAtTargetEnabled()
def setZoomEnabled()
def shadowQuality()
def shadowStrength()
def themes()
def unsetDefaultDragHandler()
def unsetDefaultInputHandler()
def unsetDefaultPinchHandler()
def unsetDefaultTapHandler()
def unsetDefaultWheelHandler()
def widget()
def wrapCameraXRotation()
def wrapCameraYRotation()

Signals¶

def activeThemeChanged()
def ambientLightStrengthChanged()
def aspectRatioChanged()
def cameraPresetChanged()
def cameraTargetPositionChanged()
def cameraXRotationChanged()
def cameraYRotationChanged()
def cameraZoomLevelChanged()
def currentFpsChanged()
def doubleTapped()
def dragged()
def gridLineTypeChanged()
def horizontalAspectRatioChanged()
def labelMarginChanged()
def lightColorChanged()
def lightStrengthChanged()
def localeChanged()
def longPressed()
def marginChanged()
def maxCameraXRotationChanged()
def maxCameraYRotationChanged()
def maxCameraZoomLevelChanged()
def measureFpsChanged()
def minCameraXRotationChanged()
def minCameraYRotationChanged()
def minCameraZoomLevelChanged()
def mouseMove()
def msaaSamplesChanged()
def optimizationHintChanged()
def orthoProjectionChanged()
def pinch()
def polarChanged()
def queriedGraphPositionChanged()
def radialLabelOffsetChanged()
def rotationEnabledChanged()
def selectedElementChanged()
def selectionEnabledChanged()
def selectionModeChanged()
def shadowQualityChanged()
def shadowStrengthChanged()
def tapped()
def wheel()
def wrapCameraXRotationChanged()
def wrapCameraYRotationChanged()
def zoomAtTargetEnabledChanged()
def zoomEnabledChanged()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description¶

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 Graphs. To specify non-default anti-aliasing for a graph, give a custom surface format as a constructor parameter. You can use the convenience function qDefaultSurfaceFormat() to create the surface format object.

Note

Q3DGraphsWidgetItem 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:

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

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property activeThemeᅟ: QGraphsTheme¶

This property holds The active theme of the graph..

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

If activeTheme 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.

Access functions:

activeTheme()
setActiveTheme()
Signal activeThemeChanged()

property ambientLightStrengthᅟ: float¶

This property holds The ambient light strength for the whole graph..

This value determines how evenly and brightly the colors are shown throughout the graph regardless of the light position.

The value must be between 0.0f and 1.0f.

Access functions:

ambientLightStrength()
setAmbientLightStrength()
Signal ambientLightStrengthChanged()

property aspectRatioᅟ: float¶

This property holds The ratio of the graph scaling between the longest axis on the horizontal plane and the y-axis..

Defaults to 2.0.

Note

Has no effect on Q3DBarsWidgetItem .

See also

horizontalAspectRatio

Access functions:

aspectRatio()
setAspectRatio()
Signal aspectRatioChanged()

property cameraPresetᅟ: QtGraphs3D.CameraPreset¶

Access functions:

cameraPreset()
setCameraPreset()
Signal cameraPresetChanged()

property cameraTargetPositionᅟ: QVector3D¶

This property holds The camera target position as a vector or vertex in the 3D space..

Defaults to QVector3D(0.0, 0.0, 0.0).

Valid coordinate values are between -1.0...1.0, where the edge values indicate the edges of the corresponding axis range. Any values outside this range are clamped to the edge.

Note

For bar graphs, the Y-coordinate is ignored and camera always targets a point on the horizontal background.

Access functions:

cameraTargetPosition()
setCameraTargetPosition()
Signal cameraTargetPositionChanged()

property cameraXRotationᅟ: float¶

This property holds The X-rotation angle of the camera around the target point in degrees..

Access functions:

cameraXRotation()
setCameraXRotation()
Signal cameraXRotationChanged()

property cameraYRotationᅟ: float¶

This property holds The Y-rotation angle of the camera around the target point in degrees..

Access functions:

cameraYRotation()
setCameraYRotation()
Signal cameraYRotationChanged()

property cameraZoomLevelᅟ: float¶

This property holds The camera zoom level in percentage..

The default value of 100.0f means there is no zoom in or out set in the camera. The value is limited by the minCameraZoomLevel and maxCameraZoomLevel properties.

See also

minCameraZoomLevel maxCameraZoomLevel

Access functions:

cameraZoomLevel()
setCameraZoomLevel()
Signal cameraZoomLevelChanged()

property currentFpsᅟ: int¶

This property holds The rendering results for the last second..

The results are stored in this read-only property when FPS measuring is enabled. It takes at least a second before this value is updated after measuring is activated.

See also

measureFps

Access functions:

currentFps()
Signal currentFpsChanged()

property gridLineTypeᅟ: QtGraphs3D.GridLineType¶

This property holds Whether the grid lines type is Q3DGraphsWidgetItem::GridLineType::Shader or Q3DGraphsWidgetItem::GridLineType::Geometry..

This value affects all grid lines.

Access functions:

gridLineType()
setGridLineType()
Signal gridLineTypeChanged()

property horizontalAspectRatioᅟ: float¶

This property holds The ratio of the graph scaling between the x-axis and z-axis..

The value of 0.0 indicates automatic scaling according to axis ranges. Defaults to 0.0.

Has no effect on Q3DBarsWidgetItem , which handles scaling on the horizontal plane via the barThickness and barSpacing properties. Polar graphs also ignore this property.

See also

aspectRatio polar barThickness barSpacing

Access functions:

horizontalAspectRatio()
setHorizontalAspectRatio()
Signal horizontalAspectRatioChanged()

property labelMarginᅟ: float¶

This property holds This property specifies the margin for the placement of the axis labels..

Negative values place the labels inside the plot-area while positive values place them outside the plot-area. Label automatic rotation is disabled when the value is negative. Defaults to 0.1

See also

labelAutoAngle

Access functions:

labelMargin()
setLabelMargin()
Signal labelMarginChanged()

property lightColorᅟ: QColor¶

This property holds The color for the ambient and specular light..

This value affects the light specified in Q3DScene .

Access functions:

lightColor()
setLightColor()
Signal lightColorChanged()

property lightStrengthᅟ: float¶

This property holds The specular light strength for the whole graph..

The value must be between 0.0f and 10.0f.

This value affects the light specified in Q3DScene .

Access functions:

lightStrength()
setLightStrength()
Signal lightStrengthChanged()

property localeᅟ: QLocale¶

This property holds The locale used for formatting various numeric labels..

Defaults to the "C" locale.

See also

labelFormat

Access functions:

locale()
setLocale()
Signal localeChanged()

property marginᅟ: float¶

This property holds The absolute value used for the space left between the edge of the plottable graph area and the edge of the graph background..

If the margin value is negative, the margins are determined automatically and can vary according to the size of the items in the series and the type of the graph. The value is interpreted as a fraction of the y-axis range if the graph aspect ratios have not beed changed from the default values. Defaults to -1.0.

Note

Setting a smaller margin for a scatter graph than the automatically determined margin can cause the scatter items at the edges of the graph to overlap with the graph background.

Note

On scatter and surface graphs, if the margin is small in comparison to the axis label size, the positions of the edge labels of the axes are adjusted to avoid overlap with the edge labels of the neighboring axes.

Access functions:

margin()
setMargin()
Signal marginChanged()

property maxCameraXRotationᅟ: float¶

This property holds The maximum X-rotation angle of the camera around the target point in degrees..

Access functions:

maxCameraXRotation()
setMaxCameraXRotation()
Signal maxCameraXRotationChanged()

property maxCameraYRotationᅟ: float¶

This property holds The maximum Y-rotation angle of the camera around the target point in degrees..

Access functions:

maxCameraYRotation()
setMaxCameraYRotation()
Signal maxCameraYRotationChanged()

property maxCameraZoomLevelᅟ: float¶

This property holds The maximum allowed camera zoom level..

If the maximum level is set to a new value that is lower than the existing minimum level, the minimum level is adjusted to the new maximum as well. If the current cameraZoomLevel is outside the new bounds, it is adjusted as well. Defaults to 500.0f.

See also

cameraZoomLevel minCameraZoomLevel

Access functions:

maxCameraZoomLevel()
setMaxCameraZoomLevel()
Signal maxCameraZoomLevelChanged()

property measureFpsᅟ: bool¶

This property holds Whether rendering is done continuously instead of on demand..

If true, rendering is continuous and the value of the currentFps property is updated. Defaults to false.

See also

currentFps

Access functions:

measureFps()
setMeasureFps()
Signal measureFpsChanged()

property minCameraXRotationᅟ: float¶

This property holds The minimum X-rotation angle of the camera around the target point in degrees..

Access functions:

minCameraXRotation()
setMinCameraXRotation()
Signal minCameraXRotationChanged()

property minCameraYRotationᅟ: float¶

This property holds The minimum Y-rotation angle of the camera around the target point in degrees..

Access functions:

minCameraYRotation()
setMinCameraYRotation()
Signal minCameraYRotationChanged()

property minCameraZoomLevelᅟ: float¶

This property holds The minimum allowed camera zoom level..

If the minimum level is set to a new value that is higher than the existing maximum level, the maximum level is adjusted to the new minimum as well. If the current zoomLevel is outside the new bounds, it is adjusted as well. The minCameraZoomLevel cannot be set below 1.0f. Defaults to 10.0f.

See also

cameraZoomLevel maxCameraZoomLevel

Access functions:

minCameraZoomLevel()
setMinCameraZoomLevel()
Signal minCameraZoomLevelChanged()

property msaaSamplesᅟ: int¶

This property holds The number of used samples in MSAA..

Sets the number of used MSAA samples to samples. The number of samples can be either 0, 2, 4, or 8.

Access functions:

msaaSamples()
setMsaaSamples()
Signal msaaSamplesChanged()

property optimizationHintᅟ: QtGraphs3D.OptimizationHint¶

This property holds Whether the default, static, or legacy mode is used for rendering optimization..

The default mode uses instanced rendering, and provides the full feature set at the best level of performance on most systems. The static mode optimizes graph rendering and is ideal for large non-changing data sets. It is slower with dynamic data changes and item rotations. Selection is not optimized, so using the static mode with massive data sets is not advisable. Static optimization works only on scatter graphs. Legacy mode renders all items in th graph individually, without instancing. It should be used only if default mode does not work, i.e. if the target system does not support instancing. Defaults to Default .

Note

On some environments, large graphs using static optimization may not render, because all of the items are rendered using a single draw call, and different graphics drivers support different maximum vertice counts per call. This is mostly an issue on 32bit and OpenGL ES2 platforms. To work around this issue, choose an item mesh with a low vertex count or use the point mesh.

See also

mesh

Access functions:

optimizationHint()
setOptimizationHint()
Signal optimizationHintChanged()

property orthoProjectionᅟ: bool¶

This property holds Whether orthographic projection is used for displaying the graph..

Defaults to false.

Note

Shadows will be disabled when set to true.

See also

labelAutoAngle

Access functions:

isOrthoProjection()
setOrthoProjection()
Signal orthoProjectionChanged()

property polarᅟ: bool¶

This property holds Whether horizontal axes are changed into polar axes..

If true, the x-axis becomes the angular axis and the z-axis becomes the radial axis. Polar mode is not available for bar graphs.

Defaults to false.

See also

orthoProjection radialLabelOffset

Access functions:

isPolar()
setPolar()
Signal polarChanged()

property queriedGraphPositionᅟ: QVector3D¶

This property holds The latest queried graph position values along each axis..

This read-only property contains the results from graphPositionQuery . The values are normalized to the range [-1, 1]. If the queried position was outside the graph bounds, the values will not reflect the real position, but will instead indicate an undefined position outside the range [-1, 1]. The value will be undefined until a query is made.

There is no single correct 3D coordinate to match a particular screen position, so to be consistent, the queries are always done against the inner sides of an invisible box surrounding the graph.

Note

Bar graphs only allow querying graph position at the graph floor level, so the y-value is always zero for bar graphs and the valid queries can be only made at screen positions that contain the floor of the graph.

See also

graphPositionQuery

Access functions:

queriedGraphPosition()
Signal queriedGraphPositionChanged()

property radialLabelOffsetᅟ: float¶

This property holds The normalized horizontal offset for the axis labels of the radial polar axis..

The value 0.0 indicates that the labels should be drawn next to the 0-angle angular axis grid line. The value 1.0 indicates that the labels are drawn in their usual place at the edge of the graph background. Defaults to 1.0.

This property is ignored if the polar property value is false.

See also

polar

Access functions:

radialLabelOffset()
setRadialLabelOffset()
Signal radialLabelOffsetChanged()

property rotationEnabledᅟ: bool¶

This property holds Whether this input handler allows graph rotation..

Defaults to true.

Access functions:

isRotationEnabled()
setRotationEnabled()
Signal rotationEnabledChanged()

property sceneᅟ: Q3DScene¶

This property holds The Q3DScene pointer that can be used to manipulate the scene and access the scene elements..

This property is read-only.

Access functions:

scene()

property selectedElementᅟ: QtGraphs3D.ElementType¶

This property holds The element selected in the graph..

This property can be used to query the selected element type. The type is valid until a new selection is made in the graph and the selectedElementChanged signal is emitted.

The signal can be used for example for implementing custom input handlers, as demonstrated in the Graph Gallery example under Scatter Graph tab.

See also

selectedLabelIndex() selectedAxis() selectedCustomItemIndex() selectedCustomItem() selectedSeries() selectedSeries() selectedSeries() setSelectionQueryPosition()

Access functions:

selectedElement()
Signal selectedElementChanged()

property selectionEnabledᅟ: bool¶

This property holds Whether this input handler allows selection from the graph..

Defaults to true.

Access functions:

isSelectionEnabled()
setSelectionEnabled()
Signal selectionEnabledChanged()

property selectionModeᅟ: Combination of QtGraphs3D.SelectionFlag¶

This property holds Item selection mode..

A combination of SelectionFlags. By default, Item. Different graph types support different selection modes.

See also

SelectionFlags

Access functions:

selectionMode()
setSelectionMode()
Signal selectionModeChanged()

property shadowQualityᅟ: QtGraphs3D.ShadowQuality¶

This property holds The quality of the shadow..

One of the ShadowQuality enum values. By default, Medium.

Note

If setting the shadow quality to a certain level fails, the level is lowered until it is successfully set. The shadowQualityChanged signal is emitted each time a change is made.

See also

ShadowQuality

Access functions:

shadowQuality()
setShadowQuality()
Signal shadowQualityChanged()

property shadowStrengthᅟ: float¶

This property holds The shadow strength for the whole graph..

The higher the number, the darker the shadows will be. The value must be between 0.0 and 100.0.

This value affects the light specified in Q3DScene .

Access functions:

shadowStrength()
setShadowStrength()
Signal shadowStrengthChanged()

property wrapCameraXRotationᅟ: bool¶

This property holds The behavior of the minimum and maximum limits in the X-rotation..

If set to true, the X-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If set to false, the X-rotation of the camera is limited to the sector determined by the minimum and maximum values. Set to true by default.

Access functions:

wrapCameraXRotation()
setWrapCameraXRotation()
Signal wrapCameraXRotationChanged()

property wrapCameraYRotationᅟ: bool¶

This property holds The behavior of the minimum and maximum limits in the Y-rotation..

If true, the Y-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If false, the Y-rotation of the camera is limited to the sector determined by the minimum and maximum values. Set to true by default.

Access functions:

wrapCameraYRotation()
setWrapCameraYRotation()
Signal wrapCameraYRotationChanged()

property zoomAtTargetEnabledᅟ: bool¶

This property holds Whether zooming should change the camera target so that the zoomed point of the graph stays at the same location after the zoom..

Defaults to true.

Access functions:

isZoomAtTargetEnabled()
setZoomAtTargetEnabled()
Signal zoomAtTargetEnabledChanged()

property zoomEnabledᅟ: bool¶

This property holds Whether this input handler allows graph zooming..

Defaults to true.

Access functions:

isZoomEnabled()
setZoomEnabled()
Signal zoomEnabledChanged()

activeTheme()¶

Return type:: QGraphsTheme

See also

setActiveTheme()

Getter of property activeThemeᅟ .

activeThemeChanged(activeTheme)¶

Parameters:: activeTheme – QGraphsTheme

Notification signal of property activeThemeᅟ .

addCustomItem(item)¶

Parameters:: item – QCustom3DItem
Return type:: int

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.

See also

removeCustomItems() removeCustomItem() removeCustomItemAt() customItems()

addTheme(theme)¶

Parameters:: theme – QGraphsTheme

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() setActiveTheme()

ambientLightStrength()¶

Return type:: float

See also

setAmbientLightStrength()

Getter of property ambientLightStrengthᅟ .

ambientLightStrengthChanged()¶

Notification signal of property ambientLightStrengthᅟ .

aspectRatio()¶

Return type:: float

See also

setAspectRatio()

Getter of property aspectRatioᅟ .

aspectRatioChanged(ratio)¶

Parameters:: ratio – float

Notification signal of property aspectRatioᅟ .

cameraPreset()¶

Return type:: CameraPreset

See also

setCameraPreset()

Getter of property cameraPresetᅟ .

cameraPresetChanged(preset)¶

Parameters:: preset – CameraPreset

Notification signal of property cameraPresetᅟ .

cameraTargetPosition()¶

Return type:: QVector3D

See also

setCameraTargetPosition()

Getter of property cameraTargetPositionᅟ .

cameraTargetPositionChanged(target)¶

Parameters:: target – QVector3D

Notification signal of property cameraTargetPositionᅟ .

cameraXRotation()¶

Return type:: float

See also

setCameraXRotation()

Getter of property cameraXRotationᅟ .

cameraXRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property cameraXRotationᅟ .

cameraYRotation()¶

Return type:: float

See also

setCameraYRotation()

Getter of property cameraYRotationᅟ .

cameraYRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property cameraYRotationᅟ .

cameraZoomLevel()¶

Return type:: float

See also

setCameraZoomLevel()

Getter of property cameraZoomLevelᅟ .

cameraZoomLevelChanged(zoomLevel)¶

Parameters:: zoomLevel – float

Notification signal of property cameraZoomLevelᅟ .

clearSelection()¶

Clears selection from all attached series.

currentFps()¶

Return type:: int

Getter of property currentFpsᅟ .

currentFpsChanged(fps)¶

Parameters:: fps – int

Notification signal of property currentFpsᅟ .

customItems()¶

Return type:: .list of QCustom3DItem

Returns the list of all added custom items.

See also

addCustomItem()

doPicking(point)¶

Parameters:: point – QPoint

doubleTapped(eventPoint, button)¶

Parameters:

eventPoint – QEventPoint
button – MouseButton

dragged(delta)¶

Parameters:: delta – QVector2D

gridLineType()¶

Return type:: GridLineType

See also

setGridLineType()

Getter of property gridLineTypeᅟ .

gridLineTypeChanged()¶

Notification signal of property gridLineTypeᅟ .

hasSeries(series)¶

Parameters:: series – QAbstract3DSeries
Return type:: bool

Returns whether the series has already been added to the graph.

horizontalAspectRatio()¶

Return type:: float

See also

setHorizontalAspectRatio()

Getter of property horizontalAspectRatioᅟ .

horizontalAspectRatioChanged(ratio)¶

Parameters:: ratio – float

Notification signal of property horizontalAspectRatioᅟ .

isOrthoProjection()¶

Return type:: bool

Getter of property orthoProjectionᅟ .

isPolar()¶

Return type:: bool

Getter of property polarᅟ .

isRotationEnabled()¶

Return type:: bool

Getter of property rotationEnabledᅟ .

isSelectionEnabled()¶

Return type:: bool

Getter of property selectionEnabledᅟ .

isZoomAtTargetEnabled()¶

Return type:: bool

Getter of property zoomAtTargetEnabledᅟ .

isZoomEnabled()¶

Return type:: bool

Getter of property zoomEnabledᅟ .

labelMargin()¶

Return type:: float

See also

setLabelMargin()

Getter of property labelMarginᅟ .

labelMarginChanged(margin)¶

Parameters:: margin – float

Notification signal of property labelMarginᅟ .

lightColor()¶

Return type:: QColor

See also

setLightColor()

Getter of property lightColorᅟ .

lightColorChanged()¶

Notification signal of property lightColorᅟ .

lightStrength()¶

Return type:: float

See also

setLightStrength()

Getter of property lightStrengthᅟ .

lightStrengthChanged()¶

Notification signal of property lightStrengthᅟ .

locale()¶

Return type:: QLocale

See also

setLocale()

Getter of property localeᅟ .

localeChanged(locale)¶

Parameters:: locale – QLocale

Notification signal of property localeᅟ .

longPressed()¶

margin()¶

Return type:: float

See also

setMargin()

Getter of property marginᅟ .

marginChanged(margin)¶

Parameters:: margin – float

Notification signal of property marginᅟ .

maxCameraXRotation()¶

Return type:: float

See also

setMaxCameraXRotation()

Getter of property maxCameraXRotationᅟ .

maxCameraXRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property maxCameraXRotationᅟ .

maxCameraYRotation()¶

Return type:: float

See also

setMaxCameraYRotation()

Getter of property maxCameraYRotationᅟ .

maxCameraYRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property maxCameraYRotationᅟ .

maxCameraZoomLevel()¶

Return type:: float

See also

setMaxCameraZoomLevel()

Getter of property maxCameraZoomLevelᅟ .

maxCameraZoomLevelChanged(zoomLevel)¶

Parameters:: zoomLevel – float

Notification signal of property maxCameraZoomLevelᅟ .

measureFps()¶

Return type:: bool

See also

setMeasureFps()

Getter of property measureFpsᅟ .

measureFpsChanged(enabled)¶

Parameters:: enabled – bool

Notification signal of property measureFpsᅟ .

minCameraXRotation()¶

Return type:: float

See also

setMinCameraXRotation()

Getter of property minCameraXRotationᅟ .

minCameraXRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property minCameraXRotationᅟ .

minCameraYRotation()¶

Return type:: float

See also

setMinCameraYRotation()

Getter of property minCameraYRotationᅟ .

minCameraYRotationChanged(rotation)¶

Parameters:: rotation – float

Notification signal of property minCameraYRotationᅟ .

minCameraZoomLevel()¶

Return type:: float

See also

setMinCameraZoomLevel()

Getter of property minCameraZoomLevelᅟ .

minCameraZoomLevelChanged(zoomLevel)¶

Parameters:: zoomLevel – float

Notification signal of property minCameraZoomLevelᅟ .

mouseMove(mousePos)¶

Parameters:: mousePos – QPoint

msaaSamples()¶

Return type:: int

See also

setMsaaSamples()

Getter of property msaaSamplesᅟ .

msaaSamplesChanged(samples)¶

Parameters:: samples – int

Notification signal of property msaaSamplesᅟ .

optimizationHint()¶

Return type:: OptimizationHint

See also

setOptimizationHint()

Getter of property optimizationHintᅟ .

optimizationHintChanged(hint)¶

Parameters:: hint – OptimizationHint

Notification signal of property optimizationHintᅟ .

orthoProjectionChanged(enabled)¶

Parameters:: enabled – bool

Notification signal of property orthoProjectionᅟ .

pinch(delta)¶

Parameters:: delta – float

polarChanged(enabled)¶

Parameters:: enabled – bool

Notification signal of property polarᅟ .

queriedGraphPosition()¶

Return type:: QVector3D

Getter of property queriedGraphPositionᅟ .

queriedGraphPositionChanged(data)¶

Parameters:: data – QVector3D

Notification signal of property queriedGraphPositionᅟ .

radialLabelOffset()¶

Return type:: float

See also

setRadialLabelOffset()

Getter of property radialLabelOffsetᅟ .

radialLabelOffsetChanged(offset)¶

Parameters:: offset – float

Notification signal of property radialLabelOffsetᅟ .

releaseCustomItem(item)¶

Parameters:: item – QCustom3DItem

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.

See also

setTextureImage() setTextureFile()

releaseTheme(theme)¶

Parameters:: theme – QGraphsTheme

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() setActiveTheme()

removeCustomItem(item)¶

Parameters:: item – QCustom3DItem

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

removeCustomItemAt(position)¶

Parameters:: position – QVector3D

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

removeCustomItems()¶

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

renderToImage([imageSize=QSize()])¶

Parameters:: imageSize – QSize
Return type:: QSharedPointer

Renders current frame to an image of imageSize. Returns a shared pointer to grab result which can be used to access the rendered image when it’s ready. Image is rendered with the current antialiasing settings.

Note

OpenGL ES2 does not support anitialiasing.

See also

grabToImage

rotationEnabledChanged(enable)¶

Parameters:: enable – bool

Notification signal of property rotationEnabledᅟ .

scene()¶

Return type:: Q3DScene

Getter of property sceneᅟ .

selectedAxis()¶

Return type:: QAbstract3DAxis

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.

See also

selectedElement

selectedCustomItem()¶

Return type:: QCustom3DItem

Can be used to get the selected custom item after receiving selectedElementChanged signal with Q3DGraphsWidgetItem::ElementType::CustomItem 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.

See also

selectedElement

selectedCustomItemIndex()¶

Return type:: int

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

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

See also

selectedElement

selectedElement()¶

Return type:: ElementType

Getter of property selectedElementᅟ .

selectedElementChanged(type)¶

Parameters:: type – ElementType

Notification signal of property selectedElementᅟ .

selectedLabelIndex()¶

Return type:: int

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.

See also

selectedElement

selectionEnabledChanged(enable)¶

Parameters:: enable – bool

Notification signal of property selectionEnabledᅟ .

selectionMode()¶

Return type:: Combination of SelectionFlag

See also

setSelectionMode()

Getter of property selectionModeᅟ .

selectionModeChanged(selectionMode)¶

Parameters:: selectionMode – Combination of SelectionFlag

Notification signal of property selectionModeᅟ .

setActiveTheme(activeTheme)¶

Parameters:: activeTheme – QGraphsTheme

See also

activeTheme()

Setter of property activeThemeᅟ .

setAmbientLightStrength(newAmbientLightStrength)¶

Parameters:: newAmbientLightStrength – float

See also

ambientLightStrength()

Setter of property ambientLightStrengthᅟ .

setAspectRatio(ratio)¶

Parameters:: ratio – float

See also

aspectRatio()

Setter of property aspectRatioᅟ .

setCameraPosition(horizontal, vertical[, zoom=100.0f])¶

Parameters:

horizontal – float
vertical – float
zoom – float

Utility function that sets the camera rotations and distance.``horizontal`` and vertical define the camera rotations to be used. Optional zoom parameter can be given to set the zoom percentage of the camera within the bounds defined by minCameraZoomLevel and maxCameraZoomLevel properties.

setCameraPreset(preset)¶

Parameters:: preset – CameraPreset

See also

cameraPreset()

Setter of property cameraPresetᅟ .

setCameraTargetPosition(target)¶

Parameters:: target – QVector3D

See also

cameraTargetPosition()

Setter of property cameraTargetPositionᅟ .

setCameraXRotation(rotation)¶

Parameters:: rotation – float

See also

cameraXRotation()

Setter of property cameraXRotationᅟ .

setCameraYRotation(rotation)¶

Parameters:: rotation – float

See also

cameraYRotation()

Setter of property cameraYRotationᅟ .

setCameraZoomLevel(level)¶

Parameters:: level – float

See also

cameraZoomLevel()

Setter of property cameraZoomLevelᅟ .

setDefaultInputHandler()¶

setDragButton(button)¶

Parameters:: button – Combination of MouseButton

setGridLineType(gridLineType)¶

Parameters:: gridLineType – GridLineType

See also

gridLineType()

Setter of property gridLineTypeᅟ .

setHorizontalAspectRatio(ratio)¶

Parameters:: ratio – float

See also

horizontalAspectRatio()

Setter of property horizontalAspectRatioᅟ .

setLabelMargin(margin)¶

Parameters:: margin – float

See also

labelMargin()

Setter of property labelMarginᅟ .

setLightColor(newLightColor)¶

Parameters:: newLightColor – QColor

See also

lightColor()

Setter of property lightColorᅟ .

setLightStrength(newLightStrength)¶

Parameters:: newLightStrength – float

See also

lightStrength()

Setter of property lightStrengthᅟ .

setLocale(locale)¶

Parameters:: locale – QLocale

See also

locale()

Setter of property localeᅟ .

setMargin(margin)¶

Parameters:: margin – float

See also

margin()

Setter of property marginᅟ .

setMaxCameraXRotation(rotation)¶

Parameters:: rotation – float

See also

maxCameraXRotation()

Setter of property maxCameraXRotationᅟ .

setMaxCameraYRotation(rotation)¶

Parameters:: rotation – float

See also

maxCameraYRotation()

Setter of property maxCameraYRotationᅟ .

setMaxCameraZoomLevel(level)¶

Parameters:: level – float

See also

maxCameraZoomLevel()

Setter of property maxCameraZoomLevelᅟ .

setMeasureFps(enable)¶

Parameters:: enable – bool

See also

measureFps()

Setter of property measureFpsᅟ .

setMinCameraXRotation(rotation)¶

Parameters:: rotation – float

See also

minCameraXRotation()

Setter of property minCameraXRotationᅟ .

setMinCameraYRotation(rotation)¶

Parameters:: rotation – float

See also

minCameraYRotation()

Setter of property minCameraYRotationᅟ .

setMinCameraZoomLevel(level)¶

Parameters:: level – float

See also

minCameraZoomLevel()

Setter of property minCameraZoomLevelᅟ .

setMsaaSamples(samples)¶

Parameters:: samples – int

See also

msaaSamples()

Setter of property msaaSamplesᅟ .

setOptimizationHint(hint)¶

Parameters:: hint – OptimizationHint

See also

optimizationHint()

Setter of property optimizationHintᅟ .

setOrthoProjection(enable)¶

Parameters:: enable – bool

See also

isOrthoProjection()

Setter of property orthoProjectionᅟ .

setPolar(enable)¶

Parameters:: enable – bool

See also

isPolar()

Setter of property polarᅟ .

setRadialLabelOffset(offset)¶

Parameters:: offset – float

See also

radialLabelOffset()

Setter of property radialLabelOffsetᅟ .

setRotationEnabled(enable)¶

Parameters:: enable – bool

See also

isRotationEnabled()

Setter of property rotationEnabledᅟ .

setSelectionEnabled(enable)¶

Parameters:: enable – bool

See also

isSelectionEnabled()

Setter of property selectionEnabledᅟ .

setSelectionMode(selectionMode)¶

Parameters:: selectionMode – Combination of SelectionFlag

See also

selectionMode()

Setter of property selectionModeᅟ .

setShadowQuality(shadowQuality)¶

Parameters:: shadowQuality – ShadowQuality

See also

shadowQuality()

Setter of property shadowQualityᅟ .

setShadowStrength(newShadowStrength)¶

Parameters:: newShadowStrength – float

See also

shadowStrength()

Setter of property shadowStrengthᅟ .

setWidget(widget)¶

Parameters:: widget – QQuickWidget

setWrapCameraXRotation(wrap)¶

Parameters:: wrap – bool

See also

wrapCameraXRotation()

Setter of property wrapCameraXRotationᅟ .

setWrapCameraYRotation(wrap)¶

Parameters:: wrap – bool

See also

wrapCameraYRotation()

Setter of property wrapCameraYRotationᅟ .

setZoomAtTargetEnabled(enable)¶

Parameters:: enable – bool

See also

isZoomAtTargetEnabled()

Setter of property zoomAtTargetEnabledᅟ .

setZoomEnabled(enable)¶

Parameters:: enable – bool

See also

isZoomEnabled()

Setter of property zoomEnabledᅟ .

shadowQuality()¶

Return type:: ShadowQuality

See also

setShadowQuality()

Getter of property shadowQualityᅟ .

shadowQualityChanged(quality)¶

Parameters:: quality – ShadowQuality

Notification signal of property shadowQualityᅟ .

shadowStrength()¶

Return type:: float

See also

setShadowStrength()

Getter of property shadowStrengthᅟ .

shadowStrengthChanged()¶

Notification signal of property shadowStrengthᅟ .

tapped(eventPoint, button)¶

Parameters:

eventPoint – QEventPoint
button – MouseButton

themes()¶

Return type:: .list of QGraphsTheme

Returns the list of all added themes.

See also

addTheme()

unsetDefaultDragHandler()¶

unsetDefaultInputHandler()¶

unsetDefaultPinchHandler()¶

unsetDefaultTapHandler()¶

unsetDefaultWheelHandler()¶

wheel(event)¶

Parameters:: event – QWheelEvent

widget()¶

Return type:: QQuickWidget

wrapCameraXRotation()¶

Return type:: bool

See also

setWrapCameraXRotation()

Getter of property wrapCameraXRotationᅟ .

wrapCameraXRotationChanged(wrap)¶

Parameters:: wrap – bool

Notification signal of property wrapCameraXRotationᅟ .

wrapCameraYRotation()¶

Return type:: bool

See also

setWrapCameraYRotation()

Getter of property wrapCameraYRotationᅟ .

wrapCameraYRotationChanged(wrap)¶

Parameters:: wrap – bool

Notification signal of property wrapCameraYRotationᅟ .

zoomAtTargetEnabledChanged(enable)¶

Parameters:: enable – bool

Notification signal of property zoomAtTargetEnabledᅟ .

zoomEnabledChanged(enable)¶

Parameters:: enable – bool

Notification signal of property zoomEnabledᅟ .