Qt 5.7 | Qt Data Visualization | QML Types | Surface3DSeries QML Type

Qt 5.7.1 Reference Documentation

# Surface3DSeries QML Type

Base series type for Surfaces3D. More...

Import Statement: | import QtDataVisualization 1.2
Since: | QtDataVisualization 1.0
Instantiates: | QSurface3DSeries
Inherits: | Abstract3DSeries

- List of all members, including inherited members

## Properties

- dataProxy : SurfaceDataProxy
- drawMode : DrawFlag
- flatShadingEnabled : bool
- flatShadingSupported : bool
- invalidSelectionPosition : point
- selectedPoint : point
- textureFile : string

## Detailed Description

This type manages the series specific visual elements, as well as series data (via data proxy).

For Surface3DSeries enums, see QSurface3DSeries::DrawFlag.

For more complete description, see QSurface3DSeries.

See also Qt Data Visualization Data Handling.

## Property Documentation

dataProxy : SurfaceDataProxy

This property holds the active data proxy. The series assumes ownership of any proxy set to it and deletes any previously set proxy when a new one is added. The proxy cannot be null or set to another series.

drawMode : DrawFlag

Sets the drawing mode to one of Surface3DSeries.DrawFlag. Clearing all flags is not allowed.

flatShadingEnabled : bool

Sets surface flat shading to enabled. It is preset to `true` by default. When disabled, the normals on the surface are interpolated making edges looking round. When enabled, the normals are kept same on a triangle making the color of the triangle solid. This makes the data more readable from the model.

Note: Flat shaded surfaces require at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension. The value of flatShadingSupported property indicates if flat shading is supported at runtime.

flatShadingSupported : bool

Flat shading for surfaces requires at least GLSL version 1.2 with GL_EXT_gpu_shader4 extension. If true, flat shading for surfaces is supported by current system.

Note: This read-only property is set to its correct value after first render pass. Before then it is always true.

invalidSelectionPosition : point

A constant property providing an invalid selection position. Set this to selectedPoint property to clear the selection from this series.

See also AbstractGraph3D::clearSelection().

selectedPoint : point

Selects a surface grid point in a position. The position is the (row, column) position in the data array of the series. Only one point can be selected at a time. To clear selection from this series, set invalidSelectionPosition as the position. If this series is added to a graph, the graph can adjust the selection according to user interaction or if it becomes invalid. Removing rows from or inserting rows to the series before the row of the selected point will adjust the selection so that the same point will stay selected.

See also AbstractGraph3D::clearSelection().

textureFile : string

Holds the texture file name for the surface texture. To clear the texture, set empty file name.